HTTP - AWS IoT Core
요구 사항파라미터예HTTP 작업 재시도 논리다음 사항도 참조하세요.

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

HTTP

HTTPS(http) 작업은 MQTT 메시지의 데이터를 웹 애플리케이션 또는 서비스에 전송합니다.

요구 사항

이 규칙 작업은 다음 요구 사항을 충족해야 합니다.

  • 규칙 엔진에서 사용하려면 먼저 HTTPS 엔드포인트를 확인하고 활성화해야 합니다. 자세한 정보는 HTTP 주제 규칙 대상 작업을 참조하세요.

파라미터

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

url

메시지가 HTTP POST 메서드를 사용하여 전송되는 HTTPS 엔드포인트입니다. 호스트 이름 대신 IP 주소를 사용하는 경우 IPv4 주소여야 합니다. IPv6 주소는 지원하지 않습니다.

대체 템플릿 지원: 예

confirmationUrl

(선택 사항) 지정된 경우 확인 URL을 AWS IoT 사용하여 일치하는 주제 규칙 대상을 만듭니다. 주제 규칙 대상을 HTTP 작업에 사용하려면 먼저 해당 대상을 활성화해야 합니다. 자세한 정보는 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 작업을 사용할 수 있습니다. 대체 템플릿이 포함되어 confirmationUrl 있지 않은 경우 주제 규칙 대상을 AWS IoT 생성합니다. confirmationUrl

대체 템플릿 지원: 예

headers

(선택 사항) 엔드포인트에 대한 HTTP 요청에 포함할 헤더 목록입니다. 각 헤더에는 다음 정보가 포함되어야 합니다.

key

헤더의 키입니다.

대체 템플릿 지원: 아니요

value

헤더의 값

대체 템플릿 지원: 예

참고

페이로드가 JSON 형식일 때 기본 콘텐츠 유형은 application/json입니다. 그렇지 않으면 application/octet-stream입니다. 키 콘텐츠 유형(대/소문자 구분 없음)으로 헤더에서 정확한 콘텐츠 유형을 지정하여 덮어쓸 수 있습니다.

auth

(선택 사항) url 인수에 지정된 엔드포인트 URL에 연결하기 위해 규칙 엔진에서 사용하는 인증입니다. 현재 서명 버전 4는 유일하게 지원되는 인증 유형입니다. 자세한 내용은 HTTP 권한 부여를 참조하세요.

대체 템플릿 지원: 아니요

예

다음 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 작업 재시도 논리

AWS IoT 규칙 엔진은 다음 규칙에 따라 HTTP 작업을 재시도합니다.

  • 규칙 엔진은 메시지를 한 번 이상 전송하려고 시도합니다.

  • 규칙 엔진은 최대 두 번 재시도합니다. 최대 시도 횟수는 3회입니다.

  • 규칙 엔진은 다음과 같은 경우 재시도를 수행하지 않습니다.

    • 이전 시도에서 16,384바이트보다 큰 응답을 제공했습니다.

    • 시도 후 다운스트림 웹 서비스 또는 애플리케이션에서 TCP 연결을 닫습니다.

    • 재시도로 요청을 완료하는 데 걸리는 총 시간이 요청 제한 시간 한도를 초과했습니다.

    • 이 요청이 429, 500-599 이외의 HTTP 상태 코드를 반환합니다.

참고

표준 데이터 전송 비용이 재시도에 적용됩니다.

다음 사항도 참조하세요.