查询当前用户保有的节省计划实例信息

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String QuerySavingsPlansInstance

系统规定参数。取值:QuerySavingsPlansInstance。

EndTime String 2021-01-01 00:00:00

结束时间,格式 yyyy-MM-dd HH:mm:ss

StartTime String 2020-01-01 00:00:00

开始时间,格式 yyyy-MM-dd HH:mm:ss

PageNum Integer 1

查询页数

PageSize Integer 20

每页个数

InstanceId String spn-xxxxxxx

节省计划实例ID

Locale String ZH

多语言信息

  • ZH 中文
  • EN 英文
Tag.N.Key String 测试标签

标签查询键

Tag.N.Value String 测试标签

标签查询值

返回数据

名称 类型 示例值 描述
Code String Success

错误码

Data Struct

返回元素

Items Array of SavingsPlansDetailResponse

实例信息列表

AllocationStatus String unallocated

分配状态:

  • unallocated 未分配
  • allocated 分配中
  • beAllocated 被分配中
Currency String CNY

货币单位:CNY人民币 USD美元

EndTime String 2021-01-01 00:00:00

实例失效时间,格式 yyyy-MM-dd HH:mm:ss

InstanceFamily String ecs.g6

如果是ECS型实例,表示对应的规格族信息或者规格族套餐信息

InstanceId String spn-xxxxxxxx

节省计划实例ID

PayMode String total

付款类型:

  • total 全预付
  • half 半预付
  • zero 0预付
PoolValue String 1.00

承付款

PrepayFee String 8760.00

预付金额

Region String cn-zhangjiakou-na62-a01

地域信息

SavingsType String ECS

节省计划类型:

  • unversal 通用型
  • ecs 计算型
StartTime String 2020-01-01 00:00:00

实例生效时间,格式 yyyy-MM-dd HH:mm:ss

Status String NORMAL

当前状态

  • NORMAL 正常状态
  • LIMIT 欠费停机
  • RELEASE 释放
Tags Array of Tag

标签信息列表

Key String 标签1

标签键

Value String 标签1

标签值

TotalSave String 20.00

总节省金额

Utilization String 1.0

总使用率

PageNum Integer 1

查询页数

PageSize Integer 20

每页个数

TotalCount Integer 100

总个数

Message String Successful

错误信息

RequestId String 61293E7A-3406-4447-8620-EC88B0AA66AD

请求ID

Success Boolean true

是否成功

示例

请求示例

http(s)://[Endpoint]/?Action=QuerySavingsPlansInstance
&<公共请求参数>

正常返回示例

XML格式

<Message>Successful</Message>
<RequestId>61293E7A-3406-4447-8620-EC88B0AA66AD</RequestId>
<Data>
    <TotalCount>100</TotalCount>
    <PageSize>20</PageSize>
    <PageNum>1</PageNum>
    <Items>
        <Status>NORMAL</Status>
        <AllocationStatus>unallocated</AllocationStatus>
        <EndTime>2021-01-01 00:00:00</EndTime>
        <InstanceFamily>ecs.g6</InstanceFamily>
        <InstanceId>spn-xxxxxxxx</InstanceId>
        <StartTime>2020-01-01 00:00:00</StartTime>
        <TotalSave>20.00</TotalSave>
        <PrepayFee>8760.00</PrepayFee>
        <PayMode>total</PayMode>
        <Utilization>1.0</Utilization>
        <Currency>CNY</Currency>
        <PoolValue>1.00</PoolValue>
        <Region>cn-zhangjiakou-na62-a01</Region>
        <SavingsType>ECS</SavingsType>
        <Tags>
            <Value>标签1</Value>
            <Key>标签1</Key>
        </Tags>
    </Items>
</Data>
<Code>Success</Code>
<Success>true</Success>

JSON格式

{"Message":"Successful","RequestId":"61293E7A-3406-4447-8620-EC88B0AA66AD","Data":{"TotalCount":"100","PageSize":"20","PageNum":"1","Items":[{"Status":"NORMAL","AllocationStatus":"unallocated","EndTime":"2021-01-01 00:00:00","InstanceFamily":"ecs.g6","InstanceId":"spn-xxxxxxxx","StartTime":"2020-01-01 00:00:00","TotalSave":"20.00","PrepayFee":"8760.00","PayMode":"total","Utilization":"1.0","Currency":"CNY","PoolValue":"1.00","Region":"cn-zhangjiakou-na62-a01","SavingsType":"ECS","Tags":[{"Value":"标签1","Key":"标签1"}]}]},"Code":"Success","Success":"true"}

错误码

HttpCode 错误码 错误信息 描述
500 InternalError An error occurred in the internal server. 内部服务器错误。
400 InvalidOwner The specified owner does not belong to caller. 指定的所有者不属于调用方。
400 InvalidParameter The specified request contains invalid parameters. 请求中包含无效参数。
400 MissingParameter The specified request lacks essential parameters. 该请求缺少必要参数。
400 NotApplicable The specified API is not applicable for the user. 此API不适用于调用方。
400 NotApplicable You are not authorized to call the API operation. Please check whether the caller site matches the API domain regionId. 用户不可调用该API。请检查调用用户站点和API域名的地域信息是否匹配。
400 NotAuthorized The user is not authorized for the specified API. 此API未对该调用者进行授权。
400 NotAuthorized You are not authorized to call the API operation. Please check whether RAM user has the permission or check whether ownerId and callerId have been given the appropriate permission. 用户没有调用该API的权限。如果是RAM调用,请检查是否授予相应权限。否则请检查ownerId和callerId的权限归属是否正确。

访问错误中心查看更多错误码。