# Establecer etiquetas de teléfonos en la nube por lotes

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](/es/api-reference/getting-started/error-codes) para el significado de cada código. Cualquier operación puede devolver además los códigos comunes.

Endpoint: POST /cloudphone/setTags/batch
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `ids` (array, required)
    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.

  - `tags` (array, required)
    Etiquetas que reemplazan todas las asignaciones actuales. Un array vacío elimina las asignaciones sin borrar las definiciones.

  - `tags.tagName` (string, required)
    Nombre de etiqueta, comparado exactamente dentro del equipo. Se rechazan los nombres repetidos en una petición.

  - `tags.tagColor` (any)
    Color de etiqueta. Si se omite o está en blanco se usa red; solo nombres de colores, no valores hexadecimales.

## Request examples:

  - `replace` (unknown)

  - `clear` (unknown)

## Response 200:

  - `200` (unknown)
    Éxito. Las asignaciones se han actualizado de forma síncrona; data es null.

## Response 200 fields (application/json):

  - `code` (integer)
    Example: 0

  - `msg` (string | null)

  - `requestId` (string)

  - `data` (null)

