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

获取备份成员列表 - ShowMembersDetail

功能介绍

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

授权信息

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

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

backup_id

String

参数解释:

备份id,获取方法可参考查询所有备份

约束限制:

不涉及

取值范围:

正整数

默认取值:

不涉及

project_id

String

参数解释:

项目ID,获取方法请参见获取项目ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

dest_project_id

String

参数解释:

接受备份共享的项目id,获取方法请参见获取项目ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

image_id

String

参数解释:

接受的共享备份副本注册的镜像id,获取方法可参考获取镜像ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

limit

Integer

参数解释:

每页显示的条目数量

约束限制:

不涉及

取值范围:

正整数

默认取值:

不涉及

marker

String

参数解释:

上一次查询最后一条的id

约束限制:

不涉及

取值范围:

仅支持uuid,形式为32个十六进制数字

默认取值:

不涉及

offset

Integer

参数解释:

偏移值

约束限制:

不涉及

取值范围:

正整数

默认取值:

不涉及

sort

String

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

status

String

参数解释:

备份共享状态

约束限制:

不涉及

取值范围:

  • pending: 等待处理

  • accepted: 已接收

  • rejected: 已拒绝

默认取值:

不涉及

vault_id

String

参数解释:

目标端接受共享备份的存储库id,获取方法可参考查询存储库列表

约束限制:

不涉及

取值范围:

仅支持uuid,形式为32个十六进制数字

默认取值:

不涉及

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

members

Array of Member objects

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

count

Integer

参数解释:

备份共享成员数量

取值范围:

大于等于0的整数

表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

错误码

请参见错误码

相关文档