Criação de um tópico para uma instância de Kafka
![](https://support.huaweicloud.com/intl/pt-br/api-kafka/public_sys-resources/note_3.0-pt-br.png)
Esta API está desatualizada e pode não ser mantida no futuro. Use a API descrita em Criação de um tópico para uma instância de Kafka.
Função
Essa API é usada para criar um tópico em uma instância do Kafka.
Solicitação
Parâmetros de solicitação
Tabela 2 descreve os parâmetros.
Parâmetro |
Tipo |
Obrigatório |
Descrição |
---|---|---|---|
id |
String |
Sim |
Indica o nome de um tópico. Um nome de tópico consiste de 4 a 64 caracteres, começa com uma letra e contém apenas letras, hífens (-) e sublinhados (_). |
partition |
Integer |
Não |
Indica o número de partições de tópico, que é usado para definir o número de mensagens consumidas simultaneamente. Faixa de valor: 1–100. Valor padrão: 3. |
replication |
Integer |
Não |
Indica o número de réplicas, que é configurado para garantir a confiabilidade dos dados. Faixa de valor: 1–3. Valor padrão: 3. |
sync_replication |
Boolean |
Não |
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. |
retention_time |
Integer |
Não |
Indica o período de retenção de uma mensagem. Seu valor padrão é 72. Faixa de valor: 1–168. Unidade: hora. |
sync_message_flush |
Boolean |
Não |
Indica se o esvaziamento síncrono deve ser ativado. Default value: false. O rubor síncrono compromete o desempenho. |
Exemplos de solicitações
POST https://{dms_endpoint}/v1.0/{project_id}/instances/{instance_id}/topics { "id" : "haha", "partition" : 3, "replication" : 3, "sync_replication " : true, "retention_time" : 10, "sync_message_flush" : true }
Resposta
Parâmetros de resposta
Tabela 3 descreve os parâmetros.
Exemplo de respostas
{ "id": "haha" }
Código de status
Tabela 4 descreve o código de status das operações sucedidas. Para obter detalhes sobre outros códigos de status, consulte Código de status.