本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 获取有关某个主题的详细信息
<a name="msk-describe-topic"></a>

您可以检索有关 MSK Provisioned 集群中特定主题的详细信息，包括其当前状态、分区数、重复因子和配置。这对于故障排除、验证主题设置或在操作期间监控主题状态非常有用。

**注意**  
此 API 响应反映了大约每分钟更新一次的数据。要了解更改后的最新主题状态，请在查询前等待大约一分钟。

**Topics**
+ [使用描述主题 AWS 管理控制台](describe-topic-console.md)
+ [使用描述主题 AWS CLI](describe-topic-cli.md)
+ [使用 API 描述主题](describe-topic-api.md)

# 使用描述主题 AWS 管理控制台
<a name="describe-topic-console"></a>

1. 登录并在[https://console.aws.amazon.com/msk/家中打开 Amazon MSK 控制台？ AWS 管理控制台 region=us](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/)-east-1\$1/home/。

1. 在集群列表中，选择包含您要描述的主题的集群的名称。

1. 在集群详细信息页面上，选择**主题**选项卡。

1. 在主题列表中，选择要查看的主题的名称。

1. 主题详细信息页面显示有关该主题的信息，包括其状态、分区数、重复因子和配置设置。

# 使用描述主题 AWS CLI
<a name="describe-topic-cli"></a>

运行以下命令，*ClusterArn*替换为集群的 Amazon 资源名称 (ARN) 和*TopicName*您要描述的主题的名称。

```
aws kafka describe-topic --cluster-arn ClusterArn --topic-name TopicName
```

该 命令的输出如以下 JSON 示例所示。

```
{
    "topicArn": "arn:aws:kafka:us-east-1:123456789012:topic/MyCluster/abcd1234-abcd-dcba-4321-a1b2abcd9f9f-2/MyTopic",
    "topicName": "MyTopic",
    "partitionCount": 3,
    "replicationFactor": 3,
    "configs": "Y29tcHJlc3Npb24udHlwZT1wcm9kdWNlcgpyZXRlbnRpb24ubXM9NjA0ODAwMDAw",
    "status": "ACTIVE"
}
```

## 了解主题状态
<a name="describe-topic-status"></a>

该`status`字段表示主题的当前状态。下表描述了可能的状态值。


**主题状态值**  

| Status | 说明 | 
| --- | --- | 
| CREATING | 主题正在创建中。 | 
| ACTIVE | 该主题处于活动状态，可供使用。 | 
| UPDATING | 主题配置正在更新中。 | 
| DELETING | 该主题正在删除中。 | 

## 了解主题配置
<a name="describe-topic-configs"></a>

该`configs`字段包含主题的 Kafka 配置属性，这些属性以 Base64 格式编码。要以可读格式查看配置，您需要解码 Base64 字符串。

以下示例显示了如何在 Linux 或 macOS 上使用`base64`命令对配置进行解码。

```
echo "Y29tcHJlc3Npb24udHlwZT1wcm9kdWNlcgpyZXRlbnRpb24ubXM9NjA0ODAwMDAw" | base64 --decode
```

解码后的输出以键值格式显示主题配置属性。

```
compression.type=producer
retention.ms=604800000
```

有关主题级配置属性的更多信息，请参阅。[主题级别的 Amazon MSK 配置](msk-configuration-properties.md#msk-topic-confinguration)

# 使用 API 描述主题
<a name="describe-topic-api"></a>

要使用 API 描述主题，请参阅[DescribeTopic](https://docs.aws.amazon.com//msk/1.0/apireference/v1-clusters-clusterarn-topics-topicname.html#DescribeTopic)。