Amazon SNS

O componente do Amazon SNS (aws.greengrass.SNS) publica as mensagens em um tópico do Amazon Simple Notification Service (Amazon SNS). Você pode usar esse componente para enviar eventos dos dispositivos principais do Greengrass para servidores Web, endereços de e-mail e outros assinantes de mensagens. Para obter mais informações, consulte O que é o Amazon SNS? no Guia do desenvolvedor do Amazon Simple Notification Service.

Para publicar em um tópico do Amazon SNS com esse componente, publique uma mensagem no tópico de assinatura desse componente. Por padrão, esse componente assina o tópico local de publicação/assinatura sns/message. Você pode especificar outros tópicos, incluindo tópicos do AWS IoT Core MQTT, ao implantar esse componente.

Em seu componente personalizado, você pode implementar a lógica de filtragem ou de formatação para processar mensagens de outras fontes antes de publicá-las nesse componente. Esse procedimento permite que você centralize a lógica de processamento de mensagens em um único componente.

Versões

Esse componente tem as seguintes versões:

Tipo

Esse é um componente do Lambda (aws.greengrass.lambda).. O núcleo do Greengrass executa a função do Lambda desse componente usando o componente inicializador do Lambda.

Para obter mais informações, consulte Tipos de componente.

Sistema operacional

Esse componente pode ser instalado somente nos dispositivos principais do Linux.

Requisitos

Esse componente tem os seguintes requisitos:

Endpoints e portas

Esse componente precisa ser capaz de realizar solicitações de saída para os endpoints e portas a seguir, além dos endpoints e portas necessários para a operação básica. Para obter mais informações, consulte Permitir o tráfego de dispositivos por meio de um proxy ou firewall.

Dependências

Quando você implanta um componente, AWS IoT Greengrass também implanta versões compatíveis de suas dependências. Isso significa que é preciso atender aos requisitos do componente e de todas as dependências dele para implantá-lo com êxito. Nesta seção, há uma lista de todas as dependências das versões lançadas desse componente e as restrições de versão semântica que definem as versões dos componentes para cada dependência. Também é possível visualizar as dependências de cada versão do componente no console do AWS IoT Greengrass. Na página de detalhes do componente, procure a lista de dependências.

Para obter mais informações sobre as dependências dos componentes, consulte referência de fórmula do componente.

Configuração

Esse componente fornece os parâmetros de configuração a seguir, que podem ser personalizados quando você o implanta.

{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "DEFAULT_SNS_ARN": "arn:aws:sns:us-west-2:123456789012:mytopic"
    }
  },
  "containerMode": "GreengrassContainer"
}

{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "DEFAULT_SNS_ARN": "arn:aws:sns:us-west-2:123456789012:mytopic"
    }
  },
  "containerMode": "NoContainer"
}

Dados de entrada

Esse componente aceita mensagens no tópico a seguir e as publica no tópico do Amazon SNS de destino exatamente como estão. Por padrão, esse componente se inscreve em publish/subscribe mensagens locais. Para obter mais informações sobre como publicar mensagens nesse componente a partir de seus componentes personalizados, consulte Publicar/assinar mensagens locais.

Tópico padrão (publicação/assinatura local): sns/message

A mensagem aceita as propriedades a seguir. As mensagens de entrada devem estar no formato JSON.

{
  "request": {
    "subject": "Message subject",
    "message": "Message data",
    "sns_topic_arn": "arn:aws:sns:region:account-id:topic2-name"
  },
  "id": "request123"
}

{
  "request": {
    "subject": "Message subject",
    "message": "{ \"default\": \"Message data\" }",
    "message_structure": "json"
  },
  "id": "request123"
}

Dados de saída

Por padrão, esse componente publica respostas como dados de saída no tópico do MQTT a seguir. Você deve especificar esse tópico como subject na configuração do componente legado de roteador de assinatura. Para obter mais informações sobre como assinar mensagens nesse tópico em seus componentes personalizados, consulte Publique/assine mensagens MQTT AWS IoT Core.

Tópico padrão (AWS IoT Core MQTT): sns/message/status

{
  "response": {
    "sns_message_id": "f80a81bc-f44c-56f2-a0f0-d5af6a727c8a",
    "status": "success"
  },
  "id": "request123"
}

{
  "response" : {
    "error": "InvalidInputException",
    "error_message": "SNS Topic Arn is invalid",
    "status": "fail"
  },
  "id": "request123"
}

Arquivo de log local

Esse componente usa o arquivo de log abaixo.

/greengrass/v2/logs/aws.greengrass.SNS.log

Licenças

Esse componente inclui o seguinte licenciamento/software de terceiros:

Esse componente foi lançado nos termos do Contrato de licença de software de núcleo do Greengrass.

Changelog

A tabela a seguir descreve as alterações em cada versão do componente.