b68bd900c1
The idea is to have namespaces in a datastore to allow grouping and namespacing backups from different (but similar trusted) sources, e.g., different PVE clusters, geo sites, use-cases or company service-branches, without separating the underlying deduplication domain and thus blowing up data and (GC/verify) resource usage. To avoid namespace ID clashes with anything existing or future usecases use a intermediate `ns` level on *each* depth. The current implementation treats that as internal and thus hides that fact from the API, iow., the namespace path the users passes along or gets returned won't include the `ns` level, they do not matter there at all. The max-depth of 8 is chosen with the following in mind: - assume that end-users already are in a deeper level of a hierarchy, most often they'll start at level one or two, as the higher ones are used by the seller/admin to namespace different users/groups, so lower than four would be very limiting for a lot of target use cases - all the more, a PBS could be used as huge second level archive in a big company, so one could imagine a namespace structure like: /<state>/<intra-state-location>/<datacenter>/<company-branch>/<workload-type>/<service-type>/ e.g.: /us/east-coast/dc12345/financial/report-storage/cassandra/ that's six levels that one can imagine for a reasonable use-case, leave some room for the ones harder to imagine ;-) - on the other hand, we do not want to allow unlimited levels as we have request parameter limits and deep nesting can create other issues as well (e.g., stack exhaustion), so doubling the minimum level of 4 (1st point) we got room to breath even for the more odd (or huge) use cases (2nd point) - a per-level length of 32 (-1 due to separator) is enough to use telling names, making lives of users and admin simpler, but not blowing up parameter total length with the max depth of 8 - 8 * 32 = 256 which is nice buffer size Much thanks for Wolfgang for all the great work on the type implementation and assisting greatly with the design. Co-authored-by: Wolfgang Bumiller <w.bumiller@proxmox.com> Co-authored-by: Thomas Lamprecht <t.lamprecht@proxmox.com> Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com> Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
22 lines
546 B
TOML
22 lines
546 B
TOML
[package]
|
|
name = "pbs-api-types"
|
|
version = "0.1.0"
|
|
authors = ["Proxmox Support Team <support@proxmox.com>"]
|
|
edition = "2018"
|
|
description = "general API type helpers for PBS"
|
|
|
|
[dependencies]
|
|
anyhow = "1.0"
|
|
hex = "0.4.3"
|
|
lazy_static = "1.4"
|
|
percent-encoding = "2.1"
|
|
regex = "1.5.5"
|
|
serde = { version = "1.0", features = ["derive"] }
|
|
serde_plain = "1"
|
|
|
|
proxmox-lang = "1.0.0"
|
|
proxmox-schema = { version = "1.2.1", features = [ "api-macro" ] }
|
|
proxmox-serde = "0.1"
|
|
proxmox-time = "1.1.1"
|
|
proxmox-uuid = { version = "1.0.0", features = [ "serde" ] }
|