翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
トピックオペレーション
Amazon MSK APIs を使用して、MSK プロビジョンドクラスターのトピックに関する情報を表示できます。これらの APIs は、パーティション数、レプリケーション係数、設定、パーティションの詳細など、トピックメタデータへの読み取り専用アクセスを提供します。この情報は、Kafka トピックのモニタリング、トラブルシューティング、および構造の理解に役立ちます。
重要
ListTopics、、および DescribeTopicPartitions APIsレスポンスはDescribeTopic、約 1 分ごとに更新されるデータを反映します。変更後の最新のトピックの状態については、クエリを実行する前に約 1 分かかります。
注記
これらの APIsトピックメタデータへの読み取り専用アクセスを提供します。トピックを作成または変更するには、Apache Kafka ツールまたは Kafka AdminClient を使用します。詳細については、「ステップ 4: Amazon MSK クラスターにトピックを作成する」を参照してください。
トピック情報を表示するための要件
-
クラスターは MSK プロビジョンドクラスターである必要があります。これらの APIsは MSK Serverless クラスターでは使用できません。
-
クラスターは Apache Kafka バージョン 3.6.0 以降を実行している必要があります。サポートされているバージョンの詳細については、「」を参照してくださいサポート対象の Apache Kafka バージョン。
-
クラスターは
ACTIVE状態である必要があります。クラスターの状態の詳細については、「MSK プロビジョンドクラスターの状態を理解する」を参照してください。 -
適切な IAM アクセス許可が必要です。詳細については、「トピック情報を表示するための IAM アクセス許可」を参照してください。
トピック情報を表示するための IAM アクセス許可
これらの APIs呼び出すには、適切な IAM アクセス許可が必要です。次の表に、各 API に必要なアクセス許可を示します。
| API | 必要な許可 | [リソース] |
|---|---|---|
| ListTopics |
|
クラスター ARN |
| DescribeTopic |
|
トピック ARN |
| DescribeTopicPartitions |
|
トピック ARN |
注記
ではListTopics、IAM ポリシーでクラスター ARN を指定します。DescribeTopic および ではDescribeTopicPartitions、IAM ポリシーでトピック ARN を指定します。
Amazon MSK の IAM アクセスコントロールの詳細については、「」を参照してくださいIAM アクセスコントロール。
