Visión general de Notifications

El servicio Notifications permite configurar canales de comunicación para publicar mensajes mediante temas y suscripciones . Cuando se publica un mensaje en un tema, el servicio Notificaciones envía este mensaje a todas las suscripciones del tema.

Cuando el punto final de un suscriptor no confirma la recepción del mensaje, el servicio Notificaciones vuelve a intentar la entrega. Esta situación puede ocurrir cuando el punto final está fuera de línea. Por ejemplo, el servidor de correo electrónico para una dirección de correo electrónico puede estar caído.

Para cambiar la duración de los reintentos de una suscripción, consulte Actualización de una suscripción.

Los siguientes conceptos son esenciales para trabajar con Notificaciones.

formato sencillo

Un entorno para aumentar la legibilidad humana de los mensajes.

Protocolos de suscripción soportados:

• Correo electrónico

Tipos de mensaje soportados:

• Mensajes de alarma (cuando Notifications es el destino)

  Consulte ejemplos de mensajes de alarma y Updating an Alarm After Moving a Resource.

• Mensajes de conector (cuando Notifications es el servicio de destino)

  Consulte ejemplos de mensajes de conector y Actualización de un conector para utilizar formatos fáciles de recordar.

mensaje

Contenido que se publica en un tema. Cada mensaje se entrega al menos una vez por suscripción. Todos los mensajes enviados como correo electrónico contienen un enlace para cancelar la suscripción al tema relacionado.

notificación

Una configuración para enviar mensajes, como una alarma o una regla de evento. Cada mensaje se envía a suscripciones en el tema especificado.

Dispone de los siguientes tipos de notificaciones:

• Notificación contextual: se crea a partir de una plantilla de inicio rápido u opciones enfocadas que son relevantes para el recurso determinado.

  Para obtener instrucciones sobre una instancia informática, consulte Configuración de notificaciones contextuales para una instancia.

• Notificación tradicional: se crea a partir de un punto de integración soportado.

  Entre los escenarios de ejemplo para las notificaciones tradicionales se incluyen cambiar el tamaño automático de las máquinas virtuales, enviar mensajes de alarma a Slack y SMS y enviar tickets de Jira para recordatorios.

Después de crear la notificación, puede gestionarla de la forma habitual. Por ejemplo, si la notificación es una alarma, gestiónela mediante la página Alarmas de la consola.

suscripción

Punto final de un tema. Los mensajes publicados se envían a cada suscripción para un tema.

Protocolos de suscripción soportados:

• Correo electrónico:

  Envía un mensaje de correo electrónico cuando publica un mensaje  en el tema principal de la suscripción.

  Nota
  
  Siga las mejores prácticas para la integración con Email Delivery. Consulte Mantenimiento de una reputación positiva del remitente de correo electrónico.

  El contenido y la apariencia del mensaje varían según el tipo de mensaje. Consulte mensajes de alarma, mensajes de evento y mensajes de conector.

  Algunos tipos de mensajes utilizan un formato sencillo.

• Función:
  Ejecuta la función especificada cuando publica un mensaje en el tema principal de la suscripción. Por ejemplo, ejecuta una función para cambiar el tamaño de las VM cuando se ejecuta una alarma asociada.
• HTTPS (URL personalizada):

  Envía información especificada cuando publica un mensaje  en el tema principal de la suscripción.

• PagerDuty:
  Crear un incidente PagerDuty por defecto cuando se publica un mensaje en el tema de la suscripción principal.
• Slack:
  Envía un mensaje al canal de Slack especificado por defecto cuando publica un mensaje  en el tema principal de la suscripción.

  El contenido y la apariencia del mensaje varían según el tipo de mensaje. Consulte mensajes de alarma, mensajes de evento y mensajes de conector.
• SMS:
  Envía un mensaje de texto mediante el servicio de mensajes cortos (SMS) al número de teléfono especificado cuando publica un mensaje en el tema principal de la suscripción. Formatos de punto final soportados: formato E.164.

  Nota
  
  

  Se requieren capacidades de SMS internacional si los mensajes SMS proceden de un número de teléfono de otro país. Agregamos continuamente soporte para más países para que más usuarios puedan recibir mensajes SMS de números de teléfono locales.

  Las suscripciones de SMS sólo están activadas para los siguientes servicios de Oracle Cloud Infrastructure: Announcements, Monitoring y Connector Hub. Los mensajes SMS que se envían desde servicios no soportados se borran. Consulte Causa: recurso no soportado utilizado para SMS.

  El servicio Notifications entrega mensajes SMS de un pool de números preconfigurado. Es posible que reciba mensajes SMS de varios números.

  El contenido y la apariencia del mensaje varían según el tipo de mensaje. Consulte Mensajes de alarma SMS y Mensajes de conector SMS.

  Regiones y países disponibles

  Puede utilizar Notifications para enviar mensajes SMS a los siguientes países y regiones:

  País o región	Código ISO
  Australia	AU
  Brasil	BR
  Canadá	CA
  Chile	CL
  China	CN
  Costa Rica	CR
  Croacia	HR
  República Checa	CZ
  Francia	FR
  Alemania	DE
  Hungría	HU
  India	IN
  Irlanda	IE
  Israel	IL
  Japón	JP
  Lituania	LT
  México	MX
  Holanda	NL
  Nueva Zelanda	NZ
  Noruega	NO
  Filipinas	PH
  Polonia	PL
  Portugal	PT
  Rumano	RO
  Arabia Saudí	SA
  Singapur	SG
  Sudáfrica	ZA
  Corea del Sur	KR
  España	ES
  Suecia	SE
  Suiza	CH
  Ucrania	UA
  Emiratos Árabes Unidos	AE
  Reino Unido	GB
  Estados Unidos	US

tema

Un canal de comunicación para enviar mensajes a suscripciones. Cada nombre de tema es único en el arrendamiento.

Los recursos publican mensajes en el tema configurado. A continuación, Notifications entregará mensajes a suscripciones activas en el tema.

Entre los recursos que pueden enviar mensajes se incluyen alarmas, suscripciones a anuncios, reglas de eventos, conectores y notificaciones contextuales (alarmas y reglas de eventos). (Un usuario, servicio o aplicación también puede enviar un mensaje a través de una publicación directa).

Por ejemplo, considere una alarma configurada para enviar mensajes a un tema. Este tema contiene suscripciones de correo electrónico, Slack y SMS. Cuando se infringe la regla de disparador de alarma, la alarma publica un mensaje en el tema. A continuación, el servicio de notificaciones entrega el mensaje a las suscripciones activas del tema. En este ejemplo, la suscripción a Slack está pendiente porque aún no se ha confirmado. El servicio de notificaciones entrega el mensaje solo a las suscripciones de correo electrónico y SMS, ya que son las únicas suscripciones activas del tema.

Para ver las métricas que realizan un seguimiento de los mensajes publicados y entregados, consulte Métricas disponibles: oci_notification.

Alarmas 🔗

Cuando se infringe una regla de disparador de una de alarma, la alarma envía un mensaje de alarma al tema configurado. A continuación, el servicio de notificaciones entrega el mensaje a las suscripciones activas en ese tema. Consulte Gestión de alarmas.

Una notificación contextual puede incluir una alarma.

Suscripciones a anuncios 🔗

Una suscripción de anuncio envía mensajes de anuncio de consola al tema configurado. A continuación, el servicio de notificaciones entrega el mensaje a las suscripciones activas en ese tema.

Reglas de Evento 🔗

Cuando se dispara, una regla de evento envía un mensaje de evento al tema configurado. A continuación, el servicio de notificaciones entrega el mensaje a las suscripciones activas en ese tema. Consulte Gestión de reglas para eventos.

Una notificación contextual puede incluir una regla de evento.

Conectores 🔗

Un conector envía un mensaje de conector al tema configurado. A continuación, el servicio de notificaciones entrega el mensaje a las suscripciones activas en ese tema. Consulte Gestión de conectores.

Publicación directa 🔗

Un usuario (o un servicio o una aplicación) envía un mensaje al tema configurado. A continuación, el servicio de notificaciones entrega el mensaje a las suscripciones activas en ese tema. Consulte Publicación de un mensaje en un tema.

El servicio de Notifications está disponible en todas las regiones comerciales de Oracle Cloud Infrastructure. Consulte Acerca de las regiones y los dominios de disponibilidad para obtener la lista de regiones disponibles, junto con las ubicaciones, los identificadores de región, las claves de región y los dominios de disponibilidad asociados.

Tenga en cuenta las siguientes funciones de servicio al decidir si desea utilizar el servicio Notificaciones o el servicio Email Delivery para enviar mensajes de correo electrónico. Para obtener más información sobre el uso de Email Delivery, consulte Visión general del servicio Email Delivery.

La mayoría de los tipos de recursos de Oracle Cloud Infrastructure tienen un identificador único asignado por Oracle denominado Oracle Cloud ID (OCID). Para obtener información sobre el formato de OCID y otras maneras de identificar los recursos, consulte Identificadores de recursos.

Puede acceder al servicio de notificaciones mediante la consola o la API de REST de Notifications. En esta guía se incluyen instrucciones para la consola, la CLI y la API. Para obtener una lista de los SDK disponibles, consulte Software development kits e interfaz de línea de comandos.

Consola: para acceder a Notifications con la consola, debe utilizar un explorador soportado. Para ir a la página de conexión de la consola, abra el menú de navegación situado en la parte superior de esta página y seleccione Consola de Infrastructure. Se le solicitará que introduzca el inquilino en la nube, el nombre de usuario y la contraseña. Abra el menú de navegación y seleccione Servicios para desarrolladores. En Integración de aplicación, seleccione Notificaciones.

API: para acceder a Notification a través de API, utilice la API de Notification.

CLI: consulte Referencia de línea de comandos para Notifications.

Administradores: para políticas comunes que otorgan a los grupos acceso a los recursos de Notifications, consulte Políticas de IAM (en la página Protección de Notifications).

Para obtener una lista de límites aplicables e instrucciones para solicitar un aumento del límite, consulte Límites de servicio. Para definir límites específicos de compartimentos en un recurso o familia de recursos, los administradores pueden utilizar las cuotas de compartimento.