Skip to content

IAM  >  Operations  >  delete_user

delete_user

Operation

delete_user async

delete_user(input: DeleteUserInput, plugins: list[Plugin] | None = None) -> DeleteUserOutput

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:

Parameters:

Name Type Description Default
input DeleteUserInput

An instance of DeleteUserInput.

required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
DeleteUserOutput

An instance of DeleteUserOutput.

Input

DeleteUserInput dataclass

Bases: _SerdeShape

Dataclass for DeleteUserInput structure.

Attributes

user_name class-attribute instance-attribute
user_name: str | None = ...

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: _+=,.@-

Output

DeleteUserOutput dataclass

Bases: _SerdeShape

Dataclass for DeleteUserOutput structure.

Attributes

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.