Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Kennzeichnen Sie Ihre AWS IoT SiteWise Ressourcen
Das Markieren Ihrer AWS IoT SiteWise Ressourcen bietet eine leistungsstarke Möglichkeit, Unternehmensressourcen effizient zu kategorisieren, zu verwalten und abzurufen. Durch die Zuweisung von Tags, die aus Schlüssel-Wert-Paaren bestehen, können Sie Ihren Ressourcen beschreibende Metadaten hinzufügen. Die Metadaten aus Tags können zur Optimierung von Vorgängen verwendet werden. In einem Windpark-Szenario ermöglichen es Ihnen beispielsweise Tags, Turbinen mit bestimmten Attributen wie Standort, Kapazität und Betriebsstatus zu kennzeichnen, was eine schnelle Identifizierung und Verwaltung innerhalb AWS IoT SiteWise der Anlage ermöglicht.
Die Integration von Tags in AWS Identity and Access Management (IAM-) Richtlinien verbessert die Sicherheit und die Betriebskontrolle, indem Regeln für den bedingten Zugriff definiert werden. Das bedeutet, dass Sie angeben können, dass nur Benutzer mit bestimmten Tags angemeldet sind. Beispielsweise können nur Personen, die mit einer bestimmten Rolle oder Abteilung gekennzeichnet sind, auf bestimmte Ressourcen zugreifen oder diese ändern.
# Verwenden Sie Tags in AWS IoT SiteWise
Verwenden Sie Tags, um Ihre AWS IoT SiteWise Ressourcen nach Zweck, Eigentümer, Umgebung oder einer anderen Klassifizierung für Ihren Anwendungsfall zu kategorisieren. Wenn es viele Ressourcen desselben Typs gibt, können Sie eine bestimmte Ressourcen schnell basierend auf ihren Tags identifizieren.
Jedes Tag besteht aus einem Schlüssel und einem optionalen Wert, den Sie angeben. Sie können beispielsweise eine Reihe von Tags für Ihre Anlagenmodelle einrichten, um sie entsprechend den industriellen Prozessen, die sie unterstützen, nachzuverfolgen. Es wird empfohlen, für jeden von Ihnen verwalteten Ressourcentyp einen maßgeschneiderten Satz von Tag-Schlüsseln zu entwickeln. Die Verwendung eines konsistenten Satzes von Tag-Schlüsseln kann die Verwaltung von Ressourcen erleichtern.
## Tag mit dem AWS-Managementkonsole
Der **Tag-Editor** im AWS-Managementkonsole bietet Ihnen eine zentrale, einheitliche Möglichkeit, Ihre Tags für Ressourcen aus allen AWS Diensten zu erstellen und zu verwalten. Weitere Informationen finden Sie unter [Erste Schritte mit dem Tag-Editor](https://docs.aws.amazon.com/tag-editor/latest/userguide/gettingstarted.html) im *Benutzerhandbuch Tagging AWS Resources and Tag Editor*.
## Taggen Sie mit der API AWS IoT SiteWise
Die AWS IoT SiteWise API verwendet auch Tags. Beachten Sie vor dem Erstellen von Tags Beschränkungen für Tags. Weitere Informationen finden Sie unter [Konventionen für Benennung und Nutzung von Tags](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html#tag-conventions) in der *Allgemeine AWS-Referenz*.
+ Wenn Sie bei der Erstellung einer Ressource Tags hinzufügen möchten, definieren Sie diese in der Eigenschaft `tags` der Ressource.
+ Verwenden Sie den [TagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_TagResource.html)Vorgang, um einer vorhandenen Ressource Tags hinzuzufügen oder Tag-Werte zu aktualisieren.
+ Verwenden Sie den [UntagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UntagResource.html)Vorgang, um Tags aus einer Ressource zu entfernen.
+ Um die mit einer Ressource verknüpften Tags abzurufen, verwenden Sie die [ListTagsForResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListTagsForResource.html)Operation oder beschreiben Sie die Ressource und überprüfen Sie ihre `tags` Eigenschaften.
In der folgenden Tabelle sind Ressourcen aufgeführt, die Sie mithilfe der AWS IoT SiteWise API taggen können, sowie die entsprechenden `Create` `Describe` AND-Operationen.
**Taggierbare Ressourcen AWS IoT SiteWise**
| Ressource | Operation erstellen | Operation beschreiben |
| --- | --- | --- |
| Anlagenmodell oder Komponentenmodell | [CreateAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAssetModel.html) | [DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html) |
| Komponente | [CreateAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAsset.html) | [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html) |
| SiteWise Edge-Gateway | [CreateGateway](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateGateway.html) | [DescribeGateway](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeGateway.html) |
| Portal | [CreatePortal](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreatePortal.html) | [DescribePortal](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribePortal.html) |
| Projekt | [CreateProject](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateProject.html) | [DescribeProject](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeProject.html) |
| Dashboard | [CreateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateDashboard.html) | [DescribeDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeDashboard.html) |
| Zugriffsrichtlinie | [CreateAccessPolicy](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAccessPolicy.html) | [DescribeAccessPolicy](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAccessPolicy.html) |
| Zeitreihen | [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) | [DescribeTimeSeries](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeTimeSeries.html) |
Denn Sie können Ihre Datenquellen so konfigurieren`[BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)`, dass Industriedaten an AWS IoT SiteWise sie gesendet werden, bevor Sie Anlagenmodelle und Anlagen erstellen. AWS IoT SiteWise erstellt automatisch Datenströme, um Rohdatenströme von Ihren Geräten zu empfangen. Weitere Informationen finden Sie unter [Verwaltung der Datenaufnahme](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/data-streams.html).
Mit den folgenden Operationen können Sie Tags für Ressourcen anzeigen und verwalten, die die Markierung mit Tags unterstützen:
+ [TagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_TagResource.html)— Fügt einer Ressource Tags hinzu oder aktualisiert den Wert eines vorhandenen Tags.
+ [ListTagsForResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListTagsForResource.html)— Listet die Tags für eine Ressource auf.
+ [UntagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UntagResource.html)— Entfernt Tags aus einer Ressource.
Sie können jederzeit Tags zu einer Ressource hinzufügen oder daraus entfernen. Um den Wert eines vorhandenen Tag-Schlüssels zu aktualisieren, fügen Sie der Ressource ein neues Tag mit demselben Schlüssel und dem gewünschten neuen Wert hinzu. Diese Aktion ersetzt den alten Wert durch den neuen. Es ist zwar möglich, eine leere Zeichenfolge als Tag-Wert zuzuweisen, aber Sie können keinen Nullwert zuweisen.
Durch das Löschen einer Ressource werden auch alle damit verknüpften Tags entfernt.
# Verwenden Sie Tags mit IAM-Richtlinien
Verwenden Sie Ressourcen-Tags in Ihren IAM-Richtlinien, um den Benutzerzugriff und die Benutzerberechtigungen zu kontrollieren. Richtlinien können es Benutzern beispielsweise ermöglichen, nur Ressourcen zu erstellen, denen ein bestimmtes Tag angehängt ist. Richtlinien können auch verhindern, dass Benutzer Ressourcen mit bestimmten Tags erstellen oder ändern.
**Anmerkung**
Wenn Sie Tags verwenden, um den Zugriff von Benutzern auf Ressourcen zuzulassen oder abzulehnen, sollten Sie Benutzern nicht die Möglichkeit geben, diese Tags diesen Ressourcen hinzuzufügen oder aus diesen Ressourcen zu entfernen. Andernfalls könnte ein Benutzer Ihre Einschränkungen umgehen und Zugriff auf eine Ressource erhalten, indem er deren Tags ändert.
Sie können im Element `Condition` (auch als `Condition`-Block bezeichnet) einer Richtlinienanweisung die folgenden Bedingungskontextschlüssel und -werte verwenden.
`aws:ResourceTag/tag-key: tag-value`
Sie können mithilfe bestimmter Tags Aktionen für Ressourcen zulassen oder ablehnen.
`aws:RequestTag/tag-key: tag-value`
Erfordert, dass beim Erstellen oder Ändern einer markierbaren Ressource ein bestimmtes Tag verwendet (oder nicht verwendet) wird.
`aws:TagKeys: [tag-key, ...]`
Erfordert, dass beim Erstellen oder Ändern einer markierbaren Ressource ein bestimmter Satz von Tag-Schlüsseln verwendet (oder nicht verwendet) wird.
**Anmerkung**
Die Bedingungskontextschlüssel und -werte in einer IAM-Richtlinie gelten nur für Aktionen, für die eine Ressource mit Tags als erforderlichem Parameter angegeben werden kann. Sie können beispielsweise den tagbasierten bedingten Zugriff für einrichten. [ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html) Sie können den tagbasierten bedingten Zugriff nicht aktivieren, [PutLoggingOptions](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutLoggingOptions.html)da in der Anfrage auf keine markierbare Ressource verwiesen wird.
*Weitere Informationen finden Sie unter [Steuern des Zugriffs auf AWS Ressourcen mithilfe von Ressourcen-Tags](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) und [IAM-JSON-Richtlinienreferenz](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies.html) im IAM-Benutzerhandbuch.*
**Beispiel für IAM-Richtlinien mit Tags**
+ [Auf Tags basierende AWS IoT SiteWise Assets anzeigen](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-view-asset-tags)