CreateVolume

Last updated:2022-09-05 10:13:06

1. Description

You can call this operation to create an EBS volume, Disk types include: Extreme Speed ESSD (ESSD_PL1/ESSD_PL2/ESSD_PL3), High Efficiency EBS volume (EHDD), SSD3.0 EBS volume (SSD3.0).

2. Request parameters

Parameter Type Required Description
VolumeName String No The name of the EBS volume.
The name must be 2 to 50 characters in length and can contain letters, digits, hyphens (-), and underscores (_).
The name is automatically generated if this parameter is not specified.
The name is displayed in the console.
The name cannot start with http:// or https://.
VolumeType String Yes The type of the EBS volume. Valid values:ESSD_PL1/ESSD_PL2/ESSD_PL3/SSD3.0/EHDD.
VolumeDesc String No The description of the EBS volume.
The description can be up to 50 characters in length.
The description is displayed in the console.
The description cannot start with http:// or https://.
Size Integer Yes The capacity of the EBS volume, in GB.
Value range: 10 to 32000. Step: 1 GB.
AvailabilityZone String Yes The availability zone in which the EBS volume resides. For more information, see Regions and availability zones.
ChargeType String Yes The billing mode of the EBS volume. Valid values:
- Monthly
- HourlyInstantSettlement
- Daily
PurchaseTime Integer No The purchase period, in months. This parameter is required for the Monthly billing mode. Value range: 1 to 36.
ProjectId String No The ID of the project to which the EBS volume belongs. The ID of the default project is used if this parameter is not specified.
Version String Yes The API version. Valid value: 2016-03-04.
SnapshotId String No When the cloud disk snapshot opens, the snapshot id is entered, and the requirements are:
1. It must be a 3.0 avatar state snapshot of the system
2. The snapshot size must be less than the size to be opened
When the local system disk snapshot opens, the local system disk snapshot id is passed in, and the requirements are:
1. The snapshot status is normal
2. The snapshot size must be less than the size to be opened
Bootable Boolean No true is the system disk, false is the data disk, and the default is not transmitted to the data disk
Tag.N.Key String No Tag key 1-128 characters, only support Chinese and English characters, numbers and ±=._/@:
The number shall not exceed 5 at a time
Tag.N.Value String No Tag value is 1-256 characters, only Chinese and English characters, numbers and ±=._/@(){}:
Tag Key and Tag Value must appear in pairs and cannot be empty
The number shall not exceed 5 at a time

3. Response parameters

Parameter Type Required Description
RequestId String Yes The request ID, which is unique. A request ID is returned for each request.
VolumeId String No The ID of the EBS volume.

4. Examples

Request parameters

http://ebs.api.ksyun.com/
?Action=CreateVolume
&Version=2016-03-04
&VolumeName=ebs-test
&VolumeType=SSD3.0
&VolumeDesc=ebs-test
&Size=20
&ChargeType=Monthly
&PurchaseTime=1

Response parameters

{
  "RequestId": "6e2682a1-5968-42f5-80e5-284aae218df0",
  "VolumeId": "32065468-6d3b-44a6-9857-42fbf23c6806"
}

Did you find the above information helpful?

Unhelpful
Mostly Unhelpful
A little helpful
Helpful
Very helpful

What might be the problems?

Insufficient
Outdated
Unclear or awkward
Redundant or clumsy
Lack of context for the complex system or functionality

More suggestions

0/200

Please give us your feedback.

Submitted

Thank you for your feedback.

问题反馈