本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

執行下列命令，以叢集的 Amazon Resource Name (ARN) 取代 *ClusterArn*，並以您要描述的主題名稱取代 *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` 欄位指出主題的目前狀態。下表說明可能的 狀態值。


**主題狀態值**  

| 狀態 | Description | 
| --- | --- | 
| 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)。