检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
RAM服务内置了不同资源类型的共享权限，资源使用者只能对资源进行权限内的访问，保证共享资源在满足资源使用者业务诉求的同时，提升资源管理的安全性。 组织级共享管理 用户通过RAM服务将资源共享给整个组织或OU时，RAM服务能够根据组织或OU下账号的调整，自动赋予或收回相应账号的共享资源访问权限。
计费说明 RAM为免费服务，使用RAM服务的相关功能不收取任何费用。 共享的资源自身的使用费用请参见各服务产品文档中的计费说明章节。 关于各付费云服务的价格详情请参见产品价格详情，如何了解和管理您的费用请参见费用中心。
状态码是一组从2xx（成功）到4xx或5xx（错误）的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于检索共享资源权限列表接口，如果调用后返回状态码为“200”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 详细的公共响应消息头字段请参见表1。
检索共享的资源 功能介绍 检索您共享的或共享给您的资源。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST https://{endpoint}/v1/sha
检索资源共享权限内容 功能介绍 检索指定资源类型的共享资源指定版本的权限内容，如果不指定权限版本，则返回默认版本的权限内容。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI
String 检索您创建的或共享给您的（self或者other-accounts）资源共享实例。 resource_share_ids 否 Array of strings 资源共享实例的ID列表。 resource_share_status 否 String 资源共享实例的状态。 tag_filters
ResourceShare object 描述RAM中的资源共享。 表5 ResourceShare 参数 参数类型 描述 id String 资源共享实例的ID。 name String 资源共享实例的名称。 description String 资源共享实例的描述。 allow_external_principals
创建的共享。 列表上方的搜索框支持根据共享名称、ID、状态和标签进行搜索。 在列表中的“操作”列可对共享进行“编辑”和“删除”操作，在“共享名称/ID”列可直接修改共享名称和复制共享名称和ID。 图1 共享管理列表 在列表中单击需要查看的共享名称，进入共享详情页，查看该共享的详细配置。
资源使用者的详细信息列表。 page_info PageInfo object 分页详细信息。 表4 SharedPrincipal 参数 参数类型 描述 resource_share_id String 资源使用者绑定的资源共享实例的ID。 id String 资源使用者的账号ID或URN。
资源所有者将该资源的访问权限授予另一个账号，且授予的权限是在配置资源共享实例时选择的共享权限。资源使用者对该共享资源的操作权限，取决于共享中配置的资源共享权限。 RAM的工作原理如下图所示： 图1 RAM工作原理 访问方式 通过管理控制台、基于HTTPS请求的API（Application
_id 是 String 资源共享邀请的ID。 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Security-Token 否 String 如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 响应参数 状态码：
_id 是 String 资源共享邀请的ID。 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Security-Token 否 String 如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 响应参数 状态码：
permission_id String 权限的ID。 permission_name String 共享资源权限的名称。 resource_type String 权限适用的资源类型。 status String 权限的当前状态。 created_at String 创建权限的时间。 updated_at
号创建资源共享的数量，resource_association资源共享关联的资源数量，principal_association资源共享关联的身份数量，permission_association资源共享关联的权限数量，tag_association资源共享关联的标签数量。 quota
如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 resource_types Array of ResourceTypesSummary objects 云服务资源的详细信息列表。 page_info
您可以在权限库列表中查看RAM针对不同资源类型预置的所有系统权限。 对于每种可共享的资源类型，至少有一个RAM预置的系统权限，该权限定义资源使用者对共享资源可执行的操作。某些资源类型定义了多个预置的系统权限，您在创建共享时可以依据最小权限原则和不同的使用诉求，选择不同的系统权限，提升了资源访问的安全性。
功能介绍 向资源共享实例绑定指定的资源使用者列表或共享资源列表。对于新增的共享资源，有权访问此资源共享实例的资源使用者获得该共享资源的访问权限。对于新增的资源使用者，获得对此资源共享实例中共享资源的访问权限。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API
ID。 每个区域的项目ID有所不同，需要根据业务所在的区域获取对应的项目ID。 图2 查看账号名、账号ID、用户名、用户ID、项目名称、项目ID 调用API获取用户ID、项目ID 获取用户ID请参考：管理员查询IAM用户列表。 获取项目ID请参考：查询指定条件下的项目列表。 获取用户组名称和ID
查询已使用的标签列表 功能介绍 查询资源共享实例已使用标签的列表。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET https://{endpoint}/v1
resource_type String 此权限适用的资源类型。 is_resource_type_default Boolean 该权限是否是此资源类型的默认权限。 created_at String 权限的创建时间。 updated_at String 上次更新权限的时间。 permission_urn
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
