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
}