根据资源类型及标签信息查询实例数量
功能介绍
根据资源类型及标签信息查询实例数量。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST https://{endpoint}/v1/organizations/{resource_type}/resource-instances/count
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
resource_type |
是 |
String |
资源类型。枚举值:organizations:policies(服务策略)、organizations:ous(组织OU)、organizations:accounts(账号信息) 、organizations:roots:(根)。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Security-Token |
否 |
String |
如果正在使用临时安全凭据,则此header是必需的,该值是临时安全凭据的安全令牌(会话令牌)。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
without_any_tag |
否 |
Boolean |
不包含任意一个标签,该字段为true时查询所有不带标签的资源。 |
tags |
否 |
Array of TagsDTO objects |
包含标签,最多包含10个key,每个key下面的value最多10个,结构体不能缺失,key不能为空或者空字符串。Key不能重复,同一个key中values不能重复。返回包含所有标签的资源列表,key之间是与的关系,key-value结构中value是或的关系。无tag过滤条件时返回全量数据。 |
matches |
否 |
Array of Match objects |
要绑定到新创建的账号的标签列表。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
total_count |
Integer |
总记录数。 |
请求示例
根据资源类型及标签信息查询实例数量
POST https://{endpoint}/v1/organizations/{resource_type}/resource-instances/count { "without_any_tag" : true, "tags" : [ { "key" : "string", "values" : [ "string" ] } ], "matches" : [ { "key" : "string", "value" : "string" } ] }
响应示例
状态码: 200
Successful
{ "total_count" : 0 }
状态码
状态码 |
描述 |
---|---|
200 |
Successful |
错误码
请参见错误码。