v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-142381,278956.3 KB

Attaches the specified principal to the specified thing. A principal can be X.509 certificates, Amazon Cognito identities or federated identities.

Requires permission to access the AttachThingPrincipal action.

put/things/{thingName}/principals#x-amzn-principal

Path parameters

thingNamestring required

The name of the thing.

Headers

x-amzn-principalstring required

The principal, which can be a certificate ARN (as returned from the CreateCertificate operation) or an Amazon Cognito ID.

Response

Success

AttachThingPrincipalResponse required

The output from the AttachThingPrincipal operation.