> For the complete documentation index, see [llms.txt](https://docs.console.zenlayer.com/api-reference/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.console.zenlayer.com/api-reference/compute/zec/disk/createdisks.md).
# CreateDisks
## 1. API Description
This API (CreateDisks) is used to create one or more disks.
{% hint style="info" %} **Note**
This API is an async API. A disk `ID` list is returned after the creation request is sent. However, it does not mean the creation has been completed. You can use [`DescribeDisks`](/api-reference/compute/zec/disk/describedisks.md) to query the status of the disk. If disk has been queried with the **AVAILABLE** status, it means that the disk has been created successfully; if disk has been attached to a certain instance while creating, the **IN\_USE** status means attaching successfully.
{% endhint %}
## 2. Input Parameters
The following request parameter list only provides API request parameters.
| Parameter Name | Required | Type | Description |
| ---------------------- | -------- | ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| zoneId | Yes | String | ID of availability zone to which the disk belongs. |
| diskSize | Yes | Integer | Storage space.
Unit: GB.
|
| instanceChargePostpaid | No | [ChargePostpaid](/api-reference/compute/zec/datastructure.md#chargepostpaid) | The commitment period for a postpaid cloud disk.
Only pass this when a commitment period needs to be specified.
|
| diskName | No | String | Disk name.
Length: 1 to 64 characters.
Only letters, digits, hyphens (-), slashes (/), underscores (\_) and periods (.) are allowed.
Must start and end with a digit or a letter.
Required when diskNames is not specified.
|
| diskNames | No | Array of String | The individual name for each cloud disk.
The number of names must match the diskAmount field, and the naming rules are the same as diskName.
If not passed, all disks in this batch use the name specified by diskName.
|
| diskAmount | No | Integer | Quantity of disks.
Value range: \[1, 1000]
Default value: 1
|
| instanceId | No | String | ID of instance to which the disks are attached.
Specify the ID of an instance in the current zone to which the disks are attached.
|
| instanceIds | No | Array of String | IDs of the instances to attach.
The number of IDs must match the diskAmount field, and each disk is attached to a different instance. If instanceId is passed at the same time, instanceId takes precedence.
|
| resourceGroupId | No | String | Resource group ID.
If the value is null, the disk will be added into default resource group.
|
| diskCategory | No | String | Disk category.
Basic NVMe SSD/BASIC\_NVME\_SSD: economical NVMe SSD.
Standard NVMe SSD/NVME\_SSD: standard NVMe SSD.
Default value: Standard NVMe SSD.
Default value: Standard NVMe SSD
|
| snapshotId | No | String | ID of the snapshot to create a disk.
If this parameter is specified, the disk will be created from the snapshot. The snapshot’s disk info must be of type disk.
|
| marketingOptions | No | [MarketingInfo](/api-reference/compute/zec/datastructure.md#marketinginfo) | Information on marketing campaigns. |
| tags | No | [TagAssociation](/api-reference/compute/zec/datastructure.md#tagassociation) | Bound tags when creating resources.
Tag keys must be unique.
|
| burstingEnabled | No | Boolean | Whether to enable burstable performance.
Default value: false
|
## 3. Output Parameters
| Parameter Name | Type | Description |
| -------------- | --------------- | --------------------------------------------------------------------------------------------------------------------- |
| requestId | String | The unique request ID, which is returned for each request.
RequestId is required for locating a problem.
|
| diskIds | Array of String | ID list of disks. |
| orderNumber | String | Number of order. |
## 4. Code Example
{% tabs %}
{% tab title="Example" %}
**1. Create one 30 GiB disk.**
```json
POST /api/v2/zec HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: CreateDisks
Request：
{
"diskName": "Test-Disk",
"diskSize": 30,
"diskAmount": 1,
"zoneId": "asia-east-1a"
}
Response:
{
"requestId": "T842EE571-4490-4AFE-9F17-931030D3B4F9",
"response": {
"requestId": "T842EE571-4490-4AFE-9F17-931030D3B4F9",
"diskIds": [
""
],
"orderNumber": ""
}
}
```
**2. Create three 20 GiB disks and attach them to the same instance.**
```json
POST /api/v2/zec HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: CreateDisks
Request：
{
"diskName": "Test-Disk",
"diskSize": 20,
"diskAmount": 3,
"zoneId": "asia-east-1a",
"instanceId": ""
}
Response:
{
"requestId": "T842EE571-4490-4AFE-9F17-931030D3B4F9",
"response": {
"requestId": "T842EE571-4490-4AFE-9F17-931030D3B4F9",
"diskIds": [
"",
"",
""
],
"orderNumber": ""
}
}
```
**3. Create two 20 GiB disks, attach them to two different instances, and specify a name for each.**
```json
POST /api/v2/zec HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: CreateDisks
Request：
{
"diskName": "Test-Disk",
"diskNames": ["Test-Disk-1", "Test-Disk-2"],
"diskSize": 20,
"diskAmount": 2,
"zoneId": "asia-east-1a",
"instanceIds": ["", ""]
}
Response:
{
"requestId": "T842EE571-4490-4AFE-9F17-931030D3B4F9",
"response": {
"requestId": "T842EE571-4490-4AFE-9F17-931030D3B4F9",
"diskIds": [
"",
""
],
"orderNumber": ""
}
}
```
{% endtab %}
{% endtabs %}
## 5. Developer Resources
Zenlayer Cloud API 2.0 integrates [SDKs](/api-reference/api-introduction/toolkit/api-sdk.md)，to make it easier for you to call APIs. More programming languages will be supported.
## 6. Error Codes
The following only lists the error codes related to the API business logic. For other error codes, see [Common Error Codes](/api-reference/api-introduction/instruction/commonerrorcode.md).
| HTTP Status Code | Error Code | Description |
| ---------------- | ---------------------------------------------------- | -------------------------------------------------------------------------------------- |
| 400 | INVALID\_DISK\_CATEGORY\_ZONE\_NO\_SELL | Disk type not for sale in the zone. |
| 400 | INVALID\_DISK\_SIZE\_EXCEED\_MAXIMUM | Disk size exceeds the maximum limit. |
| 400 | INVALID\_DISK\_SIZE\_LESS\_MINIMUM | Disk size should be larger than the minimum limit. |
| 404 | INVALID\_DISK\_SNAPSHOT\_NOT\_FOUND | Snapshot does not exist. |
| 400 | INVALID\_DISK\_SNAPSHOT\_SIZE\_MISMATCH | The capacity of the created disk is smaller than the source disk size of the snapshot. |
| 404 | INVALID\_DISK\_SNAPSHOT\_ZONE\_MISMATCH | The snapshot does not match the specified zone. |
| 404 | INVALID\_INSTANCE\_NOT\_FOUND | Instance not found. |
| 404 | INVALID\_INSTANCE\_OR\_ZONE\_CANNOT\_BE\_BOTH\_EMPTY | Specify at least one of the parameters: instance and zone. |
| 400 | INVALID\_PARAMETER\_DISK\_NAME\_MALFORMED | The disk name format is invalid. |
| 400 | INVALID\_ZONE\_MISMATCH | The zones mismatch. |
| 404 | INVALID\_ZONE\_NOT\_FOUND | Region does not exist. |
| 400 | LIMIT\_EXCEEDED\_INSTANCE\_CAN\_ATTACH | Quantity of attached disks exceed available disk numbers of an instance. |
| 400 | OPERATION\_DENIED\_DISK\_INSTANCE\_NOT\_ADAPTER | The number of instances does not match the number of disks. |
| 400 | OPERATION\_DENIED\_DISK\_IO\_BURST | The disk bursting function is not enabled. |
| 400 | OPERATION\_DENIED\_DISK\_NAME\_NOT\_ADAPTER | The number of specified disk names does not match the number of disks to be created. |
| 400 | OPERATION\_DENIED\_DISK\_SNAPSHOT\_STATUS | The operation is not supported for current snapshot state. |
| 400 | OPERATION\_DENIED\_DISK\_SYSTEM\_TYPE | The operation is not supported for system disks. |
| 400 | UNSUPPORTED\_OPERATION\_INSTANCE\_STATUS | Operations on instances in current state are not supported. |