通过DescribeDrdsInstances接口查询实例列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeDrdsInstances

系统规定参数。取值：DescribeDrdsInstances。
Type String 否 1

实例类型。

  • 共享实例：0
  • 专享实例：1
Description String 否 drds_test

实例的描述。
Expired Boolean 否 false

是否过期。
PageNumber Integer 否 1

页码。
PageSize Integer 否 20

每页大小。
ResourceGroupId String 否 NULL

资源组ID，可以为空。
RegionId String 是 cn-hangzhou

地域ID。
Mix Boolean 否 FALSE

是否支持混合查询。
ProductVersion String 否 V1

产品版本号，可取值为V1或V2。
Tag.N.Key String 否 acs:newretail:domain

标签的键。
Tag.N.Value String 否 NEW_RETAIL

标签的值。

返回数据

名称 类型 示例值 描述
RequestId String 8734773E-7B21-4A22-9106-CBD245F8****

请求ID。
PageNumber Integer 1

页码。
PageSize Integer 20

每页大小。
Total Integer 1

实例总数。
Instances Array of Instance

实例列表。
Instance
VpcId String vpc-bp**********

虚拟专用网络ID。
Status String RUN

实例状态。
Type String PRIVATE

实例类型。

  • PUBLIC：共享实例
  • PRIVATE：独享实例
CommodityCode String drdsPost

商品代码。
MachineType String ecs

实例机器类型，仅支持ecs。
CreateTime Long 1568620311000

创建时间戳。
VersionAction String Upgradable

实例版本可用操作。
InstanceSeries String drds.sn2.4c16g

实例规格系列。
NetworkType String CLASSIC

网络类型。

  • CLASSIC：经典网络
  • VPC：专有网络
Label String NORMAL

实例标签。

  • NORMAL：普通实例
  • HA：高可用实例
  • VPC：VPC实例
ProductVersion String V1

产品版本号。
InstanceSpec String drds.sn2.4c16g.8C32G

实例规格。
RegionId String cn-hangzhou-e

地域ID。
VpcCloudInstanceId String drdssen12****

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

实例描述。
Version Long 0

实例版本。
ResourceGroupId String rg-aek2ljh3ye4****

资源组ID。
ZoneId String vsw-bpxxxxxxxxxxxxx96

可用区。
DrdsInstanceId String drdssen12****

实例ID。
ExpireDate Long 4724323200000

过期时间戳。
MasterInstanceId String drdssen12****

主实例ID。
OrderInstanceId String drdssen12****

购买的实例ID。
InstRole String MASTER

实例角色。

  • MASTER：主实例
  • SLAVE：分析型只读实例
  • SLAVE_FLOW：并发型只读实例
Vips Array of Vip

VIP列表。
Vip
VpcId String vpc-bpxxxxxxxxxxxy

虚拟专用网络ID。
Type String intranet

VIP类型。

  • intranet：内网
  • internet：外网
VswitchId String vsw-bpxxxxxxxxxxxxx96

虚拟交换机ID。
Port String 3306

VIP开放端口。
IP String 10.23.***.***

IP地址。
dns String drdssen1243as.drds.aliyuncs.com

VIP绑定的域名。
ReadOnlyDBInstanceIds Array of String drdssen12****

只读实例ID列表。
series String enterprise

实例系列，取值如下：

  • starter：入门版
  • enterprise：企业版
  • standard：标准版

示例

请求示例

http(s)://[drds.aliyuncs.com]/?Action=DescribeDrdsInstances
&Type=1
&Description=drds_test
&Expired=false
&PageNumber=1
&PageSize=20
&ResourceGroupId=NULL
&RegionId=cn-hangzhou
&Mix=false
&ProductVersion=V1
&Tag=[{"Key":"acs:newretail:domain","Value":"NEW_RETAIL"}]
&公共请求参数

正常返回示例

XML格式

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

<DescribeDrdsInstancesResponse>
    <RequestId>8734773E-7B21-4A22-9106-CBD245F8****</RequestId>
    <PageNumber>1</PageNumber>
    <PageSize>20</PageSize>
    <Total>1</Total>
    <Instances>
        <VpcId>vpc-bp**********</VpcId>
        <Status>RUN</Status>
        <Type>PRIVATE</Type>
        <CommodityCode>drdsPost</CommodityCode>
        <MachineType>ecs</MachineType>
        <CreateTime>1568620311000</CreateTime>
        <VersionAction>Upgradable</VersionAction>
        <InstanceSeries>drds.sn2.4c16g</InstanceSeries>
        <NetworkType>CLASSIC</NetworkType>
        <Label>NORMAL</Label>
        <ProductVersion>V1</ProductVersion>
        <InstanceSpec>drds.sn2.4c16g.8C32G</InstanceSpec>
        <RegionId>cn-hangzhou-e</RegionId>
        <VpcCloudInstanceId>drdssen12****</VpcCloudInstanceId>
        <Description>drds_test</Description>
        <Version>0</Version>
        <ResourceGroupId>rg-aek2ljh3ye4****</ResourceGroupId>
        <ZoneId>vsw-bpxxxxxxxxxxxxx96</ZoneId>
        <DrdsInstanceId>drdssen12****</DrdsInstanceId>
        <ExpireDate>4724323200000</ExpireDate>
        <MasterInstanceId>drdssen12****</MasterInstanceId>
        <OrderInstanceId>drdssen12****</OrderInstanceId>
        <InstRole>MASTER</InstRole>
        <Vips>
            <VpcId>vpc-bpxxxxxxxxxxxy</VpcId>
            <Type>intranet</Type>
            <VswitchId>vsw-bpxxxxxxxxxxxxx96</VswitchId>
            <Port>3306</Port>
            <IP>10.23.***.***</IP>
            <dns>drdssen1243as.drds.aliyuncs.com</dns>
        </Vips>
        <ReadOnlyDBInstanceIds>drdssen12****</ReadOnlyDBInstanceIds>
        <series>enterprise</series>
    </Instances>
</DescribeDrdsInstancesResponse>

JSON格式

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

{
  "RequestId" : "8734773E-7B21-4A22-9106-CBD245F8****",
  "PageNumber" : 1,
  "PageSize" : 20,
  "Total" : 1,
  "Instances" : [ {
    "VpcId" : "vpc-bp**********",
    "Status" : "RUN",
    "Type" : "PRIVATE",
    "CommodityCode" : "drdsPost",
    "MachineType" : "ecs",
    "CreateTime" : 1568620311000,
    "VersionAction" : "Upgradable",
    "InstanceSeries" : "drds.sn2.4c16g",
    "NetworkType" : "CLASSIC",
    "Label" : "NORMAL",
    "ProductVersion" : "V1",
    "InstanceSpec" : "drds.sn2.4c16g.8C32G",
    "RegionId" : "cn-hangzhou-e",
    "VpcCloudInstanceId" : "drdssen12****",
    "Description" : "drds_test",
    "Version" : 0,
    "ResourceGroupId" : "rg-aek2ljh3ye4****",
    "ZoneId" : "vsw-bpxxxxxxxxxxxxx96",
    "DrdsInstanceId" : "drdssen12****",
    "ExpireDate" : 4724323200000,
    "MasterInstanceId" : "drdssen12****",
    "OrderInstanceId" : "drdssen12****",
    "InstRole" : "MASTER",
    "Vips" : [ {
      "VpcId" : "vpc-bpxxxxxxxxxxxy",
      "Type" : "intranet",
      "VswitchId" : "vsw-bpxxxxxxxxxxxxx96",
      "Port" : "3306",
      "IP" : "10.23.***.***",
      "dns" : "drdssen1243as.drds.aliyuncs.com"
    } ],
    "ReadOnlyDBInstanceIds" : [ "drdssen12****" ],
    "series" : "enterprise"
  } ]
}

错误码

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. 请求失败，内部错误

访问错误中心查看更多错误码。