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.
Objektverwaltung mit der Registry
Sie verwenden die AWS IoT Konsole, die AWS IoT API oder die, um mit der Registrierung AWS CLI zu interagieren. Das folgenden Abschnitte zeigen, wie Sie die CLI zur Arbeit mit dem Registry verwenden.
Wenn du deine Objekt-Objekte benennst:
-
Verwenden Sie keine persönlich identifizierbaren Informationen in Ihrem Dingnamen. Der Name des Objekts kann in unverschlüsselten Mitteilungen und Berichten vorkommen.
Ein Objekt erstellen
Der folgende Befehl zeigt, wie Sie den AWS IoT CreateThing Befehl aus der CLI verwenden, um ein Ding zu erstellen. Sie können den Namen eines Objekts nicht ändern, nachdem Sie es erstellt haben. Um den Namen einer Sache zu ändern, erstellen Sie eine neue Sache, geben Sie ihr den neuen Namen und löschen Sie dann die alte Sache.
$ aws iot create-thing --thing-name "MyLightBulb" --attribute-payload "{\"attributes\": {\"wattage\":\"75\", \"model\":\"123\"}}"
Der Befehl CreateThing zeigt den Namen und den Amazon-Ressourcennamen (ARN) des neuen Objekts an:
{ "thingArn": "arn:aws:iot:us-east-1:123456789012:thing/MyLightBulb", "thingName": "MyLightBulb", "thingId": "12345678abcdefgh12345678ijklmnop12345678" }
Anmerkung
Es wird nicht empfohlen, für Objektnamen personenbezogene Informationen zu verwenden.
Weitere Informationen finden Sie unter create-thing in der AWS CLI -Befehlsreferenz.
Objekte auflisten
Mit dem Befehl ListThings können Sie alle Objekte in Ihrem Konto auflisten:
$ aws iot list-things
{ "things": [ { "attributes": { "model": "123", "wattage": "75" }, "version": 1, "thingName": "MyLightBulb" }, { "attributes": { "numOfStates":"3" }, "version": 11, "thingName": "MyWallSwitch" } ] }
Sie können den Befehl ListThings verwenden, um nach allen Objekten eines bestimmten Objekttyps zu suchen:
$ aws iot list-things --thing-type-name "LightBulb"
{ "things": [ { "thingTypeName": "LightBulb", "attributes": { "model": "123", "wattage": "75" }, "version": 1, "thingName": "MyRGBLight" }, { "thingTypeName": "LightBulb", "attributes": { "model": "123", "wattage": "75" }, "version": 1, "thingName": "MySecondLightBulb" } ] }
Mit dem Befehl ListThings können Sie nach allen Objekten suchen, die über ein Attribut mit einem bestimmten Wert verfügen. Mit diesem Befehl werden bis zu drei Attribute durchsucht.
$ aws iot list-things --attribute-name "wattage" --attribute-value "75"
{ "things": [ { "thingTypeName": "StopLight", "attributes": { "model": "123", "wattage": "75" }, "version": 3, "thingName": "MyLightBulb" }, { "thingTypeName": "LightBulb", "attributes": { "model": "123", "wattage": "75" }, "version": 1, "thingName": "MyRGBLight" }, { "thingTypeName": "LightBulb", "attributes": { "model": "123", "wattage": "75" }, "version": 1, "thingName": "MySecondLightBulb" } ] }
Weitere Informationen finden Sie unter list-things in der AWS CLI Befehlsreferenz.
Objekte beschreiben
Mit dem Befehl DescribeThing können Sie detailliertere Informationen zu einem Objekt anzeigen:
$ aws iot describe-thing --thing-name "MyLightBulb" { "version": 3, "thingName": "MyLightBulb", "thingArn": "arn:aws:iot:us-east-1:123456789012:thing/MyLightBulb", "thingId": "12345678abcdefgh12345678ijklmnop12345678", "defaultClientId": "MyLightBulb", "thingTypeName": "StopLight", "attributes": { "model": "123", "wattage": "75" } }
Weitere Informationen finden Sie in der AWS CLI Befehlsreferenz unter describe-thing.
Ein Objekt aktualisieren
Mit dem Befehl UpdateThing können Sie ein Objekt aktualisieren. Dieser Befehl aktualisiert nur die Attribute der Sache. Sie können den Namen eines Objekts nicht ändern. Um den Namen eines Dings zu ändern, erstellen Sie ein neues Ding, geben ihm den neuen Namen und löschen Sie dann das alte Ding.
$ aws iot update-thing --thing-name "MyLightBulb" --attribute-payload "{\"attributes\": {\"wattage\":\"150\", \"model\":\"456\"}}"
Der Befehl UpdateThing erzeugt keine Ausgabe. Mit dem Befehl DescribeThing können Sie das Ergebnis anzeigen:
$ aws iot describe-thing --thing-name "MyLightBulb" { "attributes": { "model": "456", "wattage": "150" }, "version": 2, "thingName": "MyLightBulb" }
Weitere Informationen finden Sie unter update-thing in der AWS CLI Befehlsreferenz.
Ein Objekt löschen
Mit dem Befehl DeleteThing können Sie ein Objekt löschen:
$ aws iot delete-thing --thing-name "MyThing"
Dieser Befehl wird erfolgreich und ohne Fehler zurückgegeben, wenn der Löschvorgang erfolgreich ist oder Sie ein Objekt angeben, das nicht vorhanden ist.
Weitere Informationen finden Sie unter delete-thing in der AWS CLI Befehlsreferenz.
Ein Prinzipal an ein Objekt anfügen
Ein physisches Gerät muss über ein X.509-Zertifikat verfügen, mit dem AWS IoT es kommunizieren kann. Sie können das Zertifikat auf Ihrem Gerät mit dem Objekt im Registry, das Ihr Gerät widerspiegelt, verknüpfen. Mit dem Befehl AttachThingPrincipal können Sie ein Zertifikat an Ihr Objekt anfügen:
$ aws iot attach-thing-principal --thing-name "MyLightBulb" --principal "arn:aws:iot:us-east-1:123456789012:cert/a0c01f5835079de0a7514643d68ef8414ab739a1e94ee4162977b02b12842847"
Der Befehl AttachThingPrincipal erzeugt keine Ausgabe.
Weitere Informationen finden Sie in der Befehlsreferenz unter attach-thing-principal. AWS CLI
Ein Prinzipal von einem Objekt trennen
Mit dem Befehl DetachThingPrincipal können Sie ein Zertifikat von einem Objekt trennen:
$ aws iot detach-thing-principal --thing-name "MyLightBulb" --principal "arn:aws:iot:us-east-1:123456789012:cert/a0c01f5835079de0a7514643d68ef8414ab739a1e94ee4162977b02b12842847"
Der Befehl DetachThingPrincipal erzeugt keine Ausgabe.
Weitere Informationen finden Sie in der Befehlsreferenz unter detach-thing-principal. AWS CLI
