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 de OpenStack Nova/ Gestión del ciclo de vida/ Modificación de información de ECS

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

Modificación de información de ECS

Función

Esta API se utiliza para modificar la información de ECS. Solo se puede modificar el nombre y la descripción de un ECS.

URI

PUT /v2.1/{project_id}/servers/{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 de 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. La longitud es mayor que 0 y menor que 256
description	No	String	Describe el ECS. El valor contiene un máximo de 255 bytes. Este parámetro está soportado en la microversión 2.19 y posteriores.

Respuesta

Tabla 4 describe los parámetros de respuesta.

**Tabla 4** Parámetros de respuesta
Parámetro	Tipo	Descripción
server	Object	Especifica la información de 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 a la que se creó el 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 modificado del ECS.
progress	Integer	Reservada
links	Array of Object	Especifica los vínculos de acceso directo de ECS. Para más detalles, consulte Tabla 8.
id	String	Especifica el identificador único de un ECS.
updated	String	Especifica la hora a 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 el ECS está bloqueado y False cuando el 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 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. 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.

**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. Este parámetro no es compatible con la microversión 2.47 y posteriores.
links	Array of objects	Especifica los enlaces de acceso directo para los tipos de ECS. Para más detalles, consulte Tabla 8. Este parámetro no es compatible con la microversión 2.47 y posteriores.
vcpus	Integer	Especifica el número de vCPU en la variante de ECS. Este parámetro está soportado en la microversión 2.47 y posteriores.
ram	Integer	Especifica el tamaño de memoria (MB) en la variante de ECS. Este parámetro está soportado en la microversión 2.47 y posteriores.
disk	Integer	Especifica el tamaño del disco del sistema en la variante de ECS. El valor 0 indica que el tamaño del disco no está limitado. Este parámetro está soportado en la microversión 2.47 y posteriores.
ephemeral	Integer	Reservada Este parámetro está soportado en la microversión 2.47 y posteriores.
swap	Integer	Reservada Este parámetro está soportado en la microversión 2.47 y posteriores.
original_name	String	Especifica el nombre de la variante de ECS. Este parámetro está soportado en la microversión 2.47 y posteriores.
extra_specs	Object	Indica un campo de variante extendida. Para obtener más información, consulte Descripción del campo os_extra_specs (variante). Este parámetro está soportado en la microversión 2.47 y posteriores.

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

Ejemplo de la solicitud

PUT https://{endpoint}/v2.1/{project_id}/servers/{server_id}

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

Ejemplo de la respuesta

{
  "server": {
    "tenant_id": "7910a6e50b80402ba028c8d96c1b31fe",
    "image": "",
    "accessIPv4": "",
    "addresses": {
      "03be5c1e-e05d-4905-a105-c3bd9b730bdc": [
        {
          "addr": "192.168.0.72",
          "version": 4
        }
      ]
    },
    "metadata": {},
    "accessIPv6": "",
    "created": "2018-05-17T03:15:48Z",
    "hostId": "7dc82f6b1d406200fc63e395cf4829cbffcb49de0e9c75c5773f201f",
    "flavor": {
      "links": [
        {
          "rel": "bookmark",
          "href": "https://None/7910a6e50b80402ba028c8d96c1b31fe/flavors/c3.1U1G"
        }
      ],
      "id": "c3.1U1G"
    },
    "OS-DCF:diskConfig": "MANUAL",
    "user_id": "d698a78532ca430f8daec1858f2b500e",
    "name": "new-server-test",
    "progress": 0,
    "links": [
      {
        "rel": "self",
        "href": "https://None/v2/7910a6e50b80402ba028c8d96c1b31fe/servers/1a19ef4f-be0a-4526-bf2f-14b4464d536a"
      },
      {
        "rel": "bookmark",
        "href": "https://None/7910a6e50b80402ba028c8d96c1b31fe/servers/1a19ef4f-be0a-4526-bf2f-14b4464d536a"
      }
    ],
    "id": "1a19ef4f-be0a-4526-bf2f-14b4464d536a",
    "updated": "2018-05-21T00:36:27Z",
    "status": "ACTIVE"
  }
}