HTTP 주제 규칙 대상 작업

HTTP 주제 규칙 대상은 규칙 엔진이 주제 규칙에서 데이터를 라우팅할 수 있는 웹 서비스입니다. AWS IoT Core 리소스는 웹 서비스를 설명합니다 AWS IoT. 주제 규칙 대상 리소스는 여러 규칙에서 공유할 수 있습니다.

다른 웹 서비스에 데이터를 보내려면 먼저 AWS IoT Core 서비스의 엔드포인트에 액세스할 수 있는지 확인해야 합니다.

HTTP 주제 규칙 대상 개요

HTTP 주제 규칙 대상은 확인 URL과 하나 이상의 데이터 수집 URL을 지원하는 웹 서비스를 나타냅니다. HTTP 주제 규칙 대상 리소스에는 웹 서비스의 확인 URL이 포함되어 있습니다. HTTP 주제 규칙 작업을 구성할 때 웹 서비스의 확인 URL과 함께 데이터를 수신해야 하는 엔드포인트의 실제 URL을 지정합니다. 대상이 확인되면 주제 규칙은 SQL 문의 결과를 확인 URL이 아닌 HTTPS 엔드포인트로 전송합니다.

HTTP 주제 규칙 대상은 다음 상태 중 하나일 수 있습니다.

ENABLED

대상이 확인되었으며 규칙 작업에서 사용할 수 있습니다. 대상을 규칙에서 사용하려면 대상의 상태가 ENABLED여야 합니다. DISABLED 상태인 대상만 활성화할 수 있습니다.

DISABLED

대상이 확인되었지만 규칙 작업에서 사용할 수 없습니다. 이는 확인 프로세스를 다시 거치지 않고도 엔드포인트에 대한 트래픽을 일시적으로 차단하려는 경우에 유용합니다. ENABLED 상태인 대상만 비활성화할 수 있습니다.

IN_PROGRESS

대상 확인이 진행 중입니다.

ERROR

대상 확인 시간이 초과되었습니다.

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

확인할 주제 규칙 대상에 대한 Amazon Resource Name(ARN)입니다.

confirmationToken

에서 보낸 확인 토큰 AWS IoT Core. 이 예제의 토큰은 잘려져 있습니다. 사용자의 토큰은 더 길어집니다. 목적지를 확인하려면 이 토큰이 필요합니다 AWS IoT Core.

enableUrl

주제 규칙 대상을 확인하기 위해 찾아보는 URL입니다.

messageType

메시지 유형.

엔드포인트 확인 프로세스를 완료하려면 확인 URL에서 확인 요청을 받은 후 다음 중 하나를 수행해야 합니다.

• 확인 요청에서 enableUrl을 호출한 다음 UpdateTopicRuleDestination을 호출하여 주제 규칙의 상태를 ENABLED로 설정합니다.

• ConfirmTopicRuleDestination 작업을 호출하고 확인 요청에서 confirmationToken을 전달합니다.

• 를 confirmationToken 복사하여 AWS IoT 콘솔의 대상 확인 대화 상자에 붙여넣습니다.

새 확인 요청 전송하기

대상에 대해 새 확인 메시지를 활성화하려면 UpdateTopicRuleDestination을 호출하고 주제 규칙 대상의 상태를 IN_PROGRESS로 설정합니다.

새 확인 요청을 전송한 후 확인 프로세스를 반복합니다.

주제 규칙 대상 사용 중지 및 삭제

대상을 비활성화하려면 UpdateTopicRuleDestination을 호출하고 주제 규칙 대상의 상태를 DISABLED로 설정합니다. 새 확인 요청을 전송할 필요 없이 DISABLED 상태의 주제 규칙을 다시 사용할 수 있습니다.

주제 규칙 대상을 삭제하려면 DeleteTopicRuleDestination을 호출합니다.