更新时间:2024-01-24 GMT+08:00

查询所有实例列表

当前页面API为历史版本API,未来可能停止维护。请使用查询所有实例列表

功能介绍

查询租户的实例列表,支持按照条件查询。

URI

GET /v1.0/{project_id}/instances?engine={engine}&name={name}&status={status}&id={id}&includeFailure={includeFailure}&exactMatchName={exactMatchName}&enterprise_project_id={enterprise_project_id}

参数说明见表1

表1 参数说明

参数

类型

必选

说明

project_id

String

项目ID。

engine

String

rabbitmq,参数缺失查询所有实例。

name

String

实例名称。

id

String

实例ID。

status

String

实例状态。详细状态说明见实例状态说明

includeFailure

String

是否返回创建失败的实例数。

当参数值为“true”时,返回创建失败的实例数。参数值为“false”或者其他值,不返回创建失败的实例数。

exactMatchName

String

是否按照实例名称进行精确匹配查询。

默认为“false”,表示模糊匹配实例名称查询。若参数值为“true”表示按照实例名称进行精确匹配查询。

enterprise_project_id

String

企业项目ID。

示例

GET /v1.0/bd6b78e2ff9e4e47bc260803ddcc7a21/instances?start=1&limit=10&name=&status=&id=&includeFailure=true&exactMatchName=false  

请求消息

请求参数

无。

请求示例

无。

响应消息

响应参数

参数说明见表2

表2 参数说明

参数

类型

说明

instances

Array

实例的详情数组。

instance_num

Integer

实例个数。

表3 instance参数说明

参数

类型

说明

name

String

实例名称。

engine

String

引擎。

engine_version

String

版本。

specification

String

实例规格。

  • RabbitMQ实例单机返回vm规格。
  • RabbitMQ实例集群返回vm规格和节点数。

storage_space

Integer

消息存储空间,单位:GB。

used_storage_space

Integer

已使用的消息存储空间,单位:GB。

connect_address

String

实例连接IP地址。

port

Integer

实例连接端口。

status

String

实例的状态。详细状态说明见实例状态说明

description

String

实例描述。

instance_id

String

实例ID。

resource_spec_code

String

资源规格标识。

  • dms.instance.rabbitmq.single.c3.2u4g:RabbitMQ单机,vm规格2u4g
  • dms.instance.rabbitmq.single.c3.4u8g:RabbitMQ单机,vm规格4u8g
  • dms.instance.rabbitmq.single.c3.8u16g:RabbitMQ单机,vm规格8u16g
  • dms.instance.rabbitmq.single.c3.16u32g:RabbitMQ单机,vm规格16u32g
  • dms.instance.rabbitmq.cluster.c3.4u8g.3:RabbitMQ集群,vm规格4u8g,3个节点
  • dms.instance.rabbitmq.cluster.c3.4u8g.5:RabbitMQ集群,vm规格4u8g,5个节点
  • dms.instance.rabbitmq.cluster.c3.4u8g.7:RabbitMQ集群,vm规格4u8g,7个节点
  • dms.instance.rabbitmq.cluster.c3.8u16g.3:RabbitMQ集群,vm规格8u16g,3个节点
  • dms.instance.rabbitmq.cluster.c3.8u16g.5:RabbitMQ集群,vm规格8u16g,5个节点
  • dms.instance.rabbitmq.cluster.c3.8u16g.7:RabbitMQ集群,vm规格8u16g,7个节点
  • dms.instance.rabbitmq.cluster.c3.16u32g.3:RabbitMQ集群,vm规格16u32g,3个节点
  • dms.instance.rabbitmq.cluster.c3.16u32g.5:RabbitMQ集群,vm规格16u32g,5个节点
  • dms.instance.rabbitmq.cluster.c3.16u32g.7:RabbitMQ集群,vm规格16u32g,7个节点

charging_mode

Integer

付费模式,1表示按需计费,0表示包年/包月计费。

vpc_id

String

VPC ID。

vpc_name

String

VPC的名称。

created_at

String

完成创建时间。

格式为时间戳,指从格林威治时间 1970年01月01日00时00分00秒起至指定时间的偏差总毫秒数。

error_code

String

实例创建失败或状态异常时的错误码,错误码说明见表3

user_id

String

用户id。

user_name

String

用户名。

order_id

String

订单ID,只有在包周期计费时才会有order_id值,其他计费方式order_id值为空。

maintain_begin

String

维护时间窗开始时间,格式为HH:mm。

maintain_end

String

维护时间窗结束时间,格式为HH:mm。

enable_publicip

Boolean

RabbitMQ实例是否开启公网访问功能。

  • true:开启
  • false:未开启

publicip_address

String

RabbitMQ实例绑定的弹性IP地址。

如果未开启公网访问功能,该字段值为null。

publicip_id

String

RabbitMQ实例绑定的弹性IP地址的ID。

如果未开启公网访问功能,该字段值为null。

management_connect_address

String

RabbitMQ实例的管理地址。

ssl_enable

Boolean

是否开启安全认证。

  • true:开启
  • false:未开启

enterprise_project_id

String

企业项目ID。

is_logical_volume

Boolean

实例扩容时用于区分老实例与新实例。

  • true:新创建的实例,允许磁盘动态扩容不需要重启。
  • false:老实例。

extend_times

String

实例扩容磁盘次数,如果超过20次则无法扩容磁盘。

响应示例

{
    "instances": [
        {
            "name": "rabbitmq-lxy001",
            "engine": "rabbitmq",
            "port": 5672,
            "status": "RUNNING",
            "type": "single",
            "specification": "2vCPUs 4GB",
            "engine_version": "3.x.x",
            "connect_address": "192.168.255.237",
            "instance_id": "595926bf-a648-47d8-91bc-461956794c2b",
            "resource_spec_code": "dms.instance.rabbitmq.single.c3.2u4g",
            "charging_mode": 1,
            "vpc_id": "1a28dcc5-c90d-421c-82bb-783f30f5b40a",
            "vpc_name": "vpc-y00292973",
            "created_at": "1562583302800",
            "product_id": "00300-30109-0--0",
            "security_group_id": "0cc8fdb7-872a-49da-a062-88ccc39463b5",
            "security_group_name": "sg-65eb-nw-test",
            "subnet_id": "ebba7994-260d-42ab-bce1-39a08b365dc8",
            "available_zones": [
                "d573142f24894ef3bd3664de068b44b0"
            ],
            "user_id": "50a4156d334a4a82b8745dc730dc1e00",
            "user_name": "test",
            "access_user": "test-Info",
            "maintain_begin": "02:00:00",
            "maintain_end": "06:00:00",
            "storage_space": 88,
            "total_storage_space": 100,
            "used_storage_space": 4,
            "enable_publicip": false,
            "ssl_enable": false,
            "management_connect_address": "http://192.168.255.237:15672",
            "storage_resource_id": "34825335-61cb-4ee0-949e-24b08170edb2",
            "storage_spec_code": "dms.physical.storage.ultra",
            "service_type": "advanced",
            "storage_type": "hec",
            "enterprise_project_id": "0",
            "is_logical_volume": false,
            "extend_times": 0,
            "ipv6_enable": false,
            "ipv6_connect_addresses": [],
            "connector_enable": false,
            "connector_id": "",
            "rest_enable": false,
            "rest_connect_address": "",
            "public_boundwidth": 0,
            "message_query_inst_enable": true,
            "vpc_client_plain": false,
            "support_features": "feature.physerver.kafka.topic.accesspolicy,message_trace_enable,feature.physerver.kafka.pulbic.dynamic,feature.physerver.kafka.user.manager",
            "trace_enable": false
        }
    ],
    "instance_num": 1
}

状态码

操作成功的状态码如表4所示,其他响应见状态码

表4 状态码

状态码

描述

200

查询所有实例列表成功。