Kinesis Data Streams

Kinesis Data Streams(kinesis) 규칙 작업은 MQTT 메시지의 데이터를 Amazon Kinesis Data Streams에 전송합니다.

요구 사항

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

• 작업을 수행할 AWS IoT 수 있는 IAM 역할. kinesis:PutRecord 자세한 정보는 AWS IoT 규칙에 필요한 액세스 권한 부여을 참조하세요.

  AWS IoT 콘솔에서 이 규칙 작업을 수행할 수 있는 역할을 선택하거나 생성할 수 있습니다. AWS IoT

• AWS KMS 고객 관리형 AWS KMS key (KMS 키) 을 사용하여 Kinesis Data Streams에 저장된 데이터를 암호화하는 경우 서비스에 호출자를 대신하여 데이터를 사용할 AWS KMS key 수 있는 권한이 있어야 합니다. 자세한 내용은 Amazon Kinesis Data Streams 개발자 안내서의 사용자 생성 AWS KMS keys를 사용할 수 있는 권한을 참조하세요.

파라미터

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

stream

데이터를 기록할 Kinesis 데이터 스트림입니다.

대체 템플릿 지원: API 및 전용 AWS CLI

partitionKey

어느 샤드에 데이터를 기록할지 결정하는 데 사용되는 파티션 키입니다. 파티션 키는 일반적으로 표현식(예: ${topic()} 또는 ${timestamp()})으로 구성됩니다.

대체 템플릿 지원: 예

roleArn

Kinesis 데이터 스트림에 액세스할 AWS IoT 권한을 부여하는 IAM 역할의 ARN입니다. 자세한 정보는 요구 사항을 참조하세요.

대체 템플릿 지원: 아니오

예

다음 JSON 예제는 규칙에서 AWS IoT Kinesis Data Streams 작업을 정의합니다.

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "kinesis": {
                    "streamName": "my_kinesis_stream", 
                    "partitionKey": "${topic()}",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_kinesis"
                }
            }
        ] 
    }
}

다음 JSON 예제는 규칙에 대체 템플릿이 포함된 Kinesis 작업을 정의합니다. AWS IoT

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'",
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "kinesis": {
                    "streamName": "${topic()}",
                    "partitionKey": "${timestamp()}",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_kinesis"
                }
            }
        ]
    }
}

다음 사항도 참조하세요.

• Amazon Kinesis Data Streams 개발자 안내서의 Amazon Kinesis Data Streams란 무엇입니까?