文档首页/ 存储容灾服务 SDRS/ API参考/ API/ 复制对/ 查询复制对列表

更新时间：2021-11-30 GMT+08:00

编辑

查看PDF

查询复制对列表

功能介绍

查询指定保护组下的所有复制对列表，如果不给定指定保护组则查询当前租户下的所有复制对列表。

接口约束

无

调试

您可以在API Explorer中调试该接口。

URI

GET /v1/{project_id}/replications

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID。

表2 Query参数
参数	是否必选	参数类型	描述
availability_zone	否	String	复制对所在的保护组的当前生产站点可用区。
limit	否	Integer	每次请求返回结果个数限制，取值范围为[0,1000]的正整数，默认值为1000。最小值：0 最大值：1000 缺省值：1000
name	否	String	复制对的名称。支持模糊查询。
offset	否	Integer	每次请求开始的下标，即偏移量，默认值为0。offset必须为数字，不能为负数。最小值：0 缺省值：0
protected_instance_id	否	String	保护实例的ID。
protected_instance_ids	否	String	保护实例的ID列表，格式为protected_instance_ids=['protected_instance_id1','protected_instance_id2',...,'protected_instance_idx']，请使用URL编码进行转换。返回“protected_instance_ids”中有效protected_instance_id的复制对列表，无效的protected_instance_id会被忽略。支持查询最多30个protected_instance_id对应的复制对列表。如果“protected_instance_id”和“protected_instance_ids”查询参数同时存在，“protected_instance_id”会被忽略。
query_type	否	String	查询场景类型。如需查询异常状态的复制对列表，query_type的值为“status_abnormal”。否则，query_type取值为空或“general”。枚举值： status_abnormal general
server_group_id	否	String	保护组的ID。
server_group_ids	否	String	保护组的ID列表，格式为server_group_ids=['server_group_id1','server_group_id2',...,'server_group_idx']，请使用URL编码进行转换。返回“server_group_ids”中有效server_group_id的复制对列表，无效的server_group_id会被忽略。支持查询最多30个server_group_id对应的复制对列表。如果“server_group_id”和“server_group_ids”查询参数同时存在，“server_group_id”会被忽略。
status	否	String	复制对的状态。

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）

响应参数

状态码： 200

表4 响应Body参数
参数	参数类型	描述
replications	Array of ShowReplicationParams objects	复制对列表。
count	Integer	列表中包含的复制对个数。

表5 ShowReplicationParams
参数	参数类型	描述
id	String	复制对的ID。
name	String	复制对的名称。
description	String	复制对的描述。
status	String	复制对的状态。
volume_ids	String	复制对使用的云硬盘ID。
attachment	Array of ReplicationAttachment objects	挂载点。
created_at	String	创建时间。默认格式为："yyyy-MM-ddTHH:mm:ss.SSSZ"，例如："2019-04-01T12:00:00.000Z"
updated_at	String	更新时间。默认格式为："yyyy-MM-ddTHH:mm:ss.SSSZ"，例如："2019-04-01T12:00:00.000Z"
replication_model	String	复制对的复制类型。默认值为“hypermetro”，表示同步复制。
progress	Integer	复制对的同步进度。单位：百分比（%）。
failure_detail	String	仅在复制对的状态“status”为“error”时，返回的错误码。
record_metadata	ReplicationRecordMetadata object	复制对的话单数据。
fault_level	String	复制对的故障等级。0：表示无故障。2：表示当前生产站点的云硬盘无读写数据权限，此时建议执行故障切换操作。5：表示复制链路已断，不能执行故障切换操作，需联系技术支持工程师。
server_group_id	String	保护组的ID。
priority_station	String	标识复制对所在保护组的当前生产站点可用区。source：表示当前生产站点可用区为保护组source_availability_zone的值。target：表示当前生产站点可用区为保护组target_availability_zone的值。
replication_status	String	数据同步状态。active：表示数据已同步完成。inactive：表示数据未同步。copying：表示数据正在同步。active-stopped：表示数据已停止同步。枚举值： active inactive copying active-stopped

表6 ReplicationAttachment
参数	参数类型	描述
protected_instance	String	该复制对挂载的保护实例ID。
device	String	挂载点。

表7 ReplicationRecordMetadata
参数	参数类型	描述
multiattach	Boolean	复制对中的云硬盘是否为共享云硬盘。
bootable	Boolean	复制对中的云硬盘是否为系统盘。
volume_size	Integer	复制对中的云硬盘容量。单位：GB
volume_type	String	复制对中的云硬盘类型。SATA：普通IO磁盘类型。SAS：高IO磁盘类型。SSD：超高IO磁盘类型。co-p1：高IO（性能优化I型）uh-l1：超高IO（时延优化）其中co-p1和uh-l1两种云硬盘只能使用在HANA云服务器、HL1型云服务器、HL2型云服务器上。枚举值： SATA SAS SSD co-p1 uh-l1

状态码： 400

表8 响应Body参数
参数	参数类型	描述
error	ErrorInfo object	失败返回结构

表9 ErrorInfo
参数	参数类型	描述
message	String	错误信息
code	String	错误码

状态码： 401

**表10** 响应Body参数
参数	参数类型	描述
error	ErrorInfo object	失败返回结构

**表11** ErrorInfo
参数	参数类型	描述
message	String	错误信息
code	String	错误码

状态码： 403

**表12** 响应Body参数
参数	参数类型	描述
error	ErrorInfo object	失败返回结构

**表13** ErrorInfo
参数	参数类型	描述
message	String	错误信息
code	String	错误码

状态码： 404

**表14** 响应Body参数
参数	参数类型	描述
error	ErrorInfo object	失败返回结构

**表15** ErrorInfo
参数	参数类型	描述
message	String	错误信息
code	String	错误码

状态码： 405

**表16** 响应Body参数
参数	参数类型	描述
error	ErrorInfo object	失败返回结构

**表17** ErrorInfo
参数	参数类型	描述
message	String	错误信息
code	String	错误码

状态码： 406

**表18** 响应Body参数
参数	参数类型	描述
error	ErrorInfo object	失败返回结构

**表19** ErrorInfo
参数	参数类型	描述
message	String	错误信息
code	String	错误码

状态码： 407

**表20** 响应Body参数
参数	参数类型	描述
error	ErrorInfo object	失败返回结构

**表21** ErrorInfo
参数	参数类型	描述
message	String	错误信息
code	String	错误码

状态码： 408

**表22** 响应Body参数
参数	参数类型	描述
error	ErrorInfo object	失败返回结构

**表23** ErrorInfo
参数	参数类型	描述
message	String	错误信息
code	String	错误码

状态码： 409

**表24** 响应Body参数
参数	参数类型	描述
error	ErrorInfo object	失败返回结构

**表25** ErrorInfo
参数	参数类型	描述
message	String	错误信息
code	String	错误码

状态码： 500

**表26** 响应Body参数
参数	参数类型	描述
error	ErrorInfo object	失败返回结构

**表27** ErrorInfo
参数	参数类型	描述
message	String	错误信息
code	String	错误码

状态码： 501

**表28** 响应Body参数
参数	参数类型	描述
error	ErrorInfo object	失败返回结构

**表29** ErrorInfo
参数	参数类型	描述
message	String	错误信息
code	String	错误码

状态码： 502

**表30** 响应Body参数
参数	参数类型	描述
error	ErrorInfo object	失败返回结构

**表31** ErrorInfo
参数	参数类型	描述
message	String	错误信息
code	String	错误码

状态码： 503

**表32** 响应Body参数
参数	参数类型	描述
error	ErrorInfo object	失败返回结构

**表33** ErrorInfo
参数	参数类型	描述
message	String	错误信息
code	String	错误码

状态码： 504

**表34** 响应Body参数
参数	参数类型	描述
error	ErrorInfo object	失败返回结构

**表35** ErrorInfo
参数	参数类型	描述
message	String	错误信息
code	String	错误码

请求示例

GET https://{Endpoint}/v1/{project_id}/replications

响应示例

状态码： 200

{
  "count" : 1,
  "replications" : [ {
    "id" : "b93bc1c4-67ee-45a1-bc8a-d022fdd28811",
    "name" : "test_replication_name",
    "description" : "description_test",
    "replication_model" : "hypermetro",
    "status" : "available",
    "progress" : 0,
    "attachment" : [ {
      "device" : "/dev/vda",
      "protected_instance" : "8a7a6339-679b-452b-948c-144e0ef85d9e"
    } ],
    "server_group_id" : "c2aee29a-2959-4d01-9755-01cc76a4d17d",
    "volume_ids" : "48dda0c0-c800-46f2-9728-a519ff783d35,388b324a-a9d1-44a4-a00d-42085f22a9bc",
    "priority_station" : "source",
    "fault_level" : "0",
    "created_at" : "2018-05-04T03:43:24.108526",
    "updated_at" : "2018-05-04T03:44:28.322873",
    "record_metadata" : {
      "multiattach" : false,
      "bootable" : false,
      "volume_size" : 10,
      "volume_type" : "SATA"
    }
  } ]
}

状态码

状态码	描述
200	OK
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found
405	Method Not Allowed
406	Not Acceptable
407	Proxy Authentication Required
408	Request Timeout
409	Conflict
500	Internal Server Error
501	Not Implemented
502	Bad Gateway
503	Service Unavailable
504	Gateway Timeout

错误码

请参见错误码。

父主题： 复制对

上一篇：删除复制对

下一篇：查询单个复制对详情

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

查询复制对列表

功能介绍

接口约束

调试

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线