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/ Modificación de metadato del BMS especificado (API nativa de OpenStack)
Actualización más reciente 2025-02-18 GMT+08:00
Ver PDF
Compartir

Modificación de metadato del BMS especificado (API nativa de OpenStack)

Función

Esta API se utiliza para modificar metadato del BMS especificado.

Restricciones

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

URI

PUT /v2.1/{project_id}/servers/{server_id}/metadata/{key}

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 BMSBMS o invocando al Consulta de los BMS (API nativa de OpenStack).

key

Sí

Especifica el valor de clave de metadatos del BMS que se va a modificar.

Parámetros de solicitud

Parámetro

Obligatorio

Tipo

Descripción

meta

Sí

Object

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

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

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

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

Parámetros de respuesta

Parámetro

Tipo

Descripción

meta

Object

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

Parámetro

Tipo

Descripción

User-defined field key and value pair

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.

Ejemplo de respuesta

1
2
3
4
5
 
{
    "meta": {
        "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.