Utilisation de l'API REST d'administration

Event Streams fournit une API RESTful d'administration que vous pouvez utiliser pour créer, supprimer, répertorier et mettre à jour des rubriques.

Pour la connexion à l'API, vous devez extraire l'URL et les données d'identification d'un objet de données d'identification de service ou d'une clé de service de l'instance de service. Pour obtenir des informations sur la création de ces objets, voir Connexion à Event Streams.

L'URL du nœud final de l'API est fournie dans la propriété kafka_admin_url.

Les données d'identification dépendent de la méthode d'authentification et trois types de données d'identification sont pris en charge.

Authentification à l'aide de l'authentification de base

Utilisez les propriétés user et api_key des objets comme nom d'utilisateur et mot de passe. Placez ces valeurs dans l'en-tête Authorization de la requête HTTP au format Basic <base64 encoding of username and password joined by a single colon (:)>.

Authentification à l'aide d'un jeton bearer

Pour obtenir votre jeton à l'aide de l'interface de ligne de commande IBM Cloud, connectez-vous d'abord à IBM Cloud, puis exécutez la commande suivante:

ibmcloud iam oauth-tokens

Placez ce jeton dans l'en-tête d'autorisation de la requête HTTP au format Bearer <token>. La clé d'API et les jetons JWT sont pris en charge.

Authentification à l'aide de la clé d'API

Placez la clé directement en valeur de l'en-tête HTTP X-Auth-Token.

Etapes suivantes

Pour une description de l'API avec des exemples, voir Event Streams admin-rest.

Vous pouvez télécharger la spécification complète de l'API à partir du fichier YAML de l'API REST d'administrationEvent Streams. Pour afficher le fichier swagger, utilisez les outils Swagger, par exemple Swagger editor.