Domain and Bucket Ownership

It can be helpful to query Swarm directly to troubleshoot access permission problems related to ownership for domain or bucket contexts. Check the context (domain or bucket) owner has the correct value.

Unknown Tenant

Gateway handles the request as if it were from the "System Tenant" and provides troubleshooting guidance in the application logs if Gateway receives a request to a domain marked as belonging to an unknown tenant.

Note

The string {node-IP} represents the IP address of any Swarm node in the storage cluster. These examples assume direct access to the storage nodes is possible without going through the Gateway.

Retrieve Domain Metadata

curl -I -L 'http://{node-IP}/?domain=dom1.example.com'

Change the Domain Owner

curl -X PUT -L 
	--post301 
	-d '' 
	-H 'X-Owner-Meta: ccarlin' 'http://{node-IP}/?domain=dom1.example.com'

Retrieve a Bucket Object's Metadata

curl -I -L 'http://{node-IP}/bucket1?domain=dom1.example.com'

Change the Bucket

Note

Any custom metadata for domains or buckets must be included in the updates in these examples. This is performed using multiple -H arguments in the cURL command.

Change to Anonymous Ownership

Remove the X-Owner-Meta header or assign it a blank value with: -H 'X-Owner-Meta;' to change a domain or bucket to anonymous ownership so all users have full access. The semicolon is a special syntax cURL requires to send a blank header.