Queries a list of plans that can be upgraded for a simple application server.

Description

If the plans of your simple application server do not meet your business requirements, you can call the ListInstancePlansModification operation to obtain a list of plans that can be upgraded for your simple application server. Then, you can call the UpgradeInstance operation to upgrade the plans.

Note We recommend that you create snapshots for the disks of your simple application server to back up data before you upgrade the plans. For more information, see CreateSnapshot.

For the precautions about plan upgrade, see Upgrade configurations.

QPS limits

The queries per second (QPS) limit for a single user for the API operation is 10 calls per minute. If the number of calls to the API operation per minute exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation. For more information, see QPS limit.

Request parameters

Parameter Type Required Example Description
Action String Yes ListInstancePlansModification

The operation that you want to perform. Set the value to ListInstancePlansModification.

RegionId String Yes cn-hangzhou

The region ID of the simple application server. You can call the ListRegions operation to query the most recent region list.

InstanceId String Yes ace0706b2ac4454d984295a94213****

The ID of the simple application server.

Response parameters

Parameter Type Example Description
Plans Array of Plan

Details about the plans.

Core Integer 2

The number of vCPUs.

Bandwidth Integer 3

The peak bandwidth. Unit: Mbit/s.

DiskSize Integer 40

The disk size of the simple application server. Unit: GB.

Flow Integer 400

The monthly data transfer quota. Unit: GB.

Memory Integer 1

The memory size. Unit: GB.

PlanId String swas.s2.c2m1s40b3t04

The ID of the plan.

DiskType String ESSD

The category of the disk. Valid values:

  • SSD: standard SSD
  • ESSD: enhanced SSD
OriginPrice double 60

The price of the plan.

Currency String CNY

The unit of the plan price. Valid values:

  • CNY
  • USD
SupportPlatform String ["Linux","Windows"]

The operating system types supported by the plan.

RequestId String 20758A-585D-4A41-A9B2-28DA8F4F****

The ID of the request.

Examples

Sample requests

https://swas.cn-hangzhou.aliyuncs.com/?Action=ListInstancePlansModification
&RegionId=cn-hangzhou
&InstanceId=ace0706b2ac4454d984295a94213****
&Common request parameters

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<ListInstancePlansModificationResponse>
    <Plans>
        <Core>2</Core>
        <Bandwidth>3</Bandwidth>
        <DiskSize>40</DiskSize>
        <Flow>400</Flow>
        <Memory>1</Memory>
        <PlanId>swas.s2.c2m1s40b3t04</PlanId>
        <DiskType>ESSD</DiskType>
        <OriginPrice>60</OriginPrice>
        <Currency>CNY</Currency>
        <SupportPlatform>["Linux","Windows"]</SupportPlatform>
    </Plans>
    <RequestId>20758A-585D-4A41-A9B2-28DA8F4F****</RequestId>
</ListInstancePlansModificationResponse>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Plans" : [ {
    "Core" : 2,
    "Bandwidth" : 3,
    "DiskSize" : 40,
    "Flow" : 400,
    "Memory" : 1,
    "PlanId" : "swas.s2.c2m1s40b3t04",
    "DiskType" : "ESSD",
    "OriginPrice" : 60,
    "Currency" : "CNY",
    "SupportPlatform" : "[\"Linux\",\"Windows\"]"
  } ],
  "RequestId" : "20758A-585D-4A41-A9B2-28DA8F4F****"
}

Error codes

HTTP status code Error code Error message Description
400 RegionIdNotMatchHost The parameter regionId does not match the endpoint host. The error message returned because the specified RegionId parameter does not match the service address that you selected.
500 InternalError An error occurred while processing your request. The error message returned because an internal error has occurred. Try again later. If the problem persists, submit a ticket.

For a list of error codes, visit the API Error Center.