翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
トピックオペレーション
Amazon MSK APIs を使用して、Kafka 管理クライアントを設定および維持しなくても、MSK プロビジョンドクラスター内のトピックを管理できます。これらの APIs を使用すると、保持ポリシーやクリーンアップポリシーなどの設定とともに、レプリケーション係数やパーティション数などのトピックプロパティを定義または読み取ることができます。CLI、 AWS SDKs、Kafka AWS トピックをプログラムで管理できます。 AWS CloudFormation これらの APIsは Amazon MSK コンソールにも統合され、すべてのトピックオペレーションが 1 か所に集約されます。ガイド付きデフォルトを使用して数回クリックするだけで、トピック設定、パーティションレベルの情報、メトリクスを包括的に可視化しながら、トピックを作成または更新できるようになりました。
重要
これらのトピックの API レスポンスは、約 1 分ごとに更新されるデータを反映しています。変更後の最新のトピックの状態については、クエリを実行する前に約 1 分かかります。
トピック APIsを使用するための要件
-
クラスターは MSK プロビジョンドクラスターである必要があります。これらの APIsは MSK Serverless クラスターでは使用できません。
-
クラスターは Apache Kafka バージョン 3.6.0 以降を実行している必要があります。サポートされているバージョンの詳細については、「」を参照してくださいサポート対象の Apache Kafka バージョン。
-
クラスターは
ACTIVE状態である必要があります。クラスターの状態の詳細については、「MSK プロビジョンドクラスターの状態を理解する」を参照してください。 -
適切な IAM アクセス許可が必要です。詳細については、「トピックオペレーション APIsの IAM アクセス許可」を参照してください。
トピックオペレーション APIsの IAM アクセス許可
これらの APIs呼び出すには、適切な IAM アクセス許可が必要です。次の表に、各 API に必要なアクセス許可を示します。
| API | 必要な許可 | [リソース] |
|---|---|---|
| ListTopics |
|
クラスター ARN、トピック ARN |
| DescribeTopic |
|
クラスター ARN、トピック ARN |
| DescribeTopicPartitions |
|
クラスター ARN、トピック ARN |
| CreateTopic |
|
クラスター ARN、トピック ARN |
| DeleteTopic |
|
クラスター ARN、トピック ARN |
| UpdateTopic |
|
クラスター ARN、トピック ARN |
注記
ではkafka-cluster:Connect、IAM ポリシーでクラスター ARN を指定します。その他のすべてのアクションについては、IAM ポリシーでトピック ARN を指定します。
注記
ではListTopics、ワイルドカード (*) を使用して、クラスター上のすべてのトピックを一致させることができます。例: arn:aws:kafka:us-east-1:123456789012:topic/my-cluster/abcd1234-abcd-dcba-4321-a1b2abcd9f9f-2/*。
Amazon MSK の IAM アクセスコントロールの詳細については、「」を参照してくださいIAM アクセスコントロール。
トピック
