调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
| 授权项 | 访问级别 | 资源类型（*为必须） | 条件键 | 别名 | 依赖的授权项 |
| ram:resourceShares:listAssociatedPermissions | List | resourceShare * | g:ResourceTag/<tag-key> | - | - |
URI
GET /v1/resource-shares/{resource_share_id}/associated-permissions
表1 路径参数 | 参数 | 是否必选 | 参数类型 | 描述 |
| resource_share_id | 是 | String | 参数解释： 共享实例ID。获取方式：通过创建资源共享实例或查询资源共享实例列表接口获取。 约束限制： 不涉及 取值范围： 只能由英文字母、数字及“_”，“-”组成，且长度为1~36个字符。 默认取值： 不涉及 |
表2 Query参数 | 参数 | 是否必选 | 参数类型 | 描述 |
| permission_name | 否 | String | 参数解释： 共享资源权限的名称。 约束限制： 不涉及 取值范围： 只能由英文字母、数字及“_”、“-”组成，长度为1~64个字符。 默认取值： 不涉及 |
| limit | 否 | Integer | 参数解释： 分页查询时每页返回的最大记录数量。 约束限制： 不涉及 取值范围： 1~2000 默认取值： 2000 |
| marker | 否 | String | 参数解释： 页面标记，基于上一页页面标记取值，空字符串表明查询第一页。 约束限制： 不涉及 取值范围： 只支持数字和空字符串，长度为0~64个字符，空字符串表示查询第一页。 默认取值： 不涉及 |
响应参数
状态码：200
表4 响应Body参数 | 参数 | 参数类型 | 描述 |
| associated_permissions | Array of AssociatedPermission objects | 资源共享实例关联的共享资源权限信息列表。 |
| page_info | PageInfo object | 参数解释： 分页详细信息。包含 previous_marker，next_marker 与 current_count 字段 |
表5 AssociatedPermission | 参数 | 参数类型 | 描述 |
| permission_id | String | 权限的ID。取值范围：只能由英文字母、数字及“-”组成，长度为0~36个字符。 |
| permission_name | String | 共享资源权限的名称。取值范围：只能由英文字母、数字、“_”、“-”组成，长度为0~128个字符。 |
| resource_type | String | 权限适用的资源类型。不涉及。 |
| status | String | 参数解释： 权限的当前状态。 取值范围： -
ATTACHABLE：权限可绑定。 -
UNATTACHABLE：权限不可绑定。 |
| created_at | String | 创建权限的时间。UTC时间格式，格式为yyyy-MM-ddTHH:mm:ssZ，例如2020-09-25T12:05:00Z。 |
| updated_at | String | 最后一次更新权限的时间。UTC时间格式，格式为yyyy-MM-ddTHH:mm:ssZ，例如2020-09-25T12:05:00Z。 |
表6 PageInfo | 参数 | 参数类型 | 描述 |
| previous_marker | String | 参数解释： 上一页的页面标识。 取值范围： 只能由数字组成，且长度为1~64个字符 |
| next_marker | String | 参数解释： 下一页的页面标识。 取值范围： 只能由数字组成，且长度为1~64个字符 |
| current_count | Integer | 参数解释： 当前页面的记录数量。 取值范围： 1~2000 |
请求示例
检索资源共享实例关联的共享资源权限。
GET /v1/resource-shares/{resource_share_id}/associated-permissions 响应示例
状态码：200
请求成功。
{
"associated_permissions" : [ {
"permission_id" : "string",
"permission_name" : "string",
"resource_type" : "string",
"status" : "string",
"created_at" : "2022-09-19T02:12:30.736Z",
"updated_at" : "2022-09-19T02:12:30.736Z"
} ],
"page_info" : {
"previous_marker" : "0",
"next_marker" : "2000",
"current_count" : 2000
}
} 
