翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# トピックオペレーション
<a name="msk-topic-operations-information"></a>

Amazon MSK APIs を使用して、Kafka 管理クライアントを設定および維持しなくても、MSK プロビジョンドクラスター内のトピックを管理できます。これらの APIs を使用すると、保持ポリシーやクリーンアップポリシーなどの設定とともに、レプリケーション係数やパーティション数などのトピックプロパティを定義または読み取ることができます。CLI、 AWS SDKs、Kafka AWS トピックをプログラムで管理できます。 AWS CloudFormation これらの APIsは Amazon MSK コンソールにも統合され、すべてのトピックオペレーションが 1 か所に集約されます。ガイド付きデフォルトを使用して数回クリックするだけで、トピック設定、パーティションレベルの情報、メトリクスを包括的に可視化しながら、トピックを作成または更新できるようになりました。

**重要**  
これらのトピックの API レスポンスは、約 1 分ごとに更新されるデータを反映しています。変更後の最新のトピックの状態については、クエリを実行する前に約 1 分かかります。

## トピック APIsを使用するための要件
<a name="topic-operations-requirements"></a>
+ クラスターは MSK プロビジョンドクラスターである必要があります。これらの APIsは MSK Serverless クラスターでは使用できません。
+ クラスターは Apache Kafka バージョン 3.6.0 以降を実行している必要があります。サポートされているバージョンの詳細については、「」を参照してください[サポート対象の Apache Kafka バージョン](supported-kafka-versions.md)。
+ クラスターは `ACTIVE`状態である必要があります。クラスターの状態の詳細については、「[MSK プロビジョンドクラスターの状態を理解する](msk-cluster-states.md)」を参照してください。
+ 適切な IAM アクセス許可が必要です。詳細については、「[トピックオペレーション APIsの IAM アクセス許可](#topic-operations-permissions)」を参照してください。

## トピックオペレーション APIsの IAM アクセス許可
<a name="topic-operations-permissions"></a>

これらの APIs呼び出すには、適切な IAM アクセス許可が必要です。次の表に、各 API に必要なアクセス許可を示します。


**トピックオペレーション APIs に必要なアクセス許可**  

| API | 必要な許可 | [リソース]  | 
| --- | --- | --- | 
| ListTopics | `kafka-cluster:Connect`<br />`kafka-cluster:DescribeTopic` | クラスター ARN、トピック ARN | 
| DescribeTopic | `kafka-cluster:Connect`<br />`kafka-cluster:DescribeTopic`<br />`kafka-cluster:DescribeTopicDynamicConfiguration` | クラスター ARN、トピック ARN | 
| DescribeTopicPartitions | `kafka-cluster:Connect`<br />`kafka-cluster:DescribeTopic`<br />`kafka-cluster:DescribeTopicDynamicConfiguration` | クラスター ARN、トピック ARN | 
| CreateTopic | `kafka-cluster:Connect`<br />`kafka-cluster:CreateTopic` | クラスター ARN、トピック ARN | 
| DeleteTopic | `kafka-cluster:Connect`<br />`kafka-cluster:DescribeTopic`<br />`kafka-cluster:DeleteTopic` | クラスター ARN、トピック ARN | 
| UpdateTopic | `kafka-cluster:Connect`<br />`kafka-cluster:DescribeTopic`<br />`kafka-cluster:AlterTopic`<br />`kafka-cluster:AlterTopicDynamicConfiguration` | クラスター 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 アクセスコントロール](iam-access-control.md)。

**Topics**
+ [トピック APIsを使用するための要件](#topic-operations-requirements)
+ [トピックオペレーション APIsの IAM アクセス許可](#topic-operations-permissions)
+ [Amazon MSK クラスター内のトピックを一覧表示する](msk-list-topics.md)
+ [トピックに関する詳細情報を取得する](msk-describe-topic.md)
+ [トピックのパーティション情報を表示する](msk-describe-topic-partitions.md)
+ [Amazon MSK クラスターでトピックを作成する](msk-create-topic.md)
+ [Amazon MSK クラスターのトピックを更新する](msk-update-topic.md)
+ [Amazon MSK クラスター内のトピックを削除する](msk-delete-topic.md)