查詢指定地域下,一個或多個異步復制關系的信息。
接口說明
-
異步復制功能支持的地域請參見云盤異步復制概述。
-
當您指定某一地域進行查詢后,如果異步復制關系中主盤或者從盤屬于該地域,則查詢結果中將包含該異步復制關系的信息。
-
當您需要分頁查詢時,請使用
MaxResults
與NextToken
參數進行查詢。具體使用說明:分頁查詢首頁時,設置MaxResults
以限制返回信息的條目數,返回結果中的 NextToken 將作為查詢后續頁的憑證。查詢后續頁時,將 NextToken 參數設置為上一次返回結果中獲取到的 NextToken 作為查詢憑證,并設置 MaxResults 限制返回條目數。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
ebs:DescribeDiskReplicaPairs | get | *DiskReplicaPair acs:ebs:{#regionId}:{#accountId}:diskreplicapair/* *DiskReplicaPair acs:ebs:{#regionId}:{#accountId}:diskreplicapair/{#ReplicaPairId} |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 異步復制關系中主盤或從盤所屬的地域 ID。您可以調用 DescribeRegions 查詢異步復制功能支持的地域信息。 | cn-beijing |
MaxResults | long | 否 | 本次調用期望查詢的最大條目數。可配合 NextToken 參數一起使用。 取值范圍:1~500。 默認值:10。 | 1 |
NextToken | string | 否 | 查詢憑證(Token)。取值為上一次調用該接口返回的 NextToken 參數值,初次調用接口時無需設置該參數。如果設置了 NextToken,則請求參數 PageSize 和 PageNumber 將失效,且返回數據中的 TotalCount 無效。 | AAAAAdDWBF2**** |
PairIds | string | 否 | 異步復制關系 ID 列表。您可以指定一個或多個異步復制關系 ID 進行查詢。格式為: 默認值為空,表示查詢當前地域下所有的異步復制關系。最多允許填寫 100 個復制關系 ID。 | pair-cn-dsa**** |
Site | string | 否 | 獲取本 Region 為生產站點或災備站點的復制對數據。取值范圍:
默認值:production。 | production |
ReplicaGroupId | string | 否 | 一致性復制組 ID,您可以指定一個一致性復制組 ID 來查詢組內的復制對。格式為: 默認值為空,表示查詢當前地域下所有的異步復制關系。 說明
當該參數為 - 時,返回不在任何一致性組中的復制對。
| pg-**** |
PageNumber | integer | 否 | 分頁查詢時的頁碼。 | 5 |
PageSize | integer | 否 | 分頁查詢時設置的每頁行數。 取值范圍 1-100。 | 10 |
ResourceGroupId | string | 否 | 異步復制對所在的企業資源組 ID。 | rg-acfmvs****** |
Name | string | 否 | 復制對名稱,支持模糊搜索。 | name*** |
Tag | array<object> | 否 | 標簽列表,最多包含 20 個子項。 | |
object | 否 | 標簽信息。 | ||
Key | string | 否 | 異步復制對的標簽鍵。 | TestKey |
Value | string | 否 | 異步復制對的標簽值。 | TestValue |
返回參數
示例
正常返回示例
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,
"Tags": [
{
"TagKey": "testKey",
"TagValue": "testValue"
}
],
"ResourceGroupId": "rg-acfmvs*****"
}
],
"PageNumber": 1,
"PageSize": 10,
"TotalCount": 60
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
403 | OperationDenied | The operation is not allowed. | 當前操作不允許執行。 |
403 | OperationDenied.InvalidStatus | The operation is not allowed in current status. | 當前狀態下該操作不允許執行。 |
403 | Forbidden | User is not authorized to operate. | 當前用戶無權限對當前資源執行任何操作。請檢查您的賬號權限或者咨詢您的主賬號管理員。 |
403 | Forbidden.Action | User is not authorized to operate this action. | 當前用戶無權限執行該操作。請檢查您的賬號權限或者咨詢您的主賬號管理員。 |
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. | 該請求超時,請稍后再重試。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2024-08-14 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
2024-06-17 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |