Listing All Instances
Function
This API is used to query the instances of an account by the specified conditions.
Calling Method
For details, see Calling APIs.
URI
GET /v2/{project_id}/instances
Parameter | Mandatory | Type | Description |
|---|---|---|---|
project_id | Yes | String | Definition Project ID. For details, see Obtaining a Project ID. Constraints N/A Range N/A Default Value N/A |
Parameter | Mandatory | Type | Description |
|---|---|---|---|
engine | Yes | String | Definition: Message engine type. The value is rabbitmq. Constraints: N/A Range: N/A Default Value: N/A |
name | No | String | Definition: Instance name. You can call the API for querying all instances to obtain the instance name. The instance name is in the response body. Constraints: N/A Range: N/A Default Value: N/A |
instance_id | No | 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 |
status | No | String | Definition Instance status. For details, see Instance Status. Constraints N/A Range N/A Default Value N/A |
include_failure | No | String | Definition: Indicates whether to return the number of instances that fail to be created. Constraints: N/A Range:
Default Value: N/A |
exact_match_name | No | String | Definition: Whether to search for the instance that precisely matches a specified instance name. Constraints: N/A Range:
Default Value: false |
enterprise_project_id | No | String | Definition: Enterprise project ID. Constraints: N/A Range: N/A Default Value: N/A |
offset | No | String | Definition: Offset, which is the position where the query starts. Constraints: N/A Range: ≥ 0 Default Value: N/A |
limit | No | String | Definition: Maximum number of instances that can be returned in a query. Constraints: N/A Range: 1–50 Default Value: 10 |
Request Parameters
None
Response Parameters
Status code: 200
Parameter | Type | Description |
|---|---|---|
instances | Array of ShowInstanceResp objects | Definition: Instance list. |
instance_num | Integer | Definition: Number of instances. Range: N/A |
Parameter | Type | Description |
|---|---|---|
access_user | String | Definition: Authentication username. Range: N/A |
broker_num | Integer | Definition: Number of brokers. Range:
|
name | String | Definition: Instance name. Range: N/A |
engine | String | Definition: Engine type. Range: rabbitmq: RabbitMQ engine. |
engine_version | String | Definition Message engine version. Range
|
specification | String | Definition: Instance flavor. Range:
|
storage_space | Integer | Definition: Message storage space, in GB. Range: N/A |
used_storage_space | Integer | Definition: Used message storage space, in GB. Range: N/A |
dns_enable | Boolean | Definition: Whether to enable domain name access to an instance. Range:
|
connect_address | String | Definition: Instance IP address for private access. Range: N/A |
connect_domain_name | String | Definition: Instance domain name for private access. Range: N/A |
public_connect_address | String | Definition: Instance IP address for public access. Range: N/A |
public_connect_domain_name | String | Definition: Instance domain name for public access. Range: N/A |
port | Integer | Definition: Instance port. Range: N/A |
status | String | Definition Instance status. Range For details, see Instance Status. |
description | String | Definition: Instance description. Range: N/A |
instance_id | String | Definition: Instance ID. Range: N/A |
resource_spec_code | String | Definition Resource specification ID. Range
|
charging_mode | Integer | Definition: Billing mode. Range:
|
vpc_id | String | Definition: VPC ID. Range: N/A |
vpc_name | String | Definition: VPC name. Range: N/A |
created_at | String | Definition: Time when the 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 |
user_id | String | Definition: User ID. Range: N/A |
user_name | String | Definition: Username. Range: N/A |
order_id | String | Definition: Indicates an order ID. This parameter has a value only when the billing mode is yearly/monthly mode. 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_publicip | Boolean | Definition: Indicates whether to enable public access for a RabbitMQ instance. Range:
|
publicip_address | String | Definition: Indicates the EIP bound to a RabbitMQ instance. The value of this parameter is null if public access is disabled. Range:
|
publicip_id | String | Definition: Indicates the ID of the EIP bound to a RabbitMQ instance. The value of this parameter is null if public access is disabled. Range: N/A |
management_connect_address | String | Definition: Management address of a RabbitMQ instance. Range: N/A |
management_connect_domain_name | String | Definition: Management domain name of a RabbitMQ instance. Range: N/A |
public_management_connect_address | String | Definition: Public management address of a RabbitMQ instance. Range: N/A |
public_management_connect_domain_name | String | Definition: Public management domain name of a RabbitMQ instance. Range: N/A |
ssl_enable | Boolean | Definition: Whether security authentication is enabled. Range:
|
enterprise_project_id | String | Definition: Enterprise project ID. Range: N/A |
is_logical_volume | Boolean | Definition: Distinguishes old instances from new instances during instance capacity expansion. Range:
|
extend_times | Integer | Definition Times of scaling up the instance disk. Range N/A |
type | String | Definition: Instance type. Range:
|
product_id | String | Definition: Product ID. Range: N/A |
security_group_id | String | Definition: Security group ID. Range: N/A |
security_group_name | String | Definition: Name of the tenant security group. Range: N/A |
subnet_id | String | Definition: Subnet ID. Range: N/A |
available_zones | Array of strings | Definition: ID of the AZ where an instance node is located. |
available_zone_names | Array of strings | Definition: Name of the AZ where an instance node is located. |
total_storage_space | Integer | Definition: Total message storage space, in GB. Range: N/A |
storage_resource_id | String | Definition: Storage resource ID. Range: N/A |
storage_spec_code | String | Definition: I/O specification. Range: N/A |
ipv6_enable | Boolean | Definition: Whether IPv6 is enabled. Range:
|
ipv6_connect_addresses | Array of strings | Definition: IPv6 connection address. |
tags | Array of TagEntity objects | Definition: Tag list. |
service_type | String | Definition Service type. Range advanced |
storage_type | String | Definition Storage type. Range hec |
Example Requests
Listing all instances
GET https://{endpoint}/v2/{project_id}/instances Example Responses
Status code: 200
All instances are listed successfully.
{
"instances" : [ {
"name" : "api-explorer",
"engine" : "rabbitmq",
"port" : 5672,
"status" : "RUNNING",
"type" : "single",
"specification" : "2vCPUs 4GB",
"engine_version" : "3.8.35",
"connect_address" : "192.168.0.74",
"instance_id" : "de873040-d661-4770-aa96-9329c71d7c8a",
"resource_spec_code" : "dms.instance.rabbitmq.single.c3.2u4g",
"charging_mode" : 1,
"vpc_id" : "40a6501e-85ca-4449-a0db-b8bc7f0cec28",
"vpc_name" : "vpc-a400",
"created_at" : "1590047080687",
"product_id" : "00300-30109-0--0",
"security_group_id" : "bfd68e26-f8ef-4a91-a373-0a8f5c198601",
"security_group_name" : "Sys-default",
"subnet_id" : "a7f9a564-30dd-4059-8124-364ca6554578",
"available_zones" : [ "9f1c5806706d4c1fb0eb72f0a9b18c77" ],
"available_zone_names" : [ "AZ1" ],
"user_id" : "3df5acbc24a54fadb62a043c9000a307",
"user_name" : "********",
"maintain_begin" : "22:00:00",
"maintain_end" : "02: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.0.74:15672",
"storage_resource_id" : "52be287d-1d6a-4d30-937e-185b3f176fc4",
"storage_spec_code" : "dms.physical.storage.normal",
"enterprise_project_id" : "0",
"tags" : [ {
"key" : "key1",
"value" : "value1"
}, {
"key" : "key2",
"value" : "value2"
} ],
"is_logical_volume" : true,
"extend_times" : 0,
"ipv6_enable" : false,
"ipv6_connect_addresses" : [ ]
} ],
"instance_num" : 1
} Status Codes
Status Code | Description |
|---|---|
200 | All instances are listed successfully. |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.

