文档首页/ 云备份 CBR/ API参考/ API/ 备份共享/ 获取备份成员列表
更新时间:2024-11-22 GMT+08:00
分享

获取备份成员列表

功能介绍

获取备份共享成员的列表信息

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

backup_id

String

备份id

project_id

String

项目id

表2 Query参数

参数

是否必选

参数类型

描述

dest_project_id

String

接受备份共享的项目id

image_id

String

接受的共享备份副本注册的镜像id

limit

Integer

每页显示的条目数量,正整数

marker

String

上一次查询最后一条的id,仅支持uuid

offset

Integer

偏移值,正整数

sort

String

sort的内容为一组由逗号分隔的属性及可选排序方向组成,形如<key1>[:<direction>],<key2>[:<direction>],其中direction的取值为asc (升序) 或 desc (降序),如没有传入direction参数,默认为降序,sort内容的长度限制为255个字符。

status

String

备份共享状态

vault_id

String

目标端接受共享备份的存储库id,仅支持uuid

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

members

Array of Member objects

添加备份共享成员响应信息

count

Integer

备份共享成员数量

表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

请求示例

GET https://{endpoint}/v3/{project_id}/backups/{backup_id}/members

响应示例

状态码: 200

OK

{
  "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"
  } ],
  "count" : 50
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档