v1

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

Lists the principals associated with the specified policy.

Note: This action is deprecated and works as expected for backward compatibility, but we won't add enhancements. Use ListTargetsForPolicy instead.

Requires permission to access the ListPolicyPrincipals action.

get/policy-principals#x-amzn-iot-policy

Query parameters

markerstring

The marker for the next set of results.

pageSizeinteger

The result page size.

isAscendingOrderboolean

Specifies the order for results. If true, the results are returned in ascending creation order.

Headers

x-amzn-iot-policystring required

The policy name.

Response

Success

principalsPrincipalArn[]

The descriptions of the principals.

nextMarkerstring

The marker for the next set of results, or null if there are no additional results.