Domain name for API request: cbs.intl.tencentcloudapi.com.
This API is used to adjust extra performance for Enhanced SSD (CLOUD_HSSD) and ulTra SSD.
*This API only supports adjust extra performance for Enhanced SSD and ulTra SSD.
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: ModifyDiskExtraPerformance. |
| 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. |
| ThroughputPerformance | Yes | Integer | Specifies the hard disk performance of the additional CBS purchase in MiB/s. |
| DiskId | Yes | String | The CLOUD disk ID for which extra performance needs to be purchased. it can be queried via the DescribeDisks api. extra performance is only supported for enhanced SSD (CLOUD_HSSD) and ultra-fast SSD (CLOUD_TSSD) CBS disks exceeding 460GiB in size. |
| 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 purchase the extra throughput performance of 300 Mbps for a 500 GB ulTra SSD.
POST / HTTP/1.1
Host: cbs.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ModifyDiskExtraPerformance
<Common request parameters>
{
"ThroughputPerformance": 1,
"DiskId": "disk-xx"
}
{
"ThroughputPerformance": "300",
"DiskId": "disk-dritwhhm"
}
{
"Response": {
"RequestId": "d010c751-3edb-4388-878c-123fe111d1111owngrade400"
}
}
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 |
|---|---|
| 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 | Incorrect parameter. |
| ResourceInsufficient | Insufficient resources. |
| UnsupportedOperation | Unsupported operation |
文档反馈