Domain name for API request: cbs.intl.tencentcloudapi.com.
This API is used to expand cloud disks.
*This API supports only the expansion of elastic cloud disks. To query the type of a cloud disk, you can call the DescribeDisks API and check the Portable field in the response. To expand non-elastic cloud disks, you can call the ResizeInstanceDisks API. *This is an async API. A successful return of this API does not mean that the cloud disk has been expanded successfully. You can call the DescribeDisks API to query the status of a cloud disk. EXPANDING indicates that the expansion is in process.
A maximum of 20 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| Action | Yes | String | Common Params. The value used for this API: ResizeDisk. |
| Version | Yes | String | Common Params. The value used for this API: 2017-03-12. |
| Region | Yes | String | Common Params. For more information, please see the list of regions supported by the product. |
| DiskSize | Yes | Integer | Cloud disk size after scale out (in GB). This must be larger than the current size of the cloud disk. For the value range of the cloud disk sizes, see cloud disk Product Types. |
| DiskId | No | String | Cloud disk ID, which can be queried by calling the DescribeDisks api. this field is only required when expanding a single cloud disk. |
| Parameter Name | Type | Description |
|---|---|---|
| RequestId | String | The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem. |
This example shows you how to expand a cloud disk to 200G.
POST / HTTP/1.1
Host: cbs.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ResizeDisk
<Common request parameters>
{
"DiskSize": 200,
"DiskId": "disk-lzrg2pwi"
}
{
"Response": {
"RequestId": "adefc06d-2cf1-29f6-24a6-5a1f81b5c0ac"
}
}
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
| Error Code | Description |
|---|---|
| InternalError.ComponentError | Dependent component request failed. Please contact customer service. |
| InvalidAccount.InsufficientBalance | Insufficient account balance |
| InvalidDisk.Busy | The cloud disk is busy. Try again later. |
| InvalidDisk.Expire | The cloud disk has expired. |
| InvalidDisk.NotSupported | Indicates that the operation is not supported for the cloud disk. |
| InvalidDiskId.NotFound | The ‘DiskId’ entered does not exist. |
| InvalidParameter.DiskConfigNotSupported | Currently configured cloud disk not supported in current region. |
| InvalidParameterValue | Invalid parameter value. |
| MissingParameter | Missing parameter. |
| ResourceInsufficient | Insufficient resources. |
| ResourceNotFound.NotFound | The resource is not found. |
| ResourceUnavailable.Expire | The cloud disk has expired. |
| ResourceUnavailable.NotSupported | The resource does not support this operation. |
| ResourceUnavailable.SnapshotCreating | Unable to use: the snapshot is being created |
| TradeDealConflict | Order conflict. |
| UnauthorizedOperation.NotHavePaymentRight | No payment permission. |
| UnsupportedOperation.InstanceNotStopped | Instance mounted on cloud disk not shut down. |
フィードバック