기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
HTTP 작업 대상
HTTP 작업 대상은 규칙 엔진이 주제 규칙에서 데이터를 라우팅할 수 있는 웹 서비스입니다. AWS IoT Core 리소스는에 대한 웹 서비스를 설명합니다 AWS IoT. 대상 리소스는 다른 규칙에서 공유할 수 있습니다.
AWS IoT Core 가 다른 웹 서비스로 데이터를 전송하려면 먼저 서비스의 엔드포인트에 액세스할 수 있는지 확인해야 합니다.
개요
HTTP 작업 대상은 확인 URL과 하나 이상의 데이터 수집 URLs을 지원하는 웹 서비스를 말합니다. 대상 리소스에는 웹 서비스의 확인 URL이 포함되어 있습니다. HTTP 작업을 구성할 때 웹 서비스의 확인 URL과 함께 데이터를 수신해야 하는 엔드포인트의 실제 URL을 지정합니다. 대상이 확인되면 주제 규칙은 SQL 문의 결과를 확인 URL이 아닌 HTTPS 엔드포인트로 전송합니다.
HTTP 작업 대상은 다음 상태 중 하나일 수 있습니다.
- ENABLED
-
대상이 확인되었으며 규칙 작업에서 사용할 수 있습니다. 대상을 규칙에서 사용하려면 대상의 상태가
ENABLED여야 합니다. DISABLED 상태인 대상만 활성화할 수 있습니다. - DISABLED
-
대상이 확인되었지만 규칙 작업에서 사용할 수 없습니다. 이는 확인 프로세스를 다시 거치지 않고도 엔드포인트에 대한 트래픽을 일시적으로 차단하려는 경우에 유용합니다. ENABLED 상태인 대상만 비활성화할 수 있습니다.
- IN_PROGRESS
-
대상 확인이 진행 중입니다.
- ERROR
-
대상 확인 시간이 초과되었습니다.
HTTP 작업 대상이 확인되고 활성화되면 계정의 모든 규칙과 함께 사용할 수 있습니다.
HTTP 작업 대상 관리
다음 작업을 사용하여 HTTP 작업 대상을 관리할 수 있습니다.
HTTP 작업 대상 생성
CreateTopicRuleDestination 작업을 호출하거나 AWS IoT 콘솔을 사용하여 HTTP 작업 대상을 생성합니다.
대상을 생성한 후는 확인 URL로 확인 요청을 AWS IoT 보냅니다. 확인 요청의 형식은 다음과 같습니다.
HTTP POST {confirmationUrl}/?confirmationToken={confirmationToken} Headers: x-amz-rules-engine-message-type: DestinationConfirmation x-amz-rules-engine-destination-arn:"arn:aws:iot:us-east-1:123456789012:ruledestination/http/7a280e37-b9c6-47a2-a751-0703693f46e4" Content-Type: application/json Body: { "arn":"arn:aws:iot:us-east-1:123456789012:ruledestination/http/7a280e37-b9c6-47a2-a751-0703693f46e4", "confirmationToken": "AYADeMXLrPrNY2wqJAKsFNn-…NBJndA", "enableUrl": "https://iot.us-east-1.amazonaws.com/confirmdestination/AYADeMXLrPrNY2wqJAKsFNn-…NBJndA", "messageType": "DestinationConfirmation" }
확인 요청의 내용에는 다음 정보가 포함됩니다.
- arn
-
확인할 HTTP 작업 대상의 Amazon 리소스 이름(ARN)입니다.
- confirmationToken
-
에서 전송한 확인 토큰입니다 AWS IoT Core. 이 예제의 토큰은 잘려져 있습니다. 사용자의 토큰은 더 길어집니다. AWS IoT Core와 대상을 확인하려면 이 토큰이 필요합니다.
- enableUrl
-
주제 규칙 대상을 확인하기 위해 찾아보는 URL입니다.
- messageType
-
메시지 유형.
HTTP 작업 대상 확인
AWS CLI를 사용하는 경우 엔드포인트 확인 프로세스를 완료하려면 확인 URL에서 확인 요청을 받은 후 다음 중 하나를 수행해야 합니다.
-
대상이 메시지를 수신할 준비가 되었는지 확인
HTTP 작업 대상이 IoT 메시지를 수신할 준비가 되었는지 확인하려면 확인 요청
enableUrl에서를 호출하거나ConfirmTopicRuleDestinationAPI 작업을 수행하고 확인 요청confirmationToken에서를 전달합니다. -
주제 규칙 상태를 활성화됨으로 설정
대상에서 메시지를 수신할 수 있는지 확인한 후
UpdateTopicRuleDestinationAPI 작업을 수행하여 주제 규칙의 상태를ENABLED로 설정해야 합니다.
AWS IoT 콘솔을 사용하는 경우를 복사confirmationToken하여 AWS IoT 콘솔의 대상 확인 대화 상자에 붙여 넣습니다. 그런 다음 주제 규칙을 활성화할 수 있습니다.
새 확인 요청 전송하기
대상에 대해 새 확인 메시지를 활성화하려면 UpdateTopicRuleDestination을 호출하고 주제 규칙 대상의 상태를 IN_PROGRESS로 설정합니다.
새 확인 요청을 전송한 후 확인 프로세스를 반복합니다.
HTTP 작업 대상 비활성화 및 삭제
대상을 비활성화하려면 UpdateTopicRuleDestination을 호출하고 주제 규칙 대상의 상태를 DISABLED로 설정합니다. 새 확인 요청을 전송할 필요 없이 DISABLED 상태의 주제 규칙을 다시 사용할 수 있습니다.
HTTP 작업 대상을 삭제하려면를 호출합니다DeleteTopicRuleDestination.
인증 기관 지원
참고
자체 서명된 인증서는 지원되지 않습니다.
HTTP 작업 대상의 HTTPS 엔드포인트는 AWS Private Certificate Authority