Renaming Domains and Buckets

Owned by Rumena Zlatkova (Deactivated)
Last updated: Aug 23, 2024 by Anjali Tyagi
2 min read

Rename duplicate domains or buckets using the correct syntax. Rename context objects (domains and buckets) in a storage cluster using the SCSP COPY command with the newname SCSP Query Arguments specifying the new name.

Naming and Slashes - Follow the Naming Rules for domains and buckets. Swarm handles slashes:

  • Leading slashes (/foo) are silently removed in all cases.

  • Trailing slashes (foo/) are silently removed for buckets, but they cause 404 Page Not Found errors for domains. (v11.1)

Tip

Log in to the Content UI to verify the renaming.

Preserving Headers

Preserve the existing domain or bucket. See SCSP Headers.

  • In particular, look for Policy-* headers and the x-tenant-meta-name header that Gateway uses to group domains under a tenant.

  • Add the preserve SCSP Query Arguments to the COPY request to verify any custom metadata existing on the object is carried over to the copy. (v9.2)

  • Include the header name with the new value on the request to overwrite an existing value. 

See Headers to preserve in SCSP COPY.

Renaming a Domain

Rename the domain. If this is a duplicated domain it should be renamed by aliasuuid instead, see Resolving Duplicate Domain and Bucket Names.

curl -i --location-trusted -u admin -X COPY 'http://{host}?domain={old-name}&admin&newname={new-name}&preserve'  [-D log-file-name]
Example
curl -i --location-trusted -u admin -X COPY 'http://172.16.0.35?domain=abc.example.com&admin&newname=xyz.example.com&preserve'   [-D log-file-name]

The message New object created confirms that the renaming procedure is successful.

Renaming a Bucket

Rename the bucket. If this is a duplicated bucket it should be renamed by aliasuuid instead, see Resolving Duplicate Domain and Bucket Names.

curl -i --location-trusted -u admin -XCOPY 'http://{host}/{old-name}?domain={domain}&admin&newname={new-name}&preserve' [-D log-file-name]
Example

The message New object created confirms that the renaming procedure is successful.

Transferring a Domain to a Different Tenant

To assign or transfer a domain to an existing tenant, see Domain Adoption & Transfer.

 

© DataCore Software Corporation. · https://www.datacore.com · All rights reserved.