Markieren Ihrer AWS IoT Wireless-Ressourcen

Um Ihnen die Verwaltung und Organisation Ihrer Geräte, Gateways, Ziele und Profile zu erleichtern, können Sie jeder dieser Ressourcen optional eigene Metadaten in Form von Tags zuweisen. In diesem Abschnitt werden Tags beschrieben und Sie erfahren, wie Sie sie erstellen. AWS IoT Wireless hat keine Fakturierungsgruppen und verwendet dieselben Fakturierungsgruppen wie AWS IoT Core. Weitere Informationen finden Sie unter Fakturierungsgruppen in der AWS IoT Core-Dokumentation.

Grundlagen zu Tags (Markierungen)

Wenn Sie mehrere AWS IoT Wireless-Ressourcen desselben Typs haben, können Sie diese mit Tags auf unterschiedliche Weise kategorisieren (z. B. nach Zweck, Eigentümer oder Umgebung). Dadurch können Sie eine Ressource schnell anhand der ihr zugeordneten Tags identifizieren.

Jedes Tag besteht aus einem Schlüssel und einem optionalen Wert, die Sie beide selbst definieren können. Sie können beispielsweise eine Reihe von Tags für eine Gruppe von LoRaWAN-Geräten definieren, für die die Gerätefirmware aktualisiert wird. Wir empfehlen die Erstellung von Tag-Schlüsseln, die die Anforderungen der jeweiligen Ressourcenart erfüllen.

Sie können die Ressourcen auf Grundlage der hinzugefügten oder angewendeten Tags durchsuchen und filtern. Sie können auch Tags verwenden, um den Zugriff auf Ihre Ressourcen zu steuern, indem Sie IAM-Richtlinien und Fakturierungsgruppen-Tags verwenden, um Ihre Kosten zu kategorisieren und zu verfolgen.

Erstellen und Verwalten von Tags

Sie können Tags mit dem Tag Editor in der AWS Management Console, der AWS IoT Wireless oder der AWS CLI erstellen und verwalten.

Verwenden der Konsole

Der Tag-Editor in der AWS Management Console ist benutzerfreundlich und am besten dazu geeignet, Tags zentral und einheitlich zu erstellen und zu verwalten. Weitere Informationen finden Sie unter Arbeiten mit dem Tag Editor in Arbeiten mit der AWS Management Console.

Verwenden der API oder CLI

Sie können auch die API oder CLI verwenden und Tags drahtlosen Geräten, Gateways, Profilen und Zielen zuordnen, wenn Sie sie erstellen, indem Sie das Tags-Feld in den folgenden Befehlen verwenden:

Aktualisieren von Tags oder Auflisten von Tags für Ressourcen

Sie können Tags für vorhandene Ressourcen, die das Markieren unterstützen, hinzufügen, ändern oder löschen. Verwenden Sie dazu die folgenden Befehle:

Sie können Tag (Markierung)-Schlüssel und -Werte bearbeiten und Tags (Markierungen) jederzeit von einer Ressource entfernen. Sie können den Wert eines Tags (Markierung) zwar auf eine leere Zeichenfolge, jedoch nicht null festlegen. Wenn Sie ein Tag (Markierung) mit demselben Schlüssel wie ein vorhandener Tag (Markierung) für die Ressource hinzufügen, wird der alte Wert mit dem neuen überschrieben. Wenn Sie eine Ressource löschen, werden alle der Ressource zugeordneten Tags ebenfalls gelöscht.

Tag-Beschränkungen und -Einschränkungen

Die folgenden grundlegenden Einschränkungen gelten für Tags (Markierungen):

Verwenden von Tags mit IAM-Richtlinien

Um anzugeben, welche Ressourcen ein Benutzer erstellen, ändern oder verwenden kann, können Sie tagbasierte Berechtigungen auf Ressourcenebene in den IAM-Richtlinien anwenden, die Sie für AWS IoT Wireless-API-Aktionen verwenden. Um den Benutzerzugriff (Berechtigungen) basierend auf den Tags einer Ressource zu steuern, verwenden Sie das Condition-Element (auch als Condition-Block bezeichnet) mit den folgenden Bedingungskontextschlüsseln und Werten in einer IAM-Richtlinie.

Weitere Informationen finden Sie unter Zugriffssteuerung mit Tags im AWS Identity and Access Management Benutzerhandbuch. Der Abschnitt IAM-JSON-Richtlinienreferenz dieses Handbuchs enthält die detaillierte Syntax sowie Beschreibungen und Beispiele für Elemente, Variablen und die Auswertungslogik von JSON-Richtlinien in IAM.

Die folgende Beispielrichtlinie wendet zwei auf Tags basierende Einschränkungen an. Ein von dieser Richtlinie eingeschränkter IAM-Benutzer:

{
  "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": "*"
    }
  ]
}

Sie können auch mehrere Tag-Werte für einen bestimmten Tag-Schlüssel angeben, indem Sie sie wie folgt in einer Liste angeben:

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