绑定资源使用者和共享资源
功能介绍
向资源共享实例绑定指定的资源使用者列表或共享资源列表。对于新增的共享资源，有权访问此资源共享实例的资源使用者获得该共享资源的访问权限。对于新增的资源使用者，获得对此资源共享实例中共享资源的访问权限。
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Security-Token |
否 |
String |
如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
principals |
否 |
Array of strings |
指定与资源共享实例关联的一个或多个资源使用者的列表。 最小长度：0 最大长度：1500 数组长度：0 - 20 |
resource_urns |
否 |
Array of strings |
指定与资源共享实例关联的一个或多个共享资源URN的列表。 最小长度：0 最大长度：1500 数组长度：0 - 20 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
resource_share_associations |
Array of ResourceShareAssociation objects |
与资源共享实例关联的资源使用者或共享资源的详细信息。 数组长度：0 - 2000 |
参数 |
参数类型 |
描述 |
|---|---|---|
associated_entity |
String |
绑定的实体。这可以是共享资源的URN、账号ID、组织根的URN或OU的URN之一。 最小长度：0 最大长度：1500 |
association_type |
String |
绑定中包含的实体类型。 最小长度：0 最大长度：36 |
created_at |
String |
绑定被创建的时间。 |
updated_at |
String |
最后一次更新绑定的时间。 |
external |
Boolean |
标识资源使用者是否和共享的拥有者属于同一个组织 |
resource_share_id |
String |
资源共享实例的ID。 最小长度：0 最大长度：36 |
resource_share_name |
String |
资源共享实例的名称。 最小长度：0 最大长度：64 |
status |
String |
绑定的当前状态。 最小长度：0 最大长度：36 |
status_message |
String |
绑定的当前状态的描述。 最小长度：0 最大长度：65535 |
请求示例
向资源共享实例绑定指定的资源使用者列表或共享资源列表。
POST https://{hostname}/v1/resource-shares/{resource_share_id}/associate
{
"principals" : [ "string" ],
"resource_urns" : [ "string" ]
}
响应示例
状态码： 200
请求成功。
{
"resource_share_associations" : [ {
"associated_entity" : "string",
"association_type" : "string",
"created_at" : "2022-08-22T11:50:25.639Z",
"updated_at" : "2022-08-22T11:50:25.639Z",
"external" : true,
"resource_share_id" : "string",
"resource_share_name" : "string",
"status" : "string",
"status_message" : "string"
} ]
}
状态码
状态码 |
描述 |
|---|---|
200 |
请求成功。 |
错误码
请参见错误码。
