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.
# Dinge mit der Registrierung verwalten
Sie verwenden die AWS IoT Konsole, die AWS IoT API oder die, AWS CLI um mit der Registrierung 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.
**Topics**
+ [Ein Objekt erstellen](create-thing.md)
+ [Objekte auflisten](list-things.md)
+ [Objekte beschreiben](search-things.md)
+ [Ein Objekt aktualisieren](update-thing.md)
+ [Ein Objekt löschen](delete-thing.md)
+ [Ein Prinzipal an ein Objekt anfügen](attach-thing-principal.md)
+ [Listet Dinge auf, die mit einem Principal verknüpft sind](list-principal-things.md)
+ [Listet die mit einer Sache verknüpften Prinzipale auf](list-thing-principals.md)
+ [Listet Dinge auf, die mit einem Prinzipal V2 verknüpft sind](list-principal-things-v2.md)
+ [Listet die mit einer Sache verknüpften Prinzipale auf V2](list-thing-principals-v2.md)
+ [Ein Prinzipal von einem Objekt trennen](detach-thing-principal.md)
# 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-type-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](https://docs.aws.amazon.com//cli/latest/reference/iot/create-thing.html) 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](https://docs.aws.amazon.com//cli/latest/reference/iot/list-things.html) 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"
}
}
```
Sie können über die Inline-Funktion auch innerhalb der Regel-Engine auf diese API zugreifen`get_registry_data()`. Sie können diese Funktion verwenden, um dynamisch auf Informationen in der Ding-Registrierung (einschließlich Attributen, Dingtypen und Gruppenmitgliedschaften) zuzugreifen und diese zu nutzen, indem Sie Regeln aufrufen `DescribeThing` und `ListThingGroupsForThing` APIs direkt innerhalb von AWS IoT Regeln aufrufen und so die Nachrichtenverarbeitung und -weiterleitung in Echtzeit auf der Grundlage Ihrer Geräteregistrierungsdaten ermöglichen. Weitere Informationen finden Sie unter [https://docs.aws.amazon.com//iot/latest/developerguide/iot-sql-functions.html#iot-sql-function-get-registry_data](https://docs.aws.amazon.com//iot/latest/developerguide/iot-sql-functions.html#iot-sql-function-get-registry_data).
Weitere Informationen finden Sie in der [Befehlsreferenz unter describe-thing](https://docs.aws.amazon.com//cli/latest/reference/iot/describe-thing.html). AWS CLI
# Ein Objekt aktualisieren
Mit dem Befehl **UpdateThing** können Sie ein Objekt aktualisieren. Dieser Befehl aktualisiert nur die Attribute des Dings. 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](https://docs.aws.amazon.com//cli/latest/reference/iot/update-thing.html) 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](https://docs.aws.amazon.com//cli/latest/reference/iot/delete-thing.html) in der AWS CLI Befehlsreferenz.
# Ein Prinzipal an ein Objekt anfügen
Ein physisches Gerät kann einen Principal für die Kommunikation verwenden AWS IoT. Ein Principal kann ein X.509-Zertifikat oder eine Amazon Cognito Cognito-ID sein. Sie können dem Ding in der Registrierung, das Ihr Gerät repräsentiert, ein Zertifikat oder eine Amazon Cognito Cognito-ID zuordnen, indem Sie den [attach-thing-principal](https://docs.aws.amazon.com//cli/latest/reference/iot/attach-thing-principal.html)Befehl ausführen.
Verwenden Sie den [attach-thing-principal](https://docs.aws.amazon.com//cli/latest/reference/iot/attach-thing-principal.html)folgenden Befehl, um ein Zertifikat oder eine Amazon Cognito Cognito-ID an Ihr Ding anzuhängen:
```
$ aws iot attach-thing-principal \
--thing-name "MyLightBulb1" \
--principal "arn:aws:iot:us-east-1:123456789012:cert/a0c01f5835079de0a7514643d68ef8414ab739a1e94ee4162977b02b12842847"
```
Um Ihrem Ding ein Zertifikat mit einem Anhangstyp (exklusiver Anhang oder nicht exklusiver Anhang) anzuhängen, verwenden Sie den [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/attach-thing-principal.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/attach-thing-principal.html)Befehl und geben Sie einen Typ in das `--thing-principal-type` Feld ein. Ein exklusiver Anhang bedeutet, dass Ihr IoT-Ding das einzige ist, was an das Zertifikat angehängt ist, und dieses Zertifikat kann nicht mit anderen Dingen verknüpft werden. Ein nicht exklusiver Anhang bedeutet, dass Ihr IoT-Ding an das Zertifikat angehängt ist und dieses Zertifikat mit anderen Dingen verknüpft werden kann. Weitere Informationen finden Sie unter [Einer AWS IoT MQTT-Clientverbindung ein Ding zuordnen](exclusive-thing.md).
**Anmerkung**
Für [Einer AWS IoT MQTT-Clientverbindung ein Ding zuordnen](exclusive-thing.md) diese Funktion können Sie nur das X.509-Zertifikat als Prinzipal verwenden.
```
$ aws iot attach-thing-principal \
--thing-name "MyLightBulb2" \
--principal "arn:aws:iot:us-east-1:123456789012:cert/a0c01f5835079de0a7514643d68ef8414ab739a1e94ee4162977b02b12842847" \
--thing-principal-type "EXCLUSIVE_THING"
```
Wenn der Anhang erfolgreich ist, erzeugt der **AttachThingPrincipal** Befehl keine Ausgabe. Verwenden Sie den CLI-Befehl list-thing-principals-v 2, um den Anhang zu beschreiben.
Weitere Informationen finden Sie in [AttachThingPrincipal](https://docs.aws.amazon.com//iot/latest/apireference/API_AttachThingPrincipal.html)der *AWS IoT Core API-Referenz*.
# Listet Dinge auf, die mit einem Principal verknüpft sind
Um die Dinge aufzulisten, die dem angegebenen Prinzipal zugeordnet sind, führen Sie den [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-principal-things.htmls](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-principal-things.htmls)Befehl aus. Beachten Sie, dass dieser Befehl den Anhangstyp zwischen dem Ding und dem Zertifikat nicht auflistet. Verwenden Sie den [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-principal-thingsv2.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-principal-thingsv2.html)Befehl, um den Anhangstyp aufzulisten. Weitere Informationen finden Sie unter [Listet Dinge auf, die mit einem Prinzipal V2 verknüpft sind](list-principal-things-v2.md).
```
$ aws iot list-principal-things \
--principal "arn:aws:iot:us-east-1:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8"
```
Die Ausgabe kann wie folgt aussehen.
```
{
"things": [
"MyLightBulb1",
"MyLightBulb2"
]
}
```
Weitere Informationen finden Sie in [ListPrincipalThings](https://docs.aws.amazon.com//iot/latest/apireference/API_ListPrincipalThings.html)der *AWS IoT Core API-Referenz*.
# Listet die mit einer Sache verknüpften Prinzipale auf
Führen Sie den Befehl aus, um die mit dem angegebenen Ding verknüpften Prinzipale aufzulisten. [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-principals.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-principals.html) Beachten Sie, dass dieser Befehl den Anhangstyp zwischen dem Ding und dem Zertifikat nicht auflistet. Verwenden Sie den [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-principalsv2.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-principalsv2.html)Befehl, um den Anhangstyp aufzulisten. Weitere Informationen finden Sie unter [Listet die mit einer Sache verknüpften Prinzipale auf V2](list-thing-principals-v2.md).
```
$ aws iot list-thing-principals \
--thing-name "MyLightBulb1"
```
Die Ausgabe kann wie folgt aussehen.
```
{
"principals": [
"arn:aws:iot:us-east-1:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8",
"arn:aws:iot:us-east-1:123456789012:cert/1a234b39b4b68278f2e9d84bf97eac2cbf4a1c28b23ea29a44559b9bcf8d395b"
]
}
```
Weitere Informationen finden Sie in [ListThingPrincipals](https://docs.aws.amazon.com//iot/latest/apireference/API_ListThingPrincipals.html)der *AWS IoT Core API-Referenz*.
# Listet Dinge auf, die mit einem Prinzipal V2 verknüpft sind
Führen Sie den [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-principal-thingsv2.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-principal-thingsv2.html)Befehl aus, um die mit dem angegebenen Zertifikat verknüpften Dinge zusammen mit dem Anhangstyp aufzulisten. Der Anhangstyp bezieht sich darauf, wie das Zertifikat an die Sache angehängt ist.
```
$ aws iot list-principal-things-v2 \
--principal "arn:aws:iot:us-east-1:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8"
```
Die Ausgabe kann wie folgt aussehen.
```
{
"PrincipalThingObjects": [
{
"thingPrincipalType": "NON_EXCLUSIVE_THING",
"thing": "arn:aws:iot:us-east-1:123456789012:thing/thing_1"
},
{
"thingPrincipalType": "NON_EXCLUSIVE_THING",
"thing": "arn:aws:iot:us-east-1:123456789012:thing/thing_2"
}
]
}
```
Weitere Informationen finden Sie in der *AWS IoT Core API-Referenz* unter [ListPrincipalThingsV2](https://docs.aws.amazon.com//iot/latest/apireference/API_ListPrincipalThingsV2.html).
# Listet die mit einer Sache verknüpften Prinzipale auf V2
Führen Sie den [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-principalsv2.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-principalsv2.html)Befehl aus, um die mit der angegebenen Sache verknüpften Zertifikate zusammen mit dem Anlagentyp aufzulisten. Der Anhangstyp bezieht sich darauf, wie das Zertifikat an die Sache angehängt ist.
```
$ aws iot list-thing-principals-v2 \
--thing-name "thing_1"
```
Die Ausgabe kann wie folgt aussehen.
```
{
"ThingPrincipalObjects": [
{
"thingPrincipalType": "NON_EXCLUSIVE_THING",
"principal": "arn:aws:iot:us-east-1:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8"
},
{
"thingPrincipalType": "NON_EXCLUSIVE_THING",
"principal": "arn:aws:iot:us-east-1:123456789012:cert/1a234b39b4b68278f2e9d84bf97eac2cbf4a1c28b23ea29a44559b9bcf8d395b"
}
]
}
```
Weitere Informationen finden Sie in der *AWS IoT Core API-Referenz* unter [ListThingsPrincipalV2](https://docs.aws.amazon.com//iot/latest/apireference/API_ListThingPrincipalsV2.html).
# 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/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8"
```
Der Befehl **DetachThingPrincipal** erzeugt keine Ausgabe.
Weitere Informationen finden Sie in [detach-thing-principal](https://docs.aws.amazon.com//iot/latest/apireference/API_DetachThingPrincipal.html)der *AWS IoT Core API-Referenz*.