功能介绍
为资源共享实例中包含的资源类型绑定或替换共享资源权限。 对于资源共享实例中的每一种资源类型，您可以设置唯一权限。仅当资源共享实例中当前没有该资源类型的资源时，您才能绑定新的共享资源权限。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
| 授权项 | 访问级别 | 资源类型（*为必须） | 条件键 | 别名 | 依赖的授权项 |
| ram:resourceShares:associatePermission | Write | resourceShare * | g:ResourceTag/<tag-key> | - | - |
| - | ram:PermissionUrn |
URI
POST /v1/resource-shares/{resource_share_id}/associate-permission
表1 路径参数 | 参数 | 是否必选 | 参数类型 | 描述 |
| resource_share_id | 是 | String | 参数解释： 共享实例ID。 约束限制： 不涉及 取值范围： 只能由英文字母、数字及“_”、“-”组成，且长度为[0~36]个字符。 默认取值： 不涉及 |
请求参数
表3 请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 |
| replace | 否 | Boolean | 参数解释： 指定特定的权限替换或绑定到与资源共享实例关联的现有资源类型。 约束限制： 资源共享实例中的每个资源类型只能绑定一个权限。如果资源共享实例中已具有指定资源类型的权限，并且将"replace"设置为"false"，则操作返回错误。这有助于防止意外覆盖权限。 取值范围： -
false: 将权限绑定到当前资源类型 -
true: 将相同的资源类型的权限替换为当前权限 默认取值： false |
| permission_id | 是 | String | 参数解释： 共享资源权限的ID。 约束限制： 不涉及 取值范围： 只能由英文字母、数字及“_”、“-”、“.”组成，且长度为[0~36]个字符。 默认取值： false |
请求示例
为资源共享实例中包含的资源类型绑定或替换共享资源权限。
POST /v1/resource-shares/{resource_share_id}/associate-permission
{
"permission_id" : "string",
"replace" : true
} 
