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
Compartir

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"
  } ]
}

Ejemplo de las respuestas

No hay

Códigos de estado

Código de estado

Descripción

204

Las etiquetas se crean o eliminan.

Códigos de error

Consulte Códigos de error.

Tema principal: Gestión de etiquetas