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/ Cloud Container Engine/ Referência de API/ APIs/ Gerenciamento de nó/ Remoção de um nó

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

Ver PDF

Remoção de um nó

Função

Essa API é usada para remover um nó em um cluster especificado.

O URL para gerenciamento de cluster está no formato https://Endpoint/uri. No URL, uri indica o caminho do recurso, ou seja, o caminho para o acesso à API.

URI

PUT /api/v3/projects/{project_id}/clusters/{cluster_id}/nodes/operation/remove

**Tabela 1** Parâmetros de caminho
Parâmetro	Obrigatório	Tipo	Descrição
project_id	Sim	String	ID do projeto. Para obter detalhes sobre como obter o valor, consulte Como obter parâmetros no URI da API.
cluster_id	Sim	String	ID do cluster. Para obter detalhes sobre como obter o valor, consulte Como obter parâmetros no URI da API.

Parâmetros de solicitação

**Tabela 2** Parâmetros de cabeçalho de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
Content-Type	Sim	String	Tipo de corpo da mensagem (formato).
X-Auth-Token	Sim	String	As solicitações para chamar uma API podem ser autenticadas usando um token ou AK/SK. Se a autenticação baseada em token for usada, esse parâmetro é obrigatório e deve ser definido como um token de usuário. Para obter detalhes, consulte Obtenção de um token de usuário.

**Tabela 3** Parâmetros do corpo da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
apiVersion	Não	String	Versão da API. O valor é fixado em v3.
kind	Não	String	Tipo de API. O valor é fixado em RemoveNodesTask.
spec	Sim	RemoveNodesSpec object	Informações de configuração.
status	Não	TaskStatus object	Status da tarefa.

**Tabela 4** RemoveNodesSpec
Parâmetro	Obrigatório	Tipo	Descrição
login	Sim	Login object	Modo de logon do nó. O par de chaves ou a senha devem ser usados para o logon.
nodes	Sim	Array of NodeItem objects	Lista de nós a serem operados.

**Tabela 5** Login
Parâmetro	Obrigatório	Tipo	Descrição
sshKey	Não	String	Nome do par de chaves usado para logon.
userPassword	Não	UserPassword object	Senha usada para logon do nó.

**Tabela 6** UserPassword
Parâmetro	Obrigatório	Tipo	Descrição
username	Não	String	Conta de logon. O padrão é root.
password	Sim	String	Se um nome de usuário e uma senha forem usados para criar um nó, esse campo será blindado no corpo da resposta. Uma senha deve atender aos seguintes requisitos de complexidade: Contém de 8 a 26 caracteres. Contém pelo menos três dos seguintes tipos de caracteres: letras maiúsculas, minúsculas, dígitos e caracteres especiais (!@$%^-_=+[{}]:,./?~#) Não pode conter o nome de usuário ou o nome de usuário escrito ao contrário. O campo password* deve ser salgado durante a criação do nó. Para obter detalhes, consulte Adição de um sal no campo de senha ao criar um nó.

**Tabela 7** NodeItem
Parâmetro	Obrigatório	Tipo	Descrição
uid	Sim	String	ID do nó.

**Tabela 8** TaskStatus
Parâmetro	Obrigatório	Tipo	Descrição
jobID	Não	String	ID da tarefa, que é usado pelo chamador para consultar o andamento da tarefa.

Parâmetros de resposta

Código de status: 200

**Tabela 9** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
apiVersion	String	Versão da API. O valor é fixado em v3.
kind	String	Tipo de API. O valor é fixado em RemoveNodesTask.
spec	RemoveNodesSpec object	Informações de configuração.
status	TaskStatus object	Status da tarefa.

**Tabela 10** RemoveNodesSpec
Parâmetro	Tipo	Descrição
login	Login object	Modo de logon do nó. O par de chaves ou a senha devem ser usados para o logon.
nodes	Array of NodeItem objects	Lista de nós a serem operados.

**Tabela 11** Login
Parâmetro	Tipo	Descrição
sshKey	String	Nome do par de chaves usado para logon.
userPassword	UserPassword object	Senha usada para logon do nó.

**Tabela 12** UserPassword
Parâmetro	Tipo	Descrição
username	String	Conta de logon. O padrão é root.
password	String	Se um nome de usuário e uma senha forem usados para criar um nó, esse campo será blindado no corpo da resposta. Uma senha deve atender aos seguintes requisitos de complexidade: Contém de 8 a 26 caracteres. Contém pelo menos três dos seguintes tipos de caracteres: letras maiúsculas, minúsculas, dígitos e caracteres especiais (!@$%^-_=+[{}]:,./?~#) Não pode conter o nome de usuário ou o nome de usuário escrito ao contrário. O campo password* deve ser salgado durante a criação do nó. Para obter detalhes, consulte Adição de um sal no campo de senha ao criar um nó.

**Tabela 13** NodeItem
Parâmetro	Tipo	Descrição
uid	String	ID do nó.

**Tabela 14** TaskStatus
Parâmetro	Tipo	Descrição
jobID	String	ID da tarefa, que é usado pelo chamador para consultar o andamento da tarefa.

Exemplo de solicitações

Remoção de um nó

PUT /api/v3/projects/{project_id}/clusters/{cluster_id}/nodes/operation/remove

{
  "spec" : {
    "login" : {
      "sshKey" : "KeyPair-001"
    },
    "nodes" : [ {
      "uid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    }, {
      "uid" : "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"
    } ]
  }
}

Exemplo de respostas

Código de status: 200

A tarefa para remover um nó em um cluster especificado é entregue com êxito.

{
  "spec" : {
    "login" : {
      "sshKey" : "KeyPair-001"
    },
    "nodes" : [ {
      "uid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    }, {
      "uid" : "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"
    } ]
  },
  "status" : {
    "jobID" : "2ec9b78d-9368-46f3-8f29-d1a95622a568"
  }
}