该接口用于查询当前地域的盘作为复制对从端时,曾经对复制对所启动的容灾演练。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | DescribePairDrills |
系统规定参数。取值:DescribePairDrills。 |
RegionId | String | 是 | cn-hangzhou |
异步复制对中主盘或从盘所属的地域ID。您可以调用DescribeRegions查询异步复制功能支持的地域信息。 |
DrillId | String | 否 | drill-xxxx |
演练ID。 |
PairId | String | 是 | pair-xxxx |
复制对ID。您可以通过DescribeDiskReplicaPairs接口查询异步复制对列表,获得复制对ID入参的值。 |
MaxResults | Long | 否 | 10 |
本次调用期望查询的最大条目数。可配合NextToken参数一起使用。 取值范围:1~500。 默认值:10。 |
NextToken | String | 否 | AAAAAdDWBF2**** |
查询凭证(Token)。取值为上一次调用该接口返回的NextToken参数值,初次调用接口时无需设置该参数。如果设置了NextToken,则请求参数PageSize和PageNumber将失效,且返回数据中的TotalCount无效。 |
PageNumber | Integer | 否 | 1 |
分页查询时的页码。 |
PageSize | Integer | 否 | 10 |
分页查询时设置的每页行数。 取值范围1-100。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
Drills | Array of Drill |
复制对容灾演练的信息组成的集合。 |
|
DrillId | String | drill-xxx |
演练ID。 |
Status | String | executing |
演练状态。可能值:
|
DrillDiskId | String | d-xxx |
演练盘ID。 |
DrillDiskStatus | String | created |
演练盘状态,可能值:
说明 除演练盘状态外,还可以展示演练盘创建或删除失败的错误码详情。 |
StartAt | Long | 1690855888 | 演练启动时间。该参数以时间戳的形式提供返回值。单位:秒。 |
RecoverPoint | Long | 1690855931 |
该演练对应的恢复点。该参数以时间戳的形式提供返回值。单位:秒。 |
StatusMessage | String | PAIR_SYNCPOINT_NOT_FOUND |
任务执行失败的错误提示信息。 |
NextToken | String | AAAAAdDWBF2**** |
本次调用返回的查询凭证(Token)。 |
PageNumber | Integer | 1 |
分页模式查询时的页数。 |
PageSize | Integer | 10 |
分页模式查询时的单页记录数量。 |
TotalCount | Long | 1 |
分页查询时的结果总条数。 |
RequestId | String | C46FF5A8-C5F0-4024-8262-B16B6392**** |
请求ID。 |
示例
请求示例
http(s)://ebs.cn-hangzhou.aliyuncs.com/?Action=DescribePairDrills
&RegionId=cn-hangzhou
&DrillId=drill-xxxx
&PairId=pair-xxxx
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
drill-xxx
executing
d-xxx
created
1690855888
1690855931
PAIR_SYNCPOINT_NOT_FOUND
AAAAAdDWBF2****
1
10
1
C46FF5A8-C5F0-4024-8262-B16B6392****
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Drills" : [ {
"DrillId" : "drill-xxx",
"Status" : "executing",
"DrillDiskId" : "d-xxx",
"DrillDiskStatus" : "created",
"StartAt" : 1690855888,
"RecoverPoint" : 1690855931,
"StatusMessage" : "PAIR_SYNCPOINT_NOT_FOUND"
} ],
"NextToken" : "AAAAAdDWBF2****",
"PageNumber" : 1,
"PageSize" : 10,
"TotalCount" : 1,
"RequestId" : "C46FF5A8-C5F0-4024-8262-B16B6392****"
}
错误码
HttpCode |
错误码 |
错误信息 |
描述 |
400 | InvalidParameter | The parameter %s is invalid. | 参数错误 |
400 | InvalidParameter.Conflict | The specified parameter %s and %s are not blank at the same time. | 参数冲突 |
400 | InvalidParameter.Format | Specified parameter format is not valid. | 返回值格式不正确(Format 不支持)。返回格式支持 XML 与 JSON,默认为 XML。 |
400 | MissingParameter | The input parameter %s that is mandatory for processing this request is not supplied. | 参数缺失。 |
403 | Forbidden | User is not authorized to operate. | 当前用户无权限对当前资源执行任何操作。请检查您的账号权限或者咨询您的主账号管理员。 |
403 | Forbidden.Action | User is not authorized to operate this action. | 当前用户无权限执行该操作。请检查您的账号权限或者咨询您的主账号管理员。 |
403 | InvalidAccountStatus.NotEnoughBalance | Your account does not have enough balance. | 您的账户余额不足。 |
403 | LastTokenProcessing | The last token request is processing. | 相同clientToken的请求正在执行,请稍后再重试。 |
403 | NoPermission.SLR | The RAM user does not have the permission to create service linked role: AliyunServiceLinkedRoleForEBS. | 当前用户无权限创建SLR。 |
403 | OperationDenied | The operation is not allowed. | 当前操作不允许执行。 |
404 | InvalidApi.NotFound | Specified api is not found, please check your url and method. | 找不到指定的 API。请检查调用的 URL 和方法。您调用的 API 不存在。请检查 API 的名称是否正确,请注意确认大小写。 |
404 | NoSuchResource | The specified resource does not exist. | 指定的资源不存在。 |
500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 内部错误。 |
504 | RequestTimeout | The request is timeout, please try again later. | 该请求超时,请稍后再重试。 |
访问错误中心查看更多错误码。
腾讯云1折,限时活动,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折,更有现金返利。同意关联立享优惠
转转请注明出处:https://www.yunxiaoer.com/153264.html