调用QuerySavingsPlansInstance节省计划实例查询_费用与成本-阿里云帮助中心

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

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

bssapi:QuerySavingsPlansInstance

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
PageSize	integer	否	每页个数	20
Locale	string	否	多语言信息 ZH 中文 EN 英文	ZH
PageNum	integer	否	查询页数	1
InstanceId	string	否	节省计划实例 ID	spn-xxxxxxx
StartTime	string	否	开始时间，格式 yyyy-MM-dd HH:mm:ss	2020-01-01 00:00:00
EndTime	string	否	结束时间，格式 yyyy-MM-dd HH:mm:ss	2021-01-01 00:00:00
Tag	array<object>	否	标签元素列表
	object	否	标签元素
Key	string	否	标签查询键	测试标签
Value	string	否	标签查询值	测试标签
Status	string	否	实例状态： NORMAL:有效 RELEASE 失效	NORMAL
CommodityCode	string	否	商品 Code	savingplan_common_public_cn

返回参数

名称	类型	描述	示例值
	object	返回值对象
Code	string	错误码	Success
Message	string	错误信息	Successful
RequestId	string	请求 ID	61293E7A-3406-4447-8620-EC88B0AA66AD
Success	boolean	是否成功	true
Data	object	返回元素
PageNum	integer	查询页数	1
PageSize	integer	每页个数	20
TotalCount	integer	总个数	100
Items	array<object>	实例信息列表
	object	实例信息
Status	string	当前状态 NORMAL 正常状态 LIMIT 欠费停机 RELEASE 释放	NORMAL
Cycle	string	购买年限	1:Year
StartTimestamp	integer	开始时间戳	1663135741039
SavingsType	string	节省计划类型： unversal 通用型 ecs 计算型	ECS
Utilization	string	总使用率	1.0
PrepayFee	string	预付金额,单位:元	8760.00
InstanceId	string	节省计划实例 ID	spn-xxxxxxxx
Currency	string	货币单位：CNY 人民币 USD 美元	CNY
EndTimestamp	integer	结束时间戳	1663135741039
EndTime	string	实例失效时间，格式 yyyy-MM-dd HH:mm:ss	2021-01-01 00:00:00
StartTime	string	实例生效时间，格式 yyyy-MM-dd HH:mm:ss	2020-01-01 00:00:00
AllocationStatus	string	分配状态： unallocated 未分配 allocated 分配中 beAllocated 被分配中	unallocated
InstanceFamily	string	如果是 ECS 型实例，表示对应的规格族信息或者规格族套餐信息	ecs.g6
Region	string	地域信息	cn-zhangjiakou-na62-a01
LastBillTotalUsage	string	上一周期抵扣总金额，单位:元	100.0
LastBillUtilization	string	上一周期使用率	0.8
TotalSave	string	总节省金额，单位:元	20.00
PoolValue	string	承付款，单位:元	1.00
PayMode	string	付款类型： total 全预付 half 半预付 zero 0 预付	total
Tags	array<object>	标签信息列表
	object	标签元素
Key	string	标签键	标签1
Value	string	标签值	标签1
DeductCycleType	string	抵扣周期类型： HOUR：小时 DAY：天 ONCE：一次性（总量递减）	HOUR
RestPoolValue	string	弹性版，按月，按天保底当前周期剩余金额，单位:元	100.0
CommodityCode	string	商品 Code	savingplan_common_public_cn
CurrentPoolValue	string	按月周期型当前周期池额度，单位:元	100.0

示例

正常返回示例

JSON格式

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

错误码

HTTP status code	错误码	错误信息	描述
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.
400	NotAuthorized	The user is not authorized for the specified API.
500	InternalError	An error occurred in the internal server.	系统异常，请重试

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

变更历史

更多信息，参考变更详情。