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/ Bare Metal Server/ Referencia de la API/ API nativa de Nova V2.1 de OpenStack/ Gestión de metadatos de BMS/ Actualización de metadatos del BMS (API nativa de OpenStack)
Actualización más reciente 2025-02-18 GMT+08:00
Ver PDF
Compartir

Actualización de metadatos del BMS (API nativa de OpenStack)

Función

Esta API se utiliza para actualizar metadatos de BMS.

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

Restricciones

El atributo OS-EXT-STS:vm_state de BMS (estado de BMS) debe ser active, stopped o paused.

URI

POST /v2.1/{project_id}/servers/{server_id}/metadata

Tabla 1 enumera los parámetros.

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 del proyecto, consulte Obtención de un ID de proyecto.

server_id

Sí

Especifica el ID de BMS.

Puede obtener el ID de BMS desde la consola de BMSBMS o invocando al Consulta de los BMS (API nativa de OpenStack).

Parámetros de solicitud

Parámetro

Obligatorio

Tipo

Descripción

metadata

Sí

Object

Especifica el par de valores y clave de los metadatos definidos por el usuario. Para obtener más información, véase Tabla 2.
Tabla 2 Descripción de la estructura de datos de campo metadata

Parámetro

Obligatorio

Tipo

Descripción

User-defined field key and value pair

Sí

String

Especifica el par de valores y clave de los metadatos definidos por el usuario.

  • Cada clave o valor contiene un máximo de 255 caracteres.
  • La clave no admite los siguientes caracteres especiales:

    :`~!@#$%^&*()=+<,>?/'";{[]}|\

  • El valor no admite los siguientes caracteres especiales:

    \"

Ejemplo de solicitud

Actualización de los metadatos de un BMS (ID: 95bf2490-5428-432c-ad9b-5e3406f869dd) para personalizar un par de clave-valor 
1
 
POST https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/metadata

1
2
3
4
5
 
{
    "metadata": {
        "key": "value"
    }
}

Parámetros de respuesta

Parámetro

Tipo

Descripción

metadata

Object

Especifica el par de valores y clave de los metadatos definidos por el usuario. Para obtener más información, véase Tabla 3.
Tabla 3 Descripción de la estructura de datos de campo metadata

Parámetro

Tipo

Descripción

User-defined field key and value pair

String

Especifica el par de clave y valor de los metadatos.

  • Cada clave o valor contiene un máximo de 255 caracteres.
  • El valor no admite los siguientes caracteres especiales:

    \"

Ejemplo de respuesta

1
2
3
4
5
 
{
    "metadata": {
        "key": "value"
    }
    }

Valores devueltos

Valores normales

Valores devueltos

Descripción

200

La solicitud se ha procesado correctamente.

Para obtener más información sobre otros valores devueltos, consulte Códigos de estado.

Códigos de error

Véase Códigos de error.