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/ Elastic Cloud Server/ Referencia de la API/ API (recomendado)/ Gestión de etiquetas/ Adición de etiquetas a un ECS por lotes

Actualización más reciente 2022-11-08 GMT+08:00

Adición de etiquetas a un ECS por lotes

Función

Esta API se utiliza para agregar etiquetas a un ECS especificado en un lote.
El servicio de gestión de etiquetas (TMS) utiliza esta API para gestionar por lotes las etiquetas de un ECS.

Restricciones

Un ECS permite un máximo de 10 etiquetas.
Esta API es idempotente.
Durante la creación de etiquetas, si existe una etiqueta, (tanto la clave como el valor son los mismos que los de una etiqueta existente), la etiqueta se procesa correctamente de forma predeterminada.
Una nueva etiqueta sobrescribirá la original si sus claves son las mismas y los valores son diferentes.

URI

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

Tabla 1 describe los parámetros en el URI.

**Tabla 1** Descripción del parámetro
Parámetro	Obligatorio	Descripción
project_id	Yes	Especifica el ID del proyecto. Para obtener más información sobre cómo obtener el ID, consulte Obtención de un ID de proyecto.
server_id	Yes	Especifica el ID de ECS.

Solicitud

Tabla 2 describe los parámetros de solicitud.

**Tabla 2** Parámetros de solicitud
Parámetro	Obligatorio	Tipo	Descripción
tags	Yes	Array of objects	Especifica las etiquetas. Para más detalles, consulte Tabla 3.
action	Yes	String	Especifica la operación. (Solo se admiten letras minúsculas). Por ejemplo, create indica la operación de creación.

**Tabla 3** Descripción del campo **tags**
Parámetro	Obligatorio	Tipo	Descripción
key	Yes	String	Especifica la clave de etiqueta. No se puede dejar en blanco. Debe ser único para cada recurso. Contiene un máximo de 36 caracteres. Debe ser único y no se puede dejar en blanco.
value	Yes	String	Especifica el valor de etiqueta. Contiene un máximo de 43 caracteres.

Respuesta

No hay

Ejemplo de la solicitud

POST  https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/tags/action

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