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

查询指定实例

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

功能介绍

查询指定实例的详细信息。

URI

GET /v1.0/{project_id}/instances/{instance_id}

参数说明见表1

表1 参数说明

参数

类型

必选

说明

project_id

String

项目ID。

instance_id

String

实例ID。

请求消息

请求参数

无。

请求示例

无。

响应消息

响应参数

参数说明见表2

表2 参数说明

参数

类型

说明

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个节点

type

String

实例类型。

  • 单机:single
  • 集群:cluster

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

product_id

String

产品标识。

security_group_id

String

安全组ID。

security_group_name

String

租户安全组名称。

subnet_id

String

子网ID。

subnet_name

String

子网名称。

subnet_cidr

String

子网网段。

available_zones

Array

实例节点所在的可用区,返回“可用区ID”。

user_id

String

用户id。

user_name

String

用户名。

access_user

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次则无法扩容磁盘。

表3 错误码说明

错误码

说明

public.00.0001

内部服务错误。

public.00.0002

内部服务错误。

public.00.0003

内部服务错误。

public.00.0004

VPC创建失败。

public.00.0005

安全组创建失败。

public.00.0006

子网创建失败。

public.00.0007

子网状态异常。

public.00.0008

创建ECS失败。

public.00.0009

创建ECS失败。

public.00.0010

创建ECS失败。

public.00.0011

ECS绑定网卡失败。

public.00.0013

ECS启动失败。

public.00.0014

ECS启动失败。

public.00.0015

ECS停止失败。

public.00.0018

创建ECS失败,ECS资源配额不足。

public.00.0024

实例部署异常。

public.00.0025

实例部分节点故障。

public.00.0042

无法连接实例。

响应示例

{ 
    "name" : "dms-a11e", 
    "engine" : "rabbitmq", 
    "engine_version" : "3.x.x",
    "specification" : "2vCPUs 4GB", 
    "storage_space" : 100,
    "used_storage_space" : 50,
    "connect_address" : "192.168.3.100", 
    "port" : 5672, 
    "status" : "RUNNING", 
    "description" : "Create a instance", 
    "instance_id" : "68d5745e-6af2-40e4-945d-fe449be00148", 
    "resource_spec_code" : "dms.instance.rabbitmq.single.c3.2u4g", 
    "type" : "single", 
    "charging_mode" : 1, 
    "vpc_id" : "27d99e17-42f2-4751-818f-5c8c6c03ff15", 
    "vpc_name" : "vpc_4944a40e-ac57-4f08-9d38-9786e2759458_192", 
    "created_at" : "1526367063931", 
    "error_code" : null, 
    "product_id" : "00300-30109-0--0", 
    "security_group_id" : "60ea2db8-1a51-4ab6-9e11-65b418c24583", 
    "security_group_name" : "sg_6379_4944a40e-ac57-4f08-9d38-9786e2759458", 
    "subnet_id" : "ec2f34b9-20eb-4872-85bd-bea9fc943128", 
    "subnet_name" : "subnet_az_7f336767-10ec-48a5-9ae8-9cacde119318", 
    "subnet_cidr" : "192.168.0.0/24", 
    "available_zones" : ["1d7b939b382c4c3bb3481a8ca10da785"],
    "user_id": "6d0977e4c9b74ae7b5a083a8d0d8fafa", 
    "user_name": "aabb02", 
    "access_user": "user",
    "order_id": "XXXXXXXXX", 
    "maintain_begin" : "22:00", 
    "maintain_end" : "02:00", 
    "enable_publicip" : "true",
    "publicip_id": "b7940732-11ef-459b-acab-cab0d26c74a3", 
    "publicip_address": "192.168.10.5",
    "ssl_enable": false,
    "management_connect_address": "http://192.168.0.177:9999"
 }

状态码

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

表4 状态码

状态码

描述

200

查询指定实例成功。