绑定或替换共享资源权限
功能介绍
为资源共享实例中包含的资源类型绑定或替换共享资源权限。 对于资源共享实例中的每一种资源类型,您可以设置唯一权限。仅当资源共享实例中当前没有该资源类型的资源时,您才能绑定新的共享资源权限。
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Security-Token |
否 |
String |
如果正在使用临时安全凭据,则此header是必需的,该值是临时安全凭据的安全令牌(会话令牌)。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
replace |
否 |
Boolean |
指定特定的权限替换或绑定到与资源共享实例关联的现有资源类型。设置为"true"可将相同的资源类型的权限替换为当前权限。设置为"false"将权限绑定到当前资源类型。默认值为"false"。资源共享实例中的每个资源类型只能绑定一个权限。如果资源共享实例中已具有指定资源类型的权限,并且将"replace"设置为"false",则操作返回错误。这有助于防止意外覆盖权限。 |
permission_id |
是 |
String |
共享资源权限的ID。 |
响应参数
无
请求示例
为资源共享实例中包含的资源类型绑定或替换共享资源权限。
POST https://{endpoint}/v1/resource-shares/{resource_share_id}/associate-permission { "permission_id" : "string", "replace" : true }
响应示例
无
状态码
状态码 |
描述 |
---|---|
200 |
请求成功。 |
错误码
请参见错误码。