Querying an Instance
Function
This API is used to query the details about a specified instance.
Calling Method
For details, see Calling APIs.
URI
GET /v2/{project_id}/instances/{instance_id}
| 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 |
| instance_id | Yes | String | Definition Instance ID. You can call the API for querying all instances to obtain it. 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
| 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 |
| disk_encrypted | Boolean | Definition Whether disk encryption is enabled. Range |
| disk_encrypted_key | String | Definition Disk encryption key. If disk encryption is not enabled, this parameter is left blank. Range N/A |
| Parameter | Type | Description |
|---|---|---|
| key | String | Definition Tag key. Constraints Range N/A Default Value N/A |
| value | String | Definition Tag value. Constraints Range N/A Default Value N/A |
Example Requests
Querying details of a specified instance
GET https://{endpoint}/v2/{project_id}/instances/{instance_id} Example Responses
Status code: 200
The specified instance is queried successfully.
{
"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" : "paas_dms_01",
"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" : [ ],
"broker_num" : 1,
"access_user" : "root_01"
} Status Codes
| Status Code | Description |
|---|---|
| 200 | The specified instance is queried 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.