Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Thema Operationen
Sie können Amazon MSK verwenden, um Informationen APIs zu Themen in Ihrem MSK Provisioned Cluster anzuzeigen. Diese APIs bieten schreibgeschützten Zugriff auf Themenmetadaten, einschließlich Partitionsanzahl, Replikationsfaktoren, Konfigurationen und Partitionsdetails. Diese Informationen sind nützlich, um Ihre Kafka-Themen zu überwachen, Fehler zu beheben und die Struktur zu verstehen.
Wichtig
Die DescribeTopicPartitions APIs Antworten ListTopicsDescribeTopic, und beziehen sich auf Daten, die ungefähr jede Minute aktualisiert werden. Warten Sie etwa eine Minute, bevor Sie eine Abfrage durchführen, um den aktuellsten Status des Themas zu ermitteln, nachdem Sie Änderungen vorgenommen haben.
Anmerkung
Diese APIs ermöglichen den schreibgeschützten Zugriff auf Themen-Metadaten. Verwenden Sie Apache Kafka-Tools oder Kafka, um Themen zu erstellen oder zu ändern. AdminClient Weitere Informationen finden Sie unter Schritt 4: Erstellen Sie ein Thema im Amazon MSK-Cluster.
Anforderungen für das Anzeigen von Themeninformationen
-
Ihr Cluster muss ein von MSK bereitgestellter Cluster sein. Diese APIs sind für MSK-Cluster ohne Server nicht verfügbar.
-
Auf Ihrem Cluster muss Apache Kafka Version 3.6.0 oder höher ausgeführt werden. Weitere Informationen zu unterstützten Versionen finden Sie unter. Unterstützte Apache Kafka-Versionen
-
Ihr Cluster muss sich im
ACTIVEStatus befinden. Weitere Informationen zu Cluster-Status finden Sie unter Verstehen Sie die Status der bereitgestellten MSK-Cluster. -
Sie müssen über die entsprechenden IAM-Berechtigungen verfügen. Weitere Informationen finden Sie unter IAM-Berechtigungen zum Anzeigen von Themeninformationen.
IAM-Berechtigungen zum Anzeigen von Themeninformationen
Um diese aufrufen zu können APIs, benötigen Sie die entsprechenden IAM-Berechtigungen. In der folgenden Tabelle sind die erforderlichen Berechtigungen für jede API aufgeführt.
| API | Erforderliche Berechtigungen | Ressource |
|---|---|---|
| ListTopics |
|
Cluster-ARN |
| DescribeTopic |
|
Thema-ARN |
| DescribeTopicPartitions |
|
Thema-ARN |
Anmerkung
Geben Sie für ListTopics den Cluster-ARN in Ihrer IAM-Richtlinie an. Geben Sie für DescribeTopic und DescribeTopicPartitions das Thema ARN in Ihrer IAM-Richtlinie an.
Weitere Informationen zur IAM-Zugriffskontrolle für Amazon MSK finden Sie unter. IAM-Zugriffssteuerung