AWS IoT Core AWS IoT Events AWS IoT SiteWise Amazon DynamoDB Amazon DynamoDB(v2)아마존 데이터 파이어호스 AWS Lambda Amazon Simple Notification Service Amazon Simple Queue Service

다른 AWS 서비스와 함께 작업하기

AWS IoT Events 는 AWS 서비스를 사용할 수 있는 다음 작업을 지원합니다.

iotTopicPublish로 MQTT 주제에 대한 메시지 게시.
iotEvents로 AWS IoT Events 에 입력 값으로 데이터 전송.
iotSiteWise로 AWS IoT SiteWise의 자산 속성에 데이터를 보냅니다.
dynamoDB로 Amazon DynamoDB 테이블에 데이터 전송.
dynamoDBv2로 Amazon DynamoDB 테이블에 데이터 전송.
firehoseAmazon 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 참조의 표현식 및 Payload를 참조하십시오.

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 개발자 안내서의 AWS IoT의 메시지 브로커를 참조하십시오.

More information (2)

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

mqttTopic

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

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

payload

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

참고

AWS IoT Events 서비스 역할에 연결된 정책이 iot:Publish 권한을 부여하는지 확인하세요. 자세한 설명은 AWS IoT Events의 I자격 증명 및 액세스 관리 섹션을 참조하세요.

자세한 내용을 알아보려면 AWS IoT Events API 참조의 IotTopicPublishAction(을)를 참조하세요.

AWS IoT Events

IoT Events action

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

AWS IoT Events 장비 또는 장치 플릿을 모니터링하여 작동 중 장애 또는 변경 사항이 있는지 확인하고 이러한 이벤트가 발생할 경우 조치를 트리거할 수 있습니다. 자세한 내용은 What is AWS IoT Events? 를 참조하십시오. AWS IoT Events 개발자 안내서에서

More information (2)

로 AWS IoT Events 데이터를 보낼 때는 다음 매개변수를 지정해야 합니다.

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

참고

AWS IoT Events 서비스 역할에 연결된 정책이 iotevents:BatchPutMessage 권한을 부여하는지 확인하세요. 자세한 설명은 AWS IoT Events의 I자격 증명 및 액세스 관리 섹션을 참조하세요.

자세한 내용을 알아보려면 AWS IoT Events API 참조의 IotEventsAction(을)를 참조하세요.

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 식별하도록 지정해야 합니다.
를 사용하는 경우 둘 중 하나 propertyAlias 또는 둘 다를 assetId propertyId 지정하여 대상 자산 속성을 식별해야 합니다. 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에 따라 다음 값 유형 중 하나를 지정해야 합니다. 자세한 내용을 알아보려면 AWS IoT SiteWise API 참조의 AssetProperty(을)를 참조하세요.

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

참고

AWS IoT Events 서비스 역할에 첨부된 정책이 iotsitewise:BatchPutAssetPropertyValue 권한을 부여하는지 확인하세요. 자세한 설명은 AWS IoT Events의 I자격 증명 및 액세스 관리 섹션을 참조하세요.

자세한 내용을 알아보려면 AWS IoT Events API 참조의 IotSiteWiseAction(을)를 참조하세요.

Amazon DynamoDB

DynamoDB action

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

Amazon DynamoDB는 완전관리형 NoSQL 데이터베이스 서비스로서 원활한 확장성과 함께 빠르고 예측 가능한 성능을 제공합니다. 자세한 내용을 알아보려면 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

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

참고

AWS IoT Events 서비스 역할에 연결된 정책이 dynamodb:PutItem 권한을 부여하는지 확인하세요. 자세한 설명은 AWS IoT Events의 I자격 증명 및 액세스 관리 섹션을 참조하세요.

자세한 내용은 AWS IoT Events API 참조의 DynamoDBAction을 참조하십시오.

Amazon DynamoDB(v2)

DynamoDBv2 action

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

More information (2)

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

tableName: 데이터를 수신하는 DynamoDB 테이블의 이름입니다. 표현식을 지정할 수도 있습니다.
payload: (선택 사항) 기본 페이로드에는 작업을 트리거한 이벤트와 감지기 모델 인스턴스에 대한 정보가 있는 모든 속성-값 페어가 포함됩니다. 또한 페이로드를 사용자 지정할 수도 있습니다. 자세한 내용은 AWS IoT Events API 참조의 Payload를 참조하십시오.

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

참고

자세한 내용은 AWS IoT Events API 참조의 DynamoDBv2Action을 참조하십시오.

아마존 데이터 파이어호스

Firehose action

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

Amazon Data Firehose는 아마존 심플 스토리지 서비스 (Amazon Simple Storage Service), 아마존 Redshift, 아마존 서비스 (서비스), 스플렁크와 같은 목적지로 실시간 스트리밍 데이터를 전송하는 완전 관리형 서비스입니다. OpenSearch OpenSearch 자세한 내용은 Amazon Data Firehose란 무엇입니까? 를 참조하십시오. Amazon Data Firehose 개발자 가이드에서 확인할 수 있습니다.

More information (3)

Firehose 전송 스트림으로 데이터를 전송할 때는 다음 매개변수를 지정해야 합니다.

deliveryStreamName: 데이터를 수신하는 Firehose 전송 스트림의 이름입니다.
separator: (선택 사항) 문자 구분자를 사용하여 Firehose 전송 스트림으로 전송되는 연속 데이터를 구분할 수 있습니다. 구분자 값은 '\n'(줄 바꿈), '\t'(탭), '\r\n'(Windows 새 줄) 또는 ','(쉼표)여야 합니다.
payload: (선택 사항) 기본 페이로드에는 작업을 트리거한 이벤트와 감지기 모델 인스턴스에 대한 정보가 있는 모든 속성-값 페어가 포함됩니다. 또한 페이로드를 사용자 지정할 수도 있습니다. 자세한 내용은 AWS IoT Events API 참조의 Payload를 참조하십시오.

참고

AWS IoT Events 서비스 역할에 연결된 정책이 권한을 부여하는지 확인하세요. firehose:PutRecord 자세한 설명은 AWS IoT Events의 I자격 증명 및 액세스 관리 섹션을 참조하세요.

자세한 내용을 알아보려면 AWS IoT Events API 참조의 FirehoseAction(을)를 참조하세요.

AWS Lambda

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 개발자 안내서의 What is Amazon SNS?를 참조하십시오.

참고

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

More information (2)

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

targetArn: 메시지가 전송되는 Amazon SNS 대상의 ARN입니다.
payload: (선택 사항) 기본 페이로드에는 작업을 트리거한 이벤트와 감지기 모델 인스턴스에 대한 정보가 있는 모든 속성-값 페어가 포함됩니다. 또한 페이로드를 사용자 지정할 수도 있습니다. 자세한 내용은 AWS IoT Events API 참조의 Payload를 참조하십시오.

참고

AWS IoT Events 서비스 역할에 연결된 정책이 sns:Publish 권한을 부여하는지 확인하세요. 자세한 설명은 AWS IoT Events의 I자격 증명 및 액세스 관리 섹션을 참조하세요.

자세한 내용은 AWS IoT Events API TopicPublishAction 참조의 SNS를 참조하십시오.

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 작업은 Amazon SQS 대기열 FIFO(선입선출) 주제를 지원하지 않습니다. 규칙 엔진은 완전 분산형 서비스이므로 Amazon SQS 작업이 시작될 때 메시지가 지정된 순서로 표시되지 않을 수 있습니다.

More information (3)

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

queueUrl: 데이터를 수신하는 Amazon SQS 대기열의 URL입니다.
useBase64: (선택 사항) 지정한 경우 데이터를 Base64 텍스트로 AWS IoT Events 인코딩합니다. TRUE 기본값은 FALSE입니다.
payload: (선택 사항) 기본 페이로드에는 작업을 트리거한 이벤트와 감지기 모델 인스턴스에 대한 정보가 있는 모든 속성-값 페어가 포함됩니다. 또한 페이로드를 사용자 지정할 수도 있습니다. 자세한 내용은 AWS IoT Events API 참조의 Payload를 참조하십시오.

참고

AWS IoT Events 서비스 역할에 연결된 정책이 권한을 부여하는지 확인하세요. sqs:SendMessage 자세한 설명은 AWS IoT Events의 I자격 증명 및 액세스 관리 섹션을 참조하세요.

자세한 내용은 AWS IoT Events API TopicPublishAction 참조의 SNS를 참조하십시오.

Amazon SNS와 AWS IoT Core 규칙 엔진을 사용하여 AWS Lambda 함수를 트리거할 수도 있습니다. 이를 통해 Amazon Connect와 같은 다른 서비스나 회사 ERP(전사적 자원 관리) 애플리케이션을 사용하여 조치를 취할 수 있습니다.

참고

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

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

기본 제공 작업 사용

표현식