v1

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

Lists the principals associated with the specified thing. A principal can be X.509 certificates, IAM users, groups, and roles, Amazon Cognito identities or federated identities.

Requires permission to access the ListThingPrincipals action.

get/things/{thingName}/principals

Path parameters

thingNamestring required

The name of the thing.

Query parameters

nextTokenstring

To retrieve the next set of results, the <code>nextToken</code> value from a previous response; otherwise <b>null</b> to receive the first set of results.

maxResultsinteger

The maximum number of results to return in this operation.

Response

Success

principalsPrincipalArn[]

The principals associated with the thing.

nextTokenstring

The token to use to get the next set of results, or <b>null</b> if there are no additional results.