查询 DRDS 实例列表

调试

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

请求参数

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

系统规定参数，取值：DescribeDrdsInstances
RegionId String 是 cn-hangzhou

地区 ID
AccessKeyId String 否 ASU678UDIN9HdlahDHH

Access Key
Description String 否 drds_test

DRDS 实例描述
Expired Boolean 否 false

是否过期
PageNumber Integer 否 1

页码
PageSize Integer 否 20

每页大小
Tag.N.Key String 否 acs:newretail:domain

第 N 个 tag 的键
Tag.N.Value String 否 NEW_RETAIL

第 N 个 tag 的值
Type String 否 1

实例类型，共享实例 0，独享实例 1

返回数据

名称 类型 示例值 描述
Instances

实例列表
Instance

实例列表
CommodityCode String drdsPost

商品代码
CreateTime Long 1568620311000

创建时间戳
Description String drds_test

实例描述
DrdsInstanceId String drdssen1243as

实例 ID
ExpireDate Long 4724323200000

过期时间戳
InstRole String MASTER

实例角色，主实例 MASTER，分析型只读实例 SLAVE，并发型只读实例 SLAVE_FLOW
InstanceSeries String drds.sn2.4c16g

实例规格系列
InstanceSpec String drds.sn2.4c16g.8C32G

实例规格
Label String NORMAL

实例标签：

  • 普通实例：NORMAL* - 高可用实例：HA - VPC 实例： VPC
MachineType String ecs

实例机器类型，只有 ecs
MasterInstanceId String drdssen1243as

主实例 ID，只有只读实例有
NetworkType String CLASSIC

网络类型，经典网络 CLASSIC，VPC 为 VPC
OrderInstanceId String drdssen1243as

购买的实例 ID
ReadOnlyDBInstanceIds drdssen1243as

只读实例 ID 列表
ReadOnlyDBInstanceId

只读实例 ID 列表
RegionId String cn-hangzhou

地区 ID
Status String RUN

实例状态
Type String PRIVATE

实例类型，共享实例 PUBLIC，独享实例 PRIVATE
Version Long 0

实例版本
VersionAction String Upgradable

实例版本可用操作
Vips

VIP 列表
Vip

VIP 列表
IP String 10.23.4.51

IP
Port String 3306

VIP 开放端口
Type String intranet

VIP 类型，内网 intranet，外网 internet
VpcId String vpc-bpxxxxxxxxxxxy

VPC ID
VswitchId String vsw-bpxxxxxxxxxxxxx96

VSWITCH ID
VpcCloudInstanceId String drdssen1243as

VPC 集群中的实例 ID
VpcId String vpc-bpxxxxxxxxxxxy

VPC ID
ZoneId String vsw-bpxxxxxxxxxxxxx96

VSWITCH ID
PageNumber Integer 1

该页页码
PageSize Integer 20

该页大小
RequestId String 2F7F8080-9132-4279-85D0-B7E5C4305162

请求 ID
Total Integer 1

实例总数

示例

请求示例


http(s)://[Endpoint]/?Action=DescribeDrdsInstances
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML 格式 

<DescribeDrdsInstances>
	  <Instances>
		    <Instance>
			      <Status>RUN</Status>
			      <Description>drds_test</Description>
			      <InstanceSpec>drds.sn2.4c16g.8C32G</InstanceSpec>
			      <ZoneId>cn-hangzhou-e</ZoneId>
			      <ExpireDate>4724323200000</ExpireDate>
			      <CreateTime>1568620311000</CreateTime>
			      <MachineType>ecs</MachineType>
			      <Label>NORMAL</Label>
			      <InstanceSeries>drds.sn2.4c16g</InstanceSeries>
			      <VersionAction>Upgradable</VersionAction>
			      <Type>PRIVATE</Type>
			      <VpcId></VpcId>
			      <DrdsInstanceId>drdssen1243as</DrdsInstanceId>
			      <OrderInstanceId>drdssen1243as</OrderInstanceId>
			      <InstRole>MASTER</InstRole>
			      <NetworkType>CLASSIC</NetworkType>
			      <CommodityCode>drdsPost</CommodityCode>
			      <RegionId>cn-hangzhou</RegionId>
			      <Vips></Vips>
		    </Instance>
	  </Instances>
	  <PageSize>20</PageSize>
	  <RequestId>8734773E-7B21-4A22-9106-CBD245F8AF7D</RequestId>
	  <PageNumber>1</PageNumber>
	  <Total>1</Total>
</DescribeDrdsInstances>

JSON 格式 

{
	"PageNumber":1,
	"PageSize":20,
	"RequestId":"8734773E-7B21-4A22-9106-CBD245F8AF7D",
	"Instances":{
		"Instance":[
			{
				"MachineType":"ecs",
				"Description":"drds_test",
				"OrderInstanceId":"drdssen1243as",
				"Type":"PRIVATE",
				"ZoneId":"cn-hangzhou-e",
				"VpcId":"",
				"InstRole":"MASTER",
				"NetworkType":"CLASSIC",
				"Status":"RUN",
				"ExpireDate":4724323200000,
				"Vips":{
					"Vip":[]
				},
				"VersionAction":"Upgradable",
				"RegionId":"cn-hangzhou",
				"CommodityCode":"drdsPost",
				"InstanceSpec":"drds.sn2.4c16g.8C32G",
				"CreateTime":1568620311000,
				"InstanceSeries":"drds.sn2.4c16g",
				"Label":"NORMAL",
				"DrdsInstanceId":"drdssen1243as"
			}
		]
	},
	"Total":1
}

错误码

HttpCode 错误码 错误信息 描述
400 ActionUnauthorized The specified action is not available for you 指定的action未授权，请您先做RAM授权再进行操作。

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