Ciclo de vida de Data Collections
Una Data Collection transita por estados definidos desde su creación hasta su retiro. Cada estado controla qué ediciones, comparticiones y operaciones API están permitidas.
Los cuatro estados
1. Draft (Borrador)
La colección está en construcción. Puedes agregar o quitar tags libremente y editar alias, descripciones, rangos y transformaciones. Nada es visible aún para externos.
- Editar metadatos, tags, alias y transformaciones: Permitido
- Publicar a Active: Permitido (cuando todos los tags tienen alias)
- Compartir con externos / acceso API externo: Bloqueado (publicar primero)
2. Active (Publicada)
La colección está en vivo. Se pueden crear comparticiones y los consumidores API leen telemetría mediante los alias definidos.
- Editar metadatos y alias de tags: Permitido
- Agregar tags: Permitido (cambio aditivo no disruptivo)
- Quitar tags: Requiere confirmación (posible cambio disruptivo para consumidores)
- Configurar transformaciones de tags: Pausar la colección primero
- Compartir con externos y acceso API: Permitido
3. Paused (Pausada)
La colección queda suspendida temporalmente. Todas las comparticiones activas se congelan de inmediato y los receptores pierden acceso API hasta reanudar. Puedes seguir editando y configurando transformaciones mientras está pausada.
- Editar metadatos, tags, alias y transformaciones: Permitido
- Crear nuevas comparticiones / acceso API: Suspendido
4. Archived (Archivada)
La colección queda retirada de forma permanente y en solo lectura. Todas las comparticiones y llaves API (directas y de compartición) se revocan definitivamente.
- Toda edición, compartición y creación de llaves API: Bloqueado
- Consultar metadatos históricos: Permitido
Transiciones de estado
Draft ──(Publish)──▶ Active ◀──(Pause / Resume)──▶ Paused
│
(Archive)
▼
Archived (irreversible)| Desde | Hacia | Acción | ¿Reversible? |
|---|---|---|---|
| Draft | Active | Publish | No (usa Pause en su lugar) |
| Active | Paused | Pause | Sí (Resume) |
| Paused | Active | Resume | Sí (Pause) |
| Active / Paused | Archived | Archive | No |
Cómo agregar y quitar tags sin romper integraciones
- Agregar un tag: Seguro para colecciones activas. Los consumidores existentes simplemente reciben un campo adicional.
- Quitar un tag: Cualquier consumidor que lo consulte por share o llave directa deja de recibir ese dato de inmediato.
Recomendación para cambios disruptivos
Pausa la colección primero para que los destinatarios sepan que está en mantenimiento, ajusta o elimina el tag, notifica a los consumidores afectados y después ejecuta Resume.
Llaves directas vs. Llaves de compartición (Share Keys)
- Llaves API directas (Propietario): Pueden crearse en Draft, Active y Paused para probar antes de publicar o reanudar. Archived revoca todas las llaves permanentemente.
- Llaves de compartición (Consumidor externo): Dependen tanto del share como de la colección. El receptor solo puede leer datos cuando la colección está Active, el share está activo con
can_use_apihabilitado y la llave no ha expirado ni sido revocada.