获取备份成员列表 - ShowMembersDetail
功能介绍
获取备份共享成员的列表信息
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
GET /v3/{project_id}/backups/{backup_id}/members
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| backup_id | 是 | String | 参数解释: 备份id,获取方法可参考查询所有备份 约束限制: 不涉及 取值范围: 正整数 默认取值: 不涉及 |
| project_id | 是 | String | 参数解释: 项目ID,获取方法请参见获取项目ID 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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 | 参数解释: 备份共享状态 约束限制: 不涉及 取值范围: 默认取值: 不涉及 |
| vault_id | 否 | String | 参数解释: 目标端接受共享备份的存储库id,获取方法可参考查询存储库列表 约束限制: 不涉及 取值范围: 仅支持uuid,形式为32个十六进制数字 默认取值: 不涉及 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| members | Array of Member objects | 添加备份共享成员响应信息 |
| count | Integer | 参数解释: 备份共享成员数量 取值范围: 大于等于0的整数 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| status | String | 参数解释: 共享状态 取值范围: |
| 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 |
错误码
请参见错误码。