EFS / Client / delete_mount_target

delete_mount_target#

EFS.Client.delete_mount_target(**kwargs)#

Deletes the specified mount target.

This operation forcibly breaks any mounts of the file system by using the mount target that is being deleted, which might disrupt instances or applications using those mounts. To avoid applications getting cut off abruptly, you might consider unmounting any mounts of the mount target, if feasible. The operation also deletes the associated network interface. Uncommitted writes might be lost, but breaking a mount target using this operation does not corrupt the file system itself. The file system you created remains. You can mount an EC2 instance in your VPC by using another mount target.

This operation requires permissions for the following action on the file system:

  • elasticfilesystem:DeleteMountTarget

Note

The DeleteMountTarget call returns while the mount target state is still deleting. You can check the mount target deletion by calling the DescribeMountTargets operation, which returns a list of mount target descriptions for the given file system.

The operation also requires permissions for the following Amazon EC2 action on the mount target’s network interface:

  • ec2:DeleteNetworkInterface

See also: AWS API Documentation

Request Syntax

response = client.delete_mount_target(
    MountTargetId='string'
)
Parameters:

MountTargetId (string) –

[REQUIRED]

The ID of the mount target to delete (String).

Returns:

None

Exceptions

  • EFS.Client.exceptions.BadRequest

  • EFS.Client.exceptions.InternalServerError

  • EFS.Client.exceptions.DependencyTimeout

  • EFS.Client.exceptions.MountTargetNotFound

Examples

This operation deletes a mount target.

response = client.delete_mount_target(
    MountTargetId='fsmt-12340abc',
)

print(response)

Expected Output:

{
    'ResponseMetadata': {
        '...': '...',
    },
}