Usando a API de REST de administração

O Event Streams fornece uma API de RESTful de administração que você pode usar para criar, excluir, listar e atualizar tópicos.

Deve-se recuperar os detalhes da URL e da credencial necessários para se conectar à API de um objeto de credenciais de serviço ou de uma chave de serviço da instância de serviço. Para obter informações sobre como criar esses objetos, consulte Conectando ao Event Streams.

A URL para o terminal da API é fornecida na propriedade kafka_admin_url.

As credenciais dependem do método de autenticação e três tipos de credenciais são suportados.

Autenticar usando Autorização Básica

Use as propriedades user e api_key dos objetos como o nome do usuário e a senha Coloque esses valores no cabeçalho Authorization da solicitação HTTP no formulário Basic <base64 encoding of username and password joined by a single colon (:)>.

Autenticar usando um token do portador

Para obter seu token usando a CLI do IBM Cloud, primeiro efetue login no IBM Cloud e, em seguida, execute o comando a seguir:

ibmcloud iam oauth-tokens

Coloque este token no cabeçalho de autorização da solicitação de HTTP no formulário Bearer <token>. A chave de API ou os tokens JWT são suportados.

Autenticar usando o api_key

Coloque a chave diretamente como o valor do cabeçalho HTTP X-Auth-Token.

Próximas etapas

Para obter uma descrição da API com exemplos, consulte Event Streams admin-rest.

É possível fazer download da especificação completa para a API por meio do Event Streams arquivo YAML da API de REST do administrador. Para visualizar o arquivo swagger, use ferramentas Swagger, por exemplo, editor Swagger.