Creates a gateway cluster.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

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.