AWS IoT Wireless リソースのタグ付け

デバイス、ゲートウェイ、送信先およびプロファイルの管理と整理を支援するために、オプションで、タグの形式でこれらの各リソースに独自のメタデータを割り当てることができます。このセクションでは、タグとその作成方法について説明します。AWS IoT Wireless には請求グループがなく、AWS IoT Core と同じ請求グループを使用します。詳しくは、AWS IoT Core ドキュメントの「請求グループ」を参照してください。

タグの基本

同じタイプの 複数の AWS IoT Wireless リソースがある場合、タグを使って目的、所有者、環境など、さまざまな方法でリソースを分類することができます。これにより、リソースに割り当てたタグに基づいてリソースをすばやく特定できます。

タグはそれぞれ、1 つのキーとオプションの値で設定され、どちらもユーザーが定義します。例えば、デバイスのファームウェアが更新されている LoRaWAN デバイスのグループに一連のタグを定義できます。リソースをさらに管理しやすくするために、リソースの種類ごとのニーズを満たす、一貫した一連のタグキーを作成することをお勧めします。

追加または適用したタグに基づいて、リソースを検索およびフィルター処理できます。タグを使用して、IAM ポリシーと請求グループタグを使用してコストを分類および追跡することで、リソースへのアクセスを制御することもできます。

タグを作成して管理する

AWS Management Console、AWS IoT Wireless、または AWS CLI でタグエディタを使用してタグを作成および管理することができます。

コンソールを使用する場合

使いやすさのために、のタグエディタは、タグを作成および管理するための AWS Management Console の中央の統一された方法を提供します。詳細については、「 の操作 AWS Management Console」の「タグエディタの操作」を参照してください。

API または CLI の使用

API または CLI を使用して、ワイヤレスデバイス、ゲートウェイ、プロファイル、および送信先にタグを関連付けることもできます。その場合は、次のコマンドの Tags フィールドを使用します。

リソースのタグを更新するか、またはタグを一覧表示する

以下のコマンドを使用して、タグ付けがサポートされている既存のリソースに対してタグを追加、変更、または削除できます。

タグのキーと値は編集でき、タグはリソースからいつでも削除できます。タグの値を空の文字列に設定することはできますが、タグの値を null に設定することはできません。特定のリソースについて既存のタグと同じキーを持つタグを追加した場合、古い値は新しい値によってオーバーライドされます。リソースを削除すると、リソースに関連付けられているすべてのタグも削除されます。

タグの制約と制限

次のベーシックな制限がタグに適用されます。

IAM ポリシーでのタグの使用

ユーザーが作成、変更、または使用できるリソースを指定するには、AWS IoT Wireless API アクションに使用する IAM ポリシーでタグベースのリソースレベルのアクセス許可を適用できます。リソースのタグに基づいてユーザーアクセス (アクセス許可) を制御するには、IAM ポリシーの以下の条件コンテキストのキーと値とともに Condition 要素 (Condition ブロックとも呼ばれる) を使用して、リソースのタグに基づいてユーザーアクセス (アクセス許可) を制御できます。

タグの使用の詳細については、[AWS Identity and Access ManagementUser Guide](ユーザーガイド)の[Controlling Access Using Tags](タグを使用したアクセスの制御)を参照してください。そのガイドの「IAM JSON ポリシーリファレンス」セクションには、IAM での JSON ポリシーの要素、変数、および評価ロジックの詳細な構文、説明、および例が記載されています。

次のポリシー例では、タグベースの 2 つの制約が適用されています。このポリシーによって制限されている IAM ユーザーは、次のように制限されます。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Deny",
      "Action": "iot:CreateMulticastGroup",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:RequestTag/env": "prod"
        }
      }
    },
    {
      "Effect": "Deny",
      "Action": [
        "iot:CreateMulticastGroup",
        "iot:UpdateMulticastGroup",
        "iot:GetMulticastGroup",
        "iot:ListMulticastGroups"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceTag/env": "prod"
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "iot:CreateMulticastGroup",
        "iot:UpdateMulticastGroup",
        "iot:GetMulticastGroup",
        "iot:ListMulticastGroups"
      ],
      "Resource": "*"
    }
  ]
}

次のようにタグ値を 1 つのリストとして指定して、1 つのタグキーに対して複数のタグ値を指定することもできます。

"StringEquals" : {
              "aws:ResourceTag/env" : ["dev", "test"]
}