v1

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

Detaches the specified principal from the specified thing. A principal can be X.509 certificates, IAM users, groups, and roles, Amazon Cognito identities or federated identities.

This call is asynchronous. It might take several seconds for the detachment to propagate.

Requires permission to access the DetachThingPrincipal action.

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

Path parameters

thingNamestring required

The name of the thing.

Headers

x-amzn-principalstring required

If the principal is a certificate, this value must be ARN of the certificate. If the principal is an Amazon Cognito identity, this value must be the ID of the Amazon Cognito identity.

Response

Success

DetachThingPrincipalResponse required

The output from the DetachThingPrincipal operation.