Eliminazione di una connessione

• Richiesta di eliminazione
• Conseguenze dell'eliminazione

Richiesta di eliminazione

L'eliminazione di una connessione è un processo definitivo, che non può essere annullato una volta richiesto. In caso di cancellazione accidentale, sarà necessario rieffettuare il processo di connessione e validazione/certificazione.

La richiesta di eliminazione di una connessione viene inviata con l'apposita API del servizio di scrittura delle connessioni.

DELETE /api/v2/connections/{connectionId}

API che permette di richiedere l'eliminazione di una connessione. È possibile richiedere l'eliminazione di una connessione solamente se si hanno i permessi amministrativi o sul gestore o sulla gestita.

Header

Il servizio richiede gli header standard di TS Digital.

Path Parameters

• connectionId: identificativo univoco della connessione da eliminare

Risposta

HTTP 202

In caso di risposta positiva l'API ritorna un codice HTTP 202

{
  "id": "string"
}

La risposta contiene le seguenti informazioni:

• id: identificativo della connessione eliminata

HTTP 400

Un parametro obbligatorio per la chiamata non è stato specificato, oppure un parametro ha un formato non valido

HTTP 401

Non è stato fornito il token autorizzativo, oppure è scaduto o invalido

HTTP 403

Il token autorizzativo è presente e valido, ma l'utente non ha i permessi necessari per poter rimuovere la connessione

HTTP 404

Non esiste alcuna connessione corrispondente all'ID fornito

HTTP 500

Si è verificato un errore imprevisto nella creazione della richiesta di eliminazione

HTTP 502

Si è verificato un errore imprevisto nella comunicazione con un servizio terzo necessario per completare il processo (es: servizio di autenticazion non disponibile) 

Conseguenze dell'eliminazione

L'eliminazione di una connessione ha le seguenti conseguenze:

• Il gestore della connessione perde tutti i ruoli forniti dalla stessa. Questo si applica anche ad eventuali utenti aggiuntivi al quale erano stati estesi tali permessi
  • Se un'utenza non ha più alcun ruolo rimanente sull'azienda, non la vedrà più nell'elenco delle aziende e non gli sarà più permesso accedere al servizio per conto dell'azienda
• L'azienda gestita può ricevere una richiesta di connessione da un nuovo gestore per quel servizio
• Se era stata effettuata una estensione di pacchetto (la gestita addebitava i suoi consumi alla sottoscrizione del gestore), l'estensione viene annullata.
  • Se, post annullamento dell'estensione, l'ex gestita non dovesse più avere alcuna sottoscrizione rimanente, gli sarà impossibile visualizzare o utilizzare il servizio