Amazon SNS

Il componente Amazon SNS (aws.greengrass.SNS) pubblica messaggi su un argomento di Amazon Simple Notification Service (Amazon SNS). È possibile utilizzare questo componente per inviare eventi dai dispositivi core Greengrass a server Web, indirizzi e-mail e altri abbonati ai messaggi. Per ulteriori informazioni, consulta Cos'è Amazon SNS? nella Guida per gli sviluppatori di Amazon Simple Notification Service.

Per pubblicare su un argomento di Amazon SNS con questo componente, pubblica un messaggio sull'argomento a cui questo componente è abbonato. Per impostazione predefinita, questo componente sottoscrive l'argomento di pubblicazione/sottoscrizione sns/message locale. È possibile specificare altri argomenti, inclusi gli argomenti AWS IoT Core MQTT, quando si distribuisce questo componente.

Nel componente personalizzato, potresti voler implementare la logica di filtraggio o formattazione per elaborare i messaggi da altre fonti prima di pubblicarli su questo componente. Ciò consente di centralizzare la logica di elaborazione dei messaggi su un singolo componente.

Versioni

Questo componente ha le seguenti versioni:

Tipo

Questo componente è un componente Lambda () aws.greengrass.lambda. Il nucleo Greengrass esegue la funzione Lambda di questo componente utilizzando il componente di avvio Lambda.

Per ulteriori informazioni, consulta Tipi di componenti.

Sistema operativo

Questo componente può essere installato solo sui dispositivi principali di Linux.

Requisiti

Questo componente ha i seguenti requisiti:

Endpoint e porte

Questo componente deve essere in grado di eseguire richieste in uscita verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta Consenti il traffico dei dispositivi tramite un proxy o un firewall.

Dipendenze

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le versioni rilasciate di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass Nella pagina dei dettagli del componente, cerca l'elenco delle dipendenze.

Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.

Configurazione

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

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

Dati di input

Questo componente accetta messaggi sul seguente argomento e pubblica il messaggio così com'è nell'argomento Amazon SNS di destinazione. Per impostazione predefinita, questo componente sottoscrive i messaggi di pubblicazione/sottoscrizione locali. Per ulteriori informazioni su come pubblicare messaggi su questo componente dai componenti personalizzati, consulta. Pubblicare/sottoscrivere messaggi locali

Argomento predefinito (pubblicazione/sottoscrizione locale): sns/message

Il messaggio accetta le seguenti proprietà. I messaggi di input devono essere in 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"
}

Dati di output

Per impostazione predefinita, questo componente pubblica le risposte come dati di output sul seguente argomento MQTT. È necessario specificare questo argomento come contenuto subject nella configurazione del componente legacy del router di abbonamento. Per ulteriori informazioni su come sottoscrivere i messaggi relativi a questo argomento nei componenti personalizzati, consultaAWS IoT Core Pubblicare/sottoscrivere messaggi MQTT.

Argomento predefinito (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"
}

File di registro locale

Questo componente utilizza il seguente file di registro.

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

Licenze

Questo componente include i seguenti software/licenze di terze parti:

Questo componente è rilasciato in base al contratto di licenza del software Greengrass Core.

Changelog

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.