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/ Cloud Connect/ Referencia de la API/ API/ Gestión de etiquetas/ Creación o eliminación de etiquetas por lotes

Actualización más reciente 2023-03-06 GMT+08:00

Ver PDF

Creación o eliminación de etiquetas por lotes

Función

Esta API se utiliza para crear o eliminar etiquetas por lotes.

URI

POST /v3/{domain_id}/ccaas/{resource_type}/{resource_id}/tags/action

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
domain_id	Sí	String	ID de cuenta. Mínimo: 10 Máximo: 32
resource_id	Sí	String	ID del recurso. Mínimo: 0 Máximo: 36
resource_type	Sí	String	Tipo de recurso. cc: conexión a la nube bwp: paquete de ancho de banda

Parámetros de solicitud

**Tabla 2** Parámetros de cabecera de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	No	String	Token de usuario. Mínimo: 0 Máximo: 102400

**Tabla 3** Parámetros del cuerpo de solicitud
Parámetro	Obligatorio	Tipo	Descripción
action	No	String	La acción. create: Agregar una etiqueta. delete: Eliminar una etiqueta.
tags	No	Array of Tag objects	Agregar o eliminar etiquetas por lotes.

**Tabla 4** Etiqueta
Parámetro	Obligatorio	Tipo	Descripción
key	No	String	Clave de etiqueta. Mínimo: 1 Máximo: 128
value	No	String	Valor de la etiqueta. Mínimo: 0 Máximo: 255

Parámetros de respuesta

No hay

Ejemplo de las solicitudes

Si action se establece en create, las etiquetas se agregarán por lotes. Si la clave existe, los valores se actualizarán. Si la clave no existe, se agregarán los valores.

POST https://{cc_endpoint}/v3/{domain_id}/ccaas/{resource_type}/{resource_id}/tags/action

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

Si action se establece en delete, las etiquetas se eliminarán por lotes según la clave. Los valores se ignoran.

POST https://{cc_endpoint}/v3/{domain_id}/ccaas/{resource_type}/{resource_id}/tags/action

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