Updated on 2024-01-31 GMT+08:00

Querying an Instance

This API is out-of-date and may not be maintained in the future. Please use the API described in Querying an Instance.

Function

This API is used to query the details about an instance.

URI

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

Table 1 describes the parameters.

Table 1 Parameters

Parameter

Type

Mandatory

Description

project_id

String

Yes

Indicates the ID of a project.

instance_id

String

Yes

Indicates the instance ID.

Request

Request parameters

None.

Example request

GET https://{dms_endpoint}/v1.0/{project_id}/instances/{instance_id}

Response

Response parameters

Table 2 describes the parameters.

Table 2 Response parameters

Parameter

Type

Description

name

String

Indicates the instance name.

engine

String

Indicates the message engine.

engine_version

String

Indicates the version of the message engine.

specification

String

Indicates the instance specification.

storage_space

Integer

Indicates the message storage space. Unit: GB

partition_num

String

Indicates the total number of partitions in a Kafka instance.

used_storage_space

Integer

Indicates the used message storage space. Unit: GB

connect_address

String

Indicates the IP address of an instance.

port

Integer

Indicates the port number of an instance.

status

String

Indicates the status of an instance. For details, see Instance Status.

instance_id

String

Indicates the instance ID.

resource_spec_code

String

Indicates the resource specifications identifier.

  • dms.instance.kafka.cluster.c3.mini: Kafka instance, 100 MB/s reference bandwidth
  • dms.instance.kafka.cluster.c3.small.2: Kafka instance, 300 MB/s reference bandwidth
  • dms.instance.kafka.cluster.c3.middle.2: Kafka instance, 600 MB/s reference bandwidth
  • dms.instance.kafka.cluster.c3.high.2: Kafka instance, 1200 MB/s reference bandwidth

type

String

Indicates the instance type. Value: cluster

charging_mode

Integer

Indicates the billing mode. 1: pay-per-use mode; 0: yearly/monthly billing.

vpc_id

String

Indicates the ID of a VPC.

vpc_name

String

Indicates the name of a VPC.

created_at

String

Indicates the time when an instance is 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

Indicates the product ID.

security_group_id

String

Indicates the security group ID.

security_group_name

String

Indicates the security group name.

subnet_id

String

Indicates the subnet ID.

subnet_name

String

Indicates the subnet name.

subnet_cidr

String

Indicates the subnet CIDR block.

available_zones

Array

Indicates the ID of the AZ to which the instance node belongs. The AZ ID is returned.

user_id

String

Indicates the user ID.

user_name

String

Indicates the username.

access_user

String

Indicates the username of an instance.

order_id

String

Indicates the order ID.

maintain_begin

String

Indicates the time at which a maintenance time window starts.

Format: HH:mm:ss

maintain_end

String

Indicates the time at which a maintenance time window ends.

Format: HH:mm:ss

enable_publicip

Boolean

Indicates whether to enable public access for an instance.

  • true: enable
  • false: disable

management_connect_address

String

Indicates the connection address of the Kafka Manager of a Kafka instance.

ssl_enable

Boolean

Indicates whether to enable security authentication.

  • true: enable
  • false: disable

enterprise_project_id

String

Indicates the enterprise project ID.

is_logical_volume

Boolean

Distinguishes old instances from new instances during instance capacity expansion.

  • true: New instance, which allows dynamic disk capacity expansion without restarting the instance.
  • false: Old instance.

extend_times

Integer

Indicates the number of disk expansion times. If it exceeds 20, the disk cannot be expanded.

enable_auto_topic

Boolean

Indicates whether automatic topic creation is enabled.

  • true: enabled
  • false: disabled

total_storage_space

Integer

Indicates the message storage space. Unit: GB

storage_resource_id

String

Indicates the storage resource ID.

storage_spec_code

String

Indicates the I/O specification.

service_type

String

Indicates the service type.

storage_type

String

Indicates the storage type.

retention_policy

String

Indicates the message retention policy.

kafka_public_status

String

Indicates whether Kafka public access is enabled.

public_bandwidth

Integer

Indicates the public network bandwidth.

public_connect_address

String

Indicates the instance IP address for public access. This parameter is displayed only when public access is enabled.

kafka_manager_user

String

Indicates the username for logging in to Kafka Manager.

enable_log_collection

Boolean

Indicates whether log collection is enabled.

cross_vpc_info

String

Indicates cross-VPC access information.

ipv6_enable

Boolean

Indicates whether IPv6 is enabled.

ipv6_connect_addresses

Array of strings

Indicates the IPv6 connection address.

rest_enable

Boolean

Indicates whether the Kafka REST function is enabled.

rest_connect_address

String

Indicates the Kafka REST connection address.

message_query_inst_enable

Boolean

Indicates whether message query is enabled.

vpc_client_plain

Boolean

Indicates whether intra-VPC plaintext access is enabled.

support_features

String

Indicates the list of features supported by the Kafka instance.

trace_enable

Boolean

Indicates whether message tracing is enabled.

pod_connect_address

String

Indicates the connection address on the tenant side.

disk_encrypted

Boolean

Indicates whether disk encryption is enabled.

  • true: enabled
  • false: disabled

kafka_private_connect_address

String

Indicates the private connection address of a Kafka instance.

ces_version

String

Indicates the Cloud Eye version.

tags

Array<Object>

Indicates the list of tags.

Table 3 tags

Parameter

Type

Description

key

String

Indicates the tag key.

value

String

Indicates the tag value.

Example response

{
    "name": "kafka-l00230526",
    "engine": "kafka",
    "port": 9092,
    "status": "RUNNING",
    "type": "cluster",
    "specification": "100MB",
    "engine_version": "XXX",
    "connect_address": "192.168.1.116,192.168.1.152,192.168.1.78",
    "connect_dn": "",
    "instance_id": "ef84dd5f-3ece-4336-8c99-987defd62e3a",
    "resource_spec_code": "dms.instance.kafka.cluster.c3.mini",
    "charging_mode": 1,
    "vpc_id": "2477879f-aebf-496f-a08a-67812885ce9b",
    "vpc_name": "vpc-y00502467",
    "created_at": "1568797295209",
    "product_id": "00300-30308-0--0",
    "security_group_id": "008a08e2-10cc-4d9b-90ab-3f3b8f6c3333",
    "security_group_name": "z00417080-cce-node-na7j",
    "subnet_id": "5ca08fb7-7522-4d95-9fa5-ff6b3592a29d",
    "subnet_name": "subnet-cyd-6102",
    "subnet_cidr": "192.168.1.0/24",
    "available_zones": [
        "ae04cf9d61544df3806a3feeb401b204"
    ],
    "user_id": "2b4af4428ec840dfa1f0f1a32e965567",
    "user_name": "laiyh",
    "kafka_manager_user": "root",
    "maintain_begin": "22:00:00",
    "maintain_end": "02:00:00",
    "storage_space": 492,
    "total_storage_space": 600,
    "used_storage_space": 25,
    "partition_num": "300",
    "ssl_enable": false,
    "management_connect_address": "https://192.168.1.116:9999",
    "storage_resource_id": "81982562-ce8b-490a-95fa-2b225c292271",
    "storage_spec_code": "dms.physical.storage.ultra",
    "service_type": "advanced",
    "storage_type": "hec",
    "enterprise_project_id": "0",
    "is_logical_volume": true,
    "extend_times": 0,
    "retention_policy": "produce_reject",
    "ipv6_enable": false,
    "ipv6_connect_addresses": [],
    "connector_enable": false,
    "connector_id": "",
    "rest_enable": false,
    "rest_connect_address": "",
    "message_query_inst_enable": true,
    "vpc_client_plain": false,
    "support_features": "feature.physerver.kafka.topic.accesspolicy,message_trace_enable,features.pod.token.access,feature.physerver.kafka.pulbic.dynamic,feature.physerver.kafka.user.manager",
    "trace_enable": false,
    "agent_enable": false,
    "pod_connect_address": "100.113.16.105:9100,100.113.5.197:9100,100.113.15.231:9100",
    "disk_encrypted": false,
    "enable_auto_topic": true
}

Status Code

Table 4 describes the status code of successful operations. For details about other status codes, see Status Code.

Table 4 Status code

Status Code

Description

200

Specified instance queried successfully.