Creates a gateway cluster.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
Action | String | Yes | CreateStorageBundle | The operation that you want to perform. Set the value to CreateStorageBundle. |
BackendBucketRegionId | String | Yes | cn-shanghai | The region where the gateway cluster resides. You can query the region ID by calling the DescribeRegions operation. |
Name | String | Yes | alex-123*** | The name of the gateway cluster. The name must be 1 to 60 characters in length and can contain letters, digits, periods (.), underscores (_), and hyphens (-). It must start with a letter. |
Description | String | No | Test | The description of the gateway cluster. The description must be 0 to 128 characters in length. |
Response parameters
Parameter | Type | Example | Description |
Code | String | 200 | The HTTP status code. If the request is successful, 200 is returned. |
Message | String | successful | The description of the status code. |
RequestId | String | 2AD80BDC-E05C-4A77-BBAD-5EDAEDE6D333 | The ID of the request. |
StorageBundleId | String | sb-000ibk4xrlr03qrjr*** | The ID of the gateway cluster. |
Success | Boolean | true | Indicates whether the request is successful. |
Examples
Sample requests
http(s)://[Endpoint]/?Action=CreateStorageBundle
&BackendBucketRegionId=cn-shanghai
&Name=alex-123***
&<Common request parameters>
Sample success responses
XML
format
<CreateStorageBundleResponse>
<Message>successful</Message>
<RequestId>2AD80BDC-E05C-4A77-BBAD-5EDAEDE6333</RequestId>
<StorageBundleId>sb-000ibk4xrlr03qrjr***</StorageBundleId>
<Code>200</Code>
<Success>true</Success>
</CreateStorageBundleResponse>
JSON
format
{
"Message":"successful",
"RequestId":"2AD80BDC-E05C-4A77-BBAD-5EDAEDE6333",
"StorageBundleId":"sb-000ibk4xrlr03qrjr***",
"Code":200,
"Success":true
}
Error codes
HttpCode | Error code | Error message | Description |
400 | EmptyStorageBundleName | You must enter a valid name for the gateway cluster. | The error message returned because the gateway cluster name is not specified. |
400 | InvalidRegionId | The specified RegionId does not exist. You must specify a valid RegionId. | The error message returned because the specified RegionId parameter does not exist. Check whether the parameter is valid. |
400 | StorageBundleDescriptionOverLimit | The length of the specified description of the gateway cluster exceeds the maximum limit. The description cannot exceed 128 characters in length. | The error message returned because the length of the description exceeds the upper limit, which is 128 characters. |
400 | BadRequest | Invalid request. You must specify valid parameters in the request. | The error message returned because the request is invalid. Check the request parameters and try again. |
400 | DuplicateStorageBundleName | The name you specified for the gateway cluster already exists. You must specify a valid name. | The error message returned because the gateway that has the same name exists. Specify another name and try again. |
400 | InvalidStorageBundleName | The specified name for the gateway cluster is invalid. The name must be 1 to 60 characters in length and can contain letters, Chinese, digits, periods (.), underscores (_), and hyphens (-). The name must start with a letter or Chinese. | The error message returned because the name of the gateway cluster is invalid. The name must be 1 to 60 characters in length and can contain letters, digits, periods (.), underscores (_), and hyphens (-). In addition, it must start with a letter. |
For a list of error codes, visit the API Error Center.