Class ListPoliciesCommandProtected

Lists all the managed policies that are available in your Amazon Web Services account, including your own customer-defined managed policies and all Amazon Web Services managed policies.

You can filter the list of policies that is returned using the optional OnlyAttached, Scope, and PathPrefix parameters. For example, to list only the customer managed policies in your Amazon Web Services account, set Scope to Local. To list only Amazon Web Services managed policies, set Scope to AWS.

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

For more information about managed policies, see Managed policies and inline policies in the IAM User Guide.

IAM resource-listing operations return a subset of the available attributes for the resource. For example, this operation does not return tags, even though they are an attribute of the returned object. To view all of the information for a customer manged policy, see GetPolicy.

Example

Use a bare-bones client and the command you need to make an API call.

import { IAMClient, ListPoliciesCommand } from "@aws-sdk/client-iam"; // ES Modules import
// const { IAMClient, ListPoliciesCommand } = require("@aws-sdk/client-iam"); // CommonJS import
const client = new IAMClient(config);
const input = { // ListPoliciesRequest
  Scope: "All" || "AWS" || "Local",
  OnlyAttached: true || false,
  PathPrefix: "STRING_VALUE",
  PolicyUsageFilter: "PermissionsPolicy" || "PermissionsBoundary",
  Marker: "STRING_VALUE",
  MaxItems: Number("int"),
};
const command = new ListPoliciesCommand(input);
const response = await client.send(command);
// { // ListPoliciesResponse
//   Policies: [ // policyListType
//     { // Policy
//       PolicyName: "STRING_VALUE",
//       PolicyId: "STRING_VALUE",
//       Arn: "STRING_VALUE",
//       Path: "STRING_VALUE",
//       DefaultVersionId: "STRING_VALUE",
//       AttachmentCount: Number("int"),
//       PermissionsBoundaryUsageCount: Number("int"),
//       IsAttachable: true || false,
//       Description: "STRING_VALUE",
//       CreateDate: new Date("TIMESTAMP"),
//       UpdateDate: new Date("TIMESTAMP"),
//       Tags: [ // tagListType
//         { // Tag
//           Key: "STRING_VALUE", // required
//           Value: "STRING_VALUE", // required
//         },
//       ],
//     },
//   ],
//   IsTruncated: true || false,
//   Marker: "STRING_VALUE",
// };

Param

ListPoliciesCommandInput

Returns

ListPoliciesCommandOutput

See

• ListPoliciesCommandInput for command's input shape.
• ListPoliciesCommandOutput for command's response shape.
• config for IAMClient's config shape.

Throws

ServiceFailureException (server fault)

The request processing has failed because of an unknown error, exception or failure.

Throws

IAMServiceException

Base exception class for all service exceptions from IAM service.