Admin-REST-API verwenden

Event Streams stellt eine REST-konforme Verwaltungs-API bereit, mit der Sie Topics erstellen, löschen, auflisten und aktualisieren können.

Sie müssen die URL und die Berechtigungsnachweisdetails, die für die Verbindung mit der API erforderlich sind, von einem Serviceberechtigungsnachweisobjekt oder Serviceschlüssel für die Serviceinstanz abrufen. Informationen zum Erstellen dieser Objekte finden Sie in Verbindung zu Event Streams herstellen.

Die URL für den Endpunkt der API wird in der Eigenschaft kafka_admin_url angegeben.

Die Berechtigungsnachweise hängen von der Authentifizierungsmethode ab und es werden drei Typen von Berechtigungsnachweisen unterstützt.

Mit Basisauthentifizierung authentifizieren

Verwenden Sie die Eigenschaften user und api_key der Objekte als Benutzernamen und Kennwort. Fügen Sie diese Werte in den Header Authorization der HTTP-Anforderung im Format Basic <base64 encoding of username and password joined by a single colon (:)>ein.

Authentifizierung mit einem Trägertoken

Um Ihr Token über die IBM Cloud-CLI abzurufen, melden Sie sich zuerst bei IBM Cloud an und führen Sie dann den folgenden Befehl aus:

ibmcloud iam oauth-tokens

Fügen Sie dieses Token in den Berechtigungsheader der HTTP-Anforderung im Format Bearer <token> ein. Es werden sowohl API-Schlüssel als auch JWT-Token unterstützt.

Mit api_key authentifizieren

Platzieren Sie den Schlüssel direkt als Wert des HTTP-Headers X-Auth-Token .

Nächste Schritte

Eine Beschreibung der API mit Beispielen finden Sie unter Event Streams admin-rest.

Sie können die vollständige Spezifikation für die API von der YAML-Datei der Event Streams Admin-REST-APIherunterladen. Verwenden Sie zum Anzeigen der Swagger-Datei Swagger-Tools, z. B. Swagger editor.