添加备份成员 - AddMember

功能介绍

添加备份可共享的成员，只有云服务器和云硬盘备份可以添加备份共享成员，支持不同项目之间共享和不同用户之间共享。

授权信息

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

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

URI

POST /v3/{project_id}/backups/{backup_id}/members

表1 路径参数
参数	是否必选	参数类型	描述
backup_id	是	String	参数解释：备份副本id，获取方法可参考查询所有备份约束限制：不涉及取值范围： UUID，形式为32个十六进制数字默认取值：不涉及
project_id	是	String	参数解释：项目ID，获取方法请参见获取项目ID 约束限制：不涉及取值范围：不涉及默认取值：不涉及

请求参数

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

表3 请求Body参数
参数	是否必选	参数类型	描述
members	否	Array of strings	参数解释：列表，待添加备份共享成员的project_id。约束限制：不涉及取值范围： 1-10个项目ID，获取方法请参见获取项目ID 默认取值：不涉及
domains	否	Array of strings	参数解释：列表，待添加备份共享成员的domain_id。约束限制：不涉及取值范围：不涉及默认取值：不涉及说明：该特性目前属于公测阶段，部分region可能无法使用。

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
members	Array of Member objects	添加备份共享成员响应信息

表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 取值范围：不涉及

请求示例

添加备份可共享的成员。

POST https://{endpoint}/v3/0605767b5780d5762fc5c0118072a564/backups/0b07081e-3ec7-4e77-8571-54e2947da422/members

{
  "members" : [ "075e6035d300d48c2fd0c00b78b71ebf" ]
}

响应示例

状态码：200

{
  "members": [
    {
      "status": "pending",
      "backup_id": "0b07081e-3ec7-4e77-8571-54e2947da422",
      "dest_project_id": "075e6035d300d48c2fd0c00b78b71ebf",
      "created_at": 2020-02-05T10:38:34.210+00:00,
      "id": "3c5a3015-c3a0-4dc6-a1e2-917b90f62319"
    }
  ]
}