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.
Centro de ayuda/Distributed Message Service for Kafka/Referencia de la API/APIs V2 (Recomendado)/Gestión del ciclo de vida/Reinicio o eliminación de instancias por lotes
Actualización más reciente 2022-11-07 GMT+08:00
Ver PDF
Compartir

Reinicio o eliminación de instancias por lotes

Función

Esta API se utiliza para reiniciar o eliminar instancias en lotes.

Cuando se está reiniciando una instancia, se rechazarán las solicitudes de recuperación y creación de mensajes del cliente.

La eliminación de una instancia se eliminarán los datos de la instancia sin ninguna copia de seguridad. Tenga cuidado cuando realice esta acción.

URI

POST /v2/{project_id}/instances/action

Tabla 1 Parámetros de ruta

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

ID del proyecto.

Parámetros de solicitud

Tabla 2 Parámetros del cuerpo de solicitud

Parámetro

Obligatorio

Tipo

Descripción

instances

No

Matriz de strings

Lista de ID de instancia.

action

Sí

String

Operación a realizar en instancias. El valor se puede restarto delete.

all_failure

No

String

El valor kafka indica que todas las instancias de Kafka que no se crean deben eliminarse.

Parámetros de respuesta

Código de estado: 200

Tabla 3 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

results

Matriz de objetos de resultados

Resultado de la modificación de instancia.

Tabla 4 results

Parámetro

Tipo

Descripción

‏result

String

Resultado de la operación.

  • success: La operación se realizó correctamente.
  • failed: Error en la operación.

instance

String

ID de instancia.

Solicitudes de ejemplo

  • Reinicio de instancias en lotes. 
    POST https://{endpoint}/v2/{project_id}/instances/action

{
  "action" : "restart",
  "instances" : [ "54602a9d-5e22-4239-9123-77e350df4a34", "7166cdea-dbad-4d79-9610-7163e6f8b640" ]
}
  • Eliminación de instancias en lotes. 
    POST https://{endpoint}/v2/{project_id}/instances/action

{
  "action" : "delete",
  "instances" : [ "54602a9d-5e22-4239-9123-77e350df4a34", "7166cdea-dbad-4d79-9610-7163e6f8b640" ]
}
  • Eliminación de todas las instancias que no se han creado. 
    POST https://{endpoint}/v2/{project_id}/instances/action

{
  "action" : "delete",
  "allFailure" : "kafka"
}

Respuestas de ejemplo

Código de estado: 200

Las instancias se reinician o eliminan correctamente.

{
  "results" : [ {
    "result" : "success",
    "instance" : "019cacb7-4ff0-4d3c-9f33-f5f7b7fdc0e6"
  } ]
}

Códigos de estado

Código de estado

Descripción

200

Las instancias se reinician o eliminan correctamente.

Códigos de error

Consulte Códigos de error.