更新备份成员状态 - UpdateMemberStatus

功能介绍

更新备份共享成员的状态，需要接收方执行此API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，当前API调用无需身份策略权限。

URI

PUT /v3/{project_id}/backups/{backup_id}/members/{member_id}

表1 路径参数
参数	是否必选	参数类型	描述
backup_id	是	String	参数解释：备份副本id，获取方法可参考查询所有备份约束限制：不涉及取值范围：不涉及默认取值：不涉及
member_id	是	String	参数解释：成员id，成员id与项目id为同一个，获取方法请参见获取项目ID 约束限制：不涉及取值范围：不涉及默认取值：不涉及
project_id	是	String	参数解释：项目ID，获取方法请参见获取项目ID 约束限制：不涉及取值范围：不涉及默认取值：不涉及

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。约束限制：不涉及取值范围：不涉及默认取值：不涉及

表3 请求Body参数
参数	是否必选	参数类型	描述
status	是	String	参数解释：备份共享状态约束限制：不涉及取值范围： accepted: 已接收 pending: 处理中 rejected: 已拒绝默认取值：不涉及
vault_id	否	String	参数解释：共享的备份将存入的存储库约束限制：更新member状态的时候，如果是接受，必须传入vault_id，如果是拒绝，则无需取值范围：仅支持uuid，形式为32个十六进制数字默认取值：不涉及

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
member	Member object	查询备份共享成员详情响应信息

表5 Member
参数	参数类型	描述
status	String	参数解释：共享状态取值范围： pending: 等待处理 accepted: 已接收 rejected: 已拒绝
created_at	String	共享时间，例如:"2020-02-05T10:38:34.209782"
updated_at	String	更新时间，例如:"2020-02-05T10:38:34.209782"
backup_id	String	参数解释：备份ID 取值范围：不涉及
image_id	String	参数解释：接受的共享备份副本注册的镜像ID 取值范围：不涉及
dest_project_id	String	参数解释：接受备份共享的项目ID 取值范围：不涉及
vault_id	String	参数解释：目标端接受共享备份的存储库ID 取值范围：不涉及
id	String	参数解释：共享记录ID 取值范围：不涉及

请求示例

PUT https://{endpoint}/v3/f841e01fd2b14e7fa41b6ae7aa6b0594/backups/a5200268-74a5-4806-acc6-95793ab0228b/members/f841e01fd2b14e7fa41b6ae7aa6b0594

{
  "status" : "accepted",
  "vault_id" : "4b27c05b-8ad7-48c6-a886-526666c035f0"
}

响应示例

状态码：200

{
  "member": {
    "status": "accepted",
    "backup_id": "17c9acd8-3af3-4401-bab9-ff1cfac15561",
    "vault_id": "4b27c05b-8ad7-48c6-a886-526666c035f0",
    "dest_project_id": "0761021b8900d2622f38c0115db0b331",
    "created_at": 2020-02-24T09:36:00.479+00:00,
    "id": "824a90b3-c562-448b-ab04-60ea4a97cf60"
  }
}