You can retrieve the current S3 settings. You can use the method /s3_settings/set to configure settings, then use the method /s3_settings/get to verify them.
HTTP request syntax (URI)
POST https://host_ip:9099/mapi/v1/s3_settings/get
Request structure
Not applicable.
Response structure
The response body is:
{
"maxFileSizeBytes": nnnnnnnnnn,
"maxBucketsPerUser": buckets,
"maxBulkDeleteRequestSizeBytes": size,
"maxBulkDeleteRequestSizeCount": count
}
| Parameter | Required | Type | Description |
|---|---|---|---|
| maxFileSizeBytes | No | Integer | The maximum size, in bytes, of a single object that can be uploaded to an HCP for cloud scale system. Limit: 5 GB, default: 5 GB. |
| maxBucketsPerUser | No | Integer | The maximum number of buckets that a single user can create and own. Limit: 1000 buckets, default: 100 buckets. |
| maxBulkDeleteRequestSizeBytes | No | Integer | The maximum, total size of objects, in bytes, allowed in a single bulk deletion. Default: 3 MB. |
| maxBulkDeleteRequestSizeCount | No | Integer | The maximum, total number of objects allowed in a single bulk deletion. Default: 1000 objects. |
Return codes
|
Status code |
HTTP name |
Description |
|---|---|---|
| 200 | OK | The request was executed successfully. |
| 401 | Unauthorized | Access was denied because credentials are not valid. |
| 405 | Method Not Allowed | The specified HTTP method is not allowed for a storage component. Resend using POST. |
Example
Request example:
POST https://10.10.24.195:9099/mapi/v1/s3_settings/get
JSON response:
{
"maxFileSizeBytes": 4294967296,
"maxBucketsPerUser": 100,
"maxBulkDeleteRequestSizeBytes": 3145728,
"maxBulkDeleteRequestSizeCount": 1000
}