Help Center/ Distributed Message Service for RocketMQ/ API Reference/ APIs V2 (Recommended)/ Lifecycle Management/ Querying an Instance
Updated on 2026-04-30 GMT+08:00
View PDF

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

Definition

Project ID. For details about how to obtain it, see Obtaining a Project ID.

Constraints

N/A

Range

N/A

Default Value

N/A

instance_id

Yes

String

Definition

Instance ID. You can call the API for querying all instances to obtain the instance ID. The instance ID is in the response body.

Constraints

N/A

Range

N/A

Default Value

N/A

Request Parameters

None

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

name

String

Definition

Instance name.

Range

N/A

engine

String

Definition

Message engine type.

Range

  • rocketmq: RocketMQ message engine.

  • reliability: RocketMQ message engine alias.

status

String

Definition

Message status.

Range

For details, see Instance Status.

description

String

Definition

Message description.

Range

N/A

type

String

Definition

Message description.

Range

  • single: 4.8.0 single-node

  • cluster: 4.8.0 cluster

  • single.basic: 5.x single-node basic edition

  • cluster.basic: 5.x cluster basic edition

  • single.professional: 5.x single-node professional edition

  • cluster.professional: 5.x cluster professional edition

specification

String

Definition

Specification description.

Range

  • For version 4.8.0, the value consists of the resource flavor and number of brokers, for example, rocketmq.4u8g.cluster.small * 1 broker.

  • For the 5.x basic edition, the value consists of the resource flavor and instance TPS, for example, rocketmq.b2.large.4, 2000 tps.

  • For the 5.x single-node professional edition, the value consists of the resource flavor and instance TPS, for example, rocketmq.p1.large.1, 500 tps.

  • For the 5.x cluster professional edition, the value consists of the resource flavor, instance TPS, and elastic TPS, for example, rocketmq.p2.large.8, 4000 tps, 2000 elastic_tps.

For details about resource flavors and other parameters, see the instance specification table of the corresponding version in Specifications

engine_version

String

Definition

Instance version.

Range

  • 4.8.0

  • 5.x

instance_id

String

Definition

Instance ID.

Range

N/A

charging_mode

Integer

Definition

Billing mode.

Range

1 indicates pay-per-use.1: pay-per-use; 0: yearly/monthly.

vpc_id

String

Definition

VPC ID.

Range

N/A

vpc_name

String

Definition

VPC name.

Range

N/A

created_at

String

Definition

Time when creation is complete.

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.

Range

N/A

product_id

String

Definition

RocketMQ instance flavors.

Range

  • c6.4u8g.cluster.small: Max. 2,000 topics and 2,000 consumer groups per broker

  • c6.4u8g.cluster: Max. 4,000 topics and 4,000 consumer groups per broker

  • c6.8u16g.cluster: Max. 8,000 topics and 8,000 consumer groups per broker

  • c6.12u24g.cluster: Max. 12,000 topics and 12,000 consumer groups per broker

  • c6.16u32g.cluster: Max. 16,000 topics and 16,000 consumer groups per broker

  • rocketmq.b1.large.1: RocketMQ 5.x basic edition single-node flavor, instance TPS 500

  • rocketmq.b2.large.4: RocketMQ 5.x basic edition cluster flavor, instance TPS 2,000

  • rocketmq.b2.large.8: RocketMQ 5.x basic edition cluster flavor, instance TPS 4,000

  • rocketmq.b2.large.12: RocketMQ 5.x basic edition cluster flavor, instance TPS 6,000

  • rocketmq.p1.large.1: RocketMQ 5.x professional edition single-node flavor, instance TPS 500

  • rocketmq.p2.large.8: RocketMQ 5.x professional edition cluster flavor, instance TPS 4,000

  • rocketmq.p2.large.12: RocketMQ 5.x professional edition cluster flavor, instance TPS 6,000

  • rocketmq.p2.large.20: RocketMQ 5.x professional edition cluster flavor, instance TPS 10,000

  • rocketmq.p2.large.40: RocketMQ 5.x professional edition cluster flavor, instance TPS 20,000

  • rocketmq.p2.large.100: RocketMQ 5.x professional edition cluster flavor, instance TPS 50,000

  • rocketmq.p2.large.150: RocketMQ 5.x professional edition cluster flavor, instance TPS 75,000

  • rocketmq.p2.large.200: RocketMQ 5.x professional edition cluster flavor, instance TPS 100,000

  • rocketmq.p2.large.300: RocketMQ 5.x professional edition cluster flavor, instance TPS 150,000

security_group_id

String

Definition

Security group ID.

Range

N/A

security_group_name

String

Definition

Security group name.

Range

N/A

subnet_id

String

Definition

Subnet ID.

Range

N/A

subnet_name

String

Definition

Subnet name.

Range

N/A

subnet_cidr

String

Definition

Subnet route.

Range

N/A

available_zones

Array of strings

Definition

List of AZ IDs.

Range

N/A

available_zone_names

Array of strings

Definition

List of AZ names.

Range

N/A

user_id

String

Definition

User ID.

Range

N/A

user_name

String

Definition

Username.

Range

N/A

maintain_begin

String

Definition

Time at which the maintenance window starts. The format is HH:mm:ss.

Range

N/A

maintain_end

String

Definition

Time at which the maintenance window ends. The format is HH:mm:ss.

Range

N/A

enable_log_collection

Boolean

Definition

Whether log collection is enabled.

Range

  • true: Yes

  • false: No

storage_space

Integer

Definition

Storage space, in GB.

Range

Different instance specifications support different storage configurations.

used_storage_space

Integer

Definition

Used message storage space, in GB.

Range

Different instance specifications support different storage configurations.

enable_publicip

Boolean

Definition

Whether to enable public access.

Range

  • true: Yes

  • false: No

publicip_id

String

Definition

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).

Range

  • true: Yes

  • false: No

publicip_address

String

Definition

Public IP address.

Range

N/A

ssl_enable

Boolean

Definition

Whether SSL is enabled.

Range

  • true: Yes

  • false: No

cross_vpc_info

String

Definition

Cross-VPC access information.

Range

  • true: Yes

  • false: No

storage_resource_id

String

Definition

Storage resource ID.

Range

N/A

storage_spec_code

String

Definition

Storage specification code.

Range

  • dms.physical.storage.high.v2: high I/O disk This value is not supported by RocketMQ 5.x professional edition.

  • dms.physical.storage.ultra.v2: ultra-high I/O disk

service_type

String

Definition

Service type.

Range

  • advanced: Service type.

storage_type

String

Definition

Storage type.

Range

  • hec: Storage type.

extend_times

Long

Definition

Extension time.

Range

N/A

ipv6_enable

Boolean

Definition

Whether IPv6 is enabled.

Range

  • true: Yes

  • false: No

support_features

String

Definition

Features supported by the instance.

Range

N/A

disk_encrypted

Boolean

Definition

Whether disk encryption is enabled.

Range

  • true: Yes

  • false: No

ces_version

String

Definition

Cloud Eye version.

Range

N/A

node_num

Integer

Definition

Number of nodes. (This field is available only for RocketMQ 4.8.0 instances.)

Range

N/A

new_spec_billing_enable

Boolean

Definition

Whether billing based on new specifications is enabled.

Range

  • true: Yes

  • false: No

enable_acl

Boolean

Definition

Whether to enable access control.

Range

  • true: Yes

  • false: No

broker_num

Integer

Definition

Number of brokers.

Range

N/A

dns_enable

Boolean

Definition

Whether to enable domain name access to an instance.

Range

  • true: Yes

  • false: No

namesrv_address

String

Definition

Metadata address.

Range

N/A

namesrv_domain_name

String

Definition

Metadata domain name.

Range

N/A

broker_address

String

Definition

Service data address.

Range

N/A

public_namesrv_address

String

Definition

Public network metadata address.

Range

N/A

public_namesrv_domain_name

String

Definition

Public metadata domain name.

Range

N/A

public_broker_address

String

Definition

Public network service data address.

Range

N/A

grpc_address

String

Definition

gRPC connection address (displayed only for RocketMQ 5.x).

Range

N/A

grpc_domain_name

String

Definition

gRPC connection domain name (displayed only for RocketMQ 5.x).

Range

N/A

public_grpc_address

String

Definition

Public gRPC connection address (displayed only for RocketMQ 5.x).

Range

N/A

public_grpc_domain_name

String

Definition

Public gRPC domain name (displayed only for RocketMQ 5.x).

Range

N/A

enterprise_project_id

String

Definition

Enterprise project ID.

Range

N/A

tags

Array of TagEntity objects

Definition

Tag list.

Range

N/A

total_storage_space

Integer

Definition

Total storage space.

Range

N/A

resource_spec_code

String

Definition

Resource specification.

Range

N/A

produce_portion

Integer

Definition

Production TPS proportion.

Range

N/A

consume_portion

Integer

Definition

Consumption TPS proportion.

Range

N/A

dr_enable

Boolean

Definition

Whether the instance has disaster recovery (DR).

Range

  • true: Yes

  • false: No

quota_address

String

Definition

Quota address.

Range

N/A

max_msg_process_tps

Integer

Definition

Maximum message TPS.

Range

N/A

config_ssl_need_restart_process

Boolean

Definition

Whether a restart is required to configure SSL.

Range

  • true: Yes

  • false: No

tls_mode

String

Definition

Security protocol used by an instance.

Range

N/A

arch_type

String

Definition

Architecture type.

Range

  • X86

enable_elastic_tps

Boolean

Definition

Elastic TPS switch status.

Range

  • true: enabled

  • false: disabled
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" : "features.log.collection",
  "disk_encrypted" : false,
  "ces_version" : "linux,v1,v2,v3,v4",
  "new_spec_billing_enable" : true,
  "dns_enable" : false,
  "dr_enable" : false,
  "config_ssl_need_restart_process" : false,
  "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"
}

Status Codes

Status Code

Description

200

Instance queried successfully.

Error Codes

See Error Codes.

Parent Topic: Lifecycle Management