本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

建立規則

您可以建立 AWS IoT 規則來路由連線物件中的資料，以便與其他 AWS 服務互動。 AWS IoT 規則由下列元件組成：

在建立 AWS IoT 規則之前，您必須建立具有允許存取所需 AWS 資源的政策的 IAM 角色。 AWS IoT 在實作規則時會擔任此角色。如需詳細資訊，請參閱授與 AWS IoT 規則所需的存取權和傳遞角色權限。

建立規則時，請注意在主題上發佈的資料量。如果您建立了包含萬用字元主題模式的規則，這些規則可能會比對大部分的訊息。若是這種情況，您可能需要增加目標動作使用的 AWS 資源容量。此外，如果您建立了重新發佈規則，而其中包含萬用字元主題模式，最後可能會造成循環規則，導致無限迴圈。

建立規則 (主控台)

成功建立規則後，您會看到「規則」頁面上列出的規則。您可以選取規則來開啟「詳細資訊」頁面，您可以在其中檢視規則、編輯規則、停用規則以及刪除規則。

建立規則 (CLI)

建立規則 (AWS CLI)

使用create-topic-rule指令建立規則：

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

下列為一個範例承載檔案，其規則會將所有發送至 iot/test 主題的訊息插入指定的 DynamoDB 表格中。SQL 陳述式會篩選訊息，而角色 ARN 會授與寫入 DynamoDB 表格的 AWS IoT 權限。

{
	"sql": "SELECT * FROM 'iot/test'",
	"ruleDisabled": false,
	"awsIotSqlVersion": "2016-03-23",
	"actions": [
		{
			"dynamoDB": {
				"tableName": "my-dynamodb-table",
				"roleArn": "arn:aws:iam::123456789012:role/my-iot-role",
				"hashKeyField": "topic",
				"hashKeyValue": "${topic(2)}",
				"rangeKeyField": "timestamp",
				"rangeKeyValue": "${timestamp()}"
			}
		}
	]
}

以下為範例承載檔案，含有一項規則，會將所有發送至 iot/test 主題的訊息插入指定的 S3 儲存貯體。SQL 陳述式會篩選訊息，而角色 ARN 會授與寫入 Amazon S3 儲存貯體的 AWS IoT 權限。

{
	"awsIotSqlVersion": "2016-03-23",
	"sql": "SELECT * FROM 'iot/test'",
	"ruleDisabled": false,
	"actions": [
		{
			"s3": {
				"roleArn": "arn:aws:iam::123456789012:role/aws_iot_s3",
				"bucketName": "my-bucket",
				"key": "myS3Key"
			}
		}
	]
} 

以下是有效負載檔案的範例，其中包含將資料推送至 Amazon OpenSearch 服務的規則：

{
	"sql": "SELECT *, timestamp() as timestamp FROM 'iot/test'",
	"ruleDisabled": false,
	"awsIotSqlVersion": "2016-03-23",
	"actions": [
		{
			"OpenSearch": {
				"roleArn": "arn:aws:iam::123456789012:role/aws_iot_es",
				"endpoint": "https://my-endpoint",
				"index": "my-index",
				"type": "my-type",
				"id": "${newuuid()}"
			}
		}
	]
}

下列為範例承載檔案，具有會呼叫 Lambda 函數的規則：

{
	"sql": "expression",
	"ruleDisabled": false,
	"awsIotSqlVersion": "2016-03-23",
	"actions": [
		{
			"lambda": {
				"functionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-lambda-function"
			}
		}
	]
}

下列為範例承載檔案，具有會發佈至 Amazon SNS 主題的規則：

{
	"sql": "expression",
	"ruleDisabled": false,
	"awsIotSqlVersion": "2016-03-23",
	"actions": [
		{
			"sns": {
				"targetArn": "arn:aws:sns:us-west-2:123456789012:my-sns-topic",
				"roleArn": "arn:aws:iam::123456789012:role/my-iot-role"
			}
		}
	]
}

以下為範例承載檔案，含有的規則會將資料重新發佈至不同的 MQTT 主題：

{
	"sql": "expression",
	"ruleDisabled": false,
	"awsIotSqlVersion": "2016-03-23",
	"actions": [
		{
			"republish": {
				"topic": "my-mqtt-topic",
				"roleArn": "arn:aws:iam::123456789012:role/my-iot-role"
			}
		}
	]
}

以下是有效負載檔案的範例，其中包含將資料推送至 Amazon 資料 Firehose 串流的規則：

{
	"sql": "SELECT * FROM 'my-topic'",
	"ruleDisabled": false,
	"awsIotSqlVersion": "2016-03-23",
	"actions": [
		{
			"firehose": {
				"roleArn": "arn:aws:iam::123456789012:role/my-iot-role",
				"deliveryStreamName": "my-stream-name"
			}
		}
	]
}

以下是有效負載檔案的範例，其中包含規則，如果 MQTT 承載中的資料分類為 1，則會使用 Amazon SageMaker machinelearning_predict 函數重新發佈至主題。

{
	"sql": "SELECT * FROM 'iot/test' where machinelearning_predict('my-model', 'arn:aws:iam::123456789012:role/my-iot-aml-role', *).predictedLabel=1",
	"ruleDisabled": false,
	"awsIotSqlVersion": "2016-03-23",
	"actions": [
		{
			"republish": {
				"roleArn": "arn:aws:iam::123456789012:role/my-iot-role",
				"topic": "my-mqtt-topic"
			}
		}
	]
}

以下是範例承載檔案，含有的規則會將訊息發佈至 Salesforce IoT 雲端輸入串流：

{
	"sql": "expression",
	"ruleDisabled": false,
	"awsIotSqlVersion": "2016-03-23",
	"actions": [
		{
			"salesforce": {
				"token": "ABCDEFGHI123456789abcdefghi123456789",
				"url": "https://ingestion-cluster-id.my-env.sfdcnow.com/streams/stream-id/connection-id/my-event"
			}
		}
	]
}

以下是具有開始執行 Step Functions 狀態機器之規則的範例承載檔案。

{
	"sql": "expression",
	"ruleDisabled": false,
	"awsIotSqlVersion": "2016-03-23",
	"actions": [
		{
			"stepFunctions": {
				"stateMachineName": "myCoolStateMachine",
				"executionNamePrefix": "coolRunning",
				"roleArn": "arn:aws:iam::123456789012:role/my-iot-role"
			}
		}
	]
}