Passa al contenuto principale

Stati e modalità di entità e di sistema

Questa sezione fornisce una panoramica degli States (Stati) e dei Modes (Modalità) che definiscono il ciclo di vita e il comportamento operativo delle risorse Entities (Entità) e System (Sistema). Il diagramma seguente illustra le transizioni tra questi stati e modalità, specificando come la risorsa si evolve dalla creazione alla dismissione e come le sue modalità operative si adattano in base a eventi interni o chiamate API esterne.

La comprensione di queste fasi è essenziale per gestire le risorse in modo efficace, garantire operazioni senza intoppi e risolvere problemi come credenziali non valide o sospensioni temporanee.

Stati​

  • Acquired: Stato iniziale della risorsa al momento della creazione. Le operazioni non possono essere eseguite in questo stato.
  • Commissioned: La risorsa è pronta e pienamente operativa (a condizione che la modalità sia operativa).
  • Decommissioned: La risorsa non è più operativa e non può eseguire alcuna operazione. Questo stato è irreversibile.

Modalità​

  • Inactive: La risorsa è inattiva e non è operativa.
  • Operative: La risorsa è pienamente funzionale e funziona come previsto.
  • Suspended: In pausa temporanea, che può essere avviata tramite una chiamata API, ad esempio quando è necessario aggiornare le credenziali.
  • Degraded: La risorsa è operativa ma temporaneamente non disponibile, ad esempio a causa di credenziali non valide o errori.
Entity Resource State and Mode
note

Ogni transizione è attivata da una chiamata API esterna o avviene automaticamente in base alla logica interna del sistema. PATCH indica che è necessaria una chiamata API esterna per avviare la transizione. INTERNAL indica che la transizione viene attivata automaticamente all'interno del sistema. Le frecce bidirezionali indicano che la transizione può avvenire in entrambi i sensi.

Transizione degli stati​

  • Acquired → Commissioned: Richiede una chiamata API (PATCH) per aggiornare la risorsa.
  • Commissioned → Decommissioned: Gestito tramite una chiamata API (PATCH) per contrassegnare la risorsa come non più in uso. Questo cambiamento di stato è irreversibile.

Transizione delle modalità​

  • Inactive → Operative: Transizione automatica se lo stato viene aggiornato a Commissionato tramite chiamata API.
  • Operative → Suspended: Può essere eseguita attivamente tramite l'API, ad esempio per sospendere temporaneamente le operazioni durante l'aggiornamento delle credenziali.
  • Operative → Degraded: Transizione automatica se le credenziali non sono valide o si verifica un errore.
  • Degraded → Suspended: Deve essere aggiornata attivamente tramite l'API per risolvere problemi come le credenziali non valide.
  • Suspended → Operative: Può essere aggiornata tramite l'API dopo aver risolto i problemi, ad esempio aggiornando le credenziali.
  • Degraded → Operative: Può passare automaticamente quando i problemi con la risorsa vengono risolti internamente.