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.
Actualización más reciente 2022-11-08 GMT+08:00

Actualización de metadatos de ECS

Función

Esta API se utiliza para actualizar metadatos de ECS.

  • Si los metadatos no contienen el campo de destino, el campo se agrega automáticamente.
  • Si los metadatos contienen el campo de destino, el valor del campo se actualiza automáticamente.
  • Si no se solicita el campo de los metadatos, el valor del campo permanece sin cambios.

Restricciones

Un ECS debe estar en estado activo, detenido, pausado o suspendido, que se especifica mediante OS-EXT-STS:vm_state.

URI

POST /v1/{project_id}/cloudservers/{server_id}/metadata

Tabla 1 Descripción del parámetro

Parámetro

Obligatorio

Descripción

project_id

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

Especifica el ID de ECS.

Solicitud

Tabla 2 Parámetros de solicitud

Parámetro

Obligatorio

Tipo

Descripción

metadata

Object

Especifica el par clave-valor de metadatos definido por el usuario.

La estructura de datos puede estar vacía. Si el valor está vacío, los datos no se actualizan.

Para una etiqueta de metadatos:

Contiene un máximo de 255 caracteres Unicode y no se puede dejar en blanco. Una etiqueta puede contener letras mayúsculas (A-Z), minúsculas (a-z), dígitos (0-9), guiones (-) guiones bajos (_), dos puntos (:), y puntos (.).

Para un valor de metadatos:

Contiene un máximo de 255 caracteres Unicode.

Respuesta

Tabla 3 Descripción del parámetro

Parámetro

Type

Descripción

metadata

Object

Especifica el par clave-valor de metadatos definido por el usuario.

Ejemplo de la solicitud

POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/metadata
{
    "metadata": {
        "key": "value"
    }
}

Ejemplo de la respuesta

{
    "metadata":{
        "key":"value"
    }
}