描述

查看该用户下指定的实例,或者全部的数据库实例列表。

请求参数

名称 类型 是否必须 描述
<公共参数> - 参见公共参数
Action String 系统规定参数,取值为DescribeInstances。
InstanceId String 实例名。
InstanceStatus String 实例状态。
ChargeType String 付费类型。
  • PrePaid(预付费包年包月)
  • PostPaid(按量付费)
PageNumber Integer 页码,大于0且不超过Integer的最大值。默认值:1。
PageSize Integer 每页记录数,取值:10/20/30/40/50;默认值10。

返回参数

名称 类型 描述
<公共返回参数> String 参见公共返回参数
PageNumber Integer 页码。
PageSize Integer 每页记录数。
TotalCount Integer 总记录数。
Instances List<Instance> 实例组成的集合。
表 1. Instance参数
名称 类型 描述
InstanceId String 实例名。
InstanceName String 数据库实例描述。
ConnectionString String 连接串。
Port String 端口号。
InstanceStatus String 实例状态。
RegionId String 地区ID。
ZoneId String 可用区ID。
CreateTime String 创建时间
ExpireTime String 实例到期时间。其中按量付费实例返回的时间为2999-09-08T16:00:00Z,包年包月实例为实例到期时间。
NetworkType String 网络类型
  • VPC:专有网络
  • Classic:经典网络
VPCId String VPC网络ID。
VSwitchId String VSwitch ID。
Databases List<Database> 数据库组成的集合。
表 2. Database参数
名称 类型 描述
DBName String 数据库名。
ChargeType String 付费类型。
  • PrePaid(预付费包年包月)
  • PostPaid(按量付费)

请求示例

https://petadata.aliyuncs.com/?Action=DescribeInstances
&<[公共请求参数]>

返回示例

XML格式

<DescribeInstancesResponse>  
	<PageNumber>1</PageNumber>
	<TotalCount>20</TotalCount>
	<PageSize>10</PageSize>
	<RequestId>C5129A71-E67D-4832-BF61-9087E1F7C0F0</RequestId>
	<Instances>
		<Instance>
			<Databases>
				<Database>
					<ChargeType>PostPaid</ChargeType>
					<DBName>wang_100</DBName>
				</Database>
			</Databases>
			<NetworkType>Classic</NetworkType>
			<InstanceStatus>ACTIVE</InstanceStatus>
			<RegionId>cn-beijing</RegionId>
			<CreateTime>2018-08-06T12:41:27Z</CreateTime>
                        <ExpireTime>2999-09-08T16:00:00Z</ExpireTime>
			<InstanceId>pd-xxxxxxxxxxxxxx</InstanceId>
			<ZoneId>cn-beijing-c</ZoneId>
		</Instance>
		<Instance>
			<Databases>
				<Database>
					<ChargeType>PrePaid</ChargeType>
					<DBName>adb</DBName>
				</Database>
			</Databases>
			<NetworkType>Classic</NetworkType>
			<InstanceStatus>ACTIVE</InstanceStatus>
			<RegionId>cn-zhangjiakou</RegionId>
			<CreateTime>2018-07-24T11:20:53Z</CreateTime>
                        <ExpireTime>2999-09-08T16:00:00Z</ExpireTime>
			<InstanceId>pd-xxxxxxxxxxxxxx</InstanceId>
			<ZoneId>cn-zhangjiakou-a</ZoneId>
		</Instance>
		<Instance>
			<Databases>
				<Database>
					<ChargeType>PrePaid</ChargeType>
					<DBName>adb</DBName>
				</Database>
			</Databases>
			<NetworkType>Classic</NetworkType>
			<InstanceStatus>ACTIVE</InstanceStatus>
			<RegionId>cn-zhangjiakou</RegionId>
			<CreateTime>2018-07-24T10:01:19Z</CreateTime>
                        <ExpireTime>2999-09-08T16:00:00Z</ExpireTime>
			<InstanceId>pd-xxxxxxxxxxxxxx</InstanceId>
			<ZoneId>cn-zhangjiakou-a</ZoneId>
		</Instance>
		<Instance>
			<Databases>
				<Database>
					<ChargeType>PrePaid</ChargeType>
					<DBName>adb</DBName>
				</Database>
			</Databases>
			<NetworkType>Classic</NetworkType>
			<InstanceStatus>ACTIVE</InstanceStatus>
			<RegionId>cn-zhangjiakou</RegionId>
			<CreateTime>2018-07-24T09:30:46Z</CreateTime>
                        <ExpireTime>2999-09-08T16:00:00Z</ExpireTime>   
			<InstanceId>pd-xxxxxxxxxxxxxx</InstanceId>
			<ZoneId>cn-zhangjiakou-a</ZoneId>
		</Instance>
		<Instance>
			<Databases>
				<Database>
					<ChargeType>PostPaid</ChargeType>
					<DBName>adb</DBName>
				</Database>
			</Databases>
			<NetworkType>VPC</NetworkType>
			<InstanceStatus>ACTIVE</InstanceStatus>
			<RegionId>us-west-1</RegionId>
			<CreateTime>2018-07-19T09:46:51Z</CreateTime>
                        <ExpireTime>2999-09-08T16:00:00Z</ExpireTime>
			<InstanceId>pd-xxxxxxxxxxxxxx</InstanceId>
			<ZoneId>us-west-1a</ZoneId>
			<VSwitchId>vsw-xxxxxxxxxxxxxx</VSwitchId>
			<VpcId>vpc-xxxxxxxxxxxxxx</VpcId>
		</Instance>
		<Instance>
			<Databases>
				<Database>
					<ChargeType>PostPaid</ChargeType>
					<DBName>test_sla_099</DBName>
				</Database>
			</Databases>
			<NetworkType>VPC</NetworkType>
			<InstanceStatus>ACTIVE</InstanceStatus>
			<RegionId>us-east-1</RegionId>
			<CreateTime>2018-06-14T09:41:30Z</CreateTime>
                        <ExpireTime>2999-09-08T16:00:00Z</ExpireTime>
			<InstanceId>pd-xxxxxxxxxxxxxx</InstanceId>
			<ZoneId>us-east-1a</ZoneId>
			<VSwitchId>vsw-xxxxxxxxxxxxxx</VSwitchId>
			<VpcId>vpc-xxxxxxxxxxxxxx</VpcId>
		</Instance>
		<Instance>
			<Databases>
				<Database>
					<ChargeType>PostPaid</ChargeType>
					<DBName>adb</DBName>
				</Database>
			</Databases>
			<NetworkType>Classic</NetworkType>
			<InstanceStatus>ACTIVE</InstanceStatus>
			<RegionId>us-east-1</RegionId>
			<CreateTime>2018-06-14T06:18:32Z</CreateTime>
                        <ExpireTime>2999-09-08T16:00:00Z</ExpireTime>
			<InstanceId>pd-xxxxxxxxxxxxxx</InstanceId>
			<ZoneId>us-east-1a</ZoneId>
		</Instance>
		<Instance>
			<Databases>
				<Database>
					<ChargeType>PostPaid</ChargeType>
					<DBName>test_a</DBName>
				</Database>
			</Databases>
			<NetworkType>VPC</NetworkType>
			<InstanceStatus>ACTIVE</InstanceStatus>
			<RegionId>cn-beijing</RegionId>
			<CreateTime>2018-06-08T03:49:24Z</CreateTime>
                        <ExpireTime>2999-09-08T16:00:00Z</ExpireTime>
			<InstanceId>pd-xxxxxxxxxxxxxx</InstanceId>
			<ZoneId>cn-beijing-g</ZoneId>
			<VSwitchId>vsw-xxxxxxxxxxxxxx</VSwitchId>
			<VpcId>vpc-xxxxxxxxxxxxxx</VpcId>
			<InstanceName>test</InstanceName>
		</Instance>
		<Instance>
			<Databases>
				<Database>
					<ChargeType>PrePaid</ChargeType>
					<DBName>adb</DBName>
				</Database>
				<Database>
					<ChargeType>PostPaid</ChargeType>
					<DBName>testdb</DBName>
				</Database>
				<Database>
					<ChargeType>PostPaid</ChargeType>
					<DBName>testdb_01</DBName>
				</Database>
			</Databases>
			<NetworkType>Classic</NetworkType>
			<InstanceStatus>ACTIVE</InstanceStatus>
			<RegionId>cn-hangzhou</RegionId>
			<CreateTime>2018-05-15T07:31:37Z</CreateTime>
                        <ExpireTime>2999-09-08T16:00:00Z</ExpireTime>
			<InstanceId>pd-xxxxxxxxxxxxxx</InstanceId>
			<ZoneId>cn-hangzhou-b</ZoneId>
			<InstanceName>创建时间2018-05-15-15-31-37</InstanceName>
		</Instance>
		<Instance>
			<Databases>
				<Database>
					<ChargeType>PostPaid</ChargeType>
					<DBName>adb</DBName>
				</Database>
			</Databases>
			<NetworkType>Classic</NetworkType>
			<InstanceStatus>ACTIVE</InstanceStatus>
			<RegionId>ap-southeast-1</RegionId>
			<CreateTime>2018-05-07T13:10:39Z</CreateTime>
                        <ExpireTime>2019-05-07T13:10:39Z</ExpireTime>
			<InstanceId>pd-xxxxxxxxxxxxxx</InstanceId>
			<ZoneId>ap-southeast-1b</ZoneId>
		</Instance>
	</Instances>
</DescribeInstancesResponse>

JSON格式

{
    "PageNumber":1,
    "TotalCount":20,
    "PageSize":10,
    "RequestId":"C5129A71-E67D-4832-BF61-9087E1F7C0F0",
    "Instances":{
        "Instance":[
            {
                "Databases":{
                    "Database":[
                        {
                            "ChargeType":"PostPaid",
                            "DBName":"wang_100"
                        }
                    ]
                },
                "NetworkType":"Classic",
                "InstanceStatus":"ACTIVE",
                "RegionId":"cn-beijing",
                "CreateTime":"2018-08-06T12:41:27Z",
                "ExpireTime":"2999-09-08T16:00:00Z",
                "InstanceId":"pd-xxxxxxxxxxxxxx",
                "ZoneId":"cn-beijing-c"
            },
            {
                "Databases":{
                    "Database":[
                        {
                            "ChargeType":"PrePaid",
                            "DBName":"adb"
                        }
                    ]
                },
                "NetworkType":"Classic",
                "InstanceStatus":"ACTIVE",
                "RegionId":"cn-zhangjiakou",
                "CreateTime":"2018-07-24T11:20:53Z",
                "ExpireTime":"2999-09-08T16:00:00Z",
                "InstanceId":"pd-xxxxxxxxxxxxxx",
                "ZoneId":"cn-zhangjiakou-a"
            },
            {
                "Databases":{
                    "Database":[
                        {
                            "ChargeType":"PrePaid",
                            "DBName":"adb"
                        }
                    ]
                },
                "NetworkType":"Classic",
                "InstanceStatus":"ACTIVE",
                "RegionId":"cn-zhangjiakou",
                "CreateTime":"2018-07-24T10:01:19Z",
                "ExpireTime":"2999-09-08T16:00:00Z",
                "InstanceId":"pd-xxxxxxxxxxxxxx",
                "ZoneId":"cn-zhangjiakou-a"
            },
            {
                "Databases":{
                    "Database":[
                        {
                            "ChargeType":"PrePaid",
                            "DBName":"adb"
                        }
                    ]
                },
                "NetworkType":"Classic",
                "InstanceStatus":"ACTIVE",
                "RegionId":"cn-zhangjiakou",
                "CreateTime":"2018-07-24T09:30:46Z",
                "ExpireTime":"2999-09-08T16:00:00Z",
                "InstanceId":"pd-xxxxxxxxxxxxxx",
                "ZoneId":"cn-zhangjiakou-a"
            },
            {
                "Databases":{
                    "Database":[
                        {
                            "ChargeType":"PostPaid",
                            "DBName":"adb"
                        }
                    ]
                },
                "NetworkType":"VPC",
                "InstanceStatus":"ACTIVE",
                "RegionId":"us-west-1",
                "CreateTime":"2018-07-19T09:46:51Z",
                "ExpireTime":"2999-09-08T16:00:00Z",
                "InstanceId":"pd-xxxxxxxxxxxxxx",
                "ZoneId":"us-west-1a",
                "VSwitchId":"vsw-xxxxxxxxxxxxxx",
                "VpcId":"vpc-xxxxxxxxxxxxxx"
            },
            {
                "Databases":{
                    "Database":[
                        {
                            "ChargeType":"PostPaid",
                            "DBName":"test_sla_099"
                        }
                    ]
                },
                "NetworkType":"VPC",
                "InstanceStatus":"ACTIVE",
                "RegionId":"us-east-1",
                "CreateTime":"2018-06-14T09:41:30Z",
                "ExpireTime":"2999-09-08T16:00:00Z",
                "InstanceId":"pd-xxxxxxxxxxxxxx",
                "ZoneId":"us-east-1a",
                "VSwitchId":"vsw-xxxxxxxxxxxxxx",
                "VpcId":"vpc-xxxxxxxxxxxxxx"
            },
            {
                "Databases":{
                    "Database":[
                        {
                            "ChargeType":"PostPaid",
                            "DBName":"adb"
                        }
                    ]
                },
                "NetworkType":"Classic",
                "InstanceStatus":"ACTIVE",
                "RegionId":"us-east-1",
                "CreateTime":"2018-06-14T06:18:32Z",
                "ExpireTime":"2999-09-08T16:00:00Z",
                "InstanceId":"pd-xxxxxxxxxxxxxx",
                "ZoneId":"us-east-1a"
            },
            {
                "Databases":{
                    "Database":[
                        {
                            "ChargeType":"PostPaid",
                            "DBName":"test_a"
                        }
                    ]
                },
                "NetworkType":"VPC",
                "InstanceStatus":"ACTIVE",
                "RegionId":"cn-beijing",
                "CreateTime":"2018-06-08T03:49:24Z",
                "ExpireTime":"2999-09-08T16:00:00Z",
                "InstanceId":"pd-xxxxxxxxxxxxxx",
                "ZoneId":"cn-beijing-g",
                "VSwitchId":"vsw-xxxxxxxxxxxxxx",
                "VpcId":"vpc-xxxxxxxxxxxxxx",
                "InstanceName":"test"
            },
            {
                "Databases":{
                    "Database":[
                        {
                            "ChargeType":"PrePaid",
                            "DBName":"adb"
                        },
                        {
                            "ChargeType":"PostPaid",
                            "DBName":"testdb"
                        },
                        {
                            "ChargeType":"PostPaid",
                            "DBName":"testdb_01"
                        }
                    ]
                },
                "NetworkType":"Classic",
                "InstanceStatus":"ACTIVE",
                "RegionId":"cn-hangzhou",
                "CreateTime":"2018-05-15T07:31:37Z",
                "ExpireTime":"2999-09-08T16:00:00Z",
                "InstanceId":"pd-xxxxxxxxxxxxxx",
                "ZoneId":"cn-hangzhou-b",
                "InstanceName":"创建时间2018-05-15-15-31-37"
            },
            {
                "Databases":{
                    "Database":[
                        {
                            "ChargeType":"PostPaid",
                            "DBName":"adb"
                        }
                    ]
                },
                "NetworkType":"Classic",
                "InstanceStatus":"ACTIVE",
                "RegionId":"ap-southeast-1",
                "CreateTime":"2018-05-07T13:10:39Z",
                "ExpireTime":"2019-05-07T13:10:39Z",
                "InstanceId":"pd-xxxxxxxxxxxxxx",
                "ZoneId":"ap-southeast-1b"
            }
        ]
    }
}