检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
version Integer 权限版本。 status String 权限的状态 请求示例 检索指定资源类型的共享资源指定版本的权限内容，如果不指定权限版本，则返回默认版本的权限内容。 GET https://{endpoint}/v1/permissions/{permission_urn}
检索共享的资源 功能介绍 检索您共享的或共享给您的资源。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST https://{endpoint}/v1/sha
String 资源共享实例的ID。 resource_share_name String 资源共享实例的名称。 resource_share_invitation_id String 资源共享邀请的ID。 sender_account_id String 发送资源共享邀请的账号ID。 status
页面标记。 resource_type 否 String 资源类型的名称。 permission_type 否 String 权限类型。RAM_MANAGED表示RAM托管的权限，CUSTOMER_MANAGED表示租户创建的自定义的权限，ALL表示所有的权限。 请求参数 表2 请求Header参数
指定特定的权限替换或绑定到与资源共享实例关联的现有资源类型。设置为"true"可将相同的资源类型的权限替换为当前权限。设置为"false"将权限绑定到当前资源类型。默认值为"false"。资源共享实例中的每个资源类型只能绑定一个权限。如果资源共享实例中已具有指定资源类型的权限，并
组织根的URN或OU的URN之一。 association_type String 绑定中包含的实体类型。 created_at String 绑定被创建的时间。 updated_at String 最后一次更新绑定的时间。 external Boolean 标识资源使用者是否和共享的拥有者属于同一个组织
String 检索您创建的或共享给您的（self或者other-accounts）资源共享实例。 resource_share_ids 否 Array of strings 资源共享实例的ID列表。 resource_share_status 否 String 资源共享实例的状态。 tag_filters
ues不能重复。返回包含所有标签的资源列表，key之间是"与"的关系，key-value结构中value是"或"的关系。无tag过滤条件时返回全量数据。 matches 否 Array of Match objects 资源共享实例绑定标签列表的匹配字段。 表4 TagFilter
objects 与资源共享实例关联的资源使用者或共享资源的详细信息。 表5 ResourceShareAssociation 参数 参数类型 描述 associated_entity String 绑定的实体。这可以是共享资源的URN、账号ID、组织根的URN或OU的URN之一。 association_type
标签"键"的标识符或名称。 value String 标签"键"对应的"值"。您可以将标签的值设置为空字符串，但不能设置为null。 请求示例 创建一个资源共享实例，并指定需要共享的资源，资源使用者，授予资源使用者的权限，以及资源共享实例的标签。 POST https://{en
绑定资源使用者和共享资源 功能介绍 向资源共享实例绑定指定的资源使用者列表或共享资源列表。对于新增的共享资源，有权访问此资源共享实例的资源使用者获得该共享资源的访问权限。对于新增的资源使用者，获得对此资源共享实例中共享资源的访问权限。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API
状态码是一组从2xx（成功）到4xx或5xx（错误）的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于检索共享资源权限列表接口，如果调用后返回状态码为“200”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 详细的公共响应消息头字段请参见表1。
请求URL 参数 说明 URI-scheme 传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 承载REST服务端点的服务器域名或IP，不同服务在不同区域，Endpoint不同，可以从地区和终端节点处获取。例如RAM服务的Endpoint为ram.myhuaweicloud
附录 状态码 错误码 获取账号、IAM用户、项目、用户组、区域、委托的名称和ID
Manager，简称RAM）正式商用。 2023-12-30 第六次正式发布。 新增“获取权限的所有版本”接口。 2023-08-30 第五次正式发布。 新增“检索云服务资源类型”接口。 2023-05-30 第四次正式发布。 新增“查询资源共享的配额”接口。 2023-04-11 第三次正式发布。 新增“标签管理”相关接口。
AK/SK签名认证方式仅支持消息体大小12MB以内，12MB以上的请求请使用Token认证。 AK/SK既可以使用永久访问密钥中的AK/SK，也可以使用临时访问密钥中的AK/SK，但使用临时访问密钥的AK/SK时需要额外携带“X-Security-Token”字段，字段值为临时访问密钥的security_token。
资源所有者将该资源的访问权限授予另一个账号，且授予的权限是在配置资源共享实例时选择的共享权限。资源使用者对该共享资源的操作权限，取决于共享中配置的资源共享权限。 RAM的工作原理如下图所示： 图1 RAM工作原理 访问方式 通过管理控制台、基于HTTPS请求的API（Application
Manager，以下简称RAM）服务。RAM服务为用户提供安全的跨账号共享资源的能力，用户可以通过RAM来共享自己在云平台上的资源，实现不同账号间资源的访问共享，并且可以对共享实例进行集中式的管理。 本文档提供了资源访问管理API的描述、参数说明以及示例等内容。您可以使用本文档提供的API对RAM进行相关操作，如
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
