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/ Cloud Container Engine/ Referencia de la API/ API/ Gestión de nodos/ Extracción de un nodo

Actualización más reciente 2023-04-13 GMT+08:00

Ver PDF

Extracción de un nodo

Función

Esta API se utiliza para eliminar un nodo de un clúster especificado.

El URL para la gestión de clústeres tiene el formato https://Endpoint/uri. En el URL, uri indica la ruta del recurso, es decir, la ruta para el acceso a la API.

URI

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

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID del proyecto. Para obtener más información sobre cómo obtener el valor, consulta Cómo obtener parámetros en el URI de API.
cluster_id	Sí	String	ID del clúster. Para obtener más información sobre cómo obtener el valor, consulta Cómo obtener parámetros en el URI de API.

Parámetros de solicitud

**Tabla 2** Parámetros de cabecera de solicitud
Parámetro	Obligatorio	Tipo	Descripción
Content-Type	Sí	String	Tipo de cuerpo del mensaje (formato).
X-Auth-Token	Sí	String	Las solicitudes para invocar a una API pueden autenticarse usando un token o AK/SK. Si se utiliza la autenticación basada en token, este parámetro es obligatorio y se debe establecer en un token de usuario. Para obtener más información, consulte Obtención de un token de usuario.

**Tabla 3** Parámetros del cuerpo de solicitud
Parámetro	Obligatorio	Tipo	Descripción
apiVersion	No	String	Versión de la API. El valor se fija en v3.
kind	No	String	Tipo de la API. El valor se fija en RemoveNodesTask.
spec	Sí	Objeto de RemoveNodesSpec	Información de configuración.
status	No	Objeto de TaskStatus	Estado del trabajo.

**Tabla 4** RemoveNodesSpec
Parámetro	Obligatorio	Tipo	Descripción
login	Sí	Objeto de Login	Modo de inicio de sesión de nodo. Se debe usar el par de claves o la contraseña para iniciar sesión.
nodes	Sí	Matriz de objetos de NodeItem	Lista de nodos a operar.

**Tabla 5** Login
Parámetro	Obligatorio	Tipo	Descripción
sshKey	No	String	Nombre del par de claves utilizado para el inicio de sesión.
userPassword	No	Objeto de UserPassword	Contraseña utilizada para el inicio de sesión del nodo.

**Tabla 6** UserPassword
Parámetro	Obligatorio	Tipo	Descripción
username	No	String	La cuenta para iniciar sesión en. El valor predeterminado es root.
password	Sí	String	Si se utiliza un nombre de usuario y una contraseña para crear un nodo, este campo está protegido en el cuerpo de la respuesta. Una contraseña debe cumplir con los siguientes requisitos de complejidad: Contiene de 8 a 26 caracteres. Debe contener al menos tres de los siguientes tipos de caracteres: letras mayúsculas y minúsculas, dígitos y caracteres especiales (!@$%^-_=+[{}]:,./?~#) No puede contener el nombre de usuario ni el nombre de usuario escrito al revés. El campo password* debe estar salteado durante la creación del nodo. Para obtener más información, consulte la sección Adición de una sal en el campo de contraseña al crear un nodo.

**Tabla 7** NodeItem
Parámetro	Obligatorio	Tipo	Descripción
uid	Sí	String	ID del nodo.

**Tabla 8** TaskStatus
Parámetro	Obligatorio	Tipo	Descripción
jobID	No	String	ID del trabajo, que es utilizado por el llamante para consultar el progreso del trabajo.

Parámetros de respuesta

Código de estado: 200

**Tabla 9** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
apiVersion	String	Versión de la API. El valor se fija en v3.
kind	String	Tipo de la API. El valor se fija en RemoveNodesTask.
spec	Objeto de RemoveNodesSpec	Información de configuración.
status	Objeto de TaskStatus	Estado del trabajo.

**Tabla 10** RemoveNodesSpec
Parámetro	Tipo	Descripción
login	Objeto de Login	Modo de inicio de sesión de nodo. Se debe usar el par de claves o la contraseña para iniciar sesión.
nodes	Matriz de objetos de NodeItem	Lista de nodos a operar.

**Tabla 11** Login
Parámetro	Tipo	Descripción
sshKey	String	Nombre del par de claves utilizado para el inicio de sesión.
userPassword	Objeto de UserPassword	Contraseña utilizada para el inicio de sesión del nodo.

**Tabla 12** UserPassword
Parámetro	Tipo	Descripción
username	String	La cuenta para iniciar sesión en. El valor predeterminado es root.
password	String	Si se utiliza un nombre de usuario y una contraseña para crear un nodo, este campo está protegido en el cuerpo de la respuesta. Una contraseña debe cumplir con los siguientes requisitos de complejidad: Contiene de 8 a 26 caracteres. Debe contener al menos tres de los siguientes tipos de caracteres: letras mayúsculas y minúsculas, dígitos y caracteres especiales (!@$%^-_=+[{}]:,./?~#) No puede contener el nombre de usuario ni el nombre de usuario escrito al revés. El campo password* debe estar salteado durante la creación del nodo. Para obtener más información, consulte la sección Adición de una sal en el campo de contraseña al crear un nodo.

**Tabla 13** NodeItem
Parámetro	Tipo	Descripción
uid	String	ID del nodo.

**Tabla 14** TaskStatus
Parámetro	Tipo	Descripción
jobID	String	ID del trabajo, que es utilizado por el llamante para consultar el progreso del trabajo.

Ejemplo de las solicitudes

Extracción de un nodo

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"
    } ]
  }
}

Ejemplo de las respuestas

Código de estado: 200

El trabajo para eliminar un nodo en un clúster especificado se entrega correctamente.

{
  "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"
  }
}