Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Asociar un principal a un objeto
<a name="attach-thing-principal"></a>

Un dispositivo físico puede utilizar un principal para comunicarse con él. AWS IoT Una entidad principal puede ser un certificado X.509 o un ID de Amazon Cognito. Puede asociar un certificado o un ID de Amazon Cognito al elemento del registro que representa su dispositivo ejecutando el [attach-thing-principal](https://docs.aws.amazon.com//cli/latest/reference/iot/attach-thing-principal.html)comando.

Para adjuntar un certificado o un Amazon Cognito ID a tu dispositivo, usa el [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"
```

Para adjuntar un certificado a su dispositivo con un tipo de adjunto (adjunto exclusivo o no exclusivo), utilice el [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 y especifique un tipo en el `--thing-principal-type` campo. Una asociación exclusiva significa que el objeto de IoT es lo único que se asocia al certificado y este certificado no se puede asociar a ningún otro objeto. Una asociación no exclusiva significa que el objeto de IoT se asocia al certificado y este certificado se puede asociar a otro objeto. Para obtener más información, consulte [Asociar cualquier AWS IoT cosa a una conexión de cliente MQTT](exclusive-thing.md).

**nota**  
Para la característica [Asociar cualquier AWS IoT cosa a una conexión de cliente MQTT](exclusive-thing.md), solo puede usar el certificado X.509 como entidad principal.

```
$ aws iot attach-thing-principal \
    --thing-name "MyLightBulb2" \
    --principal "arn:aws:iot:us-east-1:123456789012:cert/a0c01f5835079de0a7514643d68ef8414ab739a1e94ee4162977b02b12842847" \
    --thing-principal-type "EXCLUSIVE_THING"
```

Si la asociación se realiza correctamente, el comando **AttachThingPrincipal** no producirá ningún resultado. Para describir el adjunto, utilice el comando list-thing-principals-v 2 CLI.

Para obtener más información, consulte [AttachThingPrincipal](https://docs.aws.amazon.com//iot/latest/apireference/API_AttachThingPrincipal.html) y en la Referencia de la API de *AWS IoT Core *.