s3gns enables3gns
S3gns subcommand to enable S3 global namespace.
clustergroup s3gns
command. The S3 global namespace provides a unified data plane and control plane for all native S3 storage (S3 storage on fabrics).
clustergroup s3gns
command on the primary
cluster/fabric. When you enable S3 global namespace on the primary cluster of a
cluster group, the previous access key and secret key for all the non-primary
clusters are overwritten with the access key and secret key that belong to the
primary cluster. The S3 client can authenticate to the primary/non-primary
clusters by using the access key and secret key of the primary cluster
only.Syntax
- CLI
-
maprcli clustergroup s3gns -enables3gns enabling S3GNS will overwrite existing keys/IAM policies of the non-primary cluster.
- REST
-
Request Type POST Request URL http[s]://<host>:<port>/rest/clustergroup/s3gns?enables3gns<parameters>
Parameters
Parameter | Description |
---|---|
|
(Optional) Set this option to This setting must be enabled only if you wish to access the objects and or buckets belonging to all clusters/fabrics in the cluster group from any cluster in the cluster group by way of a common pair of keys and by using a common access point. The default value for this option is
WARNING Enabling S3 global namespace overwrites
all the keys and IAM policies on non-primary
clusters/fabrics with the keys and IAM policies of the
primary cluster. Ensure that relevant changes in your S3
client scripts are made, before you can enable S3 global
namespace on your cluster group. |
Example
- CLI
-
maprcli clustergroup s3gns -enables3gns true -json { "timestamp":1720589652245, "timeofday":"2024-07-09 10:35:31.245 GMT-0700 PM", "status":"OK", "total":0, "data":[ ], "messages":[ "Successfully executed s3gns command" ] }
- REST
-
curl -u <username> -X POST https://server.sj.us:8443/rest/clustergroup/s3gns?enables3gns=true
mc ls
command would list only the cluster or fabric on which you are running the
command, along with any external S3 servers in the cluster group, even if there
are other native clusters/fabrics in the cluster group.