delete-role

Deletes the specified role. The role must not have any policies attached. For more information about roles, go to Working with Roles.

Warning

Make sure that you do not have any Amazon EC2 instances running with the role you are about to delete. Deleting a role or instance profile that is associated with a running instance will break any applications running on the instance.

Refer to delete roles, and AWS help for descriptions of global parameters.

Synopsis

delete-role
  --role-name <value>

Options

--role-name (string)

The name of the role to delete.

This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _, +, =, ,, ., @, and -.

Refer to AWS help for descriptions of global parameters.

Examples

To delete an IAM role

The following delete-role command removes the role named Test-Role

aws iam delete-role --role-name Test-Role

Before you can delete a role, you must remove the role from any instance profile (remove-role-from-instance-profile), detach any managed policies (detach-role-policy) and delete any inline policies that are attached to the role (delete-role-policy).

For more information, refer to Creating a Role and Instance Profiles in the Using IAM guide.

Output

None