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

httpsmode

The mode of operation - either forward (default) or redirect.

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