功能介绍

用户接受或者拒绝共享 镜像 时，使用该接口更新镜像成员的状态。

调试

您可以在API Explorer中调试该接口。

URI

PUT /v2/images/{image_id}/members/{member_id}

请求消息

• 请求参数

  参数	是否必选	参数类型	描述
  status	是	String	镜像成员的状态。 取值如下： accepted：表示接受共享镜像。接受后，该镜像在用户镜像列表中可见，用户可以使用该镜像创建 云服务器 。 rejected：表示拒绝共享镜像。拒绝后，该镜像在用户镜像列表中不可见，但是，用户仍然可以使用该镜像创建 云服务 器。
  vault_id	否	String	存储库ID。 如果是CBR创建的整机镜像，则在接受该共享镜像时，为必选参数，需传入该值。 存储库ID可以从 云备份 服务控制台获取，或者参考“查询存储库列表”查询。

请求示例

• 更新镜像成员状态，其中，镜像状态为“接受共享镜像”。

  PUT https://{Endpoint}/v2/images/d164b5df-1bc3-4c3f-893e-3e471fd16e64/members/edc89b490d7d4392898e19b2deb34797 { "status": "accepted" }

• 更新通过CBR创建的整机镜像成员状态，其中，镜像状态为“接受共享镜像”，存储库ID为“6yhtb5df-1bc3-4c3f-893e-3e4716yhgt61”。

  PUT https://{Endpoint}/v2/images/d164b5df-1bc3-4c3f-893e-3e471fd16e64/members/edc89b490d7d4392898e19b2deb34797 { "status": "accepted", "vault_id": "6yhtb5df-1bc3-4c3f-893e-3e4716yhgt61" }

响应消息

• 响应参数

  参数	参数类型	描述
  status	String	共享状态
  created_at	String	共享时间，格式为UTC时间
  updated_at	String	更新时间，格式为UTC时间
  image_id	String	镜像ID
  member_id	String	成员ID
  schema	String	共享视图

• 响应样例

  STATUS CODE 200

  { "status": "accepted", "created_at": "2016-09-01T02:05:14Z", "updated_at": "2016-09-01T02:37:11Z", "image_id": "d164b5df-1bc3-4c3f-893e-3e471fd16e64", "member_id": "edc89b490d7d4392898e19b2deb34797", "schema": "/v2/schemas/member" }

返回值

• 正常

  200

• 异常

  返回值	说明
  400 Bad Request	请求错误。
  401 Unauthorized	鉴权失败。
  403 Forbidden	没有操作权限。
  404 Not Found	找不到资源。
  500 Internal Server Error	服务内部错误。
  503 Service Unavailable	服务不可用。