调用QueryResourcePackageInstances查询用户某个资源包的实例,限定支持查询失效时间一年以内的资源包。

调试

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

请求参数

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

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

ProductCode String rds

产品代码。

ExpiryTimeStart String 2020-02-02T12:00:00Z

失效起始时间。日期格式按照ISO8601标准表示,并需要使用UTC时间。格式为:yyyy-MM-ddTHH:mm:ssZ。

ExpiryTimeEnd String 2020-02-02T13:00:00Z

失效结束时间。日期格式按照ISO8601标准表示,并需要使用UTC时间。格式为:yyyy-MM-ddTHH:mm:ssZ。

PageNum Integer 1

页码,默认为1。

PageSize Integer 20

每页条数,默认值20,最大100。

返回数据

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

状态码。

Data Struct

返回数据。

HostId String cn

主机ID。

Instances Array

实例详情数组。

Instance
ApplicableProducts List {"Product": ["oss"] }

资源包适用产品。

DeductType String Absolute

扣费类型:Absolute。

EffectiveTime String 2018-09-12T09:51:56Z

生效时间。

ExpiryTime String 2019-03-12T16:00:00Z

失效时间。

InstanceId String OSSBAG-cn-v0h1s4hma01

实例ID。

PackageType String FPT_ossbag_absolute_Storage_sh

资源包类型。

Region String cn-hangzhou

地域。

RemainingAmount String 40.000

剩余量。

RemainingAmountUnit String GB

剩余量单位。

Remark String 标准存储包(华东2)

适用产品。

Status String Available

资源包状态,取值:

  • Available(有效)。
  • Expired(失效)。
TotalAmount String 40.000

总量。

TotalAmountUnit String GB

总量单位。

PageNum String 1

页码。

PageSize String 20

每页条数。

TotalCount String 12

总记录数。

Message String Successful!

错误信息。

Page Integer 1

页码。

PageSize Integer 20

每页条数。

RequestId String 6000EE23-274B-4E07-A697-FF2E999520A4

请求ID。

Success Boolean true

是否成功。

Total Integer 12

总记录数。

示例

请求示例

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

正常返回示例

XML 格式

<QueryResourcePackageInstancesResponse>
      <Message>Successful!</Message>
      <RequestId>6000EE23-274B-4E07-A697-FF2E999520A4</RequestId>
      <Success>true</Success>
      <Code>Success</Code>
      <Data>
            <TotalCount>1</TotalCount>
            <PageSize>20</PageSize>
            <Instances>
                  <Instance>
                        <RemainingAmountUnit>GB</RemainingAmountUnit>
                        <ApplicableProducts>
                              <Product>oss</Product>
                        </ApplicableProducts>
                        <InstanceId>OSSBAG-cn-v0h1s4hma018</InstanceId>
                        <DeductType>Absolute</DeductType>
                        <RemainingAmount>40.000</RemainingAmount>
                        <Status>Available</Status>
                        <Region>cn-shanghai</Region>
                        <TotalAmountUnit>GB</TotalAmountUnit>
                        <PackageType>FPT_ossbag_absolute_Storage_sh</PackageType>
                        <TotalAmount>40.000</TotalAmount>
                        <Remark>标准存储包(华东2)</Remark>
                        <EffectiveTime>2018-09-12T09:51:56Z</EffectiveTime>
                        <ExpiryTime>2019-03-12T16:00:00Z</ExpiryTime>
                  </Instance>
            </Instances>
            <HostId>cn</HostId>
            <PageNum>1</PageNum>
      </Data>
</QueryResourcePackageInstancesResponse>

JSON 格式

{
	"Message": "Successful!",
	"RequestId": "6000EE23-274B-4E07-A697-FF2E999520A4",
	"Success": true,
	"Code": "Success",
	"Data": {
		"TotalCount": 1,
		"PageSize": 20,
		"Instances": {
			"Instance": [
				{
					"RemainingAmountUnit": "GB",
					"ApplicableProducts": {
						"Product": [
							"oss"
						]
					},
					"InstanceId": "OSSBAG-cn-v0h1s4hma018",
					"DeductType": "Absolute",
					"RemainingAmount": "40.000",
					"Status": "Available",
					"Region": "cn-shanghai",
					"TotalAmountUnit": "GB",
					"PackageType": "FPT_ossbag_absolute_Storage_sh",
					"TotalAmount": "40.000",
					"Remark": "标准存储包(华东2)",
					"EffectiveTime": "2018-09-12T09:51:56Z",
					"ExpiryTime": "2019-03-12T16:00:00Z"
				}
			]
		},
		"HostId": "cn",
		"PageNum": 1
	}
}

错误码

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