Creates a dedicated block storage cluster by specifying parameters such as Azone, Capacity, Type, and PeriodUnit.
Operation description
Operation description
-
A Dedicated Block Storage Cluster is a block storage service that is physically isolated from other public cloud block storage clusters. The owner has exclusive access to all resources in the cluster.
-
Cloud disks created in a dedicated block storage cluster can only be mounted to ECS instances in the same zone. Before you create a dedicated block storage cluster, plan the region and zone for your resources.
-
Dedicated block storage clusters are divided into basic and performance types. Select the appropriate cluster performance type based on your actual needs when creating a cluster.
-
Creating a dedicated block storage cluster incurs fees.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
ebs:CreateDedicatedBlockStorageCluster |
create |
*DedicatedBlockStorageCluster
|
None |
|
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
The region ID of the dedicated block storage cluster. You can call the DescribeRegions operation to query the most recent region list. |
cn-heyuan |
| Azone |
string |
Yes |
The zone ID of the dedicated block storage cluster. You can call the DescribeZones operation to query the zone list. |
cn-heyuan-b |
| DbscName |
string |
Yes |
The name of the dedicated block storage cluster. |
myDBSCCluster |
| Capacity |
integer |
Yes |
The capacity of the dedicated block storage cluster. Valid values: 61440 to 2334720 GiB (2280 TiB). The minimum increment is 12288 GiB. Note
When the capacity of the dedicated block storage cluster is less than 576 TiB, the maximum throughput supported per TiB does not exceed 52 MB/s. When the capacity of the dedicated block storage cluster is greater than 576 TiB, the maximum throughput supported per TiB does not exceed 26 MB/s. |
61440 |
| Type |
string |
Yes |
The performance type of the dedicated block storage cluster. Valid values:
Default value: Premium. For more information about ESSDs, see ESSDs. |
Premium |
| ResourceGroupId |
string |
No |
The ID of the resource group to which the dedicated block storage cluster belongs. |
rg-acfmvs******* |
| Tag |
array<object> |
No |
The list of tags. You can specify up to 20 tags. |
|
|
object |
No |
|||
| Key |
string |
Yes |
The tag key of the dedicated block storage cluster. |
tag-key |
| Value |
string |
Yes |
The tag value of the dedicated block storage cluster. |
tag-value |
| Period |
integer |
No |
Specifies the subscription duration. Valid values: 6, 7, 8, 9, 10, 11, 12, 24, and 36. |
12 |
| PeriodUnit |
string |
No |
The unit of the subscription duration, which is the unit of the |
Month |
DbscId
deprecated
|
string |
No |
[Deprecated] This parameter is deprecated. |
test1233 |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Schema of Response |
||
| RequestId |
string |
The request ID. |
20758A-585D-4A41-A9B2-28DA8F4F**** |
| OrderId |
string |
The order ID. |
50155660025**** |
| DbscId |
string |
The ID of the dedicated block storage cluster. |
dbsc-f8z4d3k4nsgg9okb**** |
Examples
Success response
JSON format
{
"RequestId": "20758A-585D-4A41-A9B2-28DA8F4F****",
"OrderId": "50155660025****",
"DbscId": "dbsc-f8z4d3k4nsgg9okb****"
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidParameter | The parameter %s is invalid. | The specified parameter value is invalid. |
| 400 | MissingParameter | The input parameter %s that is mandatory for processing this request is not supplied. | The parameter must be specified. |
| 500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | An internal error has occurred. |
| 403 | Forbidden | User is not authorized to operate. | You are not authorized to manage the resource. Check the account permissions or contact the Alibaba Cloud account. |
| 403 | Forbidden.Action | User is not authorized to operate this action. | You are not authorized to perform this operation. Check the account permissions or contact the Alibaba Cloud account. |
| 403 | InvalidAccountStatus.NotEnoughBalance | Your account does not have enough balance. | Your account balance is insufficient. |
| 403 | InvalidPayMethod | The specified pay method is not valid. | The specified purchase method is not supported. Check whether the chargeType parameter is valid. |
| 403 | NoPermission.SLR | The RAM user does not have the permission to create service linked role: AliyunServiceLinkedRoleForEBS. | You are not authorized to create service-linked roles. |
| 404 | InvalidApi.NotFound | Specified api is not found, please check your url and method. | |
| 404 | InvalidRegionId.NotFound | The specified RegionId does not exist. | The specified RegionId does not exist. |
| 404 | InvalidResourceId.NotFound | The specified ResourceIds are not found in our records. | The specified resource does not exist. Check whether the ResourceId parameter is valid. |
| 404 | MissingParameter.ResourceType | The parameter - ResourceType should not be null | The ResourceType parameter cannot be empty. |
| 404 | InvalidResourceGroup.NotFound | The ResourceGroup provided does not exist in our records. | The resource group does not exist in the records. |
| 404 | NoSuchResource | The specified resource does not exist. | The specified resource does not exist. |
| 504 | RequestTimeout | The request is timeout, please try again later. | The request has timed out. Try again later. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.