

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

# HTTP
<a name="https-rule-action"></a>

HTTPS(`http`) 작업은 MQTT 메시지의 데이터를 HTTPS 엔드포인트로 전송합니다. HTTPS 엔드포인트는 웹 애플리케이션 또는 서비스를 가리킬 수 있습니다.

## 요구 사항
<a name="https-rule-action-requirements"></a>

이 규칙 작업은 다음 요구 사항을 충족해야 합니다.
+ 규칙 엔진에서 사용하려면 먼저 HTTPS 엔드포인트를 확인하고 활성화해야 합니다. 자세한 내용은 [HTTP 작업 대상](http-action-destination.md) 단원을 참조하십시오.

## 파라미터
<a name="https-rule-action-parameters"></a>

이 작업으로 AWS IoT 규칙을 생성할 때 다음 정보를 지정해야 합니다.

`url`  
메시지가 HTTP POST 메서드를 사용하여 전송되는 HTTPS 엔드포인트입니다. 호스트 이름 대신 IP 주소를 사용하는 경우 IPv4 주소여야 합니다. IPv6 주소는 지원하지 않습니다.  
[대체 템플릿](iot-substitution-templates.md) 지원: 예

`confirmationUrl`  
(선택 사항) 지정된 경우 확인 URL을 AWS IoT 사용하여 일치하는 주제 규칙 대상을 생성합니다. HTTP 작업에서 사용하기 전에 HTTP 작업 대상을 활성화해야 합니다. 자세한 내용은 [HTTP 작업 대상](http-action-destination.md) 단원을 참조하십시오. 대체 템플릿을 사용하는 경우 작업을 `http` 사용하려면 먼저 HTTP 작업 대상을 수동으로 생성해야 합니다.는 접두사여야 `confirmationUrl` 합니다`url`.  
`url`과 `confirmationUrl` 사이의 관계는 다음으로 설명됩니다.  
+ `url`가 하드코딩되고 `confirmationUrl`가 제공되지 않은 경우 `url` 필드를 로 암시적으로 취급합니다`confirmationUrl`.는에 대한 주제 규칙 대상을 AWS IoT 생성합니다`url`.
+ `url` 및 `confirmationUrl`가 하드코딩된 경우는 로 시작해야 `url` 합니다`confirmationUrl`.는에 대한 주제 규칙 대상을 AWS IoT 생성합니다`confirmationUrl`.
+ `url`에 대체 템플릿이 포함되어 있는 경우 `confirmationUrl`을 지정하고 `url`은 `confirmationUrl`로 시작해야 합니다. 에 대체 템플릿이 `confirmationUrl` 포함된 경우 HTTP 작업 대상을 수동으로 생성해야 `http` 작업을 사용할 수 있습니다. `confirmationUrl`에 대체 템플릿이 포함되어 있지 않은 경우는에 대한 주제 규칙 대상을 AWS IoT 생성합니다`confirmationUrl`.
[대체 템플릿](iot-substitution-templates.md) 지원: 예

`headers`  
(선택 사항) 엔드포인트에 대한 HTTP 요청에 포함할 헤더 목록입니다. 각 헤더에는 다음 정보가 포함되어야 합니다.    
`key`  
헤더의 키입니다.  
[대체 템플릿](iot-substitution-templates.md) 지원: 아니요  
`value`  
헤더의 값  
[대체 템플릿](iot-substitution-templates.md) 지원: 예
페이로드가 JSON 형식일 때 기본 콘텐츠 유형은 application/json입니다. 그렇지 않으면 application/octet-stream입니다. 키 콘텐츠 유형(대/소문자 구분 없음)으로 헤더에서 정확한 콘텐츠 유형을 지정하여 덮어쓸 수 있습니다.

`auth`  
(선택 사항) `url` 인수에 지정된 엔드포인트 URL에 연결하기 위해 규칙 엔진에서 사용하는 인증입니다. 현재 서명 버전 4는 유일하게 지원되는 인증 유형입니다. 자세한 내용은 [HTTP 권한 부여](https://docs.aws.amazon.com/iot/latest/apireference/API_HttpAuthorization.html)를 참조하세요.  
[대체 템플릿](iot-substitution-templates.md) 지원: 아니요

`enableBatching`  
(선택 사항) HTTP 작업 메시지를 지정된 URL에 대한 단일 요청으로 처리할지 여부입니다. 값은 true 또는 false일 수 있습니다. 일괄 처리에 대한 자세한 내용은 [HTTP 작업 메시지 일괄 처리를 참조하세요](http_batching.md).  
부울 값  
[대체 템플릿](iot-substitution-templates.md) 지원: 아니오

`batchConfig`  
(선택 사항) 일괄 처리를 위한 구성 설정입니다. 활성화되면 `batchConfig` 파라미터를 지정해야 합니다. `batchConfig` 파라미터를 지정하지 않으면 기본값이 사용됩니다.    
`maxBatchOpenMs`  
발신 메시지가 다른 메시지가 배치를 생성할 때까지 대기하는 최대 시간(밀리초)입니다. 설정이 높을수록 일괄 HTTP 작업의 지연 시간이 길어집니다.  
최소값: 5ms. 최댓값: 200ms.  
기본값: 20ms  
[대체 템플릿](iot-substitution-templates.md) 지원: 아니오  
`maxBatchSize`  
단일 작업 실행에서 함께 일괄 처리되는 최대 메시지 수입니다.  
[대체 템플릿](iot-substitution-templates.md) 지원: 아니오  
최솟값: 메시지 2개. 최대값: 메시지 10개  
기본값: 메시지 10개  
`maxBatchSizeBytes`  
메시지 배치의 최대 크기, 바이트 단위.  
최소값: 100바이트. 최대값: 131,072바이트  
기본값: 5,120바이트  
[대체 템플릿](iot-substitution-templates.md) 지원: 아니오
페이로드가 JSON 형식일 때 기본 콘텐츠 유형은 application/json입니다. 그렇지 않으면 application/octet-stream입니다. 키 콘텐츠 유형(대/소문자 구분 없음)으로 헤더에서 정확한 콘텐츠 유형을 지정하여 덮어쓸 수 있습니다.

## 예제
<a name="https-rule-action-examples"></a>

다음 JSON 예제에서는 HTTP 작업을 사용하여 AWS IoT 규칙을 정의합니다.

```
{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23", 
        "actions": [
            { 
                "http": { 
                    "url": "https://www.example.com/subpath",
                    "confirmationUrl": "https://www.example.com", 
                    "headers": [
                        { 
                            "key": "static_header_key", 
                            "value": "static_header_value" 
                        },
                        { 
                            "key": "substitutable_header_key", 
                            "value": "${value_from_payload}" 
                        }
                    ] 
                } 
            }
        ]
    }
}
```

```
"http": { 
    "url": "https://www.example.com/subpath",
    "confirmationUrl": "https://www.example.com", 
    "headers": [
        { 
            "key": "Content-Type",
            "value": "application/json"
          }
    ],
    "enableBatching": true, 
    "batchConfig": {     
      "maxBatchOpenMs": 123, 
      "maxBatchSize": 5, 
      "maxBatchSizeBytes": 131072,
     }
 },
 "errorAction": { 
        "http": { 
            "url": "https://www.example.com/subpath",
            "confirmationUrl": "https://www.example.com"
            // batchConfig is not allowed here
        }
}
```

## HTTP 작업 재시도 논리
<a name="https-rule-action-retry-logic"></a>

 AWS IoT 규칙 엔진은 다음 규칙에 따라 HTTP 작업을 재시도합니다.
+ 규칙 엔진은 메시지를 한 번 이상 전송하려고 시도합니다.
+ 규칙 엔진은 최대 두 번 재시도합니다. 최대 시도 횟수는 3회입니다.
+ 규칙 엔진은 다음과 같은 경우 재시도를 수행하지 않습니다.
  + 이전 시도에서 16,384바이트보다 큰 응답을 제공했습니다.
  + 시도 후 다운스트림 웹 서비스 또는 애플리케이션에서 TCP 연결을 닫습니다.
  + 재시도로 요청을 완료하는 데 걸리는 총 시간이 요청 제한 시간 한도를 초과했습니다.
  + 이 요청이 429, 500-599 이외의 HTTP 상태 코드를 반환합니다.

**참고**  
[표준 데이터 전송 비용](https://aws.amazon.com/ec2/pricing/on-demand/)이 재시도에 적용됩니다.

## 다음 사항도 참조하세요.
<a name="https-rule-action-see-also"></a>
+ [HTTP 작업 메시지 배치 처리](http_batching.md)
+ [HTTP 작업 대상](http-action-destination.md)
+ 블로그*의 사물 인터넷 AWS*에서 [에서 AWS IoT Core 웹 서비스로 직접 데이터 라우팅](https://aws.amazon.com/blogs/iot/route-data-directly-from-iot-core-to-your-web-services/) 

# HTTP 작업 메시지 배치 처리
<a name="http_batching"></a>

일괄 처리를 사용하여 단일 요청으로 여러 HTTP 작업 메시지를 보낼 수 있습니다.

## 개요
<a name="batching_overview"></a>

일괄 처리를 사용하면 AWS IoT Core 규칙 엔진에서 HTTP 엔드포인트로 메시지를 일괄 전송할 수 있습니다. 이 기능을 사용하면 HTTP 작업 실행 수를 줄이고 새 연결 설정과 관련된 오버헤드를 줄여 효율성을 개선할 수 있습니다.

**참고**  
일괄 HTTP 작업은 단일 작업으로 측정됩니다. AWS IoT Core 규칙 엔진에서 다운스트림 서비스로 내보내는 아웃바운드 배치 페이로드의 크기를 기준으로 5kiB 단위로 측정됩니다. 자세한 내용은 [AWS IoT Core 요금](https://aws.amazon.com/iot-core/pricing/) 페이지를 참조하세요.

IoT 규칙 작업의 정의에서 일괄 처리를 활성화하면 구성에 다음 파라미터를 사용할 수 있습니다.

`maxBatchOpenMs`  
발신 메시지가 다른 메시지가 배치를 생성할 때까지 대기하는 최대 시간(밀리초)입니다. 설정이 높을수록 일괄 HTTP 작업의 지연 시간이 길어집니다.  
최소값: 5ms. 최댓값: 200ms.  
기본값: 20ms  
[대체 템플릿](iot-substitution-templates.md) 지원: 아니오

`maxBatchSize`  
단일 IoT 규칙 작업 실행에서 함께 일괄 처리되는 최대 메시지 수입니다.  
최솟값: 메시지 2개. 최대값: 메시지 10개  
기본값: 메시지 10개  
[대체 템플릿](iot-substitution-templates.md) 지원: 아니오

`maxBatchSizeBytes`  
메시지 배치의 최대 크기, 바이트 단위.  
최소값: 100바이트. 최대값: 131,072바이트  
기본값: 5120바이트  
[대체 템플릿](iot-substitution-templates.md) 지원: 아니오

**중요**  
여러 배치 파라미터를 지정하면 첫 번째 한도에 도달하면 일괄 처리가 완료됩니다. 예를 들어 최대 배치 열기 시간으로 100ms를 지정하고 최대 배치 크기로 5kiB를 지정하고 규칙 엔진이 100ms 이내에 2kiB만 배치하는 경우 2kiB 배치가 생성되고 전송됩니다.

## 배치에서 HTTP 헤더 사용
<a name="batching_http_headers"></a>

HTTP 작업에서 헤더를 사용하는 경우 일괄 처리 요청은 배치에 추가된 마지막 메시지의 헤더 값(반드시 게시한 마지막 메시지가 아님)을 사용합니다. 다음 중 하나인 헤더 값을 사용하는 것이 좋습니다.
+ 배치의 모든 메시지에서 동일
+ 모든 메시지에 적용 가능(예: 인증 자격 증명)

헤더는 HTTP 요청과 함께 전송되며 메시지 본문의 일부가 아닙니다.

**참고**  
일괄 처리가 활성화된 경우:  
배치 요청은 배치가 JSON 배열로 전송되므로 `Content-Type: application/json` 헤더를 자동으로 포함합니다.
배치의 마지막 메시지가 게시한 마지막 메시지임을 보장할 수는 없습니다. 배치로 만든 마지막 메시지입니다.

## 페이로드 예제
<a name="batching_payload"></a>

다음 예제는 HTTP 엔드포인트로 전송된 일괄 메시지 페이로드의 구조를 보여줍니다.

```
[
  {
    "user_id": "user1",
    "steps_today": 1000
  },
  {
    "user_id": "user2",
    "steps_today": 21000
  },
  {
    "user_id": "user8",
    "steps_today": 1500
  },
  ...
]
```

## 제한 사항
<a name="batching_limitations"></a>

다음은 일괄 처리의 제한 사항입니다.
+ AWS IoT Core 는 전체 메시지 순서를 보장하지 않습니다. 배치는 각 호스트에서 로컬로 수행되므로 배치 내의 메시지가 수신된 순서와 다른 순서로 처리될 수 있습니다.
+ AWS IoT Core 는 수신자 측에서 메시지 처리 지원을 제공하지 않습니다. 다운스트림 서비스가 데이터를 일괄적으로 수락하고 처리하도록 구성되어 있는지 확인하는 것은 사용자의 책임입니다.
+ 메시지가 동일한 리소스 식별자(HTTP URL 또는 리소스 ARN)로 향하는 경우에도 교차 계정 일괄 처리는 지원되지 않습니다.
+ AWS IoT Core 는 배치 크기가 지정한 구성을 충족할 것이라고 보장하지 않습니다. 배치는 타이밍 및 메시지 흐름에 따라 구성된 제한보다 작을 수 있습니다.
+ 일괄 처리가 활성화된 경우 이진 페이로드(UTF-8이 아닌 데이터)는 지원되지 않습니다. UTF-8 텍스트 페이로드(예: JSON)만 허용됩니다. 바이너리 데이터를 전송하려면 HTTP 작업으로 전송하기 전에 base64로 인코딩한 다음 수신 엔드포인트에서 디코딩합니다. 예를 들어 IoT 규칙의 [인코딩 함수](iot-sql-functions.html#iot-function-encode)를 사용하여 바이너리 페이로드를 인코딩할 수 있습니다. 또는 IoT 디바이스에서 바이너리 페이로드를 인코딩하여에 게시할 수 있습니다 AWS IoT Core.

## 일괄 처리를 위한 오류 작업
<a name="batching_errors"></a>

오류 작업 정의에서 별도의 일괄 처리 로직을 정의할 수 없습니다. 그러나 기본 작업에서 일괄 처리 로직을 정의한 경우 오류 작업은 일괄 처리를 지원합니다.

배치 요청이 실패하면 AWS IoT Core 규칙 엔진은 [HTTP 작업 재시도 로직](https-rule-action.md#https-rule-action-retry-logic)을 따릅니다. 마지막 재시도 후 실패한 전체 배치에 대해 오류 작업이 호출됩니다.

다음은 일괄 처리가 활성화된 오류 작업 메시지의 예입니다.

```
{
    "ruleName": "FailedTopicRule",
    "topic": "topic/rulesengine",
    "payloadsWithMetadata": [
        {
            "id": 1,
            "cloudwatchTraceId": "bebd6d93-6d4a-899e-9e40-56e82252d2be",
            "clientId": "Test",
            "sourceIp": "10.0.0.0",
            "base64OriginalPayload": "eyJ1c2VyX2lkIjogInVzZXI1NjQ3IiwgInN0ZXBzX3RvZGF5IjogMTMzNjUsICJ0aW1lc3RhbXAiOiAiMjAyNS0xMC0wOVQwNzoyMjo1OC45ODQ3OTAxNzZaIn0="
        },
        {
            "id": 2,
            "cloudwatchTraceId": "af94d3b8-0b18-1dbf-2c7d-513f5cb9e2e1",
            "clientId": "Test",
            "sourceIp": "10.0.0.0",
            "base64OriginalPayload": "eyJ1c2VyX2lkIjogInVzZXI1NjQ3IiwgInN0ZXBzX3RvZGF5IjogMTMzNjUsICJ0aW1lc3RhbXAiOiAiMjAyNS0xMC0wOVQwNzoyMjo1OC45ODQ3OTAxNzZaIn0="
        },
        {
            "id": 3,
            "cloudwatchTraceId": "ca441266-c2ce-c916-6aee-b9e5c7831675",
            "clientId": "Test",
            "sourceIp": "10.0.0.0",
            "base64OriginalPayload": "eyJ1c2VyX2lkIjogInVzZXI1NjQ3IiwgInN0ZXBzX3RvZGF5IjogMTMzNjUsICJ0aW1lc3RhbXAiOiAiMjAyNS0xMC0wOVQwNzoyMjo1OC45ODQ3OTAxNzZaIn0="
        }
    ],
    "failures": [
        {
            "affectedIds": [
                1,
                2,
                3
            ],
            "failedAction": "HttpAction",
            "failedResource": "https://example.foobar.com/HttpAction",
            "errorMessage": "HttpAction failed to make a request to the specified endpoint. StatusCode: 500. Reason: Internal Server Error."
        },
        {
            "affectedIds": [
                3
            ],
            "failedAction": "S3Action",
            "failedResource": "amzn-s3-demo-bucket",
            "errorMessage": "Failed to put S3 object. The error received was The specified bucket does not exist"
        },
        {
            "affectedIds": [
                3
            ],
            "failedAction": "LambdaAction",
            "failedResource": "arn:aws:lambda:us-west-2:123456789012:function:dummy",
            "errorMessage": "Failed to invoke lambda function. Received Server error from Lambda. The error code is 403"
        }
    ]
}
```

**참고**  
또한 배치 작업 실패는 더 큰 오류 작업 페이로드를 생성하여 크기로 인한 오류 작업 실패 가능성을 높일 수 있습니다. `ErrorActionFailure` 지표를 사용하여 오류 작업 실패를 모니터링할 수 있습니다. 자세한 정보는 [규칙 작업 지표](metrics_dimensions.md#rule-action-metrics)을 참조하세요.

## 를 사용하여 HTTP 작업 메시지 일괄 처리 AWS CLI
<a name="batching_procedure"></a>

### 일괄 처리를 사용하여 규칙 작업 생성 또는 업데이트
<a name="batching_create_update_rule"></a>

1. 적절한 AWS CLI 명령을 사용하여 규칙을 생성하거나 업데이트합니다.
   + 새 규칙을 생성하려면 [create-topic-rule](https://docs.aws.amazon.com/cli/latest/reference/iot/create-topic-rule.html) 명령을 사용합니다.

     ```
     aws iot create-topic-rule --rule-name myrule --topic-rule-payload file://myrule.json
     ```
   + 기존 규칙을 업데이트하려면 [replace-topic-rule](https://docs.aws.amazon.com/cli/latest/reference/iot/replace-topic-rule.html) 명령을 사용합니다.

     ```
     aws iot replace-topic-rule --rule-name myrule --topic-rule-payload file://myrule.json
     ```

1. 주제 규칙 페이로드에서 enableBatching 파라미터를 true로 설정하여 일괄 처리 기능을 활성화합니다.

   ```
   {
           "topicRulePayload": {
           "sql": "SELECT * FROM 'some/topic'", 
           "ruleDisabled": false,
           "awsIotSqlVersion": "2016-03-23", 
           "actions": [
               { 
                   "http": { 
                       "url": "https://www.example.com/subpath",
                       "confirmationUrl": "https://www.example.com", 
                       "headers": [
                           { 
                               "key": "static_header_key", 
                               "value": "static_header_value" 
                           },
                           { 
                               "key": "substitutable_header_key", 
                               "value": "${value_from_payload}" 
                            }
                       ],
                       "enableBatching": true,
                       "batchConfig": {
                          "maxBatchOpenMs": 100,
                          "maxBatchSize": 5,
                          "maxBatchSizeBytes": 1024
                       }
                   }
               }
         ]
   }
   ```

1. 일괄 처리 파라미터를 구성합니다. 모든 배치 파라미터를 지정할 필요는 없습니다. 1, 2 또는 3개의 배치 파라미터를 모두 지정하도록 선택할 수 있습니다. 배치 파라미터를 지정하지 않으면 규칙 엔진은 해당 파라미터를 기본값으로 업데이트합니다. 파라미터 일괄 처리 및 기본값에 대한 자세한 내용은 [HTTP 파라미터를](https-rule-action.md#https-rule-action-parameters) 참조하세요.

# 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/) 모두에서 발급된 인증서를 지원합니다.