调用CreateDedicatedBlockStorageCluster创建专属块存储集群。

接口说明

说明 专属块存储集群功能目前支持华南2(河源)、印度尼西亚(雅加达)以及金融云的华南1(深圳)地域。

专属块存储集群(Dedicated Block Storage Cluster)是与其他公共云块存储集群物理隔离、所有者可独享整个集群资源的块存储服务。更多信息,请参见什么是专属块存储集群

专属块存储集群上创建的云盘只能挂载到同可用区的ECS实例上。您在创建专属块存储集群前,需要规划好资源所属的地域和可用区。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateDedicatedBlockStorageCluster

系统规定参数。取值:CreateDedicatedBlockStorageCluster

RegionId String cn-heyuan

集群所属地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

ZoneId String cn-heyuan-b

集群所属可用区ID。您可以调用DescribeZones获取可用区列表。

DedicatedBlockStorageClusterName String myDBSCCluster

专属块存储集群名称。

Category String cloud_essd

专属块存储集群可创建的云盘类型。

取值仅支持cloud_essd,即ESSD云盘。

Capacity Integer 60

专属集群容量。取值范围:60~2304,单位为TiB。

Description String This is description.

专属块存储集群的描述信息。

Type String Premium

集群性能类型。取值范围:

  • Standard:基础型。该类型的专属块存储集群中可创建ESSD PL0云盘。
  • Premium:性能型。该类型的专属块存储集群中可创建ESSD PL1云盘。

默认值:Premium

Period Integer 2

购买集群的时长,单位由PeriodUnit指定。取值范围:

  • PeriodUnit=Year时,该参数取值范围:{"1", "2", "3", "4"}。
  • PeriodUnit=Month时,该参数取值范围:{"6", "7", "8", "9", "10", "11"}。
说明 专属块存储集群仅支持包年包月的付费方式,因此您必须设置PeriodPeriodUnit参数。
PeriodUnit String Year

购买集群的时长单位。取值范围:

  • Year:年
  • Month:月
说明 专属块存储集群仅支持包年包月的付费方式,因此您必须设置PeriodPeriodUnit参数。
ClientToken String 123e4567-e89b-12d3-a456-426612340000

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。

ClientToken只支持ASCII字符,且不能超过64个字符。更多详情,请参见如何保证幂等性

返回数据

名称 类型 示例值 描述
DedicatedBlockStorageClusterOrderId String 50155660025****

订单ID。

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

请求ID。

DedicatedBlockStorageClusterId String dbsc-f8z4d3k4nsgg9okb****

专属块存储集群ID。

示例

请求示例

https://ecs.aliyuncs.com/?Action=CreateDedicatedBlockStorageCluster
&RegionId=cn-heyuan
&ZoneId=cn-heyuan-b
&Capacity=60
&Category=cloud_essd
&Type=Premium
&Period=6
&PeriodUnit=Month
&<公共请求参数>

正常返回示例

XML格式

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格式

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

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

错误码

HttpCode 错误码 错误信息 描述
404 InvalidZoneId.NotFound The specified zone does not exist. 指定的可用区ID不存在。
404 InvalidRegionId.NotFound The specified region does not exist. 指定的 RegionId 不存在,请您检查此产品在该地域是否可用。

访问错误中心查看更多错误码。