检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
950808 转 1
预约咨询
工单提交
我有建议
未实名认证
已实名认证
分享文档到微博
复制链接到剪贴板
链接复制成功!
根据标签信息查询资源共享实例列表。
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
授权项
访问级别
资源类型(*为必须)
条件键
别名
依赖的授权项
ram:resourceShares:listResourceSharesByTag
List
-
g:TagKeys
POST /v1/resource-shares/resource-instances/filter
参数
是否必选
参数类型
描述
limit
否
Integer
参数解释:
分页页面的最大值。
约束限制:
不涉及
取值范围:
只支持数字,最小值为 1,最大值为 1000
默认取值:
1000
offset
String
分页标记。
只支持数字组成。且长度为[1~1000]个字符。
X-Security-Token
如果正在使用临时安全凭据,则此header是必需的,该值是临时安全凭据的安全令牌(会话令牌)。
只能由英文字母、数字组成,且长度为至少 1 个字符
without_any_tag
Boolean
不包含任意一个标签,该字段为true时查询所有不带标签的资源。
tags
Array of TagFilter objects
包含标签,最多包含20个key,每个key下面的value最多20个,结构体不能缺失,key不能为空或者空字符串。Key不能重复,同一个key中values不能重复。返回包含所有标签的资源列表,key之间是"与"的关系,key-value结构中value是"或"的关系。无tag过滤条件时返回全量数据。
matches
Array of Match objects
资源共享实例绑定标签列表的匹配字段。
key
是
标签"键"的标识符或名称。
只能由字母、数字、中文、下划线、点号、冒号、等号、加号、连字符、@符号及空格组成,不能以空格或"sys"开头,也不能以空格结尾。且长度为[1~128]个字符。
values
Array of strings
标签"键"对应的"值"。您可以将标签的值设置为空字符串,但不能设置为null。
只能由字母、数字、中文、下划线、点号、冒号、斜杠、等号、加号、连字符、@符号及空格组成。且长度为[0~255]个字符。
键。取值范围为policy , organizational-unit, account。
由[0-128]个字符组成
value
由[0-255]个字符组成
状态码:200
resources
Array of ResourceDTO objects
资源信息列表。
total_count
总记录数。
resource_id
资源ID。
resource_name
资源名称。
Array of Tag objects
资源标签列表。
resource_detail
Object
资源详情。
POST /v1/resource-shares/resource-instances/filter { "without_any_tag" : true, "tags" : [ { "key" : "string", "values" : [ "string" ] } ], "matches" : [ { "key" : "policy", "value" : "string" } ] }
请求成功。
{ "resources" : [ { "resource_id" : "string", "resource_name" : "string", "resource_detail" : { }, "tags" : [ { "key" : "string", "value" : "string" } ] } ], "total_count" : 0 }
状态码
200
请参见错误码。
上一篇:查询已使用的标签列表 - ListResourceShareTags
下一篇:根据标签信息查询实例数量 - SearchResourceShareCountByTags
在使用文档中是否遇到以下问题
意见反馈(选填)
请至少选择一项反馈信息并填写问题反馈
字符长度不能超过500
如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨