ListPlans API Reference for Simple Application Server Plans - Simple Application Server

Description

You can query the details of all plans provided by Simple Application Server in a specified region, including the IDs, prices, disk sizes, and disk categories of the plans.

QPS limits

You can call this API operation up to 10 times per minute per account. Requests that exceed this limit are dropped and you will experience service interruptions. We recommend that you take note of this limit when you call this operation. For more information, see QPS limits.

Request parameters


Parameter	Type	Required	Example	Description
Action	String	Yes	ListPlans	The operation that you want to perform. Set the value to ListPlans.
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.

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 size of the disk. 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 SSDs ESSD: enhanced SSDs
OriginPrice	double	60	The monthly price of the plan.
Currency	String	CNY	The unit of the plan price. Valid values: CNY USD Note CNY is for the China site (aliyun.com). USD is for the international site (alibabacloud.com).
SupportPlatform	String	["Linux","Windows"]	The operating system types supported by the plan.
RequestId	String	20758A-585D-4A41-A9B2-28DA8F4F534F	The ID of the request.

Examples

Sample requests

https://swas.cn-hangzhou.aliyuncs.com/?Action=ListPlans
&<Common request parameters>

Sample success responses

XML format

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

<ListPlansResponse>
    <Plans>
        <Memory>1</Memory>
        <PlanId>swas.s2.c2m1s40b3t04</PlanId>
        <Bandwidth>3</Bandwidth>
        <DiskSize>40</DiskSize>
        <Core>2</Core>
        <Flow>400</Flow>
    </Plans>
    <Plans>
        <Memory>1</Memory>
        <PlanId>swas.s2.c2m1s50b4t06</PlanId>
        <Bandwidth>4</Bandwidth>
        <DiskSize>50</DiskSize>
        <Core>2</Core>
        <Flow>600</Flow>
    </Plans>
    <Plans>
        <Memory>2</Memory>
        <PlanId>swas.s2.c2m2s50b4t08</PlanId>
        <Bandwidth>4</Bandwidth>
        <DiskSize>50</DiskSize>
        <Core>2</Core>
        <Flow>800</Flow>
    </Plans>
    <RequestId>20758A-585D-4A41-A9B2-28DA8F4F534F</RequestId>
</ListPlansResponse>

JSON format

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

{
  "Plans" : [ {
    "Memory" : 1,
    "PlanId" : "swas.s2.c2m1s40b3t04",
    "Bandwidth" : 3,
    "DiskSize" : 40,
    "Core" : 2,
    "Flow" : 400
  }, {
    "Memory" : 1,
    "PlanId" : "swas.s2.c2m1s50b4t06",
    "Bandwidth" : 4,
    "DiskSize" : 50,
    "Core" : 2,
    "Flow" : 600
  }, {
    "Memory" : 2,
    "PlanId" : "swas.s2.c2m2s50b4t08",
    "Bandwidth" : 4,
    "DiskSize" : 50,
    "Core" : 2,
    "Flow" : 800
  } ],
  "RequestId" : "20758A-585D-4A41-A9B2-28DA8F4F534F"
}

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 error persists, submit a ticket.

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