通过服务实例 ID、资源 ARN(Aliyun Resource Name)、地域 ID等参数,查询满足条件服务实例资源列表。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
computenest:ListServiceInstanceResources | get |
|
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
MaxResults | integer | 否 | 分页查询时每页行数。每页最大行数 100 行,默认行数 20 行。 | 20 |
NextToken | string | 否 | 查询凭证(Token),取值为上一次 API 调用返回的 NextToken 参数值。 | AAAAAc3HCuYhJi/wvpk4xOr0VLbAx7BkQzyYC+ONO+WudHGKEdB0uWSY7AGnM3qCgm/Ynge7zU6NWdbj0Tegyajyqyc= |
ServiceInstanceId | string | 是 | 服务实例 ID。 | si-d8a0cc2a1ee04dce**** |
ResourceARN | array | 否 | 资源 ARN(Aliyun Resource Name)。 | |
string | 否 | 资源 ARN(Aliyun Resource Name)。N 的取值范围:0~20。 | arn:acs:sag:cn-hangzhou:130920852836****:ccn/ccn-b3qf0q439sq2de**** | |
Tag | array<object> | 否 | 资源标签。 | |
object | 否 | 资源标签。 | ||
Key | string | 否 | 资源的标签键。 | key1 |
Value | string | 否 | 资源的标签值。 | value1 |
ExpireTimeStart | string | 否 | 预付费资源到期时间的查询开始时间 注意 只支持私有化部署服务实例查询。 | 2022-01-01T12:00:00 |
ExpireTimeEnd | string | 否 | 预付费资源到期时间的查询结束时间 注意 只支持私有化部署服务实例查询。 | 2022-03-01T12:00:00 |
PayType | string | 否 | 付费类型。取值范围:
注意 只支持私有化部署服务实例查询。 | Subscription |
RegionId | string | 否 | 地域 ID。 | cn-hangzhou |
ServiceInstanceResourceType | string | 否 | 服务实例资源类型。可能的值:
| AliyunResource |
Filters | array<object> | 否 | 过滤条件。有效值:
Resource Name)。 | |
object | 否 | 过滤参数。 | ||
Name | string | 否 | 过滤器名称,可选择一个或者多个名称进行查询。取值范围:
| ExpireTimeStart |
Values | array | 否 | 过滤条件值。 | |
string | 否 | 查询过滤器中的待匹配的值。 | 2022-01-01T12:00:00 Z |
返回参数
示例
正常返回示例
JSON
格式
{
"NextToken": "AAAAAc3HCuYhJi/wvpk4xOr0VLbAx7BkQzyYC+ONO+WudHGKEdB0uWSY7AGnM3qCgm/Ynge7zU6NWdbj0Tegyajyqyc=",
"RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6F",
"MaxResults": 20,
"Resources": [
{
"ResourceARN": "arn:acs:sag:cn-hangzhou:130920852836****:ccn/ccn-b3qf0q439sq2de****",
"PayType": "Subscription",
"RenewStatus": "AutoRenewal",
"CreateTime": "2022-01-01T12:00:00",
"ExpireTime": "2022-03-01T12:00:00",
"RenewalPeriod": 1,
"RenewalPeriodUnit": "Month",
"ProductType": "RDS",
"ProductCode": "rds",
"Status": "running"
}
]
}
错误码
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|---|---|
2024-08-09 | OpenAPI 入参发生变更 | 查看变更详情 |
2023-08-08 | OpenAPI 返回结构发生变更 | 查看变更详情 |
2023-08-04 | OpenAPI 返回结构发生变更 | 查看变更详情 |
2023-05-26 | OpenAPI 入参发生变更 | 查看变更详情 |