調(diào)用DescribeDrdsInstance接口查詢實例詳情。

調(diào)試

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

請求參數(shù)

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

系統(tǒng)規(guī)定參數(shù)。取值：DescribeDrdsInstance。

DrdsInstanceId String 是 drdshbga1138****

實例ID。
RegionId String 是 cn-hangzhou

地域ID。

返回數(shù)據(jù)

名稱 類型 示例值 描述
Success Boolean true

請求是否成功。
RequestId String B4F76641-BA45-4320-BE7C-9C62CFDAC9B2

請求ID。
Data Object

實例詳情列表。
Type String PRIVATE

實例類型，獨享實例PRIVATE，共享實例PUBLIC。
Status String RUN

實例狀態(tài)。
CreateTime Long 1568620311000

實例創(chuàng)建的時間戳。
VersionAction String Upgradeable

實例版本可用操作。
StorageType String RDS

存儲實例類型。
NetworkType String CLASSIC

網(wǎng)絡(luò)類型，經(jīng)典網(wǎng)絡(luò)CLASSIC，VPC網(wǎng)絡(luò)為VPC。
Label String NORMAL

實例標簽：

  • 普通實例： NORMAL
  • 高可用實例： HA
  • VPC實例：VPC
MysqlVersion Integer 5

實例支持的MySQL版本。
InstanceSpec String drds.sn2.4c16g.8C32G

實例規(guī)格。
VpcCloudInstanceId String drdssen12****

VPC集群中的實例ID。
Description String drds_test

實例描述。
Version Long 0

實例版本，目前為空。
ExpireDate Long 4724323200000

實例過期的時間戳。
MasterInstanceId String drdssen1243as

主實例ID。

說明 當實例類型為只讀實例時，才會返回該參數(shù)。
CommodityCode String drdsPost

商品代碼。
MachineType String ecs

實例機器類型，固定為ecs。

InstanceSeries String drds.sn2.4c16g

實例規(guī)格系列。
ProductVersion String 5.3.*

產(chǎn)品版本。
RegionId String cn-hangzhou

地域ID。
ResourceGroupId String NULL

資源組ID，可以為空。
DrdsInstanceId String drdssen1243as

實例ID。
ZoneId String cn-hangzhou-e

可用區(qū)ID。
InstRole String MASTER

實例角色，取值如下：

  • 主實例： MASTER
  • 分析型只讀實例：SLAVE
  • 并發(fā)型只讀實例：SLAVE_FLOW
OrderInstanceId String drdssen12****

購買的實例ID。
Vips Array of Vip

VIP列表。
Vip
Type String intranet

VIP 類型，內(nèi)網(wǎng) intranet，外網(wǎng) internet
VpcId String vpc-bp**********

VPC的ID。
VswitchId String vsw-bp***********

虛擬交換機的ID。
Dns String drdssen1243as.drds.aliyuncs.com

VIP綁定的域名。
Port String 3306

VIP開放端口。
ExpireDays Long 0

VIP過期剩余天數(shù)。
ReadOnlyDBInstanceIds Array of String drdssen12****

只讀實例ID列表。

示例

請求示例

http(s)://[Endpoint]/?Action=DescribeDrdsInstance
&DrdsInstanceId=drdshbga1138****
&RegionId=cn-hangzhou
&公共請求參數(shù)

正常返回示例

XML格式 

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

<DescribeDrdsInstanceResponse>
    <Success>true</Success>
    <RequestId>B4F76641-BA45-4320-BE7C-9C62CFDAC9B2</RequestId>
    <Data>
        <Type>PRIVATE</Type>
        <Status>RUN</Status>
        <CreateTime>1568620311000</CreateTime>
        <VersionAction>Upgradeable</VersionAction>
        <StorageType>RDS</StorageType>
        <NetworkType>CLASSIC</NetworkType>
        <Label>NORMAL</Label>
        <MysqlVersion>5</MysqlVersion>
        <InstanceSpec>drds.sn2.4c16g.8C32G</InstanceSpec>
        <VpcCloudInstanceId>drdssen12****</VpcCloudInstanceId>
        <Description>drds_test</Description>
        <Version>0</Version>
        <ExpireDate>4724323200000</ExpireDate>
        <MasterInstanceId>drdssen1243as</MasterInstanceId>
        <CommodityCode>drdsPost</CommodityCode>
        <MachineType>ecs</MachineType>
        <InstanceSeries>drds.sn2.4c16g</InstanceSeries>
        <ProductVersion>5.3.*</ProductVersion>
        <RegionId>cn-hangzhou</RegionId>
        <ResourceGroupId>NULL</ResourceGroupId>
        <DrdsInstanceId>drdssen1243as</DrdsInstanceId>
        <ZoneId>cn-hangzhou-e</ZoneId>
        <InstRole>MASTER</InstRole>
        <OrderInstanceId>drdssen12****</OrderInstanceId>
        <Vips>
            <Type>intranet</Type>
            <VpcId>vpc-bp**********</VpcId>
            <VswitchId>vsw-bp***********</VswitchId>
            <Dns>drdssen1243as.drds.aliyuncs.com</Dns>
            <Port>3306</Port>
            <ExpireDays>0</ExpireDays>
        </Vips>
        <ReadOnlyDBInstanceIds>drdssen12****</ReadOnlyDBInstanceIds>
    </Data>
</DescribeDrdsInstanceResponse>

JSON格式 

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

{
  "Success" : true,
  "RequestId" : "B4F76641-BA45-4320-BE7C-9C62CFDAC9B2",
  "Data" : {
    "Type" : "PRIVATE",
    "Status" : "RUN",
    "CreateTime" : 1568620311000,
    "VersionAction" : "Upgradeable",
    "StorageType" : "RDS",
    "NetworkType" : "CLASSIC",
    "Label" : "NORMAL",
    "MysqlVersion" : 5,
    "InstanceSpec" : "drds.sn2.4c16g.8C32G",
    "VpcCloudInstanceId" : "drdssen12****",
    "Description" : "drds_test",
    "Version" : 0,
    "ExpireDate" : 4724323200000,
    "MasterInstanceId" : "drdssen1243as",
    "CommodityCode" : "drdsPost",
    "MachineType" : "ecs",
    "InstanceSeries" : "drds.sn2.4c16g",
    "ProductVersion" : "5.3.*",
    "RegionId" : "cn-hangzhou",
    "ResourceGroupId" : "NULL",
    "DrdsInstanceId" : "drdssen1243as",
    "ZoneId" : "cn-hangzhou-e",
    "InstRole" : "MASTER",
    "OrderInstanceId" : "drdssen12****",
    "Vips" : [ {
      "Type" : "intranet",
      "VpcId" : "vpc-bp**********",
      "VswitchId" : "vsw-bp***********",
      "Dns" : "drdssen1243as.drds.aliyuncs.com",
      "Port" : "3306",
      "ExpireDays" : 0
    } ],
    "ReadOnlyDBInstanceIds" : [ "drdssen12****" ]
  }
}

錯誤碼

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

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