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.
