Criação de um tópico em uma instância do Kafka
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. O nome de um tópico tem de 4 a 64 caracteres, começa com uma letra e contém apenas letras, hifens (-), sublinhados (_) e dígitos. |
| 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. Intervalo de valores: 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. Intervalo de valores: 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 padrão, a replicação síncrona está desativada. |
| retention_time | Integer | Não | Indica o período de retenção de uma mensagem. Seu valor padrão é 72. Intervalo de valores: 1–720. Unidade: hora. |
| sync_message_flush | Boolean | Não | Indica se a liberação síncrona deve ser ativada. Valor padrão: false. A liberação síncrona 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 bem-sucedidas. Para obter detalhes sobre outros códigos de status, consulte Código de status.
