Saltar al contenido

Establecer etiquetas de teléfonos en la nube 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 /envtag/all antes de reintentar; no hay clave de idempotencia.

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

Security
Authorization
Bodyapplication/jsonrequired
idsArray of strings, non-emptyrequired

ID de teléfonos en la nube. La validación por lotes existente resuelve los teléfonos accesibles. No presupongas que se actualizaron todos los ID enviados; consulta los teléfonos para confirmar las asignaciones.

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 \
  https://api.morelogin.com/cloudphone/setTags/batch \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "ids": [
      "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 }