Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Gestire gli elementi con il registro
Si utilizza la AWS IoT console, AWS IoT l'API o il AWS CLI per interagire con il registro. Nelle seguenti sezioni viene illustrato come usare l'interfaccia a riga di comando per lavorare con il registro.
**Quando nomini gli oggetti:**
+ Non utilizzare informazioni di identificazione personale nel nome dell'oggetto. Il nome dell'oggetto può essere visualizzato nelle comunicazioni e nei report non crittografati.
**Topics**
+ [Crea un oggetto](create-thing.md)
+ [Visualizzazione dell'elenco di oggetti](list-things.md)
+ [Descrizione di oggetti](search-things.md)
+ [Aggiornamento di un oggetto](update-thing.md)
+ [Eliminazione di un oggetto](delete-thing.md)
+ [Collegamento di un'entità principale a un oggetto](attach-thing-principal.md)
+ [Elenca le cose associate a un preside](list-principal-things.md)
+ [Elenca i principi associati a una cosa](list-thing-principals.md)
+ [Elenca le cose associate a una V2 principale](list-principal-things-v2.md)
+ [Elenca i principi associati a una cosa V2](list-thing-principals-v2.md)
+ [Scollegamento di un'entità principale da un oggetto](detach-thing-principal.md)
# Crea un oggetto
Il comando seguente mostra come utilizzare il AWS IoT **CreateThing** comando dalla CLI per creare un oggetto. Non puoi cambiare il nome di un oggetto dopo averlo creato. Per cambiare il nome di un oggetto, creane uno nuovo, assegnagli il nuovo nome e poi elimina quello vecchio.
```
$ aws iot create-thing \
--thing-type-name "MyLightBulb" \
--attribute-payload "{\"attributes\": {\"wattage\":\"75\", \"model\":\"123\"}}"
```
Il comando **CreateThing** visualizza il nome e il nome della risorsa Amazon (ARN) del nuovo oggetto.
```
{
"thingArn": "arn:aws:iot:us-east-1:123456789012:thing/MyLightBulb",
"thingName": "MyLightBulb",
"thingId": "12345678abcdefgh12345678ijklmnop12345678"
}
```
**Nota**
Non è consigliabile utilizzare informazioni di identificazione personale nei nomi degli oggetti.
Per ulteriori informazioni, consulta [create-thing](https://docs.aws.amazon.com//cli/latest/reference/iot/create-thing.html) nella Guida di riferimento ai comandi dell' AWS CLI .
# Visualizzazione dell'elenco di oggetti
Usa il comando **ListThings** per elencare tutti gli oggetti nell'account:
```
$ aws iot list-things
```
```
{
"things": [
{
"attributes": {
"model": "123",
"wattage": "75"
},
"version": 1,
"thingName": "MyLightBulb"
},
{
"attributes": {
"numOfStates":"3"
},
"version": 11,
"thingName": "MyWallSwitch"
}
]
}
```
Usa il comando **ListThings** per cercare tutti gli oggetti di un tipo di oggetto specifico:
```
$ 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"
}
]
}
```
Usa il comando **ListThings** per cercare tutti gli oggetti che hanno un attributo con un valore specifico. Questo comando ricerca fino a tre attributi.
```
$ 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"
}
]
}
```
Per ulteriori informazioni, consulta [list-things](https://docs.aws.amazon.com//cli/latest/reference/iot/list-things.html) nella Guida di riferimento ai comandi dell' AWS CLI .
# Descrizione di oggetti
Utilizza il comando **DescribeThing** per visualizzare maggiori informazioni su un oggetto:
```
$ 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"
}
}
```
Puoi anche accedere a questa API all'interno del motore delle regole utilizzando la funzione `get_registry_data()` inline. È possibile utilizzare questa funzione per accedere e utilizzare dinamicamente le informazioni del registro degli oggetti (inclusi attributi, tipi di oggetti e appartenenze ai gruppi) chiamando e `ListThingGroupsForThing` APIs direttamente all'interno delle AWS IoT regole, abilitando l'elaborazione `DescribeThing` e il routing dei messaggi in tempo reale in base ai dati del registro del dispositivo. Per ulteriori informazioni, consulta [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).
Per ulteriori informazioni, vedere [describe-thing](https://docs.aws.amazon.com//cli/latest/reference/iot/describe-thing.html) dal Command Reference. AWS CLI
# Aggiornamento di un oggetto
Usa il comando **UpdateThing** per aggiornare un oggetto. Questo comando aggiorna solo gli attributi dell'oggetto. Non puoi cambiare il nome di un oggetto. Per cambiare il nome di un oggetto, creane uno nuovo, assegnagli un nuovo nome e quindi elimina quello vecchio.
```
$ aws iot update-thing --thing-name "MyLightBulb" --attribute-payload "{\"attributes\": {\"wattage\":\"150\", \"model\":\"456\"}}"
```
Il comando **UpdateThing** non produce output. Usa il comando **DescribeThing** per visualizzare il risultato:
```
$ aws iot describe-thing --thing-name "MyLightBulb"
{
"attributes": {
"model": "456",
"wattage": "150"
},
"version": 2,
"thingName": "MyLightBulb"
}
```
Per ulteriori informazioni, consulta [update-thing](https://docs.aws.amazon.com//cli/latest/reference/iot/update-thing.html) nella Guida di riferimento ai comandi dell' AWS CLI .
# Eliminazione di un oggetto
Usa il comando **DeleteThing** per eliminare un oggetto:
```
$ aws iot delete-thing --thing-name "MyThing"
```
Questo comando ha esito positivo senza alcun errore se l'eliminazione va a buon fine oppure se specifichi un oggetto che non esiste.
Per ulteriori informazioni, consulta [delete-thing](https://docs.aws.amazon.com//cli/latest/reference/iot/delete-thing.html) nella Guida di riferimento ai comandi dell' AWS CLI .
# Collegamento di un'entità principale a un oggetto
Un dispositivo fisico può utilizzare un dispositivo principale con cui comunicare AWS IoT. Un principale può essere un certificato X.509 o un ID Amazon Cognito. Puoi associare un certificato o un ID Amazon Cognito all'elemento nel registro che rappresenta il tuo dispositivo, eseguendo il [attach-thing-principal](https://docs.aws.amazon.com//cli/latest/reference/iot/attach-thing-principal.html)comando.
Per allegare un certificato o un ID Amazon Cognito al tuo dispositivo, usa il [attach-thing-principal](https://docs.aws.amazon.com//cli/latest/reference/iot/attach-thing-principal.html)comando:
```
$ aws iot attach-thing-principal \
--thing-name "MyLightBulb1" \
--principal "arn:aws:iot:us-east-1:123456789012:cert/a0c01f5835079de0a7514643d68ef8414ab739a1e94ee4162977b02b12842847"
```
Per allegare un certificato a un oggetto con un tipo di allegato (allegato esclusivo o allegato non esclusivo), usa il [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)comando e specifica un tipo nel `--thing-principal-type` campo. Un allegato esclusivo significa che il tuo elemento IoT è l'unico elemento allegato al certificato e questo certificato non può essere associato a nessun altro elemento. Un allegato non esclusivo significa che il tuo oggetto IoT è allegato al certificato e questo certificato può essere associato ad altri elementi. Per ulteriori informazioni, consulta [Associazione di qualsiasi AWS IoT cosa a una connessione client MQTT](exclusive-thing.md).
**Nota**
Per [Associazione di qualsiasi AWS IoT cosa a una connessione client MQTT](exclusive-thing.md) questa funzionalità, è possibile utilizzare solo il certificato X.509 come principale.
```
$ aws iot attach-thing-principal \
--thing-name "MyLightBulb2" \
--principal "arn:aws:iot:us-east-1:123456789012:cert/a0c01f5835079de0a7514643d68ef8414ab739a1e94ee4162977b02b12842847" \
--thing-principal-type "EXCLUSIVE_THING"
```
Se l'allegato ha esito positivo, il **AttachThingPrincipal** comando non produce alcun output. Per descrivere l'allegato, utilizzare il list-thing-principals-v comando 2 CLI.
Per ulteriori informazioni, consulta [AttachThingPrincipal](https://docs.aws.amazon.com//iot/latest/apireference/API_AttachThingPrincipal.html)l'*AWS IoT Core API Reference.*
# Elenca le cose associate a un preside
Per elencare gli elementi associati al principale specificato, esegui il [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)comando. Nota che questo comando non elenca il tipo di allegato tra l'oggetto e il certificato. Per elencare il tipo di allegato, utilizzare il [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)comando. Per ulteriori informazioni, consulta [Elenca le cose associate a una V2 principale](list-principal-things-v2.md).
```
$ aws iot list-principal-things \
--principal "arn:aws:iot:us-east-1:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8"
```
L'output può essere simile al seguente.
```
{
"things": [
"MyLightBulb1",
"MyLightBulb2"
]
}
```
Per ulteriori informazioni, consulta [ListPrincipalThings](https://docs.aws.amazon.com//iot/latest/apireference/API_ListPrincipalThings.html)l'*AWS IoT Core API Reference*.
# Elenca i principi associati a una cosa
Per elencare i principali associati all'oggetto specificato, esegui il [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)comando. Nota che questo comando non elenca il tipo di allegato tra l'oggetto e il certificato. Per elencare il tipo di allegato, utilizzare il [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)comando. Per ulteriori informazioni, consulta [Elenca i principi associati a una cosa V2](list-thing-principals-v2.md).
```
$ aws iot list-thing-principals \
--thing-name "MyLightBulb1"
```
L'output può essere simile al seguente.
```
{
"principals": [
"arn:aws:iot:us-east-1:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8",
"arn:aws:iot:us-east-1:123456789012:cert/1a234b39b4b68278f2e9d84bf97eac2cbf4a1c28b23ea29a44559b9bcf8d395b"
]
}
```
Per ulteriori informazioni, consulta [ListThingPrincipals](https://docs.aws.amazon.com//iot/latest/apireference/API_ListThingPrincipals.html)l'*AWS IoT Core API Reference*.
# Elenca le cose associate a una V2 principale
Per elencare gli elementi associati al certificato specificato, insieme al tipo di allegato, esegui il [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)comando. Il tipo di allegato si riferisce al modo in cui il certificato è allegato all'oggetto.
```
$ aws iot list-principal-things-v2 \
--principal "arn:aws:iot:us-east-1:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8"
```
L'output può essere simile al seguente.
```
{
"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"
}
]
}
```
Per ulteriori informazioni, consulta [ListPrincipalThingsV2](https://docs.aws.amazon.com//iot/latest/apireference/API_ListPrincipalThingsV2.html) dall'*AWS IoT Core API Reference.*
# Elenca i principi associati a una cosa V2
Per elencare i certificati associati all'oggetto specificato, insieme al tipo di allegato, esegui il [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)comando. Il tipo di allegato si riferisce al modo in cui il certificato è allegato all'oggetto.
```
$ aws iot list-thing-principals-v2 \
--thing-name "thing_1"
```
L'output può essere simile al seguente.
```
{
"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"
}
]
}
```
Per ulteriori informazioni, consulta [ListThingsPrincipalV2](https://docs.aws.amazon.com//iot/latest/apireference/API_ListThingPrincipalsV2.html) dall'*AWS IoT Core API Reference.*
# Scollegamento di un'entità principale da un oggetto
Usa il comando `DetachThingPrincipal` per scollegare un certificato da un oggetto:
```
$ aws iot detach-thing-principal \
--thing-name "MyLightBulb" \
--principal "arn:aws:iot:us-east-1:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8"
```
Il comando **DetachThingPrincipal** non produce output.
Per ulteriori informazioni, consulta [detach-thing-principal](https://docs.aws.amazon.com//iot/latest/apireference/API_DetachThingPrincipal.html)l'*AWS IoT Core API Reference.*