Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Distributed Message Service for Kafka/ Referência de API/ APIs desatualizadas/ API V1/ APIs para gerenciamento de instâncias/ Reinicialização ou exclusão de instâncias em lote

Atualizado em 2024-09-10 GMT+08:00

Ver PDF

Reinicialização ou exclusão de instâncias em lote

Esta API está desatualizada e pode não ser mantida no futuro. Use a API descrita em Reiniciação ou exclusão das instâncias em lote.

Função

Essa API é usada para reiniciar ou excluir instâncias em lote.

Quando uma instância estiver sendo reiniciada, as solicitações de recuperação e criação de mensagens do cliente serão rejeitadas.

A exclusão de uma instância excluirá os dados na instância sem nenhum backup. Tenha cuidado ao realizar esta operação.

URI

POST /v1.0/{project_id}/instances/action

Tabela 1 descreve os parâmetros.

**Tabela 1** Parâmetros
Parâmetro	Tipo	Obrigatório	Descrição
project_id	String	Sim	Indica a ID de um projeto.

Solicitação

Parâmetros de solicitação

Tabela 2 descreve os parâmetros.

**Tabela 2** Parâmetros de solicitação
Parâmetro	Tipo	Obrigatório	Descrição
action	String	Sim	Indica a operação a ser executada nas instâncias. O valor deste parâmetro pode ser restart ou delete.
instances	Array	Não	Indica a lista dos ID de instância.
allFailure	String	Não	Quando definido como kafka, indica que todas as instâncias de Kafka que não forem criadas serão excluídas.

Exemplos de solicitações

Reiniciação das instâncias em lote

POST https://{dms_endpoint}/v1.0/{project_id}/instances/action
{ 
    "action" : "restart", 
    "instances" : ["54602a9d-5e22-4239-9123-77e350df4a34", "7166cdea-dbad-4d79-9610-7163e6f8b640"] 
}

Exclusão das instâncias em lote

POST https://{dms_endpoint}/v1.0/{project_id}/instances/action
{ 
    "action" : "delete", 
    "instances" : ["54602a9d-5e22-4239-9123-77e350df4a34", "7166cdea-dbad-4d79-9610-7163e6f8b640"] 
}

Exclusão de todas as instâncias de Kafka que não foram criadas

POST https://{dms_endpoint}/v1.0/{project_id}/instances/action
{ 
    "action" : "delete", 
    "allFailure" : "kafka"
}

Resposta

Parâmetros de resposta

Quando action é definida como delete, allFailure é definida como kafka e uma resposta vazia é retornada, as instâncias são excluídas com sucesso. Tabela 3 descreve os parâmetros.

**Tabela 3** Parâmetros de resposta
Parâmetro	Tipo	Descrição
results	Array	Indica o resultado da modificação da instância.

**Tabela 4** descrição do parâmetro de resultados
Parâmetro	Tipo	Descrição
instance	String	Indica o ID da instância.
result	String	Indica um resultado da operação, que pode ser success ou failed

Exemplo de respostas

{ 
    "results": [ 
        { 
            "result": "success", 
            "instance": "afc90a2a-a02c-4cba-94d5-58dfa9ad1e0d" 
        }, 
        { 
            "result": "success", 
            "instance": "67fc5f8d-3986-4f02-bb75-4075a23112de" 
        } 
    ] 
}