The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Paws::IAM::ListPolicies - Arguments for method ListPolicies on Paws::IAM

DESCRIPTION

This class represents the parameters used for calling the method ListPolicies on the AWS Identity and Access Management service. Use the attributes of this class as arguments to method ListPolicies.

You shouldn't make instances of this class. Each attribute should be used as a named argument in the call to ListPolicies.

SYNOPSIS

my $iam = Paws->service('IAM');
my $ListPoliciesResponse = $iam->ListPolicies(
  Marker            => 'MymarkerType',         # OPTIONAL
  MaxItems          => 1,                      # OPTIONAL
  OnlyAttached      => 1,                      # OPTIONAL
  PathPrefix        => 'MypolicyPathType',     # OPTIONAL
  PolicyUsageFilter => 'PermissionsPolicy',    # OPTIONAL
  Scope             => 'All',                  # OPTIONAL
);

# Results:
my $IsTruncated = $ListPoliciesResponse->IsTruncated;
my $Marker      = $ListPoliciesResponse->Marker;
my $Policies    = $ListPoliciesResponse->Policies;

# Returns a L<Paws::IAM::ListPoliciesResponse> object.

Values for attributes that are native types (Int, String, Float, etc) can passed as-is (scalar values). Values for complex Types (objects) can be passed as a HashRef. The keys and values of the hashref will be used to instance the underlying object. For the AWS API documentation, see https://docs.aws.amazon.com/goto/WebAPI/iam/ListPolicies

ATTRIBUTES

Marker => Str

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.

MaxItems => Int

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

If you do not include this parameter, the number of items defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true, and Marker contains a value to include in the subsequent call that tells the service where to continue from.

OnlyAttached => Bool

A flag to filter the results to only the attached policies.

When OnlyAttached is true, the returned list contains only the policies that are attached to an IAM user, group, or role. When OnlyAttached is false, or when the parameter is not included, all policies are returned.

PathPrefix => Str

The path prefix for filtering the results. This parameter is optional. If it is not included, it defaults to a slash (/), listing all policies. This parameter allows (through its regex pattern (http://wikipedia.org/wiki/regex)) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\u0021) through the DEL character (\u007F), including most punctuation characters, digits, and upper and lowercased letters.

PolicyUsageFilter => Str

The policy usage method to use for filtering the results.

To list only permissions policies, set PolicyUsageFilter to PermissionsPolicy. To list only the policies used to set permissions boundaries, set the value to PermissionsBoundary.

This parameter is optional. If it is not included, all policies are returned.

Valid values are: "PermissionsPolicy", "PermissionsBoundary"

Scope => Str

The scope to use for filtering the results.

To list only AWS managed policies, set Scope to AWS. To list only the customer managed policies in your AWS account, set Scope to Local.

This parameter is optional. If it is not included, or if it is set to All, all policies are returned.

Valid values are: "All", "AWS", "Local"

SEE ALSO

This class forms part of Paws, documenting arguments for method ListPolicies in Paws::IAM

BUGS and CONTRIBUTIONS

The source code is located here: https://github.com/pplu/aws-sdk-perl

Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues