Network.AWS.IAM.ListEntitiesForPolicy

Lists all users, groups, and roles that the specified managed policy is attached to.

You can use the optional EntityFilter parameter to limit the results to a particular type of entity (users, groups, or roles). For example, to list only the roles that are attached to the specified policy, set EntityFilter to Role.

You can paginate the results using the MaxItems and Marker parameters.

See: AWS API Reference for ListEntitiesForPolicy.

Creating a Request

listEntitiesForPolicy

Arguments

:: Text

lefpPolicyARN

-> ListEntitiesForPolicy

Creates a value of ListEntitiesForPolicy with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• lefpPathPrefix
• lefpEntityFilter
• lefpMaxItems
• lefpMarker
• lefpPolicyARN

data ListEntitiesForPolicy

See: listEntitiesForPolicy smart constructor.

Instances

Eq ListEntitiesForPolicy

Data ListEntitiesForPolicy

Read ListEntitiesForPolicy

Show ListEntitiesForPolicy

Generic ListEntitiesForPolicy

AWSRequest ListEntitiesForPolicy

ToPath ListEntitiesForPolicy

ToHeaders ListEntitiesForPolicy

ToQuery ListEntitiesForPolicy

type Rep ListEntitiesForPolicy

type Sv ListEntitiesForPolicy = IAM

type Rs ListEntitiesForPolicy = ListEntitiesForPolicyResponse

Request Lenses

lefpPathPrefix :: Lens' ListEntitiesForPolicy (Maybe Text)

The path prefix for filtering the results. This parameter is optional. If it is not included, it defaults to a slash (/), listing all entities.

lefpEntityFilter :: Lens' ListEntitiesForPolicy (Maybe EntityType)

The entity type to use for filtering the results.

For example, when EntityFilter is Role, only the roles that are attached to the specified policy are returned. This parameter is optional. If it is not included, all attached entities (users, groups, and roles) are returned.

lefpMaxItems :: Lens' ListEntitiesForPolicy (Maybe Natural)

Use this only when paginating results to indicate the maximum number of items you want in the response. If there are additional items beyond the maximum you specify, the IsTruncated response element is true.

This parameter is optional. If you do not include it, it defaults to 100.

lefpMarker :: Lens' ListEntitiesForPolicy (Maybe Text)

Use this parameter only when paginating results and only after you have received a response where the results are truncated. Set it to the value of the Marker element in the response you just received.

lefpPolicyARN :: Lens' ListEntitiesForPolicy Text

Undocumented member.

Destructuring the Response

listEntitiesForPolicyResponse

Arguments

:: Int

lefprsStatus

-> ListEntitiesForPolicyResponse

Creates a value of ListEntitiesForPolicyResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• lefprsPolicyGroups
• lefprsPolicyRoles
• lefprsPolicyUsers
• lefprsMarker
• lefprsIsTruncated
• lefprsStatus

data ListEntitiesForPolicyResponse

Contains the response to a successful ListEntitiesForPolicy request.

See: listEntitiesForPolicyResponse smart constructor.

Instances

Eq ListEntitiesForPolicyResponse

Data ListEntitiesForPolicyResponse

Read ListEntitiesForPolicyResponse

Show ListEntitiesForPolicyResponse

Generic ListEntitiesForPolicyResponse

type Rep ListEntitiesForPolicyResponse

Response Lenses

lefprsPolicyGroups :: Lens' ListEntitiesForPolicyResponse [PolicyGroup]

A list of groups that the policy is attached to.

lefprsPolicyRoles :: Lens' ListEntitiesForPolicyResponse [PolicyRole]

A list of roles that the policy is attached to.

lefprsPolicyUsers :: Lens' ListEntitiesForPolicyResponse [PolicyUser]

A list of users that the policy is attached to.

lefprsMarker :: Lens' ListEntitiesForPolicyResponse (Maybe Text)

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

lefprsIsTruncated :: Lens' ListEntitiesForPolicyResponse (Maybe Bool)

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items.

lefprsStatus :: Lens' ListEntitiesForPolicyResponse Int

The response status code.