调用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"}。
说明 专属块存储集群仅支持包年包月的付费方式，因此您必须设置Period和PeriodUnit参数。
PeriodUnit String 否 Year

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

  • Year：年
  • Month：月
说明 专属块存储集群仅支持包年包月的付费方式，因此您必须设置Period和PeriodUnit参数。
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 不存在，请您检查此产品在该地域是否可用。

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