clustergroup s3gns
Sets the S3 server to redirect or forward external S3 access requests.
Syntax
Assume that there are two fabrics - F1 and F2, and that the S3 client is connected to the S3 server of fabric F1. When the client is trying to access a bucket hosted on fabric F2, the S3 server of fabric F1 sends a HTTPS redirect error to the client along with the IP address of the S3 server of fabric F2. The client then connects to the S3 server of fabric F2 to access the bucket. If your S3 client supports redirection, HPE recommends using this redirect mode for better performance.
However, some S3 clients such as the AWS client and the latest versions of minio client do not support the HTTPS redirect error. For such clients, the user can use the forward mode.
When forward mode is selected, the S3 server of fabric F1 acts as a proxy and forwards the request to the S3 server of fabric F2, while the client is only talking to the S3 server of fabric F1. Forward mode is the default and all clients should work with this mode.
- CLI
-
maprcli clustergroup s3gns -httpsmode either forward OR redirect
- REST
-
http[s]://<host>:<port>/rest/clustergroup/s3gns?<paramters>
Parameters
Parameter | Description |
---|---|
|
The mode of operation - either |
Example
Set the mode of operation to redirect
.
maprcli clustergroup s3gns -httpsmode redirect
{
"timestamp":1705411835609,
"timeofday":"2024-01-16 05:30:35.609 GMT-0800 AM",
"status":"OK",
"total":0,
"data":[
],
"messages":[
"Successfully executed s3gns command"
]
}
- REST
curl -X POST -u <username> https://abc.sj.us:8443/rest/clustergroup/s3gns?httpsmode=redirect