AWS IoT Events 다른 AWS 서비스 작업 - AWS IoT Events

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS IoT Events 다른 AWS 서비스 작업

AWS IoT Events 는 AWS 서비스 작업을 가능하게 하는 다음 작업을 지원합니다.

  • iotTopicPublish MQTT 주제에 메시지를 게시합니다.

  • iotEvents로 AWS IoT Events 에 입력 값으로 데이터 전송.

  • iotSiteWise로 AWS IoT SiteWise의 자산 속성에 데이터를 보냅니다.

  • dynamoDB로 Amazon DynamoDB 테이블에 데이터 전송.

  • dynamoDBv2로 Amazon DynamoDB 테이블에 데이터 전송.

  • firehose Amazon Data Firehose 스트림으로 데이터를 전송합니다.

  • lambda로 AWS Lambda 함수 호출.

  • sns로 푸시 알림에 데이터 전송.

  • sqs Amazon SQS 대기열로 데이터를 전송합니다.

중요
  • 작업할 AWS IoT Events 및 서비스에 대해 동일한 AWS 리전을 AWS 선택해야 합니다. 지원되는 리전 목록은 Amazon Web Services 일반 참조에서 AWS IoT Events 엔드포인트 및 할당량을 참조하십시오.

  • AWS IoT Events 작업에 대한 다른 AWS 리소스를 생성할 때 동일한 AWS 리전을 사용해야 합니다. AWS 리전을 전환하는 경우 AWS 리소스에 액세스하는 데 문제가 있을 수 있습니다.

기본적으로 는 모든 작업에 JSON 대해 에서 표준 페이로드를 AWS IoT Events 생성합니다. 이 작업 페이로드에는 작업을 트리거한 이벤트와 감지기 모델 인스턴스에 대한 정보가 있는 모든 속성-값 페어가 포함됩니다. 작업 페이로드를 구성하려면 콘텐츠 표현식을 사용하면 됩니다. 자세한 내용은 AWS IoT Events API 참조이벤트 데이터를 필터링, 변환 및 처리하는 표현식페이로드 데이터 유형을 참조하세요.

AWS IoT Core

IoT topic publish action

AWS IoT Core 작업을 통해 MQTT 메시지 브로커를 통해 AWS IoT 메시지를 게시할 수 있습니다. 지원되는 리전 목록은 Amazon Web Services 일반 참조에서 AWS IoT Core 엔드포인트 및 할당량을 참조하십시오.

AWS IoT 메시지 브로커는 게시 AWS IoT 클라이언트에서 구독 클라이언트로 메시지를 전송하여 클라이언트를 연결합니다. 자세한 내용은 AWS IoT 개발자 안내서디바이스 통신 프로토콜을 참조하세요.

More information (2)

MQTT 메시지를 게시할 때는 다음 파라미터를 지정해야 합니다.

mqttTopic

메시지를 수신하는 MQTT 주제입니다.

감지기 모델에서 생성된 변수 또는 입력 값을 사용하여 런타임 시 MQTT 주제 이름을 동적으로 정의할 수 있습니다.

payload

(선택 사항) 기본 페이로드에는 작업을 트리거한 이벤트와 감지기 모델 인스턴스에 대한 정보가 있는 모든 속성-값 페어가 포함됩니다. 또한 페이로드를 사용자 지정할 수도 있습니다. 자세한 내용은 AWS IoT Events API 참조페이로드를 참조하세요.

참고

AWS IoT Events 서비스 역할에 연결된 정책이 iot:Publish 권한을 부여하는지 확인합니다. 자세한 내용은 에 대한 자격 증명 및 액세스 관리 AWS IoT Events 단원을 참조하십시오.

자세한 내용은 참조IotTopicPublishAction의 섹션을 참조하세요. AWS IoT Events API

AWS IoT Events

IoT Events action

이 AWS IoT Events 작업을 사용하면 에 데이터를 입력 AWS IoT Events 으로 전송할 수 있습니다. 지원되는 리전 목록은 Amazon Web Services 일반 참조에서 AWS IoT Events 엔드포인트 및 할당량을 참조하십시오.

AWS IoT Events 를 사용하면 장비 또는 디바이스 플릿에 장애 또는 작동 변경 사항이 있는지 모니터링하고 이러한 이벤트가 발생할 때 작업을 트리거할 수 있습니다. 자세한 내용은 AWS IoT Events 개발자 안내서AWS IoT Events의 ?란 무엇입니까?를 참조하세요.

More information (2)

로 데이터를 전송할 때는 다음 파라미터를 지정 AWS IoT Events해야 합니다.

inputName

데이터를 수신하는 AWS IoT Events 입력의 이름입니다.

payload

(선택 사항) 기본 페이로드에는 작업을 트리거한 이벤트와 감지기 모델 인스턴스에 대한 정보가 있는 모든 속성-값 페어가 포함됩니다. 또한 페이로드를 사용자 지정할 수도 있습니다. 자세한 내용은 AWS IoT Events API 참조페이로드를 참조하세요.

참고

AWS IoT Events 서비스 역할에 연결된 정책이 iotevents:BatchPutMessage 권한을 부여하는지 확인합니다. 자세한 내용은 에 대한 자격 증명 및 액세스 관리 AWS IoT Events 단원을 참조하십시오.

자세한 내용은 참조IotEventsAction의 섹션을 참조하세요. AWS IoT Events API

AWS IoT SiteWise

IoT SiteWise action

AWS IoT SiteWise 작업을 통해 의 자산 속성으로 데이터를 전송할 수 있습니다 AWS IoT SiteWise. 지원되는 리전 목록은 Amazon Web Services 일반 참조에서 AWS IoT SiteWise 엔드포인트 및 할당량을 참조하십시오.

AWS IoT SiteWise 는 대규모 산업 장비에서 데이터를 수집, 구성 및 분석할 수 있는 관리형 서비스입니다. 자세한 내용은 AWS IoT SiteWise사용 설명서AWS IoT SiteWise 이란 무엇입니까? 섹션을 참조하십시오.

More information (11)

의 자산 속성으로 데이터를 전송할 때는 다음 파라미터를 지정 AWS IoT SiteWise해야 합니다.

중요

데이터를 수신하려면 AWS IoT SiteWise에서 기존 자산 속성을 사용해야 합니다.

  • AWS IoT Events 콘솔을 사용하는 경우 대상 자산 속성을 식별propertyAlias하도록 를 지정해야 합니다.

  • 를 사용하는 경우 대상 자산 속성을 식별propertyId하려면 assetId 및 중 하나 propertyAlias 또는 둘 다를 지정 AWS CLI해야 합니다.

자세한 내용을 알아보려면 AWS IoT SiteWise 사용 설명서산업 데이터 스트림을 자산 속성에 매핑를 참조하십시오.

propertyAlias

(선택 사항) 자산 속성 목록입니다. 표현식을 지정할 수도 있습니다.

assetId

(선택 사항) 지정된 속성이 있는 자산의 ID입니다. 표현식을 지정할 수도 있습니다.

propertyId

(선택 사항) 자산 속성 ID입니다. 표현식을 지정할 수도 있습니다.

entryId

(선택 사항) 이 항목의 고유 식별자입니다. 항목 ID를 사용하여 실패 시 오류를 발생시키는 데이터 항목을 추적할 수 있습니다. 기본값은 새 고유 식별자입니다. 표현식을 지정할 수도 있습니다.

propertyValue

속성값에 대한 세부 정보를 포함하는 구조입니다.

quality

(선택 사항) 자산 속성 값의 품질입니다. 값은 GOOD, BAD 또는 UNCERTAIN이어야 합니다. 표현식을 지정할 수도 있습니다.

timestamp

(선택 사항) 타임스탬프 정보가 포함된 구조입니다. 이 값을 지정하지 않으면 기본값은 이벤트 시간입니다.

timeInSeconds

Unix epoch 형식의 타임스탬프(초)입니다. 유효한 범위는 1~31556889864403199입니다. 표현식을 지정할 수도 있습니다.

offsetInNanos

(선택 사항) timeInSeconds에서 변환된 나노초의 오프셋입니다. 유효한 범위는 0~999999999입니다. 표현식을 지정할 수도 있습니다.

value

자산 속성 값이 포함된 구조입니다.

중요

지정된 자산 속성의 dataType에 따라 다음 값 유형 중 하나를 지정해야 합니다. 자세한 내용은 참조AssetProperty의 섹션을 참조하세요. AWS IoT SiteWise API

booleanValue

(선택 사항) 자산 속성 값은 부울 값이며 TRUE 또는 FALSE여야 합니다. 표현식을 지정할 수도 있습니다. 표현식을 사용하는 경우 평가된 결과는 부울 값이어야 합니다.

doubleValue

(선택 사항) 자산 속성 값은 실수입니다. 표현식을 지정할 수도 있습니다. 표현식을 사용하는 경우 평가된 결과는 실수여야 합니다.

integerValue

(선택 사항) 자산 속성 값은 정수입니다. 표현식을 지정할 수도 있습니다. 표현식을 사용하는 경우 평가된 결과는 정수여야 합니다.

stringValue

(선택 사항) 자산 속성 값은 문자열입니다. 표현식을 지정할 수도 있습니다. 표현식을 사용하는 경우 평가된 결과는 문자열이어야 합니다.

참고

AWS IoT Events 서비스 역할에 연결된 정책이 iotsitewise:BatchPutAssetPropertyValue 권한을 부여하는지 확인합니다. 자세한 내용은 에 대한 자격 증명 및 액세스 관리 AWS IoT Events 단원을 참조하십시오.

자세한 내용은 참조IotSiteWiseAction의 섹션을 참조하세요. AWS IoT Events API

Amazon DynamoDB

DynamoDB action

Amazon DynamoDB 작업을 통해 데이터를 DynamoDB 테이블로 보낼 수 있습니다. DynamoDB 테이블의 한 열에는 지정한 작업 페이로드의 모든 속성-값 페어가 수신됩니다. 지원하는 리전 목록은 Amazon Web Services 일반 참조의 Amazon DynamoDB 엔드포인트 및 할당량을 참조하십시오.

Amazon DynamoDB는 완전 관리형 NoSQL Database 서비스로, 원활한 확장성과 함께 빠르고 예측 가능한 성능을 제공합니다. 자세한 내용을 알아보려면 Amazon DynamoDB 개발자 안내서What Is DynamoDB?를 참조하십시오.

More information (10)

DynamoDB 테이블의 한 열로 데이터를 보낼 때는 다음 파라미터를 지정해야 합니다.

tableName

데이터를 수신하는 DynamoDB 테이블의 이름입니다. tableName 값은 DynamoDB 테이블의 테이블 이름과 일치해야 합니다. 표현식을 지정할 수도 있습니다.

hashKeyField

해시 키(파티션 키라고도 함)의 이름입니다. hashKeyField 값은 DynamoDB 테이블의 파티션 키와 일치해야 합니다. 표현식을 지정할 수도 있습니다.

hashKeyType

(선택 사항) 해시 키의 데이터 형식입니다. 해시 키 유형의 값은 STRING 또는 NUMBER이어야 합니다. 기본값은 STRING입니다. 표현식을 지정할 수도 있습니다.

hashKeyValue

해시 키의 값입니다. hashKeyValue은(는) 대체 템플릿을 사용합니다. 이러한 템플릿은 런타임 시 데이터를 제공합니다. 표현식을 지정할 수도 있습니다.

rangeKeyField

(선택 사항) 범위 키(정렬 키라고도 함)의 이름입니다. rangeKeyField 값은 DynamoDB 테이블의 정렬 키와 일치해야 합니다. 표현식을 지정할 수도 있습니다.

rangeKeyType

(선택 사항) 범위 키의 데이터 유형입니다. 해시 키 유형의 값은 STRING 또는 NUMBER이어야 합니다. 기본값은 STRING입니다. 표현식을 지정할 수도 있습니다.

rangeKeyValue

(선택 사항) 범위 키의 값입니다. rangeKeyValue은(는) 대체 템플릿을 사용합니다. 이러한 템플릿은 런타임 시 데이터를 제공합니다. 표현식을 지정할 수도 있습니다.

작업

(선택 사항) 수행할 작업의 유형입니다. 표현식을 지정할 수도 있습니다. 작업 값은 다음 중 하나여야 합니다.

  • INSERT - 데이터를 새 항목으로 DynamoDB 테이블에 삽입합니다. 이것이 기본값입니다.

  • UPDATE - DynamoDB 테이블의 기존 항목을 새 데이터로 업데이트합니다.

  • DELETE - DynamoDB 테이블의 기존 항목을 삭제합니다.

payloadField

(선택 사항) 작업 페이로드를 수신하는 DynamoDB 열의 이름입니다. 기본 이름은 payload입니다. 표현식을 지정할 수도 있습니다.

payload

(선택 사항) 기본 페이로드에는 작업을 트리거한 이벤트와 감지기 모델 인스턴스에 대한 정보가 있는 모든 속성-값 페어가 포함됩니다. 또한 페이로드를 사용자 지정할 수도 있습니다. 자세한 내용은 AWS IoT Events API 참조페이로드를 참조하세요.

지정된 페이로드 유형이 문자열인 경우 는 DynamoDB 테이블에 비JSON 데이터를 바이너리 데이터로 DynamoDBAction 보냅니다. DynamoDB 콘솔은 데이터를 Base64 인코딩된 텍스트로 표시합니다. payloadField 값은 payload-field_raw입니다. 표현식을 지정할 수도 있습니다.

참고

AWS IoT Events 서비스 역할에 연결된 정책이 dynamodb:PutItem 권한을 부여하는지 확인합니다. 자세한 내용은 에 대한 자격 증명 및 액세스 관리 AWS IoT Events 단원을 참조하십시오.

자세한 내용은 AWS IoT Events API 참조DynamoDBAction를 참조하세요.

Amazon DynamoDB(v2)

DynamoDBv2 action

Amazon DynamoDB(v2) 작업을 사용하면 DynamoDB 테이블에 데이터를 쓸 수 있습니다. DynamoDB 테이블의 별도 열에는 지정한 작업 페이로드의 속성-값 페어 하나가 수신됩니다. 지원하는 리전 목록은 Amazon Web Services 일반 참조의 Amazon DynamoDB 엔드포인트 및 할당량을 참조하십시오.

Amazon DynamoDB는 완전 관리형 NoSQL Database 서비스로, 원활한 확장성과 함께 빠르고 예측 가능한 성능을 제공합니다. 자세한 내용을 알아보려면 Amazon DynamoDB 개발자 안내서What Is DynamoDB?를 참조하십시오.

More information (2)

DynamoDB 테이블의 여러 열로 데이터를 보내는 경우 다음 파라미터를 지정해야 합니다.

tableName

데이터를 수신하는 DynamoDB 테이블의 이름입니다. 표현식을 지정할 수도 있습니다.

payload

(선택 사항) 기본 페이로드에는 작업을 트리거한 이벤트와 감지기 모델 인스턴스에 대한 정보가 있는 모든 속성-값 페어가 포함됩니다. 또한 페이로드를 사용자 지정할 수도 있습니다. 자세한 내용은 AWS IoT Events API 참조페이로드를 참조하세요.

중요

페이로드 유형은 여야 합니다JSON. 표현식을 지정할 수도 있습니다.

참고

AWS IoT Events 서비스 역할에 연결된 정책이 dynamodb:PutItem 권한을 부여하는지 확인합니다. 자세한 내용은 에 대한 자격 증명 및 액세스 관리 AWS IoT Events 단원을 참조하십시오.

자세한 내용은 AWS IoT Events API 참조DynamoDBv2Action을 참조하세요.

Amazon Data Firehose

Firehose action

Amazon Data Firehose 작업을 사용하면 Firehose 전송 스트림으로 데이터를 전송할 수 있습니다. 지원되는 리전 목록은 의 Amazon Data Firehose 엔드포인트 및 할당량을 참조하세요Amazon Web Services 일반 참조.

Amazon Data Firehose는 Amazon Simple Storage Service(Amazon Simple Storage Service), Amazon Redshift, Amazon OpenSearch Service(OpenSearch Service) 및 Splunk와 같은 대상에 실시간 스트리밍 데이터를 제공하기 위한 완전 관리형 서비스입니다. 자세한 내용은 Amazon Data Firehose 개발자 안내서의 Amazon Data Firehose란 무엇입니까?를 참조하세요.

More information (3)

Firehose 전송 스트림으로 데이터를 전송할 때는 다음 파라미터를 지정해야 합니다.

deliveryStreamName

데이터를 수신하는 Firehose 전송 스트림의 이름입니다.

separator

(선택 사항) 문자 구분자를 사용하여 Firehose 전송 스트림으로 전송되는 연속 데이터를 분리할 수 있습니다. 구분자 값은 '\n'(줄 바꿈), '\t'(탭), '\r\n'(Windows 새 줄) 또는 ','(쉼표)여야 합니다.

payload

(선택 사항) 기본 페이로드에는 작업을 트리거한 이벤트와 감지기 모델 인스턴스에 대한 정보가 있는 모든 속성-값 페어가 포함됩니다. 또한 페이로드를 사용자 지정할 수도 있습니다. 자세한 내용은 AWS IoT Events API 참조페이로드를 참조하세요.

참고

AWS IoT Events 서비스 역할에 연결된 정책이 firehose:PutRecord 권한을 부여하는지 확인합니다. 자세한 내용은 에 대한 자격 증명 및 액세스 관리 AWS IoT Events 단원을 참조하십시오.

자세한 내용은 참조FirehoseAction의 섹션을 참조하세요. AWS IoT Events API

AWS Lambda

Lambda action

AWS Lambda 작업을 통해 Lambda 함수를 호출할 수 있습니다. 지원되는 리전 목록은 Amazon Web Services 일반 참조에서 AWS Lambda 엔드포인트 및 할당량을 참조하십시오.

AWS Lambda 는 서버를 프로비저닝하거나 관리하지 않고도 코드를 실행할 수 있는 컴퓨팅 서비스입니다. 자세한 내용은 AWS Lambda 개발자 안내서AWS Lambda의 ?란 무엇입니까?를 참조하세요.

More information (2)

Lambda 함수를 호출할 때 다음 파라미터를 지정해야 합니다.

functionArn

호출할 Lambda 함수ARN의 .

payload

(선택 사항) 기본 페이로드에는 작업을 트리거한 이벤트와 감지기 모델 인스턴스에 대한 정보가 있는 모든 속성-값 페어가 포함됩니다. 또한 페이로드를 사용자 지정할 수도 있습니다. 자세한 내용은 AWS IoT Events API 참조의 페이로드를 참조하세요.

참고

AWS IoT Events 서비스 역할에 연결된 정책이 lambda:InvokeFunction 권한을 부여하는지 확인합니다. 자세한 내용은 에 대한 자격 증명 및 액세스 관리 AWS IoT Events 단원을 참조하십시오.

자세한 내용은 참조LambdaAction의 섹션을 참조하세요. AWS IoT Events API

Amazon Simple Notification Service

SNS action

Amazon SNS 주제 게시 작업을 사용하면 Amazon SNS 메시지를 게시할 수 있습니다. 지원하는 리전의 목록은 Amazon Web Services 일반 참조Amazon Simple Notification Service 엔드포인트 및 할당량을 참조하십시오.

Amazon Simple Notification Service(Amazon SNS)는 구독 중인 엔드포인트 또는 클라이언트에 대한 메시지 전달 또는 전송을 조정 및 관리하는 웹 서비스입니다. 자세한 내용은 Amazon Simple Notification Service 개발자 안내서SNS의 Amazon이란 무엇입니까?를 참조하세요.

참고

Amazon SNS 주제 게시 작업은 AmazonSNSFIFO(선입선출) 주제를 지원하지 않습니다. 규칙 엔진은 완전히 분산된 서비스이므로 Amazon SNS 작업이 시작될 때 메시지가 지정된 순서로 표시되지 않을 수 있습니다.

More information (2)

Amazon SNS 메시지를 게시할 때는 다음 파라미터를 지정해야 합니다.

targetArn

메시지를 수신하는 Amazon SNS 대상ARN의 입니다.

payload

(선택 사항) 기본 페이로드에는 작업을 트리거한 이벤트와 감지기 모델 인스턴스에 대한 정보가 있는 모든 속성-값 페어가 포함됩니다. 또한 페이로드를 사용자 지정할 수도 있습니다. 자세한 내용은 AWS IoT Events API 참조페이로드를 참조하세요.

참고

AWS IoT Events 서비스 역할에 연결된 정책이 sns:Publish 권한을 부여하는지 확인합니다. 자세한 내용은 에 대한 자격 증명 및 액세스 관리 AWS IoT Events 단원을 참조하십시오.

자세한 내용은 참조SNSTopicPublishAction의 섹션을 참조하세요. AWS IoT Events API

Amazon Simple Queue Service

SQS action

Amazon SQS 작업을 사용하면 Amazon SQS 대기열로 데이터를 전송할 수 있습니다. 지원되는 리전 목록은 Amazon Web Services 일반 참조Amazon Simple Queue Service 엔드포인트 및 할당량을 참조하십시오.

Amazon Simple Queue Service(Amazon SQS)는 분산 소프트웨어 시스템 및 구성 요소를 통합하고 분리할 수 있는 안전하고 내구성이 뛰어나며 사용 가능한 호스팅 대기열을 제공합니다. 자세한 정보는 Amazon Simple Queue Service 개발자 안내서What is Amazon Simple Queue Service?를 참조하십시오.

참고

Amazon SQS 작업은 >AmazonSQSFIFO(선입선출) 주제를 지원하지 않습니다. 규칙 엔진은 완전히 분산된 서비스이므로 Amazon SQS 작업이 시작될 때 메시지가 지정된 순서로 표시되지 않을 수 있습니다.

More information (3)

Amazon SQS 대기열로 데이터를 전송할 때는 다음 파라미터를 지정해야 합니다.

queueUrl

데이터를 수신하는 URL Amazon SQS 대기열의 입니다.

useBase64

(선택 사항)를 지정하는 경우 데이터를 Base64 텍스트로 AWS IoT Events 인코딩합니다TRUE. 기본값은 FALSE입니다.

payload

(선택 사항) 기본 페이로드에는 작업을 트리거한 이벤트와 감지기 모델 인스턴스에 대한 정보가 있는 모든 속성-값 페어가 포함됩니다. 또한 페이로드를 사용자 지정할 수도 있습니다. 자세한 내용은 AWS IoT Events API 참조의 페이로드를 참조하세요.

참고

AWS IoT Events 서비스 역할에 연결된 정책이 sqs:SendMessage 권한을 부여하는지 확인합니다. 자세한 내용은 에 대한 자격 증명 및 액세스 관리 AWS IoT Events 단원을 참조하십시오.

자세한 내용은 참조SNSTopicPublishAction의 섹션을 참조하세요. AWS IoT Events API

Amazon SNS 및 AWS IoT Core 규칙 엔진을 사용하여 함수를 트리거할 수도 있습니다 AWS Lambda . 이렇게 하면 Amazon Connect 또는 회사 엔터프라이즈 리소스 계획(ERP) 애플리케이션과 같은 다른 서비스를 사용하여 작업을 수행할 수 있습니다.

참고

대규모 데이터 레코드 스트림을 실시간으로 수집하고 처리하려면 Amazon Kinesis 와 같은 다른 AWS 서비스를 사용할 수 있습니다. 여기에서 초기 분석을 완료한 다음 결과를 에 감지기에 대한 입력 AWS IoT Events 으로 전송할 수 있습니다.