DescribeRegions
Description
Call the DescribeRegions to query the Alibaba Cloud region that you can use.
Request Method
POST
Request Path
/apsara/route/Ecs/DescribeRegions
Request Parameters Common Parameters
| Name | Location | Type | Required | Sample value | Description |
|---|---|---|---|---|---|
| regionId | BODY | string | Yes | No sample value for this parameter. | region id |
| AcceptLanguage | BODY | string | No | zh-CN | returns results based on Chinese, English and Japanese filtering. For more details, please refer to RFC7231. Value range: zh-CN: Chinese en-US: English ja: Japanese default value: zh-CN. |
| ResourceType | BODY | string | No | instance | resource type. Value range: instance:ECS instance disk: disk default value: instance. |
| version | BODY | string | No | 2016-01-01 | version of api |
Return data
| Name | Type | Sample value | Description |
|---|---|---|---|
| RequestID | string | 1E3D5A1E0-67CA-43DA-24BC-EAF2D5A1E4DC | Request id |
Example
Successful Response example
{
"RequestID":"1E3D5A1E0-67CA-43DA-24BC-EAF2D5A1E4DC"
}
Failed Response example
{
"errorSample":
{
"resultCode":-1,
"resultMsg":"system error",
"result":null
}
}
DescribeResourcesModification
Description
Call the DescribeResourcesModification to query the available resource information of an available area when upgrading and downgrading instance specifications or system disks.
Request Method
POST
Request Path
/apsara/route/Ecs/DescribeResourcesModification
Request Parameters Common Parameters
| Name | Location | Type | Required | Sample value | Description |
|---|---|---|---|---|---|
| Cores | BODY | integer | No | 2 | the number of vCPU cores of the instance specification. For the value, please refer to the instance specifications in the ECS User Guide. Cores is a valid parameter only when DestinationResource = InstanceType parameter is valid. |
| ResourceId | BODY | string | Yes | i-bp67acfmxazb4p**** | resource ID. For example, when the resource to be queried is an instance, it can be understood as InstanceId. |
| regionId | BODY | string | Yes | No sample value for this parameter. | region id |
| DestinationResource | BODY | string | Yes | InstanceType | target resource type. Value range: InstanceType: instance type. SystemDisk: system disk type. |
| Memory | BODY | float | No | 8.0 | The memory size of the instance specification, in GiB. For the value, please refer to the instance specifications in the ECS User Guide. Memory is a valid parameter when DestinationResource = InstanceType. |
| RegionId | BODY | string | Yes | cn-qingdao-env17-d01 | target region ID. You can call the DescribeRegions to view the latest Alibaba Cloud region list. |
| InstanceType | BODY | string | No | ecs.g5.large | instance specification. For more details, please refer to the instance specification of the cloud server ECS user guide, or call the DescribeInstanceTypes interface to obtain the latest specification table. When the parameter DestinationResource value is SystemDisk, InstanceType parameters must be specified at the same time. |
| version | BODY | string | No | 2016-01-01 | version of api |
| MigrateAcrossZone | BODY | boolean | No | true | whether to upgrade instance specifications across clusters. Value range: true: supported. false: not supported. default value: false. |
Return data
| Name | Type | Sample value | Description |
|---|---|---|---|
| RequestID | string | 1E3D5A1E0-67CA-43DA-24BC-EAF2D5A1E4DC | Request id |
Example
Successful Response example
{
"RequestID":"1E3D5A1E0-67CA-43DA-24BC-EAF2D5A1E4DC"
}
Failed Response example
{
"errorSample":
{
"resultCode":-1,
"resultMsg":"system error",
"result":null
}
}