Class ListAttachedRolePoliciesCommandProtected

Lists all managed policies that are attached to the specified IAM role.

An IAM role can also have inline policies embedded with it. To list the inline policies for a role, use ListRolePolicies. For information about policies, see Managed policies and inline policies in the IAM User Guide.

You can paginate the results using the MaxItems and Marker parameters. You can use the PathPrefix parameter to limit the list of policies to only those matching the specified path prefix. If there are no policies attached to the specified role (or none that match the specified path prefix), the operation returns an empty list.

Example

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

import { IAMClient, ListAttachedRolePoliciesCommand } from "@aws-sdk/client-iam"; // ES Modules import
// const { IAMClient, ListAttachedRolePoliciesCommand } = require("@aws-sdk/client-iam"); // CommonJS import
const client = new IAMClient(config);
const input = { // ListAttachedRolePoliciesRequest
  RoleName: "STRING_VALUE", // required
  PathPrefix: "STRING_VALUE",
  Marker: "STRING_VALUE",
  MaxItems: Number("int"),
};
const command = new ListAttachedRolePoliciesCommand(input);
const response = await client.send(command);
// { // ListAttachedRolePoliciesResponse
//   AttachedPolicies: [ // attachedPoliciesListType
//     { // AttachedPolicy
//       PolicyName: "STRING_VALUE",
//       PolicyArn: "STRING_VALUE",
//     },
//   ],
//   IsTruncated: true || false,
//   Marker: "STRING_VALUE",
// };

Param

ListAttachedRolePoliciesCommandInput

Returns

ListAttachedRolePoliciesCommandOutput

See

• ListAttachedRolePoliciesCommandInput for command's input shape.
• ListAttachedRolePoliciesCommandOutput for command's response shape.
• config for IAMClient's config shape.

Throws

InvalidInputException (client fault)

The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

Throws

NoSuchEntityException (client fault)

The request was rejected because it referenced a resource entity that does not exist. The error message describes the resource.

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.