O caso de uso mais comum para Notificações será o suporte a mensagens de Monitoramento e o Service Connector Hub para enviar alertas de aplicativos. Por exemplo, você pode configurar os alarmes do Oracle Cloud Infrastructure Monitoring para enviar notificações para um tópico. Ao assinar o tópico usando o Email ou o PagerDuty, você é imediatamente notificado sobre anomalias na sua infraestrutura de nuvem. Outra implementação é usar nossa integração de protocolo de email para permitir que o serviço de Notificações envie mensagens em nome de seus serviços para assinantes especificados. Para casos de uso que variam de redefinições de senha, lembretes de calendário e até sugestões de carrinho de compras, o serviço de Notificações fornece flexibilidade para desacoplar serviços com suporte para os protocolos mais populares e integrações de terceiros.

O serviço de notificações usa uma estrutura de publicação-assinatura na qual os editores de mensagens são dissociados dos assinantes da mensagem. Você configura canais de comunicação para publicar mensagens usando tópicos e assinaturas. Um tópico é um canal para comunicar mensagens a uma assinatura. Uma assinatura é um terminal para um protocolo suportado. Quando uma mensagem é publicada em um tópico, o serviço envia a mensagem para todas as assinaturas do tópico.

Você pode acessar o serviço de Notificações usando o Console (uma interface baseada em navegador) ou a API REST ou CLI. Para obter uma lista dos SDKs disponíveis, consulte Kits de Desenvolvimento de Software e Interface de Linha de Comando.

A Oracle Cloud Infrastructure oferece os seguintes serviços de mensagens para entrega de eventos:

• Streaming
• Notificações

Embora esses serviços tenham algumas semelhanças, eles abordam casos de uso distintos:

• O caso de uso mais frequente para o serviço de Notificações é enviar notificações para assinantes interessados registrados e é usado na programação reativa. Este serviço envia notificações usando um modelo de "extração", que elimina a sobrecarga de pesquisas periódicas para atualizações.
• O caso de uso mais frequente do Streaming é ingerir grandes quantidades de dados contínuos e disponibilizá-los imediatamente para consumo. O serviço de Streaming facilita a ingestão, retenção e reprodução rápida de dados de streaming. Diferentemente do serviço de Notificações, o Streaming permite a reprodução repetida dos dados armazenados.

Considere a seguinte comparação de serviço ao determinar se o Serviço de Notificações ou de Entrega de Email é o que melhor se encaixar para seu caso de uso.

Um tópico é um canal para comunicar mensagens a uma assinatura.

Uma assinatura é um terminal para um tópico. As mensagens publicadas são enviadas para cada assinatura para um tópico específico. Atualmente, os seguintes protocolos de assinatura são suportados:

• Email: As mensagens são enviadas para um endereço de email especificado.
• HTTPS (PagerDuty): As mensagens são enviadas para o PagerDuty.
• HTTPS (Webhook): As mensagens são enviadas para o terminal HTTPS.
• Slack: Mensagens são enviadas para um canal Slack
• Oracle Functions: Aplique um Oracle Function
• SMS: As mensagens são enviadas para um número de telefone habilitado para SMS

O conteúdo que é publicado em um tópico. Cada mensagem é entregue pelo menos uma vez por assinatura. Toda mensagem enviada como email contém um link para cancelar a inscrição no tópico relacionado.

• Várias integrações de terminais e suporte a protocolo de mensagens, como email e PagerDuty
• Escalável com um serviço totalmente gerenciado que garante durabilidade das mensagens
• Lógica de repetição inteligente para entregar pelo menos uma vez
• Suporte de segurança para Gerenciamento de Identidade e Acesso
• Gerenciamento de Assinaturas

As notificações são compatíveis com Email, PagerDuty, Functions, HTTPS, Slack e SMS.

As seguintes operações são suportadas com mais documentação localizada aqui:

• Use estas operações da API para gerenciar tópicos:

  Operação	Descrição
  createTopic	Cria um tópico no compartimento especificado.
  getTopic	Obtém as informações de configuração do’tópico especificado.
  listTopics	Lista os tópicos no compartimento especificado.
  updateTopic	Atualiza a configuração do tópico especificado.
  deleteTopic	Exclui o tópico especificado.

• Use estas operações da API para gerenciar assinaturas:

  Operação	Descrição
  createSubscription	Cria uma assinatura para o tópico especificado.
  deleteSubscription	Exclui a assinatura especificada.
  listSubscriptions	Lista as assinaturas no compartimento ou tópico especificado.
  getSubscription	Obtém as informações de configuração da assinatura especificada.
  updateSubscription	Atualiza a configuração da assinatura especificada.
  getConfirmSubscription	Obtém os detalhes de confirmação para a assinatura especificada.
  resendSubscriptionConfirmation	Envia novamente os detalhes de confirmação para a assinatura especificada.
  getUnsubscription	Obtém os detalhes de cancelamento da assinatura especificada.

• Use estas operações da API para publicar Mensagens:

  Operação	Descrição
  publishMessage	Publica uma mensagem no tópico especificado.

Todas as mensagens publicadas em um tópico de Notificações são duráveis na região. Quando uma mensagem é publicada em um tópico, ela é replicada de forma síncrona para três domínios de disponibilidade em uma região antes que uma confirmação seja enviada ao publicador da mensagem.

Quando um terminal de assinante não confirma o recebimento de uma mensagem, o serviço tenta novamente realizar a entrega e atualmente a retém até duas horas após a publicação da mensagem em um tópico. O serviço tenta entregar mensagens dentro da janela de retenção.

Sim. O serviço de notificações descarta uma mensagem quando atinge seu tempo máximo de retenção, que é de duas horas, independente da mensagem ter sido entregue ou não.

O serviço de notificações entrega mensagens pelo menos uma vez para um terminal de assinatura. Com essas implementações, a duplicação pode ocorrer ocasionalmente e é recomendável que o destinatário lide com notificações duplicadas.

As notificações podem ser configuradas para entregar mensagens para vários terminais de um único tópico. Por exemplo, você pode enviar um alarme do Oracle Cloud Infrastructure Monitoring para um endereço de email e / ou terminal do PagerDuty ao mesmo tempo.

O serviço de notificações entrega mensagens do editor na ordem em que são publicadas em um tópico. No entanto, devido à natureza das partições de rede, estabilidade da conexão com a internet e falha transitória, o serviço de Notificações pode entregar mensagens fora dessa ordem.

Atualmente, todas as mensagens publicadas em um tópico são entregues em todos os terminais de assinatura desse tópico. Os assinantes não podem se inscrever seletivamente em um subconjunto de mensagens.

Você não pode’excluir uma mensagem depois que ela for publicada em um tópico de Notificações.

Você pode alterar a linha de assunto de cada mensagem, passando o assunto como um parâmetro na operação da API PublishMessage. Atualmente, você não pode alterar o nome padrão do remetente dos emails enviados pelo serviço de Notificações.

• Aqui estão as principais métricas que você pode usar:

Você pode configurar um alarme na métrica NumberOfNotificationFailed por meio do serviço de Monitoramento. Saiba mais Aqui.

A operação de publicação é bem-sucedida, mas as mensagens são descartadas porque nenhuma assinatura está interessada nelas.

Se o serviço de Notificações não receber uma confirmação de um terminal de assinatura, o serviço tenta reenviar mensagens por até duas horas. Essa situação pode ocorrer quando o terminal está offline. Por exemplo, o serviço PagerDuty pode estar offline.

Por padrão, os administradores de Inquilinos da Oracle Cloud Infrastructure têm permissões para criar tópicos. No entanto, os administradores de Inquilinos podem conceder permissões e políticas para permitir que grupos de usuários criem tópicos também. Para mais informações, veja Introdução às Políticas. Para detalhes específicos sobre como escrever políticas para cada um dos diferentes serviços, consulte Referência de Política. Para políticas comuns que dão aos grupos acesso a notificações, consulte também Permitir que um grupo gerencie tópicos, Permitir que um grupo gerencie assinaturas de tópicos e Permitir que um grupo publique mensagens em tópicos.

Por padrão, o proprietário do tópico pode publicar mensagens, no entanto, outros usuários da Oracle Cloud Infrastructure podem receber permissões. Consulte permitir que um grupo publique mensagens em tópicos.

Um proprietário do tópico pode definir permissões explícitas para permitir que mais de um usuário ou inquilino publique em um tópico. Por padrão, apenas os proprietários de tópicos têm permissão para publicar em um tópico, para ajustar suas políticas, saiba mais em permitir que um grupo publique mensagens em tópicos.

Os assinantes podem ser adicionados pelo administrador do inquilino ou pelo proprietário do tópico. Consulte Políticas de Notificações e gerenciamento de assinaturas para obter maiores informações.

O proprietário do tópico pode conceder permissão de assinatura a um tópico para os assinantes. Para obter mais informações, consulte Políticas Comuns para Publicação de Notificações.

Para email, os Assinantes receberão um URL de confirmação da assinatura depois de adicionados. Para obter mais ajuda com a confirmação da assinatura e o reenvio dos detalhes da confirmação, saiba mais aqui.

Para garantir que um terminal do assinante não possa ser alvo de spam e que as mensagens sejam enviadas apenas para terminais registrados e válidos, o serviço de Notificações requer uma inclusão explícita de um assinante.

1. Assim que um administrador de inquilino ou proprietário do tópico adicionar um usuário de terminal, o serviço de Notificações envia uma mensagem de confirmação para esse assinante.
2. Após receber a mensagem de confirmação no terminal, o assinante confirma a solicitação de assinatura enviando uma resposta válida. Somente então o serviço de Notificações considera a solicitação de assinatura válida. Se não houver resposta, o serviço não envia notificações para esse terminal.

A autenticação de notificações está integrada ao serviço Oracle Cloud Infrastructure Identity and Access Management (IAM). Saiba mais aqui.

Um assinante pode cancelar a inscrição de um tópico de Notificações das seguintes maneiras:

• Usando o Console ou a operação da API DeleteSubscription
• (Somente para assinantes de email) Usando a opção de cancelamento de inscrição no corpo dos emails enviados pelo serviço de Notificações

• Observe que os limites de Notificações são definidos em nível regional.

• Outros limites são os seguintes:

Limites de Solicitação

Limites da Taxa de Entrega de Mensagens

A precificação do serviço de Notificações é simples e intuitiva. Os clientes pagam por entrega de mensagem. Para HTTPS, os clientes pagam US$ 0,60 por milhão de mensagens por mês. Para emails, os clientes pagam US$ 0,02 por 1.000 emails enviados por mês. Para SMS, os clientes pagam por SMS de acordo com o país de destino.

O serviço de Notificações introduz uma camada que permite aos clientes da Oracle Cloud Infrastructure começar gratuitamente. A cada mês, os clientes podem entregar 1 milhão de mensagens aos terminais HTTPS e 1.000 mensagens de email sem incorrer em nenhum custo.

• Blog: Apresentação do Oracle Cloud Infrastructure Notifications
• Blog: Notificações Sensíveis ao Horário de Envio
• Introdução ao serviço de Notificações