描述

查看該用戶下指定的實例，或者全部的數據庫實例列表。

請求參數

名稱 類型 是否必須 描述
<公共參數> - 是 參見公共參數。
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"
            }
        ]
    }
}