Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Distributed Message Service for Kafka/ Referência de API/ APIs desatualizadas/ API V1/ APIs para gerenciamento de instâncias/ Consulta de um tópico em uma instância de Kafka

Atualizado em 2024-09-10 GMT+08:00

Ver PDF

Consulta de um tópico em uma instância de Kafka

Esta API está desatualizada e pode não ser mantida no futuro. Use a API descrita em Lista dos tópicos de uma instância de Kafka.

Função

Essa API é usada para consultar detalhes sobre um tópico em uma instância de Kafka.

URI

GET /v1.0/{project_id}/instances/{instance_id}/topics

Tabela 1 descreve os parâmetros.

**Tabela 1** Parâmetros
Parâmetro	Tipo	Obrigatório	Descrição
project_id	String	Sim	Indica a ID de um projeto.
instance_id	String	Sim	Indica o ID da instância.

Solicitação

Parâmetros de solicitação

Nenhum.

Exemplos de solicitações

GET https://{dms_endpoint}/v1.0/{project_id}/instances/{instance_id}/topics

Resposta

Parâmetros de resposta

Tabela 2 descreve os parâmetros de resposta.

**Tabela 2** Parâmetro de resposta
Parâmetro	Tipo	Descrição
total	Integer	Indica o número total de tópicos.
size	Integer	Indica o número máximo de registros a serem exibidos em uma página.
remain_partitions	Integer	Indica o número de partições restantes.
max_partitions	Integer	Indica o número total de partições.
topics	Array	Indica a lista de tópicos.

**Tabela 3** Descrição do parâmetro
Parâmetro	Tipo	Descrição
policiesOnly	Boolean	Se esta política é a política padrão.
id	String	Indica o nome do tópico.
replication	Integer	Indica o número de réplicas, que é configurado para garantir a confiabilidade dos dados.
partition	Integer	Indica o número de partições de tópico, que é usado para definir o número de mensagens consumidas simultaneamente.
retention_time	Integer	Indica o período de retenção de uma mensagem.
sync_replication	Boolean	Indica se a replicação síncrona deve ser ativada. Depois que essa função for ativada, o parâmetro acks no cliente do produtor deve ser definido como –1. Caso contrário, esse parâmetro não terá efeito. Por predefinição, a replicação síncrona está desactivada.
sync_message_flush	Boolean	Indica se o esvaziamento síncrono deve ser ativado. O rubor síncrono compromete o desempenho.
external_configs	Object	Indica a configuração estendida.
topic_type	Integer	Indica o tipo de tópico.

Exemplo de respostas

{
 "count": 1,
 "topics": [
  {
   "id": "topic-test",
   "replication": 3,
   "partition": 4,
   "retention_time": 72,
   "sync_replication": "false",
   "sync_message_flush": "false"
  }
 ]
}