Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Topik Operasi
Anda dapat menggunakan Amazon MSK APIs untuk mengelola topik di klaster MSK Provisioned Anda tanpa perlu mengatur dan memelihara klien admin Kafka. Dengan ini APIs, Anda dapat menentukan atau membaca properti topik seperti faktor replikasi dan jumlah partisi, bersama dengan pengaturan konfigurasi seperti kebijakan retensi dan pembersihan. Anda dapat mengelola topik Kafka secara terprogram menggunakan antarmuka yang Anda kenal termasuk AWS CLI,, dan. AWS SDKs AWS CloudFormation Ini APIs juga terintegrasi ke dalam konsol MSK Amazon, membawa semua operasi topik ke satu tempat. Anda sekarang dapat membuat atau memperbarui topik hanya dengan beberapa klik menggunakan default yang dipandu sambil mendapatkan visibilitas komprehensif ke dalam konfigurasi topik, informasi tingkat partisi, dan metrik.
**penting**
Respons API topik ini mencerminkan data yang diperbarui kira-kira setiap menit. Untuk status topik terbaru setelah membuat perubahan, biarkan sekitar satu menit sebelum melakukan kueri.
## Persyaratan untuk menggunakan topik APIs
+ Cluster Anda harus berupa klaster MSK Provisioned. Ini tidak APIs tersedia untuk kluster MSK Tanpa Server.
+ Cluster Anda harus menjalankan Apache Kafka versi 3.6.0 atau yang lebih baru. Untuk informasi selengkapnya tentang versi yang didukung, lihat[Versi Apache Kafka yang didukung](supported-kafka-versions.md).
+ Cluster Anda harus berada di `ACTIVE` negara bagian. Untuk informasi selengkapnyua tentang status klaster, lihat [Memahami status cluster MSK Provisioned](msk-cluster-states.md).
+ Anda harus memiliki izin IAM yang sesuai. Untuk informasi selengkapnya, lihat [Izin IAM untuk operasi topik APIs](#topic-operations-permissions).
## Izin IAM untuk operasi topik APIs
Untuk memanggil ini APIs, Anda harus memiliki izin IAM yang sesuai. Tabel berikut mencantumkan izin yang diperlukan untuk setiap API.
**Izin yang diperlukan untuk operasi topik APIs**
| API | Izin yang Diperlukan | Sumber daya |
| --- | --- | --- |
| ListTopics | `kafka-cluster:Connect` `kafka-cluster:DescribeTopic` | Kluster ARN, Topik ARN |
| DescribeTopic | `kafka-cluster:Connect` `kafka-cluster:DescribeTopic` `kafka-cluster:DescribeTopicDynamicConfiguration` | Kluster ARN, Topik ARN |
| DescribeTopicPartitions | `kafka-cluster:Connect` `kafka-cluster:DescribeTopic` `kafka-cluster:DescribeTopicDynamicConfiguration` | Kluster ARN, Topik ARN |
| CreateTopic | `kafka-cluster:Connect` `kafka-cluster:CreateTopic` | Kluster ARN, Topik ARN |
| DeleteTopic | `kafka-cluster:Connect` `kafka-cluster:DescribeTopic` `kafka-cluster:DeleteTopic` | Kluster ARN, Topik ARN |
| UpdateTopic | `kafka-cluster:Connect` `kafka-cluster:DescribeTopic` `kafka-cluster:AlterTopic` `kafka-cluster:AlterTopicDynamicConfiguration` | Kluster ARN, Topik ARN |
**catatan**
Untuk`kafka-cluster:Connect`, tentukan ARN cluster dalam kebijakan IAM Anda. Untuk semua tindakan lainnya, tentukan topik ARN dalam kebijakan IAM Anda.
**catatan**
Untuk`ListTopics`, Anda dapat menggunakan wildcard (\$1) untuk mencocokkan semua topik di cluster. Sebagai contoh: `arn:aws:kafka:us-east-1:123456789012:topic/my-cluster/abcd1234-abcd-dcba-4321-a1b2abcd9f9f-2/*`.
Untuk informasi selengkapnya tentang kontrol akses IAM untuk Amazon MSK, lihat. [Kontrol akses IAM](iam-access-control.md)
**Topics**
+ [Persyaratan untuk menggunakan topik APIs](#topic-operations-requirements)
+ [Izin IAM untuk operasi topik APIs](#topic-operations-permissions)
+ [Daftar topik dalam cluster MSK Amazon](msk-list-topics.md)
+ [Dapatkan informasi rinci tentang suatu topik](msk-describe-topic.md)
+ [Melihat informasi partisi untuk topik](msk-describe-topic-partitions.md)
+ [Buat topik di kluster MSK Amazon](msk-create-topic.md)
+ [Perbarui topik di kluster MSK Amazon](msk-update-topic.md)
+ [Hapus topik di kluster MSK Amazon](msk-delete-topic.md)