v1

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

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

Requires permission to access the ListPrincipalThings action.

get/principals/things#x-amzn-principal

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.

Headers

x-amzn-principalstring required

The principal.

Response

Success

thingsThingName[]

The things.

nextTokenstring

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