Amazon SNS

Amazon SNS 구성 요소 (aws.greengrass.SNS) 는 메시지를 Amazon Simple Notification Service (Amazon SNS) 주제에 게시합니다. 이 구성 요소를 사용하여 Greengrass 코어 디바이스에서 웹 서버, 이메일 주소 및 기타 메시지 구독자에게 이벤트를 보낼 수 있습니다. 자세한 정보는 Amazon Simple Notification 개발자 안내서의 What is Amazon SNS?를 참조하십시오.

이 구성 요소를 사용하여 Amazon SNS 주제에 게시하려면 이 구성 요소가 구독하는 주제에 메시지를 게시하십시오. 기본적으로 이 구성 요소는 sns/message 로컬 게시/구독 주제를 구독합니다. 이 구성 요소를 배포할 때 AWS IoT Core MQTT 주제를 비롯한 다른 주제를 지정할 수 있습니다.

사용자 지정 구성 요소에서 다른 소스의 메시지를 이 구성 요소에 게시하기 전에 처리하도록 필터링 또는 형식 지정 로직을 구현하고 싶을 수 있습니다. 이렇게 하면 메시지 처리 로직을 단일 구성 요소에 중앙 집중화할 수 있습니다.

버전

이 구성 요소의 버전은 다음과 같습니다.

유형

이 구성 요소는 Lambda 구성 요소 () 입니다. aws.greengrass.lambda Greengrass 핵은 Lambda 런처 구성 요소를 사용하여 이 구성 요소의 Lambda 함수를 실행합니다.

자세한 설명은 구성 요소 유형 섹션을 참조하세요.

운영 체제

이 구성 요소는 Linux 코어 디바이스에만 설치할 수 있습니다.

요구 사항

이 구성 요소의 요구 사항은 다음과 같습니다.

엔드포인트 및 포트

이 구성 요소는 기본 작업에 필요한 엔드포인트 및 포트 외에도 다음 엔드포인트 및 포트에 대한 아웃바운드 요청을 수행할 수 있어야 합니다. 자세한 설명은 프록시 또는 방화벽을 통한 장치 트래픽 허용 섹션을 참조하세요.

의존성

구성 요소를 배포할 때 는 호환되는 버전의 종속 AWS IoT Greengrass 항목도 배포합니다. 즉, 구성 요소를 성공적으로 배포하려면 구성 요소 및 해당 종속성에 대한 요구 사항을 모두 충족해야 합니다. 이 섹션에는 이 구성 요소의 릴리스된 버전에 대한 종속성과 각 종속성에 대한 구성 요소 버전을 정의하는 시맨틱 버전 제약 조건이 나열되어 있습니다. 콘솔에서 구성 요소의 각 버전에 대한 종속성을 볼 수도 있습니다. AWS IoT Greengrass 구성 요소 세부 정보 페이지에서 종속성 목록을 찾아보십시오.

구성 요소 종속성에 대한 자세한 내용은 구성 요소 레시피 참조를 참조하십시오.

구성

이 구성 요소는 구성 요소를 배포할 때 사용자 지정할 수 있는 다음과 같은 구성 매개 변수를 제공합니다.

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

입력 데이터

이 구성 요소는 다음 주제에 대한 메시지를 수락하고 메시지를 대상 Amazon SNS 주제에 있는 그대로 게시합니다. 기본적으로 이 구성 요소는 로컬 게시/구독 메시지를 구독합니다. 사용자 정의 구성 요소에서 이 구성 요소에 메시지를 게시하는 방법에 대한 자세한 내용은 을 참조하십시오. 로컬 메시지 게시/구독

기본 주제 (로컬 게시/구독): sns/message

메시지는 다음 속성을 수락합니다. 입력 메시지는 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"
}

출력 데이터

이 구성 요소는 기본적으로 응답을 다음 MQTT 주제에 출력 데이터로 게시합니다. 이 주제를 레거시 구독 라우터 구성 요소의 subject 구성에서 로 지정해야 합니다. 사용자 지정 구성 요소에서 이 항목의 메시지를 구독하는 방법에 대한 자세한 내용은 을 참조하십시오MQTT 메시지 게시/구독 AWS IoT Core.

기본 주제 (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"
}

로컬 로그 파일

이 구성 요소는 다음 로그 파일을 사용합니다.

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

라이선스

이 구성 요소에는 다음과 같은 타사 소프트웨어/라이선스가 포함됩니다.

이 구성 요소는 Greengrass Core 소프트웨어 라이센스 계약에 따라 릴리스됩니다.

Changelog

다음 표에는 각 구성 요소 버전의 변경 사항이 설명되어 있습니다.