1. Interface Description
Interface request domain name: cbs.api3.convergecloud.com.
This API is used to query the price for modifying the cloud disk type.
- Currently, type modification is supported only for elastic cloud disks. If the Portable field returned by calling the DescribeDisks API is true, it indicates an elastic cloud disk.
- Currently, cloud disk types can only be upgraded but cannot be downgraded, specifically as follows:
- CLOUD_BASIC changes to CLOUD_PREMIUM;
- CLOUD_BASIC changes to CLOUD_SSD;
- CLOUD_PREMIUM changes to CLOUD_SSD.
Default interface request rate limit: 20 times per second.
Interface update time: 2024-07-16 07:01:21.
The interface only verifies the signature but does not authenticate.
2. Input Parameters
The following list of request parameters only lists interface request parameters and some public parameters, For a complete list of public parameters see public request parameters.
| Parameter name | Required | Allow NULL | Type | Description |
|---|---|---|---|---|
| Action | Yes | No | String | Public parameter, The value of this interface: InquiryPriceModifyDiskAttributes |
| Version | Yes | No | String | Public parameter, The value of this interface: 2017-03-12 |
| Region | No | No | String | Public parameter,Regional information A list of supported geographies is available through the DescribeRegions interface |
| DiskIds | Yes | No | Array of String | List of cloud disk instance IDs to be migrated. Currently, only one cloud disk can be input at a time. Example: ["disk-6rag8jef"] |
| DiskType | Yes | No | String | Target type of cloud disk change. Value range: Type downgrading is not currently supported. Example: CLOUD_SSD |
| ProjectId | No | No | Uint64 | Cloud disk's project ID. If this parameter is input, it is only used for authentication. Example: 1002189 |
3. Output Parameters
| Parameter name | Type | Description |
|---|---|---|
| DiskPrice | Price | It describes the price of changing cloud disk types. Example:View |
| RequestId | String | Unique request id, Each request will return. The RequestId of the request needs to be provided when locating the problem. |
4. Error Code
The following lists only the error codes related to the interface business logic, For other error codes, see public ErrorCode.
| Error Code | Description |
|---|---|
| InvalidDisk.NotPortable | Non-elastic cloud disks are not supported. |
| MissingParameter | Missing parameter. The request does not include the mandatory parameter. |
| InvalidParameterValue | Invalid parameter value. The format of the parameter value is incorrect or the parameter value is not supported. |
| InvalidDisk.Expire | The cloud disk has expired. |
| ResourceInUse.DiskMigrating | The cloud disk is migrating. |