调试
您可以在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。 约束限制： 不涉及 取值范围： 只能由英文字母、数字及“_”、“-”组成，且长度为[0~36]个字符。 默认取值： 不涉及 |
表2 Query参数 | 参数 | 是否必选 | 参数类型 | 描述 |
| permission_name | 否 | String | 参数解释： 共享资源权限的名称。 约束限制： 不涉及 取值范围： 由[1-64]个字符组成 默认取值： 不涉及 |
| limit | 否 | Integer | 参数解释： 分页页面的大小。 约束限制： 不涉及 取值范围： 只支持数字，最小值为 1，最大值为 2000 默认取值： 2000 |
| marker | 否 | String | 参数解释： 页面标记，基于上一页页面标记取值，空字符串表明查询第一页。 约束限制： 不涉及 取值范围： 只支持数字，最小值为 1，最大值为 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。 |
| permission_name | String | 共享资源权限的名称。 |
| resource_type | String | 权限适用的资源类型。 |
| status | String | 权限的当前状态。 |
| created_at | String | 创建权限的时间。 |
| updated_at | String | 最后一次更新权限的时间。 |
表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" : "string",
"next_marker" : "string",
"current_count" : 2000
}
} 
