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à.

# Collegamento di un'entità principale a un oggetto
<a name="attach-thing-principal"></a>

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.*