Preguntas frecuentes sobre Cloud Notifications
Preguntas generales
¿Qué es el servicio Oracle Cloud Infrastructure Notifications?
Oracle Cloud Infrastructure Notifications es un servicio de publicación-suscripción totalmente administrado que envía mensajes a escala hacia varios puntos finales de suscripción. Notifications es compatible con notificaciones push por correo electrónico, PagerDuty, Functions, HTTPS, Slack y terminales de SMS, y dispone de soporte integrado para Oracle Cloud Infrastructure Monitoring y Service Connector Hub.
¿Qué puedo hacer con este servicio?
El uso más común de Notifications será el de ofrecer soporte para Service Connector Hub y mensajes de Monitoring a fin de enviar alertas de aplicaciones. Por ejemplo, puede configurar alarmas en Oracle Cloud Infrastructure Monitoring para enviar notificaciones a un tema. Cuando se suscriba al tema mediante correo electrónico o PagerDuty, se le notificará inmediatamente sobre las anomalías en su infraestructura en la nube. Otro posible uso consiste en utilizar nuestra integración de protocolo de correo electrónico para permitir que Notifications envíe mensajes en nombre de sus servicios a suscriptores específicos. Para cosas como el restablecimiento de contraseñas, los recordatorios de calendario y hasta el posicionamiento del carrito de compra, Notifications proporciona flexibilidad en la desvinculación de servicios con soporte para los protocolos más populares y las integraciones de terceros.
¿Cómo funciona Notifications?
Notifications utiliza un marco de publicación-suscripción en el que los autores del mensaje se desvinculan de los suscriptores del mensaje. Puede configurar canales de comunicación para publicar mensajes utilizando temas y suscripciones. Un tema es un canal para comunicar mensajes a una suscripción. Una suscripción es un punto final para un protocolo compatible. Cuando se publica un mensaje en un tema, el servicio envía el mensaje a todas las suscripciones del tema.
¿Cómo puedo empezar a usar Notifications?
Puede acceder al servicio Notifications utilizando la consola (una interfaz basada en navegador) o la API REST o CLI. Para obtener una lista de los SDK disponibles, consulte Kits de desarrollo de software e interfaz de línea de comandos.
¿Cuál es la diferencia entre Notifications y otros servicios de mensajería disponibles en Oracle Cloud Infrastructure?
Oracle Cloud Infrastructure ofrece los siguientes servicios de mensajería para la entrega de eventos:
- Streaming
- Notifications
Aunque estos servicios tienen algunas similitudes, se utilizan en situaciones distintas:
- El uso más frecuente de Notifications consiste en enviar notificaciones a suscriptores interesados y registrados, y se utiliza en la programación reactiva. Este servicio envía notificaciones mediante un modelo "push", que elimina la carga de tener que comprobar periódicamente las actualizaciones.
- El uso más frecuente de Streaming consiste en introducir grandes cantidades de datos continuos y ponerlos a disposición para el consumo inmediatamente. El servicio de Streaming facilita la entrada, la retención y la reproducción rápida de datos en transmisión. A diferencia de Notifications, Streaming permite reproducir repetidas veces los datos almacenados.
Conceptos clave
¿Qué es un tema?
Un tema es un canal para comunicar mensajes a una suscripción.
¿Qué es una suscripción?
Una suscripción es el punto final de un tema. Los mensajes publicados se envían a cada suscripción para un tema en particular. Actualmente se admiten los siguientes protocolos de suscripción:
- Correo electrónico: los mensajes se envían a una dirección de correo electrónico especificada.
- HTTPS (PagerDuty): los mensajes se envían a PagerDuty.
- HTTPS (Webhook): los mensajes se envían al punto final HTTPS.
- Slack: los mensajes se envían a un canal de Slack.
- Oracle Functions: invoque una función de Oracle
- SMS: los mensajes se envían a un número de teléfono activado para SMS.
¿Qué es un mensaje?
Es el contenido que se publica en un tema. Cada mensaje se entrega al menos una vez por suscripción. Cada mensaje enviado como correo electrónico contiene un enlace para cancelar la suscripción al tema relacionado.
Características y funcionalidad
¿Qué funciones son compatibles con Notifications?
- Múltiples integraciones de punto final y soporte para protocolos de mensajería como correo electrónico y PagerDuty
- Escalable y con un servicio totalmente administrado que garantiza la durabilidad de los mensajes
- Lógica de reintento inteligente para entregar los mensajes al menos una vez
- Soporte de seguridad para la gestión de identidades y acceso
- Gestión de suscripciones
¿Qué protocolos de notificación son compatibles actualmente con este servicio?
Notifications es compatible con correo electrónico, PagerDuty, Functions, HTTPS, Slack y SMS.
¿Cuáles son las operaciones API disponibles de Notifications y dónde puedo encontrar documentación?
Las siguientes operaciones son compatibles con más documentación ubicada aquí:
- Use estas operaciones de API para administrar temas:
| Operación | Descripción |
|---|---|
| createTopic | Crea un tema en el compartimento especificado. |
| getTopic | Obtiene la información de configuración de un tema especificado. |
| listTopics | Enumera los temas en el compartimento especificado. |
| updateTopic | Actualiza la configuración del tema especificado. |
| deleteTopic | Elimina el tema especificado. |
- Use estas operaciones de API para administrar suscripciones:
| Operación | Descripción |
|---|---|
| createSubscription | Crea una suscripción para el tema especificado. |
| deleteSubscription | Elimina la suscripción especificada. |
| listSubscriptions | Enumera las suscripciones en el compartimento o tema especificado. |
| getSubscription | Obtiene la información de configuración de la suscripción especificada. |
| updateSubscription | Actualiza la configuración de la suscripción especificada. |
| getConfirmSubscription | Obtiene los detalles de confirmación para la suscripción especificada. |
| resendSubscriptionConfirmation | Reenvía los detalles de confirmación para la suscripción especificada. |
| getUnsubscription | Obtiene los detalles de la baja para la suscripción especificada. |
- Use estas operaciones de API para publicar mensajes:
| Operación | Descripción |
|---|---|
| publishMessage | Publica un mensaje para el tema especificado. |
¿Cuán duraderos son los mensajes tras haber sido publicados en un tema?
Todos los mensajes que se publican en un tema del servicio de notificaciones son duraderos en la región. Cuando se publica un mensaje en un tema, el mensaje se replica de forma sincronizada en tres dominios de disponibilidad dentro de una región antes de que se envíe un acuse de recibo al autor del mensaje.
¿Puede Notifications retener mensajes?
Cuando el punto final de un suscriptor no acusa la recepción de un mensaje, el servicio vuelve a intentar la entrega y retiene el mensaje hasta dos horas desde el momento en el que este se haya publicado en un tema. El servicio intenta entregar mensajes dentro del plazo de retención.
¿Envía Notifications un mensaje cuando se ha agotado el tiempo de retención?
Sí. Notifications envía un mensaje cuando el tiempo de retención máximo (dos horas) se ha agotado, tanto si el mensaje se ha entregado como si no.
¿Cuántas veces recibe una notificación el destinatario?
Notifications envía mensajes a un punto final de suscripción al menos una vez. Con estas implementaciones a veces se puede producir una duplicación, por lo que es recomendable que el destinatario gestione las notificaciones duplicadas.
¿Puedo publicar los mismos mensajes en múltiples puntos finales a través de un solo tema?
Notifications se puede configurar para que entregue mensajes a múltiples puntos finales en un solo tema. Por ejemplo, puede enviar una alarma Oracle Cloud Infrastructure Monitoring a una dirección de correo electrónico y a un punto final PagerDuty al mismo tiempo.
¿Los mensajes se entregan exactamente en el mismo orden en el que se publican en un tema?
Notifications entrega los mensajes del autor en el orden en el que se publican en un tema. Sin embargo, debido a la naturaleza de las particiones de red, la estabilidad de la conexión a internet y los fallos transitorios, es posible que a veces Notifications entregue mensajes en otro orden.
¿Pueden los suscriptores recibir solo un subconjunto de los mensajes publicados en un tema?
Actualmente, todos los mensajes publicados en un tema se entregan a todos los puntos finales de las suscripciones de ese tema. Los suscriptores no pueden escoger suscribirse a un subconjunto de mensajes.
¿Puedo borrar un mensaje después de que se haya publicado en un tema?
No es posible eliminar un mensaje después de que se haya publicado en un tema de notificaciones.
¿Puedo cambiar el asunto y el nombre del remitente en los correos electrónicos enviados con Notifications?
Puede cambiar la línea de asunto de cada mensaje pasando el asunto como un parámetro en la operación API PublishMessage. Actualmente, no puede cambiar el nombre del remitente predeterminado de los correos electrónicos enviados por Notifications.
Operaciones y resolución de problemas
¿Qué parámetros puedo usar para supervisar Notifications?
- Estos son los tres parámetros principales que puede emplear:
| Nombre del parámetro | Descripción |
|---|---|
| Recuento de mensajes publicados | El número de mensajes publicados en Notifications. |
| Recuento de mensajes entregados | El número de mensajes entregados correctamente. |
| Recuento de mensajes fallidos | El número de mensajes que no se han entregado. |
| Tamaño de mensajes publicados (bytes) | El tamaño total de los mensajes publicados. |
| Tamaño de mensajes entregados (bytes) | El tamaño total de los mensajes entregados correctamente. |
| Tamaño de mensajes fallidos (bytes) | El tamaño total de los mensajes que no se pudieron entregar. |
¿Qué tipo de aviso recibo cuando hay un error en una notificación?
Puede configurar una alarma en el parámetro NumberOfNotificationFailed a través del servicio Monitoring; más información aquí.
¿Qué sucede si publico mensajes en un tema que no tiene ninguna suscripción?
La operación de publicación se realiza correctamente, pero los mensajes se descartan porque no hay ninguna suscripción interesada.
¿Puede Notifications retener mensajes?
Cuando el punto final de un suscriptor no acusa la recepción de un mensaje, el servicio vuelve a intentar la entrega y retiene el mensaje hasta dos horas desde el momento en el que este se haya publicado en un tema. El servicio intenta entregar mensajes dentro del plazo de retención.
¿Qué sucede si un suscriptor no está disponible?
Si el servicio de notificaciones no recibe un acuse de recibo del punto final de suscripción, este intenta volver a enviar los mensajes durante un máximo de dos horas. Esta situación se puede producir cuando el punto final no está conectado. Por ejemplo, el servicio PagerDuty podría estar desconectado.
Seguridad
¿Quién puede crear un tema?
De forma predeterminada, los administradores de inquilinos de Oracle Cloud Infrastructure tienen permiso para crear temas. Sin embargo, los administradores de inquilinos pueden otorgar permisos y políticas para permitir que grupos de usuarios también puedan crear temas. Si deseas más información, consulta Primeros pasos con el uso de políticas. Para obtener detalles específicos sobre el diseño de políticas para los diferentes servicios, consulte Referencia sobre políticas. Para conocer las políticas comunes por las cuales los grupos pueden acceder a Notifications, consulte Cómo permitir que un grupo administre temas, Cómo permitir que un grupo administre suscripciones de temas y Cómo permitir que un grupo publique mensajes en temas.
¿Quién puede publicar mensajes en un tema?
De forma predeterminada, el propietario del tema puede publicar mensajes; sin embargo, otros usuarios de Oracle Cloud Infrastructure también pueden recibir permisos. Consulte Permitir que un grupo pueda publicar mensajes en temas.
¿Puede haber varios autores publicando en un mismo tema?
El propietario de un tema puede establecer permisos explícitos para permitir que más de un usuario o inquilino publique en un tema. De forma predeterminada, los propietarios de temas son los únicos con permiso para publicar en un tema; si deseas cambiar tus políticas, puedes obtener más información en Cómo permitir que un grupo publique mensajes en temas.
¿Quién puede suscribirse a un tema?
El administrador del inquilino o el propietario del tema pueden añadir suscriptores. Consulte Políticas de notificaciones y Gestión de suscripciones para obtener más información.
¿Cómo puede el propietario de un tema darle acceso a suscriptores?
El propietario del tema puede otorgar a los suscriptores permisos de suscripción a un tema. Para obtener más información, consulte Políticas comunes para la publicación de notificaciones.
¿Quién puede confirmar o rechazar una suscripción?
En el caso del correo electrónico, los suscriptores recibirán una dirección URL de confirmación de suscripción cuando se hayan añadido. Para obtener más ayuda con la confirmación de suscripción y el reenvío de los detalles de confirmación, puede informarse aquí.
¿Cómo se asegura Notifications de que un autor no pueda enviar spam a un punto final de suscripción y de que los mensajes se envían únicamente a suscriptores válidos, registrados e interesados?
Para garantizar que el punto final de un suscriptor no reciba spam y que los mensajes se envían solo a puntos finales válidos y registrados, Notifications exige una aceptación explícita por parte del suscriptor.
- Cuando el administrador del inquilino o el propietario del tema añada un usuario de punto final, Notifications enviará un mensaje de confirmación a ese suscriptor.
- Después de recibir el mensaje de confirmación en el punto final, el suscriptor confirma la solicitud de suscripción enviando una respuesta válida. Notifications solo aceptará la solicitud de suscripción en este caso. Si no hay respuesta, el servicio no envía ninguna notificación a ese punto final.
¿Cómo autentifica Notifications las llamadas a la API?
La autenticación de notificaciones está integrada en el servicio Oracle Cloud Infrastructure Identity and Access Management (IAM); más información aquí.
¿Cómo puede un suscriptor darse de baja de los mensajes?
Un suscriptor puede darse de baja de un tema en Notifications de las siguientes maneras:
- Con la consola o la operación de API DeleteSubscription
- (Solo para suscriptores de correo electrónico) Con la opción para cancelar suscripción incluida en el cuerpo de los correos electrónicos enviados por Notifications
Límites y restricciones
¿Cuáles son los límites del servicio Notifications?
- Tenga en cuenta que los límites de Notifications se establecen en el ámbito regional.
| Recurso | Créditos universales mensuales | Pay As You Go (pago por consumo) o promocional |
|---|---|---|
| Temas | 50 (activos o en creación*) por cliente | Contáctanos |
| Suscripciones | 10 (activos o pendientes*) por tema 100 (pendientes*) por arrendamiento |
Contáctanos |
| Para temas/suscripciones adicionales, ponte en contacto con nosotros a fin de aumentar los límites. | ||
- También están los siguientes límites:
| Elemento | Tamaño |
|---|---|
| Tamaño de mensaje por solicitud | 64 kB |
| Protocolo | Mensajes por minuto a un único terminal |
|---|---|
| Correo electrónico | 60 |
| HTTPS (PagerDuty) | 10 |
¿Cuánto cuesta Notifications?
El precio de Notifications es sencillo e intuitivo. Los clientes pagan por la entrega de mensajes. Para HTTPS, los clientes pagan 0,60 dólares por cada millón de mensajes al mes. Para los correos electrónicos, los clientes pagan 0,02 dólares por 1000 correos electrónicos enviados por mes. Para los SMS, los clientes pagan por SMS según el país de destino.
¿Tiene Notifications algún nivel gratuito?
Notifications contiene un nivel en el que los clientes de Oracle Cloud Infrastructure pueden empezar de forma gratuita. Cada mes, los clientes pueden entregar un millón de mensajes a puntos finales HTTPS y 1000 mensajes de correo electrónico sin incurrir en ningún costo.
Próximos pasos
Si el servicio de notificaciones no recibe un acuse de recibo del punto final de suscripción, este intenta volver a enviar los mensajes durante un máximo de dos horas. Esta situación se puede producir cuando el punto final no está conectado. Por ejemplo, el servicio PagerDuty podría estar desconectado.