Saltar al contenido

Establecer etiquetas de perfiles por lotes

Request

Sobrescribe las etiquetas de los recursos seleccionados. Requiere permiso de gestión de etiquetas y acceso a los destinos. Los nombres se comparan exactamente dentro del equipo: se crean las etiquetas que faltan y se reutilizan las existentes actualizando su color. El cambio de color afecta también a otros recursos con la misma etiqueta. No se admiten nombres repetidos en una petición. Un array tags vacío elimina solo las asignaciones y conserva las definiciones y los grupos. La operación es síncrona y data es null. Tras un timeout, consulta los destinos y /api/envtag/all antes de reintentar; no hay clave de idempotencia.

Errores de negocio documentados: 15003, 15004, 19039, 19173, 19193. Consulte Error Codes para el significado de cada código. Cualquier operación puede devolver además los códigos comunes.

Bodyapplication/jsonrequired
Any of:
envIdsArray of strings, non-emptyrequired

ID de perfiles. Indica envIds o uniqueIds no vacío; envIds no vacío tiene prioridad. Se aplican las reglas existentes de selección por lotes y permisos.

uniqueIdsArray of integers

Números de serie de perfiles, usados si envIds está vacío o se omite.

Example:
[ 1 ]
tagsArray of objectsrequired

Etiquetas que reemplazan todas las asignaciones actuales. Un array vacío elimina las asignaciones sin borrar las definiciones.

curl -i -X POST \
  http://127.0.0.1:40000/api/env/setTags/batch \
  -H 'Content-Type: application/json' \
  -d '{
    "envIds": [
      "1993244721490239488"
    ],
    "tags": [
      {
        "tagName": "Sales",
        "tagColor": "blue"
      }
    ]
  }'

Responses

Éxito. Las asignaciones se han actualizado de forma síncrona; data es null.

Bodyapplication/json
codeinteger
Example:0
msgstring or null
requestIdstring
datanull
Response
{ "code": 0, "msg": null, "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d", "data": null }