All Documents
Current Document

Content is empty

If you don't find the content you expect, please try another search term

Documentation

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"
}
On this page
Pure ModeNormal Mode

Pure Mode

Click to preview the document content in full screen
Feedback