IoT Analytics 커넥터

이 커넥터에 할당할 메모리 양(KB)입니다.

AWS IoT 콘솔의 표시 이름: 메모리 크기

필수: true

형식: string

유효한 패턴: ^[0-9]+$

AWS IoT Analytics 채널이 생성되는 AWS 리전입니다. 커넥터와 동일한 리전을 사용합니다.

AWS IoT 콘솔의 표시 이름: 게시 리전

필수: false

형식: string

유효한 패턴: ^$|([a-z]{2}-[a-z]+-\\d{1})

수신된 데이터의 배치를 AWS IoT Analytics에 게시하는 간격(초)입니다.

AWS IoT 콘솔의 표시 이름: 게시 간격

필수: false

형식: string

기본값: 1

유효한 패턴: $|^[0-9]+$

커넥터가 활성으로 감시하는 최대 AWS IoT Analytics 채널 수입니다. 이 값은 0보다 커야 하며 최소한 커넥터가 지정된 시간에 게시할 것으로 예상되는 채널 수와 같아야 합니다.

이 파라미터를 사용하면 커넥터가 지정된 시간에 관리할 수 있는 총 대기열 수를 제한하여 메모리 사용을 제한할 수 있습니다. 대기된 메시지를 모두 전송하면 대기열이 삭제됩니다.

AWS IoT 콘솔의 표시 이름: 활성 채널의 최대 수

필수: false

형식: string

기본값: 50

유효한 패턴: ^$|^[1-9][0-9]*$

대기열이 가득 차 있을 때 채널 대기열에서 메시지를 삭제하기 위한 동작입니다.

AWS IoT 콘솔의 표시 이름: 대기열 삭제 동작

필수: false

형식: string

유효한 값: DROP_NEWEST 또는 DROP_OLDEST

기본값: DROP_NEWEST

유효한 패턴: ^DROP_NEWEST$|^DROP_OLDEST$

메시지가 제출되거나 삭제되기 전에 메모리에 유지할 최대 메시지 수입니다(채널당). 이 값은 0보다 커야 합니다.

AWS IoT 콘솔의 표시 이름: 채널당 최대 대기열 크기

필수: false

형식: string

기본값: 2048

유효한 패턴: ^$|^[1-9][0-9]*$

배치 요청에서 AWS IoT Analytics 채널에 전송할 최대 메시지 수입니다. 이 값은 0보다 커야 합니다.

AWS IoT 콘솔의 표시 이름: 채널당 일괄 처리할 최대 메시지 수

필수: false

형식: string

기본값: 5

유효한 패턴: ^$|^[1-9][0-9]*$

이 커넥터가 고객 정의 입력 주제로 전송되는 메시지에 사용하는 AWS IoT Analytics 채널의 이름입니다.

AWS IoT 콘솔의 표시 이름: 기본 채널 이름

필수: false

형식: string

유효한 패턴: ^[a-zA-Z0-9_]$

이 커넥터의 컨테이너화 모드입니다. 기본값은 GreengrassContainer이며 이는 커넥터가 AWS IoT Greengrass 컨테이너 내부의 격리된 런타임 환경에서 실행됨을 의미합니다.

AWS IoT 콘솔의 표시 이름: 컨테이너 격리 모드

필수: false

형식: string

유효한 값: GreengrassContainer 또는 NoContainer

유효한 패턴: ^NoContainer$|^GreengrassContainer$

이 커넥터는 게시자가 인라인으로 채널 이름을 지정하도록 허용하는 다음 두 가지 정형 MQTT 주제를 지원합니다.

커넥터는 구독에서 구성한 모든 MQTT 주제에 대한 입력 메시지를 수락하도록 허용하는 # 주제 구문을 지원합니다. 구독에 # 와일드카드만 사용하는 대신 주제 경로를 지정하는 것이 좋습니다. 이러한 메시지는 커넥터에 지정하는 기본 채널로 전송됩니다.

고객 정의 주제에 대한 입력 메시지는 바이너리 데이터로 처리됩니다. 이러한 메시지는 모든 메시지 형식을 사용할 수 있으며 모든 데이터 유형을 포함할 수 있습니다. 고객 정의 주제를 사용하여 고정 주제에 게시하는 디바이스의 메시지를 라우팅할 수 있습니다. 또한 이 주제를 사용하여 데이터를 커넥터에 전송할 형식 지정된 메시지로 처리할 수 없는 클라이언트 디바이스의 입력 데이터를 수락할 수 있습니다.

구독 및 MQTT 주제에 대한 자세한 내용은 입력 및 출력 단원을 참조하십시오.

이 주제를 사용하여 형식 지정된 메시지를 커넥터에 전송하고 대상 채널을 동적으로 지정합니다. 또한 이 주제를 사용하여 응답 출력에서 반환되는 ID를 지정할 수 있습니다. 이 커넥터는 AWS IoT Analytics에 전송하는 발신 BatchPutMessage 요청의 각 메시지에 대해 ID가 고유한지 확인합니다. 중복 ID가 있는 메시지는 취소됩니다.

이 주제에 전송되는 입력 데이터는 다음 메시지 형식을 사용해야 합니다.

이 주제를 사용하여 형식이 지정되지 않은 메시지를 커넥터에 전송하고 대상 채널을 동적으로 지정합니다.

커넥터 데이터는 이 주제에 대해 수신된 입력 메시지를 구문 분석하지 않습니다. 이러한 메시지는 바이너리로 처리합니다. 메시지를 AWS IoT Analytics에 전송하기 전에 커넥터는 BatchPutMessage API 요구 사항에 적합하도록 메시지를 인코딩하고 형식 지정합니다.

이 주제를 사용하여 모든 메시지 형식을 기본 채널로 전송합니다. 이 기능은 클라이언트 디바이스가 고정 주제에 게시하는 경우 또는 데이터를 커넥터 지원 메시지 형식으로 처리할 수 없는 클라이언트 디바이스의 기본 채널로 데이터를 전송하려는 경우에 유용합니다.

생성하는 구독에서 주제 구문을 정의하여 이 커넥터를 데이터 소스에 연결합니다. 구독에 # 와일드카드만 사용하는 대신 주제 경로를 지정하는 것이 좋습니다.

커넥터 데이터는 이 입력 주제에 게시되는 메시지를 구문 분석하지 않습니다. 모든 입력 메시지는 바이너리 데이터로 처리됩니다. 메시지를 AWS IoT Analytics에 전송하기 전에 커넥터는 BatchPutMessage API 요구 사항에 적합하도록 메시지를 인코딩하고 형식 지정합니다.

iotanalytics/messages/put/status

{
    "response" : {
        "status" : "success"
    },
    "id" : "req123"
}

{
    "response" : {
        "status" : "fail",
        "error" : "ResourceNotFoundException",
        "error_message" : "A resource with the specified name could not be found."
    },
    "id" : "req123"
}