| Table of Contents |
|---|
To let you organize storage of your data objects, 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.
Best practices
These actions make your URLs and cURL commands as simple as possible:
Have your DNS map the cluster name to one or more of your the Swarm nodes.
Create a storage domain that matches the name of the cluster. This is the default domain if no domain is specified in the SCSP request or if the specified domain does not exist.
...
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.
...
| Info |
|---|
NoteBuckets 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 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 or the scsp.defaultContextReplicas and scsp.maxContextReplicas configuration parameters when creating a new bucket.
See the Naming Rules.
| Child pages (Children Display) |
|---|