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 etiquetas 1D del BMS/ Adición de etiquetas para un BMS (API nativa de OpenStack)
Actualización más reciente 2025-02-18 GMT+08:00
Ver PDF
Compartir

Adición de etiquetas para un BMS (API nativa de OpenStack)

Función

Esta API se utiliza para agregar etiquetas para un BMS.

Se requiere que utilice el encabezado de HTTP X-OpenStack-Nova-API-Version: 2.26 para especificar la versión micro en el cliente.

Restricciones

Un BMS puede tener un máximo de 50 etiquetas.
  • Se recomienda agregar la etiqueta __type_baremetal a los BMS para distinguir los BMS de los ECS. De lo contrario, los BMS solo estarán disponibles en la consola de ECS.
  • Una nueva etiqueta sobrescribirá la existente. Si desea conservar la etiqueta original, agréguela a la lista de etiquetas nuevas. Se recomienda agregar __type_baremetal a la lista de etiquetas agregadas cada vez que agregue una etiqueta.

URI

PUT /v2.1/{project_id}/servers/{server_id}/tags

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

tags

Sí

Array of strings
  • Especifica las etiquetas que se van a agregar. Cada etiqueta puede contener un máximo de 80 caracteres.
  • La etiqueta no puede comenzar con un punto (.).
  • Un BMS puede tener un máximo de 50 etiquetas.
  • No se puede crear una etiqueta vacía.

Ejemplo de solicitud

Adición de las etiquetas baz, foo y qux para un BMS (Número: 53206ed0-56de-4d6b-b7ee-ffc62ca26f43) 
1
 
PUT https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers/53206ed0-56de-4d6b-b7ee-ffc62ca26f43/tags

1
2
3
4
5
6
7
 
{
    "tags": [
        "baz",
        "foo",
        "qux"
    ]
}

Parámetros de respuesta

Parámetro

Tipo

Descripción

tags

Array of strings

Especifica las etiquetas definidas por el usuario de un BMS.

Ejemplo de respuesta

1
2
3
4
5
6
7
 
{
    "tags": [
        "baz",
        "foo",
        "qux"
    ]
}

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.