Cancellazione dalla lista di distribuzione

Per annullare l'iscrizione alla lista di distribuzione, utilizzare il link nel piè di pagina di qualsiasi e-mail inviata dalla lista di distribuzione.

Eventi per le notifiche

La tabella seguente elenca i tipi di evento che il servizio Notifiche invia a Event Notifications:

Aggiunta di un'istanza di Event Notifications all'elenco di distribuzione delle notifiche

Prima di aggiungere un'istanza di Event Notifications all'elenco di distribuzione delle notifiche, assicurarsi di avere già un' istanza del servizio Event Notifications con lo stesso account dell'elenco di distribuzione. Se non si dispone di un'istanza del servizio Event Notifications, vedere Per iniziare con Event Notifications. Per aggiungere un'istanza del servizio Event Notifications esistente all'elenco di distribuzione delle notifiche, completare i passaggi seguenti:

1. Dalla console IBM Cloud, andare su Gestione > Account > Elenco di distribuzione delle notifiche.
2. Fare clic su Aggiungi > Event Notifications.
3. Selezionare un'istanza del servizio Event Notifications dall'elenco delle istanze Event Notifications. Se non si dispone di un'istanza del servizio Event Notifications da collegare al proprio account, è possibile crearne una nel catalogo IBM Cloud.
4. Fai clic su Aggiungi.

Non è possibile aggiungere un'istanza del servizio Event Notifications all'elenco di distribuzione delle notifiche già configurato.

Invio di notifiche di test a un'istanza di Event Notifications

Dopo aver aggiunto un'istanza di Event Notifications all'elenco di distribuzione delle notifiche, è possibile testarla per verificare che gli eventi generati dal servizio Notifiche vengano inoltrati a tale istanza.

Completare i seguenti passaggi per inviare una notifica di prova a un'istanza di Event Notifications:

1. Nella console IBM Cloud, andare su Gestione > Account > Elenco di distribuzione delle notifiche.
2. Selezionare l'istanza Event Notifications a cui si desidera inviare una notifica di prova e fare clic sull'icona Azioni Azioni > Prova.
3. Selezionare il tipo di evento di notifica che si desidera testare, quindi fare clic su Invia test.
   1. Per inviare nuovamente la notifica del test, fare clic su Invia nuovamente il test.

Dettagli del carico utile della notifica

Quando un'istanza di Event Notifications viene aggiunta all'elenco di distribuzione dell'account e l'account riceve una notifica, viene inviato un payload di notifica all'istanza Event Notifications. Le proprietà dell'oggetto payload sono le stesse per tutti i tipi di evento. Si veda il seguente esempio di payload che contiene informazioni dettagliate su un evento di manutenzione per l'invio di una notifica di prova:

{
   "instanceId": "12345678-abcd-1234-efgh-1234567890ab",
   "id": "CHG1234567",
   "source": "crn:v1:bluemix:public:notificationapi::a/<scope>:12345678-abcd-1234-efgh-1234567890ab::",
   "ibmenseverity": "high_impact",
   "severity": "high_impact",
   "ibmensourceid": "crn:v1:bluemix:public:notificationapi::a/<scope>:12345678-abcd-1234-efgh-1234567890ab::",
   "type": "com.ibm.cloud.notificationapi.maintenance",
   "time": "2025-10-08T18:31:09.363Z",
   "ibmendefaultshort": "Maintenance - High Impact: this is a maintenance test notif",
   "ibmendefaultlong": "this is a maintenance test notif \n \nSource ID: CHG1234567 \nType: Maintenance \nSeverity: High Impact \nStart Time: 23 Oct 2025, 7:09 PM UTC \nEnd Time: 24 Oct 2025, 7:09 PM UTC \nUpdate Time: 21 Oct 2025, 2:52 AM UTC \n\nthis is the body text and sev = 1\n\nThis is a test email, please disregard\n\n\n",
   "ibmensmstext": "Maintenance - High Impact: this is a maintenance test notif \nSource ID: CHG2755299 \nCategory: Maintenance \nSeverity: High Impact \n",
   "ibmensubject": "Maintenance - High Impact: this is a maintenance test notif",
   "ibmenhtmlbody": "<div> this is a maintenance test notif</div></br><div><div><b>Source ID:</b> CHG2755299</div><div><b>Type:</b> Maintenance</div><div><b>Severity:</b> High Impact</div><div><b>Start Time:</b> 23 Oct 2025, 7:09 PM UTC</div><div><b>End Time:</b> 24 Oct 2025, 7:09 PM UTC</div><div><b>Update Time:</b> 21 Oct 2025, 2:52 AM UTC</div></br>this is the body text and sev = 1</br></div><div></br><b>This is a test email, please disregard</b></br><div>",
   "specversion": "1.0",
   "datacontenttype": "application/json",
   "data": {
       "sourceID": "CHG1234567",
       "category": "maintenance",
       "severity": 1,
       "crnMasks": [],
       "startTime": "1761246551",
       "endTime": "1761332951",
       "title": [
           {
               "language": "en",
               "text": "this is a maintenance test notif"
           }
       ],
       "body": [
           {
               "content-type": "text/html",
               "language": "en",
               "text": "this is the body text and sev = 1"
           }
       ]
   }
}

Per ulteriori informazioni sulle proprietà del payload della notifica, consultare la tabella seguente per Event Notifications.

Eliminazione di un'istanza di Event Notifications

È possibile eliminare qualsiasi istanza di Event Notifications aggiunta all'elenco di distribuzione delle notifiche completando i seguenti passaggi:

1. Selezionare l'istanza del servizio Event Notifications che si desidera eliminare dall'elenco di distribuzione delle notifiche e fare clic sull'icona Azioni .
2. Fai clic su Delete.

Intestazioni

Il payload viene ricevuto con un'intestazione configurata nell'interfaccia utente quando si aggiunge un webhook e con un'intestazione aggiuntiva di versione che contiene un numero di versione semantico. Questa intestazione di versione può essere usata per determinare il formato previsto del payload del webhook.

L'intestazione della versione corrente è "IBM-Notifications-API-Version": "v2.0.0".

Valori del campo

Le seguenti descrizioni forniscono informazioni sui valori dei campi inviati all'interno del payload:

body: Questo campo descrive l'evento che si sta verificando sulla piattaforma e che vi riguarda. Questo campo contiene una descrizione dettagliata e leggibile della notifica e può essere lungo diversi paragrafi. Può anche contenere formattazione html. Questo campo è configurato per supportare più lingue, anche se attualmente è supportato solo l'inglese.

category: Il tipo di evento. Può trattarsi di incidenti, manutenzione, annunci o bollettini di sicurezza.

componentNames: Se un servizio è impattato, questo campo lo rappresenta. Può anche essere un valore globale come Component: IBM Cloud, non solo un servizio specifico. Vedere i servizi alla pagina del catalogo IBM Cloud.

regions: Questo campo indica la posizione dell'evento.

severity: Questo campo si riferisce alla gravità dell'evento. La gravità può essere 1, 2, 3 o 4 per gli incidenti, alta, media o bassa per la manutenzione e maggiore o minore per gli annunci. Vedere le seguenti descrizioni dettagliate dei livelli di gravità:

* **Incidents**
  * `Severity 1`: Business-critical functionality is inoperable or critical interference failed. This severity usually applies to the production environment and the inability to access services is causing a critical impact on operations.
  * `Severity 2`: Core functionality is impacted. Service is operational but causing major impact on usage.
  * `Severity 3`: Partial or noncritical disruption to functionality with minimal or isolated impact.
  * `Severity 4`: A minor issue that requires action, but does not impact functionality or usage.
* **Maintenance**
  * `High impact`: Maintenance will, or is likely to cause service outages and disruptions.
  * `Medium impact`: Maintenance will, or is likely to cause measurable service degradation but not an actual outage.
  * `Low impact`: Maintenance will cause no service disruption during or after the maintenance window.
* **Announcements**
  * `Major`: Important incidents such as legal notices, service deprecation, or security patches.
  * `Minor`: Informative announcements such as product enhancements.

L'attributo severità nel payload della richiesta può assumere un valore pari a 0, 1, 2, 3 o 4. La tabella seguente elenca i valori di gravità e le classificazioni corrispondenti:

state: Questo campo serve solo per la manutenzione e le notifiche. Vedere i seguenti valori possibili:

* Values for *Maintenance* states: Planned, In progress, Completed, Canceled, Failed
* Values for *Incident* states: New issue, Investigating, Resolved

title: Il campo del titolo indica l'oggetto della notifica. Questo campo è configurato per supportare più lingue, anche se attualmente è supportato solo l'inglese.

startTime, endTime: È possibile verificare quando l'evento inizia e quando termina.

I campi startTime e endTime mostrano l'ora di inizio e di fine dell'evento in tempo universale coordinato Unix.

I campi inviati nel payload possono essere obbligatori o facoltativi. I campi opzionali, ad esempio startTime, vengono passati se la notifica ha questo tipo di informazioni e non vengono passati se la notifica non le ha. I campi obbligatori, ad esempio category, vengono passati in ogni caso. La tabella seguente elenca i campi obbligatori e quelli facoltativi:

In futuro potrebbero essere aggiunti altri campi senza una modifica sostanziale della versione. Ciò significa che il codice che elabora le notifiche deve essere pronto a ignorare i campi che non riconosce.

Invio di notifiche di test a un webhook

Se si è pronti con i passaggi precedenti e si dispone di un webhook configurato, è possibile testarlo facilmente. Inviare una notifica di prova al webhook e verificare che l'integrazione del webhook funzioni correttamente e riceva la notifica.

Completare i seguenti passaggi per inviare una notifica di prova a un webhook:

1. Andate su Gestione > Account > Elenco di distribuzione delle notifiche nella console IBM Cloud.
2. Selezionare il webhook a cui si desidera inviare una notifica di prova e fare clic sull'icona Azioni Azioni.
3. Fare clic su Test > Invia test.
4. Per inviare nuovamente la notifica del test, fare clic su Invia nuovamente il test.