| Table of Contents |
|---|
...
| Table of Contents | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
Swarm provides a hierarchy of container objects: cluster, domain, and bucket (shown in white, below) to facilitate organizing storage of data objects.
Clusters
The cluster is the top-level container in your an object storage cloud. A cluster can have several storage domains, each organized with its own bucketsa separate bucket:
These storage domains and buckets can enforce many business requirements:
Assign permissions
Issue metadata search or listing requests
Account for usage and billing
You can configure your cluster into Configure a cluster in to a storage cloud (such as cloud.com, below) that allows users in one storage domain (my.cloud.com) securely access their content separately from other users:
...
A domain is the highest-level container in which you place data objects are placed, and it is the primary way to control access to and grouping of the data.
A cluster administrator creates the domain either using the Swarm Admin Console or programmatically, with an SCSP command. Buckets and data objects must be created in a domain (tenanted), so plan to create your domains first.
| Tip |
|---|
Best |
...
Practice |
...
These actions make |
...
URLs and cURL commands as simple as possible:
|
...
|
...
|
See the Naming Rules.
Buckets
Buckets are the required organizing containers for any named objects in a domain. Buckets let you create allows creating logical paths to named objects, and they provide a layer of access control.
...
| Code Block |
|---|
MYDOMAIN/my_bucket/my_document.doc |
Note
Buckets are not folders: they cannot be nested in other buckets.
Since named objects only exist within buckets, the The bucket must be created prior to storing a named object since named objects exist within buckets.
| Info |
|---|
ImportantNever Do not write named objects without specifying a bucket (with a path like |
When you create a new bucket, the The cluster synchronously creates two replicas of the bucket object and then asynchronously creates any additional replicas as determined by a lifepoint header https://caringo.atlassian.net/wiki/spaces/public/pages/2443821972/Lifepoint+Metadata+Headers?search_id=029a4c47-7770-4c44-acc5-b28bbe0cf645 or the scsp.defaultContextReplicas and scsp.maxContextReplicas configuration parameters when creating a new bucket.
See the Naming Rules.
...