Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Actualización más reciente 2022-11-07 GMT+08:00

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.

URI

POST /v1.0/{project_id}/instances/{instance_id}/topics

Tabla 1 describe los parámetros.

Tabla 1 Parámetros

Parámetro

Tipo

Obligatorio

Descripción

project_id

String

Indica el ID de un proyecto.

instance_id

String

Indica el ID de instancia.

Solicitud

Parámetros de solicitud

Tabla 2 describe el parámetro.

Tabla 2 Parámetros de solicitud

Parámetro

Tipo

Obligatorio

Descripción

id

String

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.

Tabla 3 Parámetros de respuesta

Parámetro

Tipo

Descripción

id

String

Indica el nombre de un tema.

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.

Tabla 4 Código de estado

Código de estado

Descripción

200

El tema se ha creado correctamente.