Creates a dedicated block storage cluster.

Description

Note Dedicated Block Storage Cluster is available in the China (Heyuan), Indonesia (Jakarta), and China South 1 Finance regions.

Dedicated block storage clusters are physically isolated from public block storage clusters. The owner of each dedicated block storage cluster has exclusive access to all resources in the cluster. For more information, see Overview.

Disks created in a dedicated block storage cluster can be attached only to Elastic Compute Service (ECS) instances within the same zone as the cluster. Before you create a dedicated block storage cluster, you must have an understanding of the region and zone in which cloud resources are located to create the 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 CreateDedicatedBlockStorageCluster

The operation that you want to perform. Set the value to CreateDedicatedBlockStorageCluster.

RegionId String Yes cn-heyuan

The ID of the region in which to create the dedicated block storage cluster. You can call the DescribeRegions operation to query the most recent region list.

ZoneId String Yes cn-heyuan-b

The ID of the zone in which to create the dedicated block storage cluster. You can call the DescribeZones operation to query the most recent zone list.

DedicatedBlockStorageClusterName String No myDBSCCluster

The name of the dedicated block storage cluster.

Category String Yes cloud_essd

The category of disks that can be created in the dedicated block storage cluster.

Valid value: cloud_essd. Only enhanced SSDs (ESSDs) can be created in dedicated block storage clusters.

Capacity Integer Yes 60

The capacity of the dedicated block storage cluster. Valid values: 60 to 2304. Unit: TiB.

Description String No This is description.

The description of the dedicated block storage cluster.

Type String No Premium

The type of the dedicated block storage cluster. Valid values:

  • Standard: When you set Type to Standard, ESSDs at performance level 0 (PL0 ESSDs) can be created in the dedicated block storage cluster.
  • Premium: When you set Type to Premium, ESSDs at performance level 1 (PL1 ESSDs) can be created in the dedicated block storage cluster.

Default value: Premium.

Period Integer No 2

The subscription period of the dedicated block storage cluster. The unit is specified by the PeriodUnit parameter. Valid values:

  • When PeriodUnit is set to Year, the valid values of Period are 1, 2, 3, and 4.
  • When PeriodUnit is set to Month, the valid values of Period are 6, 7, 8, 9, 10, and 11.
Note Dedicated Block Storage Cluster supports only the subscription billing method. You must specify the Period and PeriodUnit parameters.
PeriodUnit String No Year

The unit of the subscription period. Valid values:

  • Year
  • Month
Note Dedicated Block Storage Cluster supports only the subscription billing method. You must specify the Period and PeriodUnit parameters.
ClientToken String No 123e4567-e89b-12d3-a456-426612340000

The client token that is used to ensure the idempotence of the request. You can use the client to generate the value, but you must make sure that it is unique among different requests.

The ClientToken value can contain only ASCII characters and cannot exceed 64 characters in length. For more information, see How to ensure idempotence.

Response parameters

Parameter Type Example Description
DedicatedBlockStorageClusterOrderId String 50155660025****

The ID of the order.

RequestId String 20758A-585D-4A41-A9B2-28DA8F4F534F

The ID of the request.

DedicatedBlockStorageClusterId String dbsc-f8z4d3k4nsgg9okb****

The ID of the dedicated block storage cluster.

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=CreateDedicatedBlockStorageCluster
&RegionId=cn-heyuan
&ZoneId=cn-heyuan-b
&Capacity=60
&Category=cloud_essd
&Type=Premium
&Period=6
&PeriodUnit=Month
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateDedicatedBlockStorageClusterResponse>
    <DedicatedBlockStorageClusterOrderId>50155660025****</DedicatedBlockStorageClusterOrderId>
    <RequestId>20758A-585D-4A41-A9B2-28DA8F4F534F</RequestId>
    <DedicatedBlockStorageClusterId>dbsc-f8z4d3k4nsgg9okb****</DedicatedBlockStorageClusterId>
</CreateDedicatedBlockStorageClusterResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "DedicatedBlockStorageClusterOrderId" : "50155660025****",
  "RequestId" : "20758A-585D-4A41-A9B2-28DA8F4F534F",
  "DedicatedBlockStorageClusterId" : "dbsc-f8z4d3k4nsgg9okb****"
}

Error codes

HTTP status code Error code Error message Description
404 InvalidZoneId.NotFound The specified zone does not exist. The error message returned because the specified ZoneId parameter does not exist.
404 InvalidRegionId.NotFound The specified region does not exist. The error message returned because the specified RegionId parameter does not exist. Check whether the service is available in the specified region.

For a list of error codes, visit the API Error Center.