检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
标签管理 查询已使用的标签列表 根据标签信息查询实例列表 根据标签信息查询实例数量 资源共享实例增加标签 删除资源共享实例的标签 父主题： API
或删除资源共享实例。 资源使用者可以接受或拒绝共享邀请，查看当前正在使用的共享信息，以及在共享资源使用结束后退出共享。 共享信息查询 资源所有者可以查询当前已经共享的资源信息，以及资源使用者的相关信息。 资源使用者可以查询当前正在使用的共享资源信息，以及资源所有者信息。 与组织共享资源
理。 本文档提供了资源访问管理API的描述、参数说明以及示例等内容。您可以使用本文档提供的API对RAM进行相关操作，如创建、删除、更新、查询等。支持的全部操作请参阅API概览。 在调用RAM的API前，请确保已经充分了解了RAM的相关概念，详细信息请参阅产品介绍。 RAM提供了
stAssociatedPermissions × × 查询已使用的标签列表 GET /v1/resource-shares/tags ram:resourceShares:listTags × × 根据标签信息查询实例列表 POST /v1/resource-shares/re
API概览 表1 RAM接口列表 类型 说明 共享资源权限 检索指定资源类型的共享资源权限列表和详细信息接口，以及获取权限的所有版本接口。 资源共享实例 包括资源共享实例的创建、检索、更新和删除接口。 绑定的资源使用者和共享资源 包括绑定、移除和检索与资源共享实例关联的资源使用者和共享资源接口。
限，与各个接口所对应的授权项相对应，只有发起请求的用户被授予授权项所对应的策略，该用户才能成功调用该接口。例如，用户要调用接口来查询RAM权限策略列表，那么这个IAM用户被授予的策略中必须包含允许“ram:permissions:list”的授权项，该接口才能调用成功。 支持的授权项
支持共享的云服务和资源类型 表1 支持共享的云服务和资源类型 云服务 资源类型 是否支持主动退出共享 应用场景 虚拟私有云 VPC vpc:subnet（子网） 是 共享VPC功能支持多个账号在一个集中管理、共享的VPC内创建云资源，比如ECS、ELB、RDS等。VPC的所有者可
其他操作 查询资源共享的配额 检索云服务资源类型 父主题： API
全凭据的安全令牌（会话令牌）。 表3 请求Body参数 参数 是否必选 参数类型 描述 tags 是 Array of Untag objects 一个或多个标签键值对的列表。标签键必须存在，而不是空字符串。标签值必须存在，但可以是空字符串。 表4 Untag 参数 是否必选 参数类型
安全凭据的安全令牌（会话令牌）。 表3 请求Body参数 参数 是否必选 参数类型 描述 tags 是 Array of Tag objects 一个或多个标签键值对的列表。标签键必须存在，而不是空字符串。标签值必须存在，但可以是空字符串。 表4 Tag 参数 是否必选 参数类型
urce_share_id}/associated-permissions 表1 路径参数 参数 是否必选 参数类型 描述 resource_share_id 是 String 资源共享实例的ID。 表2 Query参数 参数 是否必选 参数类型 描述 permission_name
https://{endpoint}/v1/permissions/{permission_id}/versions 表1 路径参数 参数 是否必选 参数类型 描述 permission_id 是 String 共享资源权限的ID。 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer
resource-shares/{resource_share_id} 表1 路径参数 参数 是否必选 参数类型 描述 resource_share_id 是 String 资源共享实例的ID。 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Security-Token
strings 指定资源共享实例的ID列表。 响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 shared_principals Array of SharedPrincipal objects 资源使用者的详细信息列表。 page_info PageInfo
es/{resource_share_id}/disassociate 表1 路径参数 参数 是否必选 参数类型 描述 resource_share_id 是 String 资源共享实例的ID。 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Security-Token
e_share_id}/disassociate-permission 表1 路径参数 参数 是否必选 参数类型 描述 resource_share_id 是 String 资源共享实例的ID。 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Security-Token
n_id} 表1 路径参数 参数 是否必选 参数类型 描述 permission_id 是 String 共享资源权限的ID。 表2 Query参数 参数 是否必选 参数类型 描述 permission_version 否 Integer 资源权限版本。 请求参数 表3 请求Header参数
rces/search 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Security-Token 否 String 如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 表2 请求Body参数 参数 是否必选
strings 标签"键"对应的"值"列表。 响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 resource_shares Array of ResourceShare objects 资源共享实例的详细信息列表。 page_info PageInfo
resource_share_ids 否 Array of strings 指定资源共享实例的ID列表。 resource_ids 否 Array of strings 指定共享资源ID列表。 响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 resource_share_associations
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
