Querying an Instance

Function

This API is used to query the details about a specified instance.

URI

GET /v2/{project_id}/instances/{instance_id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details, see Obtaining a Project ID.
instance_id	Yes	String	Instance ID.

Request Parameters

None

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
name	String	Instance name.
engine	String	Message engine.
status	String	Status.
description	String	Message description.
type	String	Instance type. Value: cluster.
specification	String	Instance specification.
engine_version	String	Version.
instance_id	String	Instance ID.
charging_mode	Integer	Billing mode. 1 indicates pay-per-use.Billing mode. Options: 1: pay-per-use; 0: yearly/monthly.
vpc_id	String	VPC ID.
vpc_name	String	VPC name.
created_at	String	Time when the instance was created. The time is in the format of timestamp, that is, the offset milliseconds from 1970-01-01 00:00:00 UTC to the specified time.
product_id	String	Product ID.
security_group_id	String	Security group ID.
security_group_name	String	Security group name.
subnet_id	String	Subnet ID.
subnet_name	String	Subnet name.
subnet_cidr	String	Subnet route. This field is available only for RocketMQ 5.x instances.
available_zones	Array of strings	IDs of AZs.
available_zone_names	Array of strings	Names of AZs.
user_id	String	User ID.
user_name	String	Username.
maintain_begin	String	Time at which the maintenance window starts. The format is HH:mm:ss.
maintain_end	String	Time at which the maintenance window ends. The format is HH:mm:ss.
enable_log_collection	Boolean	Whether log collection is enabled.
storage_space	Integer	Storage space. Unit: GB.
used_storage_space	Integer	Used message storage space. Unit: GB.
enable_publicip	Boolean	Whether public access is enabled.
publicip_id	String	ID of the EIP bound to the instance.Use commas (,) to separate multiple EIP IDs.This parameter is mandatory if public access is enabled (that is, enable_publicip is set to true).
publicip_address	String	Public IP address.
ssl_enable	Boolean	Whether SSL is enabled.
cross_vpc_info	String	Cross-VPC access information.
storage_resource_id	String	Storage resource ID.
storage_spec_code	String	Storage specification code.
service_type	String	Service type.
storage_type	String	Storage category.
extend_times	Long	Extension time.
ipv6_enable	Boolean	Whether IPv6 is enabled.
support_features	String	Features supported by the instance.
disk_encrypted	Boolean	Whether disk encryption is enabled.
ces_version	String	Cloud Eye version.
node_num	Integer	Node quantity.
new_spec_billing_enable	Boolean	Whether billing based on new specifications is enabled.
enable_acl	Boolean	Whether access control is enabled.
broker_num	Integer	Number of nodes. This field is available only for RocketMQ 4.8.0 instances.
dns_enable	Boolean	Whether domain name access is enabled for an instance. true: yes false: no
namesrv_address	String	Metadata address.
namesrv_domain_name	String	Metadata domain name.
broker_address	String	Service data address.
public_namesrv_address	String	Public network metadata address.
public_namesrv_domain_name	String	Public metadata domain name.
public_broker_address	String	Public network service data address.
grpc_address	String	gRPC address. This field is available only for RocketMQ 5.x instances.
grpc_domain_name	String	gRPC domain name. This field is available only for RocketMQ 5.x instances.
public_grpc_address	String	gRPC address (public). This field is available only for RocketMQ 5.x instances.
public_grpc_domain_name	String	Public gRPC domain name. This field is available only for RocketMQ 5.x instances.
enterprise_project_id	String	Enterprise project ID.
tags	Array of TagEntity objects	Tag list.
total_storage_space	Integer	Total storage space.
resource_spec_code	String	Resource specifications.

**Table 3** TagEntity
Parameter	Type	Description
key	String	Tag key. Must be specified. Must be unique for the same instance. Can contain 1 to 128 characters. Can contain letters, digits, spaces, and special characters _.:=+-@ Cannot start or end with a space.
value	String	Tag value. Can contain 0 to 255 characters. Can contain letters, digits, spaces, and special characters _.:=+-@ Cannot start or end with a space.

Example Requests

Querying details of a specified instance

GET https://{endpoint}/v2/{project_id}/instances/{instance_id}

Example Responses

Status code: 200

Instance queried successfully.

{
  "name" : "reliability-test",
  "engine" : "reliability",
  "status" : "RUNNING",
  "description" : "",
  "type" : "single.basic",
  "specification" : "rocketmq.b1.large.1, 500 tps",
  "engine_version" : "5.x",
  "instance_id" : "68fdc9a8-805e-439d-8dd9-25adc1c58bf6",
  "resource_spec_code" : "",
  "charging_mode" : 1,
  "vpc_id" : "3db8490c-4d6d-4d8f-8d3f-047b0de4c5cf",
  "vpc_name" : "vpc-1101840",
  "created_at" : "1636699753874",
  "product_id" : "rocketmq.b1.large.1",
  "security_group_id" : "23c5977f-ff33-4b95-a73e-08d8a0bc4e6c",
  "security_group_name" : "security_group_test",
  "subnet_id" : "0a0f1fcb-f019-458d-b9e5-301867394d50",
  "subnet_name" : "subnet-test",
  "subnet_cidr" : "192.168.64.0/18",
  "available_zones" : [ "9f1c5806706d4c1fb0eb72f0a9b18c77" ],
  "available_zone_names" : [ "AZ3" ],
  "user_id" : "0b01fbb53600d4671fa8c00673c71260",
  "user_name" : "user_test",
  "maintain_begin" : "02:00:00",
  "maintain_end" : "06:00:00",
  "enable_log_collection" : false,
  "storage_space" : 558,
  "total_storage_space" : 600,
  "used_storage_space" : 28,
  "enable_publicip" : true,
  "publicip_id" : "83924171-7014-48f0-a6b2-c714e7a090dd",
  "publicip_address" : "***",
  "ssl_enable" : false,
  "cross_vpc_info" : "{\"192.168.93.114\":{\"advertised_ip\":\"192.168.93.114\",\"broker_port\":\"10100\",\"port_id\":\"b3de3981-1f73-4e6f-b35a-78833b783364\",\"namesrv_port\":\"8300\"}}",
  "storage_resource_id" : "164bdaef-2e67-4fd5-be8b-a18f91d455a2",
  "storage_spec_code" : "dms.physical.storage.ultra.v2",
  "service_type" : "advanced",
  "storage_type" : "hec",
  "enterprise_project_id" : "0",
  "extend_times" : 0,
  "ipv6_enable" : false,
  "support_features" : "kafka.crossvpc.domain.enable,auto.create.topics.enable,rabbitmq.plugin.management,support.permissive.mode,auto_topic_switch,feature.physerver.kafka.user.manager,kafka.ssl.2way.modify.enable,kafka.new.pod.port,message_trace_enable,features.pod.token.access,log.enable,features.log.collection,max.connections,rabbitmq.manage.support,replica_port_standalone,feature.physerver.kafka.topic.accesspolicy,enable.kafka.quota.monitor,rocketmq.acl,roma_app_enable,support.kafka.producer.ip,enable.new.authinfo,enable.kafka.quota,rabbitmq_run_log_enable,max.ssl.connections,route,message_trace_v2_enable,kafka.config.dynamic.modify.enable,feature.physerver.kafka.topic.modify,enable.topic.quota,kafka.ssl.cert.modify.enable,roma.user.manage.no.support,auto.create.groups.enable,feature.physerver.kafka.pulbic.dynamic,kafka.config.static.modify.enable",
  "disk_encrypted" : false,
  "ces_version" : "linux,v1,v2,v3,v4",
  "new_spec_billing_enable" : true,
  "enable_acl" : false,
  "namesrv_address" : "192.168.93.114:8100",
  "broker_address" : "192.168.64.0/18:10100",
  "public_namesrv_address" : "100.85.116.211:8200",
  "public_broker_address" : "100.85.116.211:10101",
  "grpc_address" : "192.168.93.114:8080",
  "public_grpc_address" : "100.85.116.211:8081"
}