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

# HTTP 작업 대상
<a name="http-action-destination"></a>

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

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

## 개요
<a name="http-action-destination-overview"></a>

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

HTTP 작업 대상은 다음 상태 중 하나일 수 있습니다.

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

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

IN\$1PROGRESS  
대상 확인이 진행 중입니다.

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

HTTP 작업 대상이 확인되고 활성화되면 계정의 모든 규칙과 함께 사용할 수 있습니다.

## HTTP 작업 대상 관리
<a name="http-action-destination-managing"></a>

다음 작업을 사용하여 HTTP 작업 대상을 관리할 수 있습니다.

### HTTP 작업 대상 생성
<a name="http-action-destination-creating"></a>

`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 작업 대상 확인
<a name="http-action-destination-confirming"></a>

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

1. 

**대상이 메시지를 수신할 준비가 되었는지 확인**  
HTTP 작업 대상이 IoT 메시지를 수신할 준비가 되었는지 확인하려면 확인 요청`enableUrl`에서를 호출하거나 `ConfirmTopicRuleDestination` API 작업을 수행하고 확인 요청`confirmationToken`에서를 전달합니다.

1. 

**주제 규칙 상태를 활성화됨으로 설정**  
대상에서 메시지를 수신할 수 있는지 확인한 후 `UpdateTopicRuleDestination` API 작업을 수행하여 주제 규칙의 상태를 `ENABLED`로 설정해야 합니다.

 AWS IoT 콘솔을 사용하는 경우를 복사`confirmationToken`하여 AWS IoT 콘솔의 대상 확인 대화 상자에 붙여 넣습니다. 그런 다음 주제 규칙을 활성화할 수 있습니다.

### 새 확인 요청 전송하기
<a name="trigger-confirm"></a>

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

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

### HTTP 작업 대상 비활성화 및 삭제
<a name="http-action-destination-deleting"></a>

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

HTTP 작업 대상을 삭제하려면를 호출합니다`DeleteTopicRuleDestination`.

## 인증 기관 지원
<a name="http-action-destination-certificates"></a>

**참고**  
자체 서명된 인증서는 지원되지 않습니다.

 HTTP 작업 대상의 HTTPS 엔드포인트는 [AWS Private Certificate Authority](https://www.amazontrust.com/repository/)와 [Lets Encrypt](https://letsencrypt.org/certificates/) 모두에서 발급된 인증서를 지원합니다.