Creación de un tema en una instancia de Kafka
Esta API está desactualizada y es posible que no se mantenga en el futuro. Utilice la API descrita en Creación de un tema para una instancia de Kafka.
Función
Esta API se utiliza para crear un tema en una instancia de Kafka.
Solicitud
Parámetros de solicitud
Tabla 2 describe el parámetro.
Parámetro |
Tipo |
Obligatorio |
Descripción |
---|---|---|---|
id |
String |
Sí |
Indica el nombre de un tema. Un nombre de tema consta de 4 a 64 caracteres, comienza con una letra y contiene solo letras, guiones (-), guiones bajos (_), y dígitos. |
partition |
Integer |
No |
Indica el número de particiones de tema, que se utiliza para establecer el número de mensajes consumidos simultáneamente. Rango de valores: 1–100. Valor predeterminado: 3. |
replication |
Integer |
No |
Indica el número de réplicas, que se configura para garantizar la fiabilidad de los datos. Rango de valores: 1–3. Valor predeterminado: 3. |
sync_replication |
Boolean |
No |
Indica si se debe habilitar la replicación síncrona. Después de activar esta función, el parámetro acks en el cliente productor debe establecerse en –1. En caso contrario, este parámetro no tiene efecto. De forma predeterminada, la replicación síncrona está deshabilitada. |
retention_time |
Integer |
No |
Indica el período de retención de un mensaje. Su valor predeterminado es 72. Rango de valores: 1–168. Unidad: hora. |
sync_message_flush |
Boolean |
No |
Indica si se activa el vaciado síncrono. Valor predeterminado: false. El lavado síncrono compromete el rendimiento. |
Solicitud de ejemplo
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 }
Respuesta
Parámetros de respuesta
Tabla 3 describe el parámetro.
Ejemplo de respuesta
{ "id": "haha" }
Código de estado
Tabla 4 describe el código de estado de las operaciones exitosas. Para obtener más información sobre el código de estado, consulte Código de estado.