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 de BMS/ Gestión de etiquetas/ Adición de etiquetas para un BMS

Actualización más reciente 2025-02-18 GMT+08:00

Ver PDF

Adición de etiquetas para un BMS

Función

Esta API se utiliza para agregar etiquetas para un BMS especificado por lotes.
El Tag Management Service (TMS) utiliza esta API para gestionar etiquetas de BMS.

Esta es una API idempotente. Si una etiqueta que se está creando ya existe (tiene la misma clave y valor que una etiqueta existente) se devolverá un resultado exitoso. Una nueva etiqueta sobrescribirá la original si sus claves son las mismas pero los valores son diferentes.

Restricciones

Para un BMS se puede agregar un máximo de 20 etiquetas.

URI

POST /v1/{project_id}/baremetalservers/{server_id}/tags/action

Tabla 1 enumera los parámetros.

**Tabla 1** Descripción del parámetro
Parámetro	Tipo	Obligatorio	Descripción
project_id	String	Sí	Especifica el ID del proyecto.
server_id	String	Sí	Especifica el ID de BMS.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción
tags	List <resource_tag>	Sí	Especifica la lista de etiquetas. Para obtener más información, véase Tabla 2.
action	String	Sí	Especifica la operación (solo se admiten letras minúsculas). Por ejemplo, create indica la operación de creación.

**Tabla 2** Descripción de la estructura de datos de campo **tags**
Parámetro	Tipo	Obligatorio	Descripción
key	String	Sí	Especifica la clave de etiqueta. Contiene un máximo de 36 caracteres de Unicode y no puede estar vacío. No puede contener caracteres ASCII (0–31) o caracteres especiales =*<>\,\|/ La clave de etiqueta de un BMS debe ser única.
value	String	No	Especifica el valor de etiqueta. Cada valor contiene un máximo de 43 caracteres Unicode y puede ser una cadena vacía. No puede contener caracteres ASCII (0–31) o caracteres especiales =*<>\,\|/

Ejemplo de solicitud

Agregar dos etiquetas (key1: value1, key2: value3) para un BMS

{
    "action": "create",
    "tags": [
        {
            "key": "key1",
            "value": "value1"
        },
        {
            "key": "key2",
            "value": "value3"
        }
    ]
}

Mensaje de la respuesta

No hay

Valores devueltos

Normal

Valores devueltos

Descripción

204

No hay contenido

Valores devueltos	Descripción
204	No hay contenido

Anormal

Valores devueltos	Descripción
400	Etiqueta no válida.
401	Error al autenticar.
403	Permiso insuficiente.
404	No se encontró el recurso solicitado.
500	Ocurrió una excepción del sistema.