Esta página aún no está disponible en su idioma local. Estamos trabajando arduamente para agregar más versiones de idiomas. Gracias por tu apoyo.
Querying an Instance
Function
This API is used to query the details about a specified instance.
URI
GET /v2/{project_id}/instances/{instance_id}
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Project ID. |
instance_id |
Yes |
String |
Instance ID. |
Request Parameters
None
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
name |
String |
Instance name. |
engine |
String |
Message engine. |
engine_version |
String |
Version. |
description |
String |
Instance description |
specification |
String |
Instance specifications. |
storage_space |
Integer |
Message storage space in GB. |
partition_num |
String |
Number of partitions in a Kafka instance. |
used_storage_space |
Integer |
Used message storage space in GB. |
connect_address |
String |
IP address of an instance. |
port |
Integer |
Port of an instance. |
status |
String |
Instance status. |
instance_id |
String |
Instance ID. |
resource_spec_code |
String |
Resource specification code.
|
charging_mode |
Integer |
Billing mode. 1: pay-per-use. |
vpc_id |
String |
VPC ID. |
vpc_name |
String |
VPC name. |
created_at |
String |
Time when the instance was 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. |
subnet_name |
String |
Subnet name. |
subnet_cidr |
String |
Subnet CIDR block. |
user_id |
String |
User ID. |
user_name |
String |
Username. |
access_user |
String |
Username for accessing the instance. |
order_id |
String |
Order ID. This parameter has a value only when the billing mode is yearly/monthly. |
maintain_begin |
String |
Time at which the maintenance time window starts. The format is HH:mm:ss. |
maintain_end |
String |
Time at which the maintenance time window ends. The format is HH:mm:ss. |
enable_publicip |
Boolean |
Whether public access is enabled for the instance.
|
management_connect_address |
String |
Connection address of Kafka Manager of the Kafka instance. |
ssl_enable |
Boolean |
Whether security authentication is enabled.
|
ssl_two_way_enable |
Boolean |
Indicates whether to enable two-way authentication. |
cert_replaced |
Boolean |
Whether the certificate can be replaced. |
public_management_connect_address |
String |
Address for accessing Kafka Manager over public networks. |
enterprise_project_id |
String |
Enterprise project ID. |
is_logical_volume |
Boolean |
Whether the instance is a new instance. This parameter is used to distinguish old instances from new instances during instance capacity expansion.
|
extend_times |
Integer |
Number of disk expansion times. If the value exceeds 20, disk expansion is no longer allowed. |
enable_auto_topic |
Boolean |
Whether automatic topic creation is enabled.
|
type |
String |
Instance type. The value can be cluster. |
product_id |
String |
Product ID. |
security_group_id |
String |
Security group ID. |
security_group_name |
String |
Security group name. |
subnet_id |
String |
Subnet ID. |
available_zones |
Array of strings |
AZ to which the instance brokers belong. The AZ ID is returned. |
total_storage_space |
Integer |
Message storage space in GB. |
public_connect_address |
String |
Instance public access address. This parameter is available only when public access is enabled for the instance. |
storage_resource_id |
String |
Storage resource ID. |
storage_spec_code |
String |
I/O specifications. |
service_type |
String |
Service type. |
storage_type |
String |
Storage class. |
retention_policy |
String |
Message retention policy. |
kafka_public_status |
String |
Whether public access is enabled for Kafka. |
public_bandwidth |
Integer |
Public network access bandwidth. |
kafka_manager_user |
String |
Username for logging in to Kafka Manager. |
enable_log_collection |
Boolean |
Whether log collection is enabled. |
cross_vpc_info |
String |
Cross-VPC access information. |
ipv6_enable |
Boolean |
Whether IPv6 is enabled. |
ipv6_connect_addresses |
Array of strings |
IPv6 connection address. |
rest_enable |
Boolean |
Whether Kafka REST is enabled. |
rest_connect_address |
String |
Kafka REST connection address. |
public_boundwidth |
Integer |
Public network access bandwidth. To be deleted. |
message_query_inst_enable |
Boolean |
Whether message query is enabled. |
vpc_client_plain |
Boolean |
Whether intra-VPC plaintext access is enabled. |
support_features |
String |
List of features supported by the Kafka instance. |
trace_enable |
Boolean |
Whether message tracing is enabled. |
agent_enable |
Boolean |
Indicates whether the proxy is enabled. |
pod_connect_address |
String |
Connection address on the tenant side. |
disk_encrypted |
Boolean |
Whether disk encryption is enabled. |
disk_encrypted_key |
String |
Disk encryption key. If disk encryption is not enabled, this parameter is left blank. |
kafka_private_connect_address |
String |
Private connection address of a Kafka instance. |
ces_version |
String |
Cloud Eye version. |
public_access_enabled |
String |
Time when public access was enabled for an instance. The value can be true, actived, closed, or false. |
node_num |
Integer |
Node quantity. |
enable_acl |
Boolean |
Indicates whether access control is enabled. |
new_spec_billing_enable |
Boolean |
Whether billing based on new specifications is enabled. |
broker_num |
Integer |
Broker quantity. |
tags |
Array of TagEntity objects |
Tag list. |
dr_enable |
Boolean |
Indicates whether DR is enabled. |
Parameter |
Type |
Description |
---|---|---|
key |
String |
Tag key, which can contain a maximum of 36 Unicode characters. The key cannot be left blank or be an empty string. It cannot contain nonprintable ASCII (0–31) characters and the following special characters: =*<>,|/ |
value |
String |
Tag value, which can contain a maximum of 43 Unicode characters. The value cannot be left blank or be an empty string. It cannot contain nonprintable ASCII (0–31) characters and the following special characters: =*<>,|/ |
Example Requests
GET https://{endpoint}/v2/{project_id}/instances/{instance_id}
Example Responses
None
Status Codes
Status Code |
Description |
---|---|
200 |
The 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.