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.