查詢在指定地域下,一個或多個一致性復制組的信息。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀?。≧ead)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
ebs:DescribeDiskReplicaGroups | list | *DiskReplicaGroup acs:ebs:{#regionId}:{#accountId}:diskreplicagroup/* *DiskReplicaGroup acs:ebs:{#regionId}:{#accountId}:diskreplicagroup/{#ReplicaGroupId} |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 一致性復制組所屬的地域 ID。 | cn-beijing |
MaxResults | long | 否 | 本次調用期望查詢的最大條目數??膳浜?NextToken 參數一起使用。 取值范圍:1~500。 默認值:10。 | 10 |
NextToken | string | 否 | 查詢憑證(Token)。取值為上一次調用該接口返回的 NextToken 參數值,初次調用接口時無需設置該參數。如果設置了 NextToken,則請求參數 PageSize 和 PageNumber 將失效,且返回數據中的 TotalCount 無效。 | AAAAAdDWBF2**** |
GroupIds | string | 否 | 一致性復制組的 ID 列表。您可以指定一個或多個一致性復制組的 ID 進行查詢。多個一致性復制組的 ID 之間用半角逗號(,)分隔。 默認值為空,表示查詢當前地域下所有的一致性復制組。最多允許填寫 100 個復制組 ID。 | AAAAAdDWBF2**** |
Site | string | 否 | 查詢并返回指定站點的記錄,主要應用于跨可用區復制對的場景。
| production |
PageNumber | integer | 否 | 分頁查詢時的頁碼。 | 5 |
PageSize | integer | 否 | 分頁查詢時設置的每頁行數。 取值范圍 1~100。 | 10 |
ResourceGroupId | string | 否 | 一致性復制組所在的企業資源組 ID。 | rg-aekz***** |
Name | string | 否 | 復制組名稱,支持模糊搜索。 | pg-name*** |
Tag | array<object> | 否 | 標簽列表,最多包含 20 個子項。 | |
object | 否 | 標簽信息。 | ||
Key | string | 否 | 一致性復制組的標簽鍵。 | tag-key |
Value | string | 否 | 一致性復制組的標簽值。 | tag-value |
返回參數
示例
正常返回示例
JSON
格式
{
"RequestId": "AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****",
"NextToken": "AAAAAdDWBF2****",
"ReplicaGroups": [
{
"ReplicaGroupId": "pg-myreplica****",
"SourceRegionId": "cn-beijing",
"SourceZoneId": "cn-beijing-f",
"DestinationRegionId": "cn-shanghai",
"DestinationZoneId": "cn-shanghai-e",
"GroupName": "myreplicagrouptest",
"Description": "This is description.",
"Status": "created",
"RPO": 180,
"LastRecoverPoint": 1637835114,
"Site": "production",
"PairIds": [
"pair-cn-dsa****,pair-cn-asd****"
],
"PairNumber": 2,
"PrimaryRegion": "cn-beijing",
"StandbyRegion": "cn-shanghai\n",
"PrimaryZone": "cn-beijing-h",
"StandbyZone": "cn-shanghai-e",
"Bandwidth": 0,
"ResourceGroupId": "rg-aek2a*******",
"Tags": [
{
"TagKey": "testKey",
"TagValue": "testValue"
}
]
}
],
"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 入參發生變更 | 查看變更詳情 |
2023-07-19 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |