Eliminación de la suscripción a la lista de distribución

Para anular la suscripción de la lista de distribución, utilice el enlace del pie de página de cualquier correo electrónico enviado desde la lista de distribución.

Eventos para notificaciones

La siguiente tabla enumera los tipos de eventos que el servicio de Notificaciones envía a Event Notifications:

Añadir una instancia Event Notifications a la lista de distribución de notificaciones

Antes de poder añadir cualquier instancia de Event Notifications a la lista de distribución de notificaciones, asegúrese de que ya dispone de una instancia del servicio Event Notifications que se encuentra en la misma cuenta que la lista de distribución. Si no dispone de una instancia del servicio Event Notifications, consulte Introducción a Event Notifications. Para añadir una instancia de servicio Event Notifications existente a la lista de distribución de notificaciones, siga estos pasos:

1. Utilizando la consola de IBM Cloud, vaya a Gestionar > Cuenta > Lista de distribución de notificaciones.
2. Haga clic en Añadir > Event Notifications.
3. Seleccione una instancia de servicio Event Notifications de la lista de instancias Event Notifications. Si no dispone de una instancia de servicio Event Notifications que pueda conectar a su cuenta, puede crear una en el catálogo IBM Cloud.
4. Pulse Añadir.

No se puede añadir una instancia de servicio Event Notifications a la lista de distribución de notificaciones ya configurada.

Envío de notificaciones de prueba a una instancia de Event Notifications

Después de añadir una instancia de Event Notifications a su lista de distribución de notificaciones, puede probarla para asegurarse de que los eventos generados por el servicio de notificaciones se reenvían a esa instancia.

Complete los siguientes pasos para enviar una notificación de prueba a una instancia de Event Notifications:

1. En la consola IBM Cloud, vaya a Gestionar > Cuenta > Lista de distribución de notificaciones.
2. Seleccione la instancia Event Notifications a la que desea enviar una notificación de prueba y haga clic en el icono Acciones > Prueba.
3. Seleccione el tipo de evento de notificación que desea probar y, a continuación, haga clic en Enviar prueba.
   1. Para volver a enviar la notificación de prueba, pulse Reenviar prueba.

Detalles de carga útil de notificación

Cuando se añade una instancia de Event Notifications a la lista de distribución de su cuenta y ésta recibe una notificación, se envía una carga útil de notificación a dicha instancia de Event Notifications. Las propiedades del objeto de carga útil son las mismas para todos los tipos de eventos. Consulte el siguiente ejemplo de carga útil que contiene información detallada sobre un evento de mantenimiento para enviar una notificación de prueba:

{
   "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"
           }
       ]
   }
}

Revise la siguiente tabla para obtener más información sobre las propiedades de la carga útil de la notificación para Event Notifications.

Supresión de una instancia de Event Notifications

Puede eliminar cualquier instancia de Event Notifications que haya añadido a la lista de distribución de notificaciones completando los siguientes pasos:

1. Seleccione la instancia de servicio Event Notifications que desea eliminar de la lista de distribución de notificaciones y haga clic en el icono Acciones .
2. Pulse Suprimir.

Cabeceras

Recibes la carga útil con una cabecera que configuraste en la interfaz de usuario cuando añadiste un webhook, y con una cabecera de versión adicional que tiene un número de versión semántico. Esta cabecera de versión se puede utilizar para determinar el formato esperado de la carga útil de webhook.

La cabecera de versión actual es "IBM-Notifications-API-Version": "v2.0.0".

Valores de campos

Las descripciones siguientes proporcionan información sobre los valores de campos que se envían dentro de la carga útil:

body: este campo describe el suceso que se está produciendo en la plataforma y que le atañe. Este campo contiene una descripción detallada y legible para una persona de la notificación y puede tener varios párrafos. También puede contener formato html. Este campo está configurado para dar soporte a más idiomas, aunque actualmente solo se admite el inglés.

category: el tipo del suceso. Puede ser incidente, mantenimiento, anuncio o boletines de seguridad.

componentNames: Si un servicio se ve afectado, este campo lo representa. También puede ser un valor global como Component: IBM Cloud, no sólo un servicio específico. Consulte los servicios en la página del catálogo IBM Cloud.

regions: este campo muestra la ubicación del suceso.

severity: este campo hace referencia a la gravedad del suceso. Puede ser gravedad 1, 2, 3 o 4 para incidencias, alto, medio o bajo para mantenimiento y principal o secundario para anuncios. Consulte las siguientes descripciones detalladas del nivel de gravedad:

* **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.

El atributo de gravedad en la carga útil de la solicitud puede tomar un valor de 0, 1, 2, 3 o 4. La siguiente tabla enumera los valores de gravedad y sus correspondientes clasificaciones:

state: este campo solo tiene fines de mantenimiento y notificaciones. Consulte los siguientes valores posibles:

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

title: el campo de título indica de qué se trata la notificación. Este campo está configurado para dar soporte a más idiomas, aunque actualmente solo se admite el inglés.

startTime, endTime: puede comprobar cuándo se inicia y cuando finaliza el suceso.

Los campos startTime y endTime muestran la hora de inicio y la hora de finalización del suceso en indicaciones de fecha y hora de hora universal coordinada (UTC) de Unix.

Los campos que se envían en la carga útil pueden ser obligatorios u opcionales. Los campos opcionales, por ejemplo startTime, se pasan si la notificación tiene este tipo de información y no se pasan si la notificación no la tiene. Los campos necesarios, por ejemplo category, se pasan en todos los casos. La tabla siguiente lista qué campos son necesarios y cuáles son opcionales:

Es posible que en el futuro se añadan más campos sin necesidad de cambiar la versión. Esto significa que cualquier código que esté procesando notificaciones debe estar preparado para ignorar los campos que no reconoce.

Envío de notificaciones de prueba a un webhook

Si está preparado con los pasos anteriores y tiene un webhook configurado, puede probarlo fácilmente. Envíe una notificación de prueba a su webhook y asegúrese de que la integración de webhook está funcionando correctamente y que recibe la notificación.

Siga estos pasos para enviar una notificación de prueba a un webhook:

1. Vaya a Gestionar > Cuenta > Lista de distribución de notificaciones en la consola de IBM Cloud.
2. Seleccione el webhook al que desea enviar una notificación de prueba y pulse el icono Acciones .
3. Pulse Probar > Enviar prueba.
4. Para volver a enviar la notificación de prueba, pulse Reenviar prueba.