Creación de un tema para una instancia de Kafka
Función
Esta API se utiliza para crear un tema para una instancia de Kafka.
URI
POST /v2/{project_id}/instances/{instance_id}/topics
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| project_id | Sí | String | ID del proyecto. |
| instance_id | Sí | String | ID de la instancia |
Parámetros de solicitud
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| id | Sí | String | Nombre del tema, que consta de 4 a 64 caracteres, comienza con una letra y contiene solo letras, guiones (-), guiones bajos (_), y dígitos. |
| replication | No | Integer | Número de réplicas, que se configura para garantizar la fiabilidad de los datos. Rango de valores: 1 a 3. |
| sync_message_flush | No | Boolean | Si el vaciado síncrono está habilitado. El valor predeterminado es false. El lavado síncrono compromete el rendimiento. |
| partition | No | Integer | Número de particiones de tema, que se utiliza para establecer el número de mensajes consumidos simultáneamente. Rango de valores: 1–100. |
| sync_replication | No | Boolean | Si la replicación síncrona está habilitada. 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. |
| retention_time | No | Integer | Período de retención de mensajes. El valor predeterminado es 72. Rango de valores: 1–168. Unidad: hora. |
Parámetros de respuesta
Código de estado: 200
| Parámetro | Tipo | Descripción |
|---|---|---|
| name | String | Nombre del tema |
Ejemplo de las solicitudes
POST https://{endpoint}/v2/{project_id}/instances/{instance_id}/topics
{
"id" : "kafka01"
} Ejemplo de las respuestas
Código de estado: 200
La creación se realiza correctamente.
{
"name" : "kafka01"
} Códigos de estado
| Código de estado | Descripción |
|---|---|
| 200 | La creación se realiza correctamente. |
Códigos de error
Consulte Códigos de error.
