查询实例计费信息

接口说明


查询实例计费方式。其中按量计费支持查询自动退订时间,包年包月支持查询是否开启自动续订(支持批量)。

注意事项:

  1. 一次最多查询20台实例。

  2. 专属宿主机上实例不支持。


推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

URL

POST https://ecloud.10086.cn/api/openapi-instance/v4/batch-query-price-info

请求参数

Body

参数名称
类型
必填
描述
batchActionReq
BatchActionReq
是

batchActionReq

instanceIds
<string> array
是

实例ID数组。可通过查询实例状态列表接口获取。

请求示例

POST https://ecloud.10086.cn/api/openapi-instance/v4/batch-query-price-info
{
	"instanceIds":[
		"f53265b9-1c5a-42cd-9d22-3b9131399b39",
		"33c2cb03-45aa-4462-9211-ee80e74dc24e",
		"ec36ccba-ab1e-480b-b802-7a7a544f1aab"
	]
}

返回参数

返回码:200
OK
参数名称
类型
描述
body
<InstancePriceUnitResp> array

请求成功时返回的数据。

instanceId
string

实例ID。

priceUnit
string

资费单位类型,涉及一个实例多资费场景时,通过分隔符返回。取值范围:

  • Y:包年。
  • F:包月。
  • M:包年一次性费用。
  • O:一次性费用。
  • C:话单。
chargingMode
integer(int32)

计费模式。取值范围:

  • 1:包周期计费。
  • 2:按需计费。
autoRenew
string

是否续订标识。取值范围: - 0:不续订。 - 1:续订。 空表示之前没有续订。

respDesc
string

资源查询状态描述。

endTime
string

订购关系到期时间。

autoEndTime
string

自动释放时间。

errorCode
string

统一错误码。

errorMessage
string

页面国际化错误提示。

errorParams
<string> array

统一错误码的自定义参数。

requestId
string

每个请求的序列号。

state
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)

返回状态码。返回正常:OK,返回错误:ERROR,返回异常:EXCEPTION,需要告警实现的:ALARM,禁止访问:FORBIDDEN。

返回示例

返回码:200
OK
{
	"requestId":"f68f17d7-e495-dddd-911f-12s166q61-0115-1",
	"state":"OK",
	"body":[
		{
			"instanceId":"33c2cb03-45aa-4462-9211-ee80e74dc24e",
			"priceUnit":"F",
			"chargingMode":1,
			"autoRenew":"0",
			"endTime":"2099-12-31 23:59:59"
		},
		{
			"instanceId":"ec36ccba-ab1e-480b-b802-7a7a544f1aab",
			"priceUnit":"C",
			"chargingMode":2,
			"autoRenew":"0",
			"endTime":"2099-12-31 23:59:59"
		}
	]
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。