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
The existing domain or bucket SCSP HeadersSCSP Headersshould be preserved.
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
curl -i --location-trusted -u admin -XCOPY 'http://172.16.0.35/oldbucketname?domain=abc.example.com&admin&newname=newbucketname&preserve' [-D log-file-name]
The message New object created confirms that the renaming procedure is successful.