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.
# Arbeiten mit AWS IoT in AWS Toolkit for Visual Studio Code
AWS IoT in AWS Toolkit for Visual Studio Code ermöglicht es Ihnen, mit dem AWS IoT Dienst zu interagieren und gleichzeitig Unterbrechungen Ihres Arbeitsablaufs in VS Code zu minimieren. Dieses Benutzerhandbuch soll Ihnen den Einstieg in die Nutzung der AWS IoT Servicefunktionen erleichtern, die in der verfügbar sind. AWS Toolkit for Visual Studio Code Weitere Informationen zum AWS IoT Service finden Sie im Entwicklerhandbuch [Was ist AWS IoT?](https://docs.aws.amazon.com/iot/latest/developerguide/what-is-aws-iot.html)
## AWS IoT Voraussetzungen
Um mit der Nutzung AWS IoT von Toolkit for VS Code zu beginnen, stellen Sie sicher, dass Ihr AWS Konto und VS Code die Anforderungen in diesen Handbüchern erfüllen:
+ Informationen zu den AWS Kontoanforderungen und AWS Benutzerberechtigungen, die für den AWS IoT Dienst spezifisch sind, finden Sie im Entwicklerhandbuch [Erste Schritte mit AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html).
+ Die spezifischen Anforderungen für Toolkit for VS Code finden Sie im Benutzerhandbuch zum [Einrichten des Toolkit for VS Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/setting-up.html).
## AWS IoT Dinge
AWS IoT verbindet Geräte mit AWS Cloud-Diensten und Ressourcen. Sie können Ihre Geräte mithilfe AWS IoT von Objekten verbinden, die als **Dinge** bezeichnet werden. Ein Objekt ist eine Darstellung eines bestimmten Geräts oder einer logischen Entität. Es kann ein physisches Gerät oder ein Sensor sein (beispielsweise eine Glühbirne oder ein Wandschalter). Weitere Informationen zu diesen AWS IoT Dingen finden Sie im Entwicklerhandbuch [Geräte verwalten mit AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-thing-management.html).
### AWS IoT Dinge verwalten
Das Toolkit for VS Code verfügt über mehrere Funktionen, mit denen Sie Ihr AWS IoT Ding-Management effizienter gestalten können. Auf diese Weise können Sie das VS Code-Toolkit verwenden, um Ihre AWS IoT Dinge zu verwalten:
+ [Create a thing](#thing-create)
+ [Attach a certificate to a thing](#thing-certificate-attach)
+ [Detach a certificate from a thing](#thing-certificate-detach)
+ [Delete a thing](#thing-delete)
**So erstellen Sie eine Objekt**
1. **Erweitern Sie im AWS Explorer die Überschrift **IoT-Dienst** und wählen Sie Dinge im Kontext aus (klicken Sie mit der rechten Maustaste).**
1. Wählen Sie im Kontextmenü die Option **Ding erstellen**, um ein Dialogfeld zu öffnen.
1. Folgen Sie der Aufforderung, indem Sie einen Namen für Ihr IoT-Ding in das Feld **Dingname** eingeben.
1. Wenn dieser Vorgang abgeschlossen ist, wird ein **Dingsymbol**, gefolgt von dem von Ihnen angegebenen Namen, im Abschnitt **Ding** angezeigt.
**So fügen Sie einem Objekt ein Zertifikat an**
1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**.
1. Suchen Sie im Unterabschnitt **Dinge** nach dem **Ding**, an das Sie das Zertifikat anhängen möchten.
1. Wählen Sie **das Ding** im Kontext aus (klicken Sie mit der rechten Maustaste) und wählen Sie im Kontextmenü die Option **Zertifikat anhängen**, um eine Eingabeselektion mit einer Liste Ihrer Zertifikate zu öffnen.
1. Wählen Sie aus der Liste die **Zertifikat-ID aus, die dem Zertifikat** entspricht, das Sie an Ihr Ding anhängen möchten.
1. Wenn dieser Vorgang abgeschlossen ist, kann auf Ihr Zertifikat im AWS Explorer zugegriffen werden, und zwar als Element der Sache, an die Sie es angehängt haben.
**So trennen Sie ein Zertifikat von einem Objekt**
1. Erweitern Sie im AWS Explorer den **IoT-Servicebereich**
1. Suchen Sie im Unterabschnitt **Things** (Objekte) nach dem **Objekt**, dessen Zertifikat Sie trennen möchten.
1. Wählen Sie das **Ding** im Kontext aus (klicken Sie mit der rechten Maustaste) und wählen Sie im Kontextmenü die Option **Zertifikat trennen** aus.
1. **Wenn dieser Vorgang abgeschlossen ist, wird das abgetrennte Zertifikat nicht mehr unter diesem Ding im AWS Explorer angezeigt, aber es ist weiterhin über den Unterabschnitt Zertifikate zugänglich.**
**So löschen Sie ein Objekt**
1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**.
1. Suchen Sie im Unterabschnitt **Dinge** nach dem **Ding, das** Sie löschen möchten.
1. Wählen Sie das Ding im Kontext aus (klicken Sie mit der rechten Maustaste) und wählen Sie im Kontextmenü die Option **Ding löschen**, um es zu löschen.
1. **Wenn dieser Vorgang abgeschlossen ist, ist das gelöschte Ding nicht mehr im Unterabschnitt „Dinge“ verfügbar.**
**Anmerkung**
Hinweis: Sie können nur Dinge löschen, an die kein Zertifikat angehängt ist.
## AWS IoT Zertifikate
Zertifikate sind eine gängige Methode, um eine sichere Verbindung zwischen Ihren AWS IoT Diensten und Geräten herzustellen. X.509-Zertifikate sind digitale Zertifikate, die den X.509-Standard für Public-Key-Infrastrukturen verwenden, um einen öffentlichen Schlüssel mit einer Identität in einem Zertifikat zu verknüpfen. Weitere Informationen zu AWS IoT Zertifikaten finden Sie im Entwicklerhandbuch [Authentication (IoT)](https://docs.aws.amazon.com/iot/latest/developerguide/authentication.html).
### Verwalten von Zertifikaten
Das VS Code Toolkit bietet eine Vielzahl von Möglichkeiten, wie Sie Ihre AWS IoT Zertifikate direkt vom AWS Explorer aus verwalten können.
+ [Create a certificate](#cert-create)
+ [Change a certificate status](#cert-status)
+ [Attach a policy to a certificate](#cert-attach-policy)
+ [Delete a certificate](#cert-delete)
**Um ein Zertifikat zu erstellen AWS IoT**
Ein X.509-Zertifikat kann verwendet werden, um eine Verbindung mit Ihrer Instanz von AWS IoT herzustellen.
1. **Erweitern Sie im AWS Explorer den Abschnitt **IoT-Dienst** und wählen Sie Zertifikate im Kontext aus (klicken Sie mit der rechten Maustaste).**
1. Wählen Sie im Kontextmenü die Option **Zertifikat erstellen** aus, um ein Dialogfeld zu öffnen.
1. Wählen Sie ein Verzeichnis in Ihrem lokalen Dateisystem aus, um Ihr RSA-Schlüsselpaar und Ihr X.509-Zertifikat zu speichern.
**Anmerkung**
Die Standarddateinamen enthalten die Zertifikat-ID als Präfix.
Nur das X.509-Zertifikat wird über den Dienst in Ihrem AWS Konto gespeichert. AWS IoT
Ihr RSA-Schlüsselpaar kann nur einmal ausgestellt werden. Speichern Sie es an einem sicheren Ort in Ihrem Dateisystem, wenn Sie dazu aufgefordert werden.
Wenn entweder das Zertifikat oder das key pair zu diesem Zeitpunkt nicht in Ihrem Dateisystem gespeichert werden können, löscht das AWS Toolkit das Zertifikat aus Ihrem AWS Konto.
**So ändern Sie den Status eines Zertifikats**
Der Status eines einzelnen Zertifikats wird im AWS Explorer neben seiner ID angezeigt und kann wie folgt festgelegt werden: aktiv, inaktiv oder gesperrt.
**Anmerkung**
Ihr Zertifikat muss einen **aktiven** Status haben, bevor Sie es verwenden können, um Ihr Gerät mit Ihrem AWS IoT Dienst zu verbinden.
Ein **inaktives** Zertifikat kann aktiviert werden, unabhängig davon, ob es zuvor deaktiviert wurde oder standardmäßig inaktiv ist.
Ein Zertifikat, das **widerrufen** wurde, kann nicht erneut aktiviert werden.
1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**.
1. Suchen Sie im Unterabschnitt **Zertifikate** das Zertifikat, das Sie ändern möchten.
1. Wählen Sie das Zertifikat im Kontext aus (klicken Sie mit der rechten Maustaste darauf), um ein Kontextmenü zu öffnen, in dem die für dieses Zertifikat verfügbaren Optionen zur Statusänderung angezeigt werden.
+ Wenn ein Zertifikat den Status **inactive** (inaktiv) hat, wählen Sie **activate** (Aktivieren) aus, um den Status in **active** (aktiv) zu ändern.
+ Hat ein Zertifikat den Status **active** (aktiv), wählen Sie **deactivate** (Deaktivieren) aus, um den Status in **inactive** (inaktiv) zu ändern.
+ Wenn ein Zertifikat weder den Status **active** (aktiv) noch **inactive** (inaktiv) hat, wählen Sie **revoke** (Widerrufen) aus, um den Status in **revoked** (widerrufen) zu ändern.
**Anmerkung**
**Jede dieser Aktionen zur Statusänderung ist auch verfügbar, wenn Sie ein Zertifikat auswählen, das an ein Objekt angehängt ist, während es im Unterabschnitt Dinge angezeigt wird.**
**So fügen Sie einem Zertifikat eine IoT-Richtlinie an**
1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**.
1. Suchen Sie im Unterabschnitt **Zertifikate** das Zertifikat, das Sie ändern möchten.
1. Wählen Sie das Zertifikat im Kontext aus (klicken Sie mit der rechten Maustaste darauf) und wählen Sie im Kontextmenü die Option **Richtlinie anhängen**, um eine Eingabeselektion mit einer Liste Ihrer verfügbaren Richtlinien zu öffnen.
1. Wählen Sie die Richtlinie aus, die Sie an das Zertifikat anhängen möchten.
1. Wenn dies abgeschlossen ist, wird die von Ihnen ausgewählte Richtlinie dem Zertifikat als Untermenüelement hinzugefügt.
**So trennen Sie eine IoT-Richtlinie von einem Zertifikat**
1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**.
1. Suchen Sie im Unterabschnitt **Zertifikate** das Zertifikat, das Sie ändern möchten.
1. Erweitern Sie das Zertifikat und suchen Sie nach der Richtlinie, die Sie trennen möchten.
1. Wählen Sie die Richtlinie im Kontext aus (klicken Sie mit der rechten Maustaste darauf) und wählen Sie im Kontextmenü die Option **Trennen** aus.
1. **Wenn dieser Vorgang abgeschlossen ist, ist die Richtlinie kein Element mehr, auf das Sie von Ihrem Zertifikat aus zugreifen können, sondern sie steht im Unterabschnitt Richtlinie zur Verfügung.**
**So löschen Sie ein Zertifikat**
1. Erweitern Sie im AWS Explorer die Überschrift **IoT-Dienst**.
1. Suchen Sie im Unterabschnitt **Zertifikate** das Zertifikat, das Sie löschen möchten.
1. Wählen Sie das Zertifikat im Kontext aus (klicken Sie mit der rechten Maustaste darauf) und wählen Sie im Kontextmenü die Option **Zertifikat löschen**.
**Anmerkung**
Sie können ein Zertifikat nicht löschen, wenn es einem Objekt angefügt ist oder einen aktiven Status hat. Sie können ein Zertifikat löschen, dem Richtlinien angefügt sind.
## AWS IoT Richtlinien
AWS IoT Kernrichtlinien werden durch JSON-Dokumente definiert, die jeweils eine oder mehrere Richtlinienerklärungen enthalten. Richtlinien definieren AWS IoT, wie AWS, und Ihr Gerät miteinander interagieren können. Weitere Informationen zum Erstellen eines Richtliniendokuments finden Sie im Entwicklerhandbuch [IoT Polices.](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html)
**Anmerkung**
Benannte Richtlinien sind versioniert, sodass Sie sie rückgängig machen können. Im AWS Explorer werden Ihre IoT-Richtlinien im Unterabschnitt **Richtlinien** im IoT-Dienst aufgeführt. Sie können die Versionen der Richtlinien anzeigen, indem Sie eine Richtlinie erweitern. Die Standardversion ist mit einem Sternchen gekennzeichnet.
### Verwalten von Richtlinien
Das Toolkit for VS Code bietet Ihnen verschiedene Möglichkeiten, Ihre AWS IoT Servicerichtlinien zu verwalten. Auf diese Weise können Sie Ihre Richtlinien direkt im AWS Explorer in VS Code verwalten oder ändern:
+ [Create a policy](#policy-create)
+ [Upload a new policy version](#policy-version-upload)
+ [Edit a policy version](#policy-version-edit)
+ [Change the policy version defualt](#policy-version-default)
+ [Change the policy version defualt](#policy-delete)
**Um eine AWS IoT Richtlinie zu erstellen**
**Anmerkung**
Sie können im AWS Explorer eine neue Richtlinie erstellen, aber das JSON-Dokument, das die Richtlinie definiert, muss bereits in Ihrem Dateisystem vorhanden sein.
1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**.
1. Wählen Sie im Kontext den Unterabschnitt **Richtlinien** aus (klicken Sie mit der rechten Maustaste darauf) und wählen Sie **Richtlinie aus Dokument erstellen aus**, um das Eingabefeld **Richtlinienname** zu öffnen.
1. Geben Sie einen Namen ein und folgen Sie den Anweisungen, um ein Dialogfeld zu öffnen, in dem Sie aufgefordert werden, ein JSON-Dokument aus Ihrem Dateisystem auszuwählen.
1. Wählen Sie die JSON-Datei aus, die Ihre Richtliniendefinitionen enthält. Die Richtlinie ist im AWS Explorer verfügbar, wenn der Vorgang abgeschlossen ist.
**Um eine neue AWS IoT Richtlinienversion hochzuladen**
Eine neue Version einer Richtlinie kann erstellt werden, indem ein JSON-Dokument in die Richtlinie hochgeladen wird.
**Anmerkung**
Das neue JSON-Dokument muss in Ihrem Dateisystem vorhanden sein, um mit dem AWS Explorer eine neue Version zu erstellen.
1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**.
1. Erweitern Sie den Unterabschnitt **Richtlinien**, um Ihre AWS IoT Richtlinien anzuzeigen
1. Wählen Sie im Kontext (mit der rechten Maustaste) die Richtlinie aus, die Sie aktualisieren möchten, und wählen Sie **Neue Version aus Dokument erstellen**.
1. Wenn das Dialogfeld geöffnet wird, wählen Sie die JSON-Datei aus, die die Aktualisierungen Ihrer Richtliniendefinitionen enthält.
1. Auf die neue Version kann über Ihre Richtlinie im Explorer zugegriffen werden. AWS
**Um eine AWS IoT Richtlinienversion zu bearbeiten**
Ein Richtliniendokument kann mit VS Code geöffnet und bearbeitet werden. Wenn Sie mit der Bearbeitung des Dokuments fertig sind, können Sie es in Ihrem Dateisystem speichern. Anschließend können Sie es aus dem AWS Explorer in Ihren AWS IoT Dienst hochladen.
1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**.
1. Erweitern Sie den Unterabschnitt **Richtlinien** und suchen Sie die Richtlinie, die Sie aktualisieren möchten. **Richtlinie aus Dokument erstellen, um das** Eingabefeld **Richtlinienname** zu öffnen.
1. Erweitern Sie die Richtlinie, die Sie aktualisieren möchten, und wählen Sie dann im Kontext (Rechtsklick) die Richtlinienversion aus, die Sie bearbeiten möchten.
1. Wählen Sie im Kontextmenü die Option **Ansicht** aus, um die Richtlinienversion in VS Code zu öffnen
1. Wenn das Richtliniendokument geöffnet ist, nehmen Sie die gewünschten Änderungen vor und speichern Sie sie.
**Anmerkung**
Zu diesem Zeitpunkt werden die Änderungen, die Sie an der Richtlinie vorgenommen haben, nur in Ihrem lokalen Dateisystem gespeichert. Um die Version zu aktualisieren und sie mit dem AWS Explorer zu verfolgen, wiederholen Sie die im [Upload a new policy version](#policy-version-upload) Verfahren beschriebenen Schritte.
**So wählen Sie eine neue Standardversion einer Richtlinie aus**
1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**.
1. Erweitern Sie den Unterabschnitt **Policies** (Richtlinien) und suchen Sie die Richtlinie, die Sie aktualisieren möchten.
1. Erweitern Sie die Richtlinie, die Sie aktualisieren möchten, und wählen Sie dann im Kontext (mit der rechten Maustaste) die Richtlinienversion aus, die Sie festlegen möchten, und wählen Sie **Als Standard festlegen** aus.
1. Wenn dieser Vorgang abgeschlossen ist, wird neben der neuen Standardversion, die Sie ausgewählt haben, ein Stern angezeigt.
**So löschen Sie -Richtlinien**
**Anmerkung**
Bevor Sie eine Richtlinie oder eine Richtlinienversion löschen können, müssen bestimmte Bedingungen erfüllt sein.
Sie können eine Richtlinie nicht löschen, wenn sie an ein Zertifikat angehängt ist.
Sie können eine Richtlinie nicht löschen, wenn sie nicht standardmäßige Versionen hat.
Sie können die Standardversion einer Richtlinie nur löschen, wenn eine neue Standardversion ausgewählt oder die gesamte Richtlinie gelöscht wurde.
Bevor Sie eine gesamte Richtlinie löschen können, müssen zuerst alle nicht standardmäßigen Versionen dieser Richtlinie gelöscht werden.
1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**.
1. Erweitern Sie den Unterabschnitt **Policies** (Richtlinien) und suchen Sie die Richtlinie, die Sie aktualisieren möchten.
1. **Erweitern Sie die Richtlinie, die Sie aktualisieren möchten, und wählen Sie dann im Kontext (mit der rechten Maustaste) die Richtlinienversion aus, die Sie löschen möchten, und wählen Sie Löschen aus.**
1. Wenn eine Version gelöscht wird, ist sie im Explorer nicht mehr sichtbar.
1. Wenn für eine Richtlinie nur noch die Standardversion übrig ist, können Sie die übergeordnete Richtlinie im Kontext auswählen (mit der rechten Maustaste klicken) und **Löschen** wählen, um sie zu löschen.