Options
All
  • Public
  • Public/Protected
  • All
Menu

Class DeletePolicyCommand

Deletes the specified managed policy.

Before you can delete a managed policy, you must first detach the policy from all users, groups, and roles that it is attached to. In addition, you must delete all the policy's versions. The following steps describe the process for deleting a managed policy:

  • Detach the policy from all users, groups, and roles that the policy is attached to, using DetachUserPolicy, DetachGroupPolicy, or DetachRolePolicy. To list all the users, groups, and roles that a policy is attached to, use ListEntitiesForPolicy.

  • Delete all versions of the policy using DeletePolicyVersion. To list the policy's versions, use ListPolicyVersions. You cannot use DeletePolicyVersion to delete the version that is marked as the default version. You delete the policy's default version in the next step of the process.

  • Delete the policy (this automatically deletes the policy's default version) using this operation.

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

example

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

import { IAMClient, DeletePolicyCommand } from "@aws-sdk/client-iam"; // ES Modules import
// const { IAMClient, DeletePolicyCommand } = require("@aws-sdk/client-iam"); // CommonJS import
const client = new IAMClient(config);
const command = new DeletePolicyCommand(input);
const response = await client.send(command);
see

DeletePolicyCommandInput for command's input shape.

see

DeletePolicyCommandOutput for command's response shape.

see

config for IAMClient's config shape.

Hierarchy

Implements

Index

Constructors

constructor

Properties

Readonly input

input: DeletePolicyCommandInput

Readonly middlewareStack

middlewareStack: IMiddlewareStack<DeletePolicyCommandInput, DeletePolicyCommandOutput>

Methods

Static getEndpointParameterInstructions