principal_things

Creates, updates, deletes, gets or lists a principal_things resource.

Overview

Name	principal_things
Type	Resource
Id	aws.iot.principal_things

Fields

The following fields are returned by SELECT queries:

list_principal_things

Name	Datatype	Description
thing	string	The things.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_principal_things	select	x-amzn-principal, region	nextToken, maxResults	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.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
region	string	AWS region (default: us-east-1)
x-amzn-principal	string	The principal.
maxResults	integer	The maximum number of results to return in this operation.
nextToken	string	To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

SELECT examples

list_principal_things

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.

SELECT
thing
FROM aws.iot.principal_things
WHERE `x-amzn-principal` = '{{ x-amzn-principal }}' -- required
AND region = '{{ region }}' -- required
AND nextToken = '{{ nextToken }}'
AND maxResults = '{{ maxResults }}'
;