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/ Elastic Cloud Server/ Referencia de la API/ API (recomendado)/ Gestión del ciclo de vida/ Modificación de un ECS

Actualización más reciente 2022-11-08 GMT+08:00

Modificación de un ECS

Función

Esta API se utiliza para modificar la información de ECS. Solo el nombre, la descripción y el nombre de host de un ECS se pueden modificar actualmente.

Restricciones

Después de cambiar el nombre de host de un ECS, debe reiniciar el ECS para que la configuración surta efecto.

URI

PUT /v1/{project_id}/cloudservers/{server_id}

Tabla 1 describe los parámetros en el URI.

**Tabla 1** Descripción del parámetro
Parámetro	Obligatorio	Descripción
project_id	Sí	Especifica el ID del proyecto. Para obtener más información sobre cómo obtener el ID, consulte Obtención de un ID de proyecto.
server_id	Sí	Especifica el ID de ECS.

Solicitud

Tabla 2 describe los parámetros de solicitud.

**Tabla 2** Parámetros de solicitud
Parámetro	Obligatorio	Tipo	Descripción
server	Sí	Object	Especifica la estructura de datos ECS. Para más detalles, consulte Tabla 3.

**Tabla 3** Descripción del campo **server**
Parámetro	Obligatorio	Tipo	Descripción
name	No	String	Especifica el nombre del ECS modificado. El valor del parámetro consta de 1 a 64 caracteres, incluyendo letras, dígitos, guiones bajos (_), guiones (-), puntos (.).
description	No	String	Describe el ECS. El valor consta de 0-85 caracteres y no puede contener corchetes (<>).
hostname	No	String	Especifica el nombre de host de ECS. El nombre consta de 1-64 caracteres. Se puede segmentar usando periodos (.). Solo se permiten letras, dígitos y guiones (-) en cada segmento. Un nombre no puede contener (.) de puntos consecutivos ni guiones (-) y no puede comenzar ni terminar con un (.) de punto ni un guion (-). Además, no se permiten las combinaciones de (.-) y (-.).

Respuesta

Tabla 4 describe los parámetros de respuesta.

**Tabla 4** Parámetros de respuesta
Parámetro	Tipo	Descripción
server	Object	Especifica el ECS. Para más detalles, consulte Tabla 5.

**Tabla 5** Descripción del campo **server**
Parámetro	Tipo	Descripción
tenant_id	String	Especifica el ID del tenant o del proyecto.
image	String	Especifica el ID de imagen.
accessIPv4	String	Reservada
addresses	Object	Especifica la información de red atribuida al ECS. La estructura es Map<String, Object>. Para más detalles, consulte Tabla 6.
metadata	Object	Especifica los metadatos de ECS.
accessIPv6	String	Reservada
created	String	Especifica la hora en la que se creó ECS. El tiempo está en el formato de "2019-05-22T03:19:19Z".
hostId	String	Especifica el ID de host del ECS.
flavor	Object	Especifica la variante de ECS. Para más detalles, consulte Tabla 7.
OS-DCF:diskConfig	String	Especifica el modo de configuración del disco. Este es un atributo extendido. Este campo es válido para los ECS iniciados usando una imagen.
user_id	String	Especifica el ID del usuario al que pertenece un ECS.
name	String	Especifica el nombre del ECS modificado.
progress	Integer	Reservada
links	Array of Object	Especifica los vínculos de acceso directo de ECS para ECS. Para más detalles, consulte Tabla 8.
id	String	Especifica el identificador único de un ECS.
updated	String	Especifica la hora en la que se actualizó el ECS la última vez. El tiempo está en el formato de "2019-05-22T03:19:19Z".
locked	Boolean	Especifica el estado de bloqueo de ECS, que es True cuando ECS está bloqueado y False cuando ECS está desbloqueado. Este parámetro está soportado en la microversión 2.9 y posteriores.
description	String	Describe el ECS. Este parámetro está soportado en la microversión 2.19 y posteriores.
tags	Array of strings	Especifica las etiquetas de ECS. Este parámetro está soportado en la microversión 2.26 y posteriores. Si la microversión no se utiliza para la consulta, la respuesta no contiene el campo tags. Las funciones de etiqueta se han actualizado en la nube pública. Después de la actualización, los valores de etiqueta devueltos por el sistema cumplen las siguientes reglas: La clave y el valor de una etiqueta se conectan usando un signo igual (=), por ejemplo, clave=valor. Si el valor está vacío, solo se devuelve la clave.
status	String	Especifica el estado de ECS. Opciones: ACTIVE, BUILD, ERROR, HARD_REBOOT, MIGRATING, REBOOT, RESIZE, REVERT_RESIZE, SHELVED, SHELVED_OFFLOADED, SHUTOFF, UNKNOWN, y VERIFY_RESIZE Para más detalles, consulte Estados de ECS.
OS-EXT-SRV-ATTR:hostname	String	Especifica el nombre de host de ECS.

**Tabla 6** Estructura de datos de la red a la que accede un ECS
Parámetro	Tipo	Descripción
addr	String	Especifica la dirección IP.
version	Integer	Especifica el tipo de dirección IP. El valor de este parámetro puede ser 4 o 6. 4: El tipo de dirección IP es IPv4. 6: El tipo de dirección IP es IPv6.

**Tabla 7** Descripción del campo **flavor**
Parámetro	Tipo	Descripción
id	String	Especifica el ID de ECS.
links	Array of objects	Especifica los enlaces de acceso directo para los tipos de ECS. Para más detalles, consulte Tabla 8.

**Tabla 8** Descripción del campo **links**
Parámetro	Tipo	Descripción
rel	String	Especifica el nombre del marcador de vínculo de acceso directo.
href	String	Proporciona el vínculo de acceso directo.

Ejemplo de la solicitud

PUT  https://{endpoint}/v1/{project_id}/cloudservers/{server_id}

{
    "server": {
        "name": "new-server-test"
    }
}

Ejemplo de la respuesta

{
  "server": {
    "tenant_id": "66c860cb130b465fbafcdee43fb09c64",
    "image": "",
    "accessIPv4": "",
    "addresses": {
      "01d7aef8-442b-408e-b82f-13afff51e4e4": [
        {
          "addr": "192.168.26.22",
          "version": 4
        }
      ]
    },
    "metadata": {
      "virtual_env_type": "FusionCompute"
    },
    "description": "",
    "accessIPv6": "",
    "created": "2019-04-25T11:52:53Z",
    "hostId": "57d278e7c53d07cd34fad3ba4fdc9f3d779017d0879726d83b45a22a",
    "OS-EXT-SRV-ATTR:hostname": "new-test-hostname",
    "flavor": {
      "links": [
        {
          "rel": "bookmark",
          "href": "https://None/66c860cb130b465fbafcdee43fb09c64/flavors/s2.large.2"
        }
      ],
      "id": "s2.large.2"
    },
    "OS-DCF:diskConfig": "MANUAL",
    "user_id": "f88581d53be64716a985c66ca28c75f6",
    "name": "new-test-hostname",
    "progress": 0,
    "links": [
      {
        "rel": "self",
        "href": "https://None/v2/66c860cb130b465fbafcdee43fb09c64/servers/24930df0-db4c-4a8b-8914-d0bd558564b0"
      },
      {
        "rel": "bookmark",
        "href": "https://None/66c860cb130b465fbafcdee43fb09c64/servers/24930df0-db4c-4a8b-8914-d0bd558564b0"
      }
    ],
    "id": "24930df0-db4c-4a8b-8914-d0bd558564b0",
    "updated": "2019-04-28T08:15:36Z",
    "status": "ACTIVE"
  }
}