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 2023-03-20 GMT+08:00
Ver PDF
Compartir

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

Función

Esta API se utiliza para actualizar los metadatos del 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, paused o suspended.

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 del BMS.

Puede obtener el ID de BMS desde la consola de BMS o usando la API de Consulta del BMS (API nativa de OpenStack).

Solicitud

  • 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 más detalles, consulte 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 la solicitud 
    1
    		 
    POST https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/metadata

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

Respuesta

  • 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 más detalles, consulte 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 la 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.