Skip to content

Delete User

iam_delete_user R Documentation

Deletes the specified IAM user

Description

Deletes the specified IAM user. Unlike the Amazon Web Services Management Console, when you delete a user programmatically, you must delete the items attached to the user manually, or the deletion fails. For more information, see Deleting an IAM user. Before attempting to delete a user, remove the following items:

  • Password (delete_login_profile)

  • Access keys (delete_access_key)

  • Signing certificate (delete_signing_certificate)

  • SSH public key (delete_ssh_public_key)

  • Git credentials (delete_service_specific_credential)

  • Multi-factor authentication (MFA) device (deactivate_mfa_device, delete_virtual_mfa_device)

  • Inline policies (delete_user_policy)

  • Attached managed policies (detach_user_policy)

  • Group memberships (remove_user_from_group)

Usage

iam_delete_user(UserName)

Arguments

UserName

[required] The name of the user 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: _+=,.@-

Value

An empty list.

Request syntax

svc$delete_user(
  UserName = "string"
)

Examples

## Not run: 
# The following command removes the IAM user named Bob from the current
# account.
svc$delete_user(
  UserName = "Bob"
)

## End(Not run)