調用DescribeDrdsDBs接口查看實例下的數據庫詳情。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 DescribeDrdsDBs

系統規定參數。取值：DescribeDrdsDBs。

DrdsInstanceId String 是 drdshbga1138****

實例ID。
PageNumber Integer 否 1

頁碼，取值為大于0且不超過Integer數據類型的最大值，默認值為1。

PageSize Integer 否 30

每頁記錄數，取值為30、50或100。

默認值為30。

RegionId String 是 cn-hangzhou

地域ID。

返回數據

名稱 類型 示例值 描述
PageSize String 30

每頁記錄數。
PageNumber String 1

頁碼。
RequestId String 006B7D19-8CDB-4AA6-AAE7-23C107GS3W2T

請求ID。
Total String 1

數據庫列表的總數量。
Success Boolean true

請求是否成功。
Data Array of Db

數據庫列表。
Db
Status String NORMAL

數據庫狀態。
DbName String drds_test

數據庫名稱。
Schema String drds_test_1563773871118kxqd

系統為拆分后的數據庫分配的schema ID。
CreateTime String 1563773824000

數據庫創建時間，格式為Unix時間戳，單位為毫秒。
Mode String HORIZONTAL

數據庫拆分模式，取值范圍如下：

  • HORIZONTAL：水平拆分
  • VERTICAL：垂直拆分
DbInstType String RDS

數據庫類型，取值為RDS或POLARDB。

示例

請求示例

http(s)://[Endpoint]/?Action=DescribeDrdsDBs
&DrdsInstanceId=drdshbga1138****
&PageNumber=1
&PageSize=30
&RegionId=cn-hangzhou
&公共請求參數

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDrdsDBsResponse>
    <PageSize>30</PageSize>
    <PageNumber>1</PageNumber>
    <RequestId>006B7D19-8CDB-4AA6-AAE7-23C107GS3W2T</RequestId>
    <Total>1</Total>
    <Success>true</Success>
    <Data>
        <Status>NORMAL</Status>
        <DbName>drds_test</DbName>
        <Schema>drds_test_1563773871118kxqd</Schema>
        <CreateTime>1563773824000</CreateTime>
        <Mode>HORIZONTAL</Mode>
        <DbInstType>RDS</DbInstType>
    </Data>
</DescribeDrdsDBsResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "PageSize" : "30",
  "PageNumber" : "1",
  "RequestId" : "006B7D19-8CDB-4AA6-AAE7-23C107GS3W2T",
  "Total" : "1",
  "Success" : true,
  "Data" : [ {
    "Status" : "NORMAL",
    "DbName" : "drds_test",
    "Schema" : "drds_test_1563773871118kxqd",
    "CreateTime" : "1563773824000",
    "Mode" : "HORIZONTAL",
    "DbInstType" : "RDS"
  } ]
}

錯誤碼

HttpCode 錯誤碼 錯誤信息 描述
400 ActionUnauthorized The specified action is not available for you 指定的action未授權，請您先做RAM授權再進行操作。
500 InternalError The request processing has failed due to some unknown error. 請求失敗，內部錯誤

訪問錯誤中心查看更多錯誤碼。