调用DescribeDiskReplicaPairs查询指定地域下,一个或多个异步复制关系的信息。
接口说明
- 异步复制功能支持华东1(杭州)、华东2(上海)、华北2(北京)、华南1(深圳)、华南2(河源)、西南1(成都)、中国(香港)、新加坡、美国(硅谷)和美国(弗吉尼亚)地域。
- 当您指定某一地域进行查询后,如果异步复制关系中主盘或者从盘属于该地域,则查询结果中将包含该异步复制关系的信息。
- 当您需要分页查询时,请使用
MaxResults
与NextToken
参数进行查询。具体使用说明:分页查询首页时,设置MaxResults
以限制返回信息的条目数,返回结果中的NextToken将作为查询后续页的凭证。查询后续页时,将NextToken参数设置为上一次返回结果中获取到的NextToken作为查询凭证,并设置MaxResults限制返回条目数。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeDiskReplicaPairs |
系统规定参数。取值:DescribeDiskReplicaPairs。 |
RegionId | String | 是 | cn-beijing |
异步复制关系中主盘或从盘所属的地域ID。您可以调用DescribeRegions查询异步复制功能支持的地域信息。 |
MaxResults | Long | 否 | 1 |
分页查询时每页的最大条目数。 取值范围:1~500。 默认值:10。 |
NextToken | String | 否 | AAAAAdDWBF2**** |
查询凭证(Token)。取值为上一次调用该接口返回的NextToken参数值,初次调用接口时无需设置该参数。 |
PairIds | String | 否 | pair-cn-dsa**** |
异步复制关系ID列表。您可以指定一个或多个异步复制关系ID进行查询。格式为: 默认值为空,表示查询当前地域下所有的异步复制关系。 |
Site | String | 否 | production |
获取本地为主站点或备站点的复制对数据。取值范围:
默认值:production。 |
ReplicaGroupId | String | 否 | pg-xxxx**** |
异步复制关系ID列表。您可以指定一个或多个异步复制关系ID进行查询。格式为: 默认值为空,表示查询当前地域下所有的异步复制关系。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | AAA478A0-BEE6-1D42-BEB6-A9CFEAD6**** |
请求ID。 |
NextToken | String | AAAAAdDWBF2**** |
本次调用返回的查询凭证(Token)。 |
ReplicaPairs | Array of ReplicaPair |
异步复制关系的信息组成的集合。 |
|
ReplicaPairId | String | pair-cn-dsa**** |
异步复制关系的ID。 |
SourceRegion | String | cn-beijing |
源云盘(主盘)所属的地域信息。 |
SourceZoneId | String | cn-beijing-a |
主盘所属的可用区。 |
SourceDiskId | String | d-bp131n0q38u3a4zi**** |
源云盘(主盘)的云盘ID。 |
DestinationRegion | String | cn-shanghai |
目标云盘(从盘)所属的地域信息。 |
DestinationZoneId | String | cn-shanghai-b |
从盘所属的可用区。 |
DestinationDiskId | String | d-asdfjl2342kj2l3k4**** |
目标云盘(从盘)的云盘ID。 |
PairName | String | TestReplicaPair |
异步复制关系的名称。 |
Description | String | This is description. |
异步复制关系的描述信息。 |
Status | String | created |
异步复制关系的状态。可能值:
|
RPO | Long | 900 |
复制对的RPO值。单位为秒。 |
Bandwidth | Long | 10240 |
异步复制时使用的带宽。单位:Kbps。 |
StatusMessage | String | PrePayOrderExpired |
异步复制关系的状态提示信息。仅当
|
LastRecoverPoint | Long | 1649751977 |
异步复制关系最近一次异步复制操作完成的时间。该参数以时间戳的形式提供返回值。单位:秒。 |
ReplicaGroupId | String | pg-xxxx**** |
所属的一致性复制组ID。 |
CreateTime | Long | 1649750977 |
创建时间。该参数以时间戳的形式提供返回值。单位:秒。 |
ReplicaGroupName | String | pg-name**** |
所属的一致性复制组名称。 |
Site | String | production |
复制对和一致性复制组的站点信息来源。可能值:
|
PrimaryRegion | String | cn-beijing |
异步复制关系的初始源地域。 |
StandbyRegion | String | cn-shanghai |
异步复制关系的初始目的地域。 |
PrimaryZone | String | cn-beijing-a |
异步复制关系的初始源可用区。 |
StandbyZone | String | cn-shanghai-b |
异步复制关系的初始目的可用区。 |
ChargeType | String | PREPAY |
异步复制关系的付费方式。可能值:PrePay(包年包月)。 |
ExpiredTime | Long | 1649750977 |
异步复制关系的过期时间。 |
示例
请求示例
http(s)://ebs.cn-beijing.aliyuncs.com/?Action=DescribeDiskReplicaPairs
&RegionId=cn-beijing
&MaxResults=1
&NextToken=AAAAAdDWBF2****
&PairIds=pair-cn-dsa****
&Site=production
&ReplicaGroupId=pg-xxxx****
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeDiskReplicaPairsResponse>
<RequestId>AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****</RequestId>
<NextToken>AAAAAdDWBF2****</NextToken>
<ReplicaPairs>
<ReplicaPairId>pair-cn-dsa****</ReplicaPairId>
<SourceRegion>cn-beijing</SourceRegion>
<SourceZoneId>cn-beijing-a</SourceZoneId>
<SourceDiskId>d-bp131n0q38u3a4zi****</SourceDiskId>
<DestinationRegion>cn-shanghai</DestinationRegion>
<DestinationZoneId>cn-shanghai-b</DestinationZoneId>
<DestinationDiskId>d-asdfjl2342kj2l3k4****</DestinationDiskId>
<PairName>TestReplicaPair</PairName>
<Description>This is description.</Description>
<Status>created</Status>
<RPO>900</RPO>
<Bandwidth>10240</Bandwidth>
<StatusMessage>PrePayOrderExpired</StatusMessage>
<LastRecoverPoint>1649751977</LastRecoverPoint>
<ReplicaGroupId>pg-xxxx****</ReplicaGroupId>
<CreateTime>1649750977</CreateTime>
<ReplicaGroupName>pg-name****</ReplicaGroupName>
<Site>production</Site>
<PrimaryRegion>cn-beijing</PrimaryRegion>
<StandbyRegion>cn-shanghai</StandbyRegion>
<PrimaryZone>cn-beijing-a</PrimaryZone>
<StandbyZone>cn-shanghai-b</StandbyZone>
<ChargeType>PREPAY</ChargeType>
<ExpiredTime>1649750977</ExpiredTime>
</ReplicaPairs>
</DescribeDiskReplicaPairsResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****",
"NextToken" : "AAAAAdDWBF2****",
"ReplicaPairs" : [ {
"ReplicaPairId" : "pair-cn-dsa****",
"SourceRegion" : "cn-beijing",
"SourceZoneId" : "cn-beijing-a",
"SourceDiskId" : "d-bp131n0q38u3a4zi****",
"DestinationRegion" : "cn-shanghai",
"DestinationZoneId" : "cn-shanghai-b",
"DestinationDiskId" : "d-asdfjl2342kj2l3k4****",
"PairName" : "TestReplicaPair",
"Description" : "This is description.",
"Status" : "created",
"RPO" : 900,
"Bandwidth" : 10240,
"StatusMessage" : "PrePayOrderExpired",
"LastRecoverPoint" : 1649751977,
"ReplicaGroupId" : "pg-xxxx****",
"CreateTime" : 1649750977,
"ReplicaGroupName" : "pg-name****",
"Site" : "production",
"PrimaryRegion" : "cn-beijing",
"StandbyRegion" : "cn-shanghai",
"PrimaryZone" : "cn-beijing-a",
"StandbyZone" : "cn-shanghai-b",
"ChargeType" : "PREPAY",
"ExpiredTime" : 1649750977
} ]
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
404 | InvalidRegionId.NotFound | The specified RegionId does not exist. | 指定的RegionId不存在。 |
404 | InvalidZoneId.NotFound | The specified ZoneId does not exist. | 指定的ZoneId不存在。 |
404 | NoSuchResource | The specified resource does not exist. | 指定的资源不存在。 |
504 | RequestTimeout | The request is timeout, please try again later. | 该请求超时,请稍后再重试。 |
500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 内部错误。 |
403 | InvalidPayMethod | The specified pay method is not valid. | 不支持该购买方式。请检查您传入的参数chargeType是否正确。 |
403 | Forbidden | User is not authorized to operate. | 当前用户无权限对当前资源执行任何操作。请检查您的账号权限或者咨询您的主账号管理员。 |
403 | Forbidden.Action | User is not authorized to operate this action. | 当前用户无权限执行该操作。请检查您的账号权限或者咨询您的主账号管理员。 |
403 | NoPermission.SLR | The RAM user does not have the permission to create service linked role: AliyunServiceLinkedRoleForEBS. | 当前用户无权限创建SLR。 |
403 | LastTokenProcessing | The last token request is processing. | 相同clientToken的请求正在执行,请稍后再重试。 |
403 | InvalidAccountStatus.NotEnoughBalance | Your account does not have enough balance. | 您的账户余额不足。 |
403 | InvalidDiskCategory.NotSupported | The specified disk category is not supported. | 当前操作不支持您指定的磁盘类型。请检查您的输入参数和API文档。 |
403 | OperationDenied | The operation is not allowed. | 当前操作不允许执行。 |
403 | OperationDenied.QuotaExceed | The operation is not allowed due to quota exceed. | 当前操作已超过使用配额。 |
403 | NotOnSale.Region | The specified region is not on sale. | 当前Region停售或无库存。 |
403 | NotOnSale.Zone | The specified zone is not on sale. | 当前Zone停售或无库存。 |
403 | OperationDenied.PairInAnotherGroup | The operation is not allowed because pair is already in another group. | 当前操作不允许执行,因为复制对已被加入另一个一致性组中。 |
403 | OperationDenied.PairNotInGroup | The operation is not allowed because pair is not in any group. | 当前操作不允许执行,因为指定的异步复制对未加入任何一致性组中。 |
403 | OperationDenied.NoPairInGroup | The operation is not allowed because no pair in the group. | 当前操作不允许执行,因为指定的一致性组中没有复制对。 |
403 | OperationDenied.PairsExceedInGroup | The operation is not allowed due to too much pair in the group. | 当前操作不允许执行,因为已超过一致性组可支持的最大复制对数量。 |
403 | OperationDenied.ManualSyncLimit | One shot start manual syncing too frequently, please try again later. | 手动同步冷却时间未满足。 |
403 | OperationDenied.GroupTotalDiskCapacityLimit | Operation failed because of total disk capacity in group over limit. | 复制组中的云盘总容量过大。 |
访问错误中心查看更多错误码。