Skip to content

list_policies_granting_service_access

Operation

list_policies_granting_service_access

Retrieves a list of policies that the IAM identity (user, group, or role) can use to access each specified service.

Note

This operation does not use other policy types when determining whether a resource could access a service. These other policy types include resource-based policies, access control lists, Organizations policies, IAM permissions boundaries, and STS assume role policies. It only applies permissions policy logic. For more about the evaluation of policy types, see Evaluating policies in the IAM User Guide.

The list of policies returned by the operation depends on the ARN of the identity that you provide.

  • User -- The list of policies includes the managed and inline policies that are attached to the user directly. The list also includes any additional managed and inline policies that are attached to the group to which the user belongs.

  • Group -- The list of policies includes only the managed and inline policies that are attached to the group directly. Policies that are attached to the group's user are not included.

  • Role -- The list of policies includes only the managed and inline policies that are attached to the role.

For each managed policy, this operation returns the ARN and policy name. For each inline policy, it returns the policy name and the entity to which it is attached. Inline policies do not have an ARN. For more information about these policy types, see Managed policies and inline policies in the IAM User Guide.

Policies that are attached to users and roles as permissions boundaries are not returned. To view which managed policy is currently used to set the permissions boundary for a user or role, use the GetUser or GetRole operations.

Parameters:

Name Type Description Default
request ListPoliciesGrantingServiceAccessInput | ListPoliciesGrantingServiceAccessInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[ListPoliciesGrantingServiceAccessInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
ListPoliciesGrantingServiceAccessOutput

An instance of ListPoliciesGrantingServiceAccessOutput.

list_policies_granting_service_access async

Retrieves a list of policies that the IAM identity (user, group, or role) can use to access each specified service.

Note

This operation does not use other policy types when determining whether a resource could access a service. These other policy types include resource-based policies, access control lists, Organizations policies, IAM permissions boundaries, and STS assume role policies. It only applies permissions policy logic. For more about the evaluation of policy types, see Evaluating policies in the IAM User Guide.

The list of policies returned by the operation depends on the ARN of the identity that you provide.

  • User -- The list of policies includes the managed and inline policies that are attached to the user directly. The list also includes any additional managed and inline policies that are attached to the group to which the user belongs.

  • Group -- The list of policies includes only the managed and inline policies that are attached to the group directly. Policies that are attached to the group's user are not included.

  • Role -- The list of policies includes only the managed and inline policies that are attached to the role.

For each managed policy, this operation returns the ARN and policy name. For each inline policy, it returns the policy name and the entity to which it is attached. Inline policies do not have an ARN. For more information about these policy types, see Managed policies and inline policies in the IAM User Guide.

Policies that are attached to users and roles as permissions boundaries are not returned. To view which managed policy is currently used to set the permissions boundary for a user or role, use the GetUser or GetRole operations.

Parameters:

Name Type Description Default
request ListPoliciesGrantingServiceAccessInput | ListPoliciesGrantingServiceAccessInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[ListPoliciesGrantingServiceAccessInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
ListPoliciesGrantingServiceAccessOutput

An instance of ListPoliciesGrantingServiceAccessOutput.

Input

Pass the input as keyword arguments, a positional dictionary, or a positional model object. Pass plugins separately as a keyword argument.

ListPoliciesGrantingServiceAccessInputDict

Bases: TypedDict

Dictionary form of ListPoliciesGrantingServiceAccessInput.

Attributes

arn instance-attribute
arn: Required[str]

The ARN of the IAM identity (user, group, or role) whose policies you want to list.

marker instance-attribute
marker: str | None

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

service_namespaces instance-attribute
service_namespaces: Required[Sequence[str]]

The service namespace for the Amazon Web Services services whose policies you want to list.

To learn the service namespace for a service, see Actions, resources, and condition keys for Amazon Web Services services in the IAM User Guide. Choose the name of the service to view details for that service. In the first paragraph, find the service prefix. For example, (service prefix: a4b). For more information about service namespaces, see Amazon Web Services service namespaces in the Amazon Web Services General Reference.

ListPoliciesGrantingServiceAccessInput dataclass

Bases: _SerdeShape

Dataclass for ListPoliciesGrantingServiceAccessInput structure.

Attributes

arn class-attribute instance-attribute
arn: str | None = ...

The ARN of the IAM identity (user, group, or role) whose policies you want to list.

marker class-attribute instance-attribute
marker: str | None = ...

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

service_namespaces class-attribute instance-attribute
service_namespaces: list[str] | None = ...

The service namespace for the Amazon Web Services services whose policies you want to list.

To learn the service namespace for a service, see Actions, resources, and condition keys for Amazon Web Services services in the IAM User Guide. Choose the name of the service to view details for that service. In the first paragraph, find the service prefix. For example, (service prefix: a4b). For more information about service namespaces, see Amazon Web Services service namespaces in the Amazon Web Services General Reference.

Output

ListPoliciesGrantingServiceAccessOutput dataclass

Bases: _SerdeShape

Dataclass for ListPoliciesGrantingServiceAccessOutput structure.

Attributes

is_truncated class-attribute instance-attribute
is_truncated: 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. We recommend that you check IsTruncated after every call to ensure that you receive all your results.

marker class-attribute instance-attribute
marker: str | None = ...

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

policies_granting_service_access instance-attribute
policies_granting_service_access: list[ListPoliciesGrantingServiceAccessEntry]

A ListPoliciesGrantingServiceAccess object that contains details about the permissions policies attached to the specified identity (user, group, or role).

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.