调用 DescribeInstanceDetail 接口查看指定实例的详情。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：DescribeInstanceDetail

要执行的操作，取值：DescribeInstanceDetail。

Version string 必选示例值：2022-05-01

API的版本，取值：2022-05-01。

InstanceId string 必选示例值：kafka-cnngqkfgdudt****

待查询详情的 Kafka 实例 ID。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

BasicInstanceInfo object 示例值：--

实例的名称、版本等基本信息。

InstanceId string 示例值：kafka-cnngqkfgdudt****

Kafka 实例 ID。

InstanceName string 示例值：kafkainstance

Kafka 实例名称。

InstanceDescription string 示例值：这是一个测试实例

实例的简单描述。

InstanceStatus string 示例值：Running

实例状态。

Error：错误

Deleting：删除中

Creating：部署中

Upgrading：升级中

Updating：变更中

Running：运行中

Scaling：更配中

Rebuilding：重建中

Destroying：销毁中

Restarting：重启中

Migrating：迁移中

Restoring：恢复中

Importing：导入中

NetCreating：申请公网中

NetReleasing：释放公网中

Rollingback：回滚中

CreateFailed：创建失败

UpgradeFailed：升级失败

ScaleFailed：更配失败

RestartFailed：重启失败

RegionId string 示例值：cn-beijing

实例所在的地域 ID。

ZoneId string 示例值：cn-beijing-a

实例所在的可用区 ID。

Version string 示例值：2.2.2

支持的Kafka版本。当前支持的版本包括：

2.2.2：Kafka 2.2.2 版本。

2.8.2：Kafka 2.8.2 版本。

UsedTopicNumber integer 示例值：20

当前实例已创建的 Topic 个数。

UsedGroupNumber integer 示例值：20

当前实例已经创建的消费组（Group）个数。

UsedPartitionNumber integer 示例值：120

当前实例已经使用的分区个数。

UsablePartitionNumber integer 示例值：20

当前实例剩余可用分区数。

ComputeSpec string 示例值：kafka.60xrate.hw

Kafka 实例的计算规格。

CreateTime string 示例值：2022-07-18T07:48:58Z

实例的创建时间。时间显示格式为 YYYY-MM-DD'T'HH:MM:SS'Z'。

UsedStorageSpace integer 示例值：100

实例已用储空间。单位为 GiB。

StorageSpace integer 示例值：200

实例总存储空间。单位为 GiB。

SubnetId string 示例值：subnet-min6uy01***

VPC 的子网 ID。

EipId string 示例值：eip-mjhulvqza****

EIP 的 ID。

如果实例未开启公网访问方式，则不返回此参数。

VpcId string 示例值：vpc-13fo9gkz6j****

私有网络（VPC） ID。

ProjectName string 示例值：newproject

实例所属的 IAM 项目。如果实例不属于任何 IAM 项目，则不返回此参数。

AccountId string `示例值：200000****

`

创建实例的火山引擎主账号 ID。

ChargeDetail object 示例值：--

实例的计费方式等计费信息。详细说明请参考【ChargeDetailObject】。

ChargeType string 示例值：PostPaid

实例的计费类型。支持的类型包括：

PostPaid ：按量付费

PrePaid：包年包月

AutoRenew boolean 示例值：true

包年包月实例到期后是否自动续费。

true：自动续费。

false：不自动续费。到期后需要手动续费，否则实例将被关停。

PeriodUnit string 示例值：Month

包年包月类型实例的生命周期单位，即指定以月或以年为单位购买。其中：

Month：（默认）包月

Year：包年

ChargeStatus string 示例值：Normal

实例的计费状态。包括：

Normal：正常

Overdue：按量计费欠费

Expired：包年包月到期

ChargeExpireTime string 示例值：2022-07-18T07:48:58Z

包年包月实例的到期时间。时间显示格式为YYYY-MM-DD'T'HH:MM:SS'Z'。

仅包年包月实例返回此参数。

OverdueTime string 示例值：2022-07-18T07:48:58Z

实例的欠费关停时间。时间显示格式为 YYYY-MM-DD'T'HH:MM:SS'Z'。

OverdueReclaimTime string 示例值：2022-07-18T07:48:58Z

实例欠费关停后的预计释放时间。时间显示格式为 YYYY-MM-DD'T'HH:MM:SS'Z'。

ChargeStartTime string 示例值：2022-07-18T07:48:58Z

实例的开始计费时间。时间显示格式为YYYY-MM-DD'T'HH:MM:SS'Z'。

PrivateDomainOnPublic boolean 示例值：false

是否已开启公网解析功能。

true：已开启

false：已关闭

StorageType string 示例值：ESSD_FlexPL

Kafka 实例数据存储的云盘类型。即 ESSD_FlexPL 或 ESSD_PL0。关于不同存储类型的详细性能说明，请参考云盘规格。

UsableGroupNumber integer 示例值：100

当前实例剩余可用消费组数。

Tags object 示例值：{ "mode": "http", "tag-wzx": "11" }

已绑定的标签。

ConnectionInfo object[] 示例值：--

实例的连接信息。

InternalEndpoint string 示例值：kafka-cnng5ysg5vv9****.kafka.ivolces.com:9093

实例私网访问域名。

PublicEndpoint string 示例值：kafka-cnng5ysg5vv9ps****.kafka.volces.com:9492

实例公网访问域名。

NetworkType string 示例值：PrivateNetwork

接入点的网络类型。统一为 PrivateNetwork。

EndpointType string 示例值：PLAINTEXT

实例的接入点类型。

Kafka 实例提供的接入点类型包括：

PLAINTEXT：默认接入点。

SASL_PLAINTEXT：SASL接入点（私网）。

SASL_SSL：SASL接入点（公网）。未开启公网访问时，不提供此接入点。