翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS IoT ルールの管理
<a name="iot-managae-rule"></a>

 AWS IoT ルールを管理するには、次のアクションを使用できます。

**Topics**
+ [ルールのタグ付け](#iot-create-rule-tagging)
+ [ルールの表示](#iot-view-rules)
+ [ルールの削除](#iot-delete-rule)

## ルールのタグ付け
<a name="iot-create-rule-tagging"></a>

新規のルールまたは既存のルールにさらに詳細性のレイヤーを追加するには、タグ付けを適用できます。タグ付けは、ルール内のキーと値のペアを活用して、 AWS IoT リソースとサービスにルールを適用する方法と場所をより細かく制御できます。例えば、プレリリーステスト (`Key=environment, Value=beta`) のために、ルールのスコープをベータ環境でのみ適用するように制限したり、特定のエンドポイントのみから `iot/test` トピックに送信されたすべてのメッセージをキャプチャして、Amazon S3 バケットに保存したりできます。

### IAM ポリシーの例
<a name="iot-create-rule-tagging-iam-example"></a>

ルールのタグ付けのアクセス許可を付与する方法を示す例として、次のコマンドを実行してルールを作成し、タグ付けしてベータ環境にのみ適用する方法について考えてみましょう。

この例では、次のように置き換えます。
+ *MyTopicRuleName* をルールの名前に置き換えます。
+ *myrule.json* をポリシードキュメントの名前に置き換えます。

```
aws iot create-topic-rule 
    --rule-name MyTopicRuleName 
    --topic-rule-payload file://myrule.json
    --tags "environment=beta"
```

この例では、次の IAM ポリシーを使用する必要があります。

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": 
    {
        "Action": [ "iot:CreateTopicRule", "iot:TagResource" ],
        "Effect": "Allow",
        "Resource": [
            "arn:aws:iot:us-east-1:123456789012:rule/MyTopicRuleName"
        ]
    }
}
```

上の例は、ベータ環境にのみ適用される、`MyTopicRuleName` という新しく作成されたルールを示しています。`MyTopicRuleName` を明確に呼び出したポリシーステートメントの `iot:TagResource` により、`MyTopicRuleName` の作成時または更新時にタグ付けが可能になります。ルールの作成時にパラメータ `--tags "environment=beta"` を使用すると、`MyTopicRuleName` のスコープがベータ環境のみに制限されます。パラメータ `--tags "environment=beta"` を削除した場合、`MyTopicRuleName` はすべての環境に適用されます。

 AWS IoT ルールに固有の IAM ロールとポリシーの作成に関する詳細については、「[必要なアクセスを AWS IoT ルールに付与する](iot-create-role.md)」を参照してください。

リソースのタグ付けの詳細については、「[AWS IoT リソースのタグ付け](tagging-iot.md)」を参照してください。

## ルールの表示
<a name="iot-view-rules"></a>

ルールをリスト表示するには、[list-topic-rules](https://docs.aws.amazon.com/cli/latest/reference/iot/list-topic-rules.html) コマンドを使用します。

```
aws iot list-topic-rules
```

ルールに関する情報を取得するには、[get-topic-rule](https://docs.aws.amazon.com/cli/latest/reference/iot/get-topic-rule.html) コマンドを使用します。

```
aws iot get-topic-rule --rule-name myrule
```

## ルールの削除
<a name="iot-delete-rule"></a>

不要になったルールは、削除することができます。

**ルール (AWS CLI) を削除するには**  
[delete-topic-rule](https://docs.aws.amazon.com/cli/latest/reference/iot/delete-topic-rule.html) コマンドを使用して、ルールを削除します。

```
aws iot delete-topic-rule --rule-name myrule
```