PolarDB-X 1.0-API参考-1.0(2019版本)-实例管理-DescribeDrdsInstances

本文涉及的产品
云原生数据库 PolarDB 分布式版,标准版 2核8GB
简介: 通过DescribeDrdsInstances接口查询DRDS实例列表。

调试

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

调试

请求参数

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

系统规定参数,取值为DescribeDrdsInstances。

Type String 1

实例类型。

  • 共享实例:0
  • 专享实例:1
Tag.N.Key String acs:newretail:domain

第N个tag的键。

Tag.N.Value String NEW_RETAIL

第N个tag的值。

Description String drds_test

DRDS实例的描述。

Expired Boolean false

是否过期。

PageNumber Integer 1

页码。

PageSize Integer 20

每页大小。

返回数据

名称 类型 示例值 描述
Instances Array

实例列表。

PageNumber Integer 1

该页页码。

PageSize Integer 20

该页大小。

RequestId String 8734773E-7B21-4A22-9106-CBD245F8****

请求ID。

Total Integer 1

实例总数。

示例

请求示例


http(s)://drds.aliyuncs.com/?Action=DescribeDrdsInstances
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML 格式


<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/>
        <DrdsInstanceId>drdssen12****</DrdsInstanceId>
        <OrderInstanceId>drdssen12****</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-CBD245F8****</RequestId>
<PageNumber>1</PageNumber>
<Total>1</Total>

JSON 格式


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

错误码

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

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

相关实践学习
快速体验PolarDB开源数据库
本实验环境已内置PostgreSQL数据库以及PolarDB开源数据库:PolarDB PostgreSQL版和PolarDB分布式版,支持一键拉起使用,方便各位开发者学习使用。
相关文章
|
XML JSON 关系型数据库
|
XML JSON 关系型数据库
|
XML JSON 关系型数据库
|
XML JSON 关系型数据库
PolarDB-X 1.0-API参考-1.0(2019版本)-实例管理-ModifyDrdsInstanceDescription
调用ModifyDrdsInstanceDescription接口修改实例描述。
137 0
|
XML JSON 关系型数据库
PolarDB-X 1.0-API参考-1.0(2019版本)-实例管理-UpdateResourceGroupAttribute
调用UpdateResourceGroupAttribute接口将实例转移至新的资源组。
141 0
|
XML JSON 关系型数据库
PolarDB-X 1.0-API参考-1.0(2019版本)-实例版本-UpgradeInstanceVersion
调用UpgradeInstanceVersion接口升级DRDS实例的版本。
110 0
|
XML JSON 关系型数据库
PolarDB-X 1.0-API参考-1.0(2019版本)-实例版本-DescribeDrdsInstanceVersion
调用DescribeDrdsInstanceVersion接口查看实例版本。
134 0
|
XML JSON 关系型数据库
PolarDB-X 1.0-API参考-1.0(2019版本)-实例版本-RollbackInstanceVersion
调用RollbackInstanceVersion接口回滚目标实例的版本。
118 0

相关产品

  • 云原生分布式数据库 PolarDB-X
  • 下一篇
    无影云桌面