Skip to content

EFSClient

Index > EFS > EFSClient

Auto-generated documentation for EFS type annotations stubs module types-aiobotocore-efs.

EFSClient

Type annotations and code completion for session.client("efs") boto3 documentation

Usage example
from aioboto3.session import Session
from types_aiobotocore_efs.client import EFSClient

session = Session()
async with session.client("efs") as client:
    client: EFSClient

Exceptions

aioboto3 client exceptions are generated in runtime. This class provides code completion for session.client("efs").exceptions structure.

Usage example
async with session.client("efs") as client:
    try:
        do_something(client)
    except (
            client.AccessPointAlreadyExists,
        client.AccessPointLimitExceeded,
        client.AccessPointNotFound,
        client.AvailabilityZonesMismatch,
        client.BadRequest,
        client.ClientError,
        client.DependencyTimeout,
        client.FileSystemAlreadyExists,
        client.FileSystemInUse,
        client.FileSystemLimitExceeded,
        client.FileSystemNotFound,
        client.IncorrectFileSystemLifeCycleState,
        client.IncorrectMountTargetState,
        client.InsufficientThroughputCapacity,
        client.InternalServerError,
        client.InvalidPolicyException,
        client.IpAddressInUse,
        client.MountTargetConflict,
        client.MountTargetNotFound,
        client.NetworkInterfaceLimitExceeded,
        client.NoFreeAddressesInSubnet,
        client.PolicyNotFound,
        client.ReplicationNotFound,
        client.SecurityGroupLimitExceeded,
        client.SecurityGroupNotFound,
        client.SubnetNotFound,
        client.ThrottlingException,
        client.ThroughputLimitExceeded,
        client.TooManyRequests,
        client.UnsupportedAvailabilityZone,
        client.ValidationException,
    ) as e:
        print(e)
Type checking example
from types_aiobotocore_efs.client import Exceptions

def handle_error(exc: Exceptions.AccessPointAlreadyExists) -> None:
    ...

Methods

can_paginate

Check if an operation can be paginated.

Type annotations and code completion for session.client("efs").can_paginate method. boto3 documentation

Method definition
def can_paginate(
    self,
    operation_name: str,
) -> bool:
    ...

close

Closes underlying endpoint connections.

Type annotations and code completion for session.client("efs").close method. boto3 documentation

Method definition
await def close(
    self,
) -> None:
    ...

create_access_point

Creates an EFS access point.

Type annotations and code completion for session.client("efs").create_access_point method. boto3 documentation

Method definition
await def create_access_point(
    self,
    *,
    ClientToken: str,
    FileSystemId: str,
    Tags: Sequence[TagTypeDef] = ...,  # (1)
    PosixUser: PosixUserTypeDef = ...,  # (2)
    RootDirectory: RootDirectoryTypeDef = ...,  # (3)
) -> AccessPointDescriptionResponseMetadataTypeDef:  # (4)
    ...
  1. See TagTypeDef
  2. See PosixUserTypeDef
  3. See RootDirectoryTypeDef
  4. See AccessPointDescriptionResponseMetadataTypeDef
Usage example with kwargs
kwargs: CreateAccessPointRequestRequestTypeDef = {  # (1)
    "ClientToken": ...,
    "FileSystemId": ...,
}

parent.create_access_point(**kwargs)
  1. See CreateAccessPointRequestRequestTypeDef

create_file_system

Creates a new, empty file system.

Type annotations and code completion for session.client("efs").create_file_system method. boto3 documentation

Method definition
await def create_file_system(
    self,
    *,
    CreationToken: str,
    PerformanceMode: PerformanceModeType = ...,  # (1)
    Encrypted: bool = ...,
    KmsKeyId: str = ...,
    ThroughputMode: ThroughputModeType = ...,  # (2)
    ProvisionedThroughputInMibps: float = ...,
    AvailabilityZoneName: str = ...,
    Backup: bool = ...,
    Tags: Sequence[TagTypeDef] = ...,  # (3)
) -> FileSystemDescriptionResponseMetadataTypeDef:  # (4)
    ...
  1. See PerformanceModeType
  2. See ThroughputModeType
  3. See TagTypeDef
  4. See FileSystemDescriptionResponseMetadataTypeDef
Usage example with kwargs
kwargs: CreateFileSystemRequestRequestTypeDef = {  # (1)
    "CreationToken": ...,
}

parent.create_file_system(**kwargs)
  1. See CreateFileSystemRequestRequestTypeDef

create_mount_target

Creates a mount target for a file system.

Type annotations and code completion for session.client("efs").create_mount_target method. boto3 documentation

Method definition
await def create_mount_target(
    self,
    *,
    FileSystemId: str,
    SubnetId: str,
    IpAddress: str = ...,
    SecurityGroups: Sequence[str] = ...,
) -> MountTargetDescriptionResponseMetadataTypeDef:  # (1)
    ...
  1. See MountTargetDescriptionResponseMetadataTypeDef
Usage example with kwargs
kwargs: CreateMountTargetRequestRequestTypeDef = {  # (1)
    "FileSystemId": ...,
    "SubnetId": ...,
}

parent.create_mount_target(**kwargs)
  1. See CreateMountTargetRequestRequestTypeDef

create_replication_configuration

Creates a replication configuration that replicates an existing EFS file system to a new, read-only file system.

Type annotations and code completion for session.client("efs").create_replication_configuration method. boto3 documentation

Method definition
await def create_replication_configuration(
    self,
    *,
    SourceFileSystemId: str,
    Destinations: Sequence[DestinationToCreateTypeDef],  # (1)
) -> ReplicationConfigurationDescriptionResponseMetadataTypeDef:  # (2)
    ...
  1. See DestinationToCreateTypeDef
  2. See ReplicationConfigurationDescriptionResponseMetadataTypeDef
Usage example with kwargs
kwargs: CreateReplicationConfigurationRequestRequestTypeDef = {  # (1)
    "SourceFileSystemId": ...,
    "Destinations": ...,
}

parent.create_replication_configuration(**kwargs)
  1. See CreateReplicationConfigurationRequestRequestTypeDef

create_tags

.

Type annotations and code completion for session.client("efs").create_tags method. boto3 documentation

Method definition
await def create_tags(
    self,
    *,
    FileSystemId: str,
    Tags: Sequence[TagTypeDef],  # (1)
) -> EmptyResponseMetadataTypeDef:  # (2)
    ...
  1. See TagTypeDef
  2. See EmptyResponseMetadataTypeDef
Usage example with kwargs
kwargs: CreateTagsRequestRequestTypeDef = {  # (1)
    "FileSystemId": ...,
    "Tags": ...,
}

parent.create_tags(**kwargs)
  1. See CreateTagsRequestRequestTypeDef

delete_access_point

Deletes the specified access point.

Type annotations and code completion for session.client("efs").delete_access_point method. boto3 documentation

Method definition
await def delete_access_point(
    self,
    *,
    AccessPointId: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
Usage example with kwargs
kwargs: DeleteAccessPointRequestRequestTypeDef = {  # (1)
    "AccessPointId": ...,
}

parent.delete_access_point(**kwargs)
  1. See DeleteAccessPointRequestRequestTypeDef

delete_file_system

Deletes a file system, permanently severing access to its contents.

Type annotations and code completion for session.client("efs").delete_file_system method. boto3 documentation

Method definition
await def delete_file_system(
    self,
    *,
    FileSystemId: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
Usage example with kwargs
kwargs: DeleteFileSystemRequestRequestTypeDef = {  # (1)
    "FileSystemId": ...,
}

parent.delete_file_system(**kwargs)
  1. See DeleteFileSystemRequestRequestTypeDef

delete_file_system_policy

Deletes the FileSystemPolicy for the specified file system.

Type annotations and code completion for session.client("efs").delete_file_system_policy method. boto3 documentation

Method definition
await def delete_file_system_policy(
    self,
    *,
    FileSystemId: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
Usage example with kwargs
kwargs: DeleteFileSystemPolicyRequestRequestTypeDef = {  # (1)
    "FileSystemId": ...,
}

parent.delete_file_system_policy(**kwargs)
  1. See DeleteFileSystemPolicyRequestRequestTypeDef

delete_mount_target

Deletes the specified mount target.

Type annotations and code completion for session.client("efs").delete_mount_target method. boto3 documentation

Method definition
await def delete_mount_target(
    self,
    *,
    MountTargetId: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
Usage example with kwargs
kwargs: DeleteMountTargetRequestRequestTypeDef = {  # (1)
    "MountTargetId": ...,
}

parent.delete_mount_target(**kwargs)
  1. See DeleteMountTargetRequestRequestTypeDef

delete_replication_configuration

Deletes an existing replication configuration.

Type annotations and code completion for session.client("efs").delete_replication_configuration method. boto3 documentation

Method definition
await def delete_replication_configuration(
    self,
    *,
    SourceFileSystemId: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
Usage example with kwargs
kwargs: DeleteReplicationConfigurationRequestRequestTypeDef = {  # (1)
    "SourceFileSystemId": ...,
}

parent.delete_replication_configuration(**kwargs)
  1. See DeleteReplicationConfigurationRequestRequestTypeDef

delete_tags

.

Type annotations and code completion for session.client("efs").delete_tags method. boto3 documentation

Method definition
await def delete_tags(
    self,
    *,
    FileSystemId: str,
    TagKeys: Sequence[str],
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
Usage example with kwargs
kwargs: DeleteTagsRequestRequestTypeDef = {  # (1)
    "FileSystemId": ...,
    "TagKeys": ...,
}

parent.delete_tags(**kwargs)
  1. See DeleteTagsRequestRequestTypeDef

describe_access_points

Returns the description of a specific Amazon EFS access point if the AccessPointId is provided.

Type annotations and code completion for session.client("efs").describe_access_points method. boto3 documentation

Method definition
await def describe_access_points(
    self,
    *,
    MaxResults: int = ...,
    NextToken: str = ...,
    AccessPointId: str = ...,
    FileSystemId: str = ...,
) -> DescribeAccessPointsResponseTypeDef:  # (1)
    ...
  1. See DescribeAccessPointsResponseTypeDef
Usage example with kwargs
kwargs: DescribeAccessPointsRequestRequestTypeDef = {  # (1)
    "MaxResults": ...,
}

parent.describe_access_points(**kwargs)
  1. See DescribeAccessPointsRequestRequestTypeDef

describe_account_preferences

Returns the account preferences settings for the Amazon Web Services account associated with the user making the request, in the current Amazon Web Services Region.

Type annotations and code completion for session.client("efs").describe_account_preferences method. boto3 documentation

Method definition
await def describe_account_preferences(
    self,
    *,
    NextToken: str = ...,
    MaxResults: int = ...,
) -> DescribeAccountPreferencesResponseTypeDef:  # (1)
    ...
  1. See DescribeAccountPreferencesResponseTypeDef
Usage example with kwargs
kwargs: DescribeAccountPreferencesRequestRequestTypeDef = {  # (1)
    "NextToken": ...,
}

parent.describe_account_preferences(**kwargs)
  1. See DescribeAccountPreferencesRequestRequestTypeDef

describe_backup_policy

Returns the backup policy for the specified EFS file system.

Type annotations and code completion for session.client("efs").describe_backup_policy method. boto3 documentation

Method definition
await def describe_backup_policy(
    self,
    *,
    FileSystemId: str,
) -> BackupPolicyDescriptionTypeDef:  # (1)
    ...
  1. See BackupPolicyDescriptionTypeDef
Usage example with kwargs
kwargs: DescribeBackupPolicyRequestRequestTypeDef = {  # (1)
    "FileSystemId": ...,
}

parent.describe_backup_policy(**kwargs)
  1. See DescribeBackupPolicyRequestRequestTypeDef

describe_file_system_policy

Returns the FileSystemPolicy for the specified EFS file system.

Type annotations and code completion for session.client("efs").describe_file_system_policy method. boto3 documentation

Method definition
await def describe_file_system_policy(
    self,
    *,
    FileSystemId: str,
) -> FileSystemPolicyDescriptionTypeDef:  # (1)
    ...
  1. See FileSystemPolicyDescriptionTypeDef
Usage example with kwargs
kwargs: DescribeFileSystemPolicyRequestRequestTypeDef = {  # (1)
    "FileSystemId": ...,
}

parent.describe_file_system_policy(**kwargs)
  1. See DescribeFileSystemPolicyRequestRequestTypeDef

describe_file_systems

Returns the description of a specific Amazon EFS file system if either the file system CreationToken or the FileSystemId is provided.

Type annotations and code completion for session.client("efs").describe_file_systems method. boto3 documentation

Method definition
await def describe_file_systems(
    self,
    *,
    MaxItems: int = ...,
    Marker: str = ...,
    CreationToken: str = ...,
    FileSystemId: str = ...,
) -> DescribeFileSystemsResponseTypeDef:  # (1)
    ...
  1. See DescribeFileSystemsResponseTypeDef
Usage example with kwargs
kwargs: DescribeFileSystemsRequestRequestTypeDef = {  # (1)
    "MaxItems": ...,
}

parent.describe_file_systems(**kwargs)
  1. See DescribeFileSystemsRequestRequestTypeDef

describe_lifecycle_configuration

Returns the current LifecycleConfiguration object for the specified Amazon EFS file system.

Type annotations and code completion for session.client("efs").describe_lifecycle_configuration method. boto3 documentation

Method definition
await def describe_lifecycle_configuration(
    self,
    *,
    FileSystemId: str,
) -> LifecycleConfigurationDescriptionTypeDef:  # (1)
    ...
  1. See LifecycleConfigurationDescriptionTypeDef
Usage example with kwargs
kwargs: DescribeLifecycleConfigurationRequestRequestTypeDef = {  # (1)
    "FileSystemId": ...,
}

parent.describe_lifecycle_configuration(**kwargs)
  1. See DescribeLifecycleConfigurationRequestRequestTypeDef

describe_mount_target_security_groups

Returns the security groups currently in effect for a mount target.

Type annotations and code completion for session.client("efs").describe_mount_target_security_groups method. boto3 documentation

Method definition
await def describe_mount_target_security_groups(
    self,
    *,
    MountTargetId: str,
) -> DescribeMountTargetSecurityGroupsResponseTypeDef:  # (1)
    ...
  1. See DescribeMountTargetSecurityGroupsResponseTypeDef
Usage example with kwargs
kwargs: DescribeMountTargetSecurityGroupsRequestRequestTypeDef = {  # (1)
    "MountTargetId": ...,
}

parent.describe_mount_target_security_groups(**kwargs)
  1. See DescribeMountTargetSecurityGroupsRequestRequestTypeDef

describe_mount_targets

Returns the descriptions of all the current mount targets, or a specific mount target, for a file system.

Type annotations and code completion for session.client("efs").describe_mount_targets method. boto3 documentation

Method definition
await def describe_mount_targets(
    self,
    *,
    MaxItems: int = ...,
    Marker: str = ...,
    FileSystemId: str = ...,
    MountTargetId: str = ...,
    AccessPointId: str = ...,
) -> DescribeMountTargetsResponseTypeDef:  # (1)
    ...
  1. See DescribeMountTargetsResponseTypeDef
Usage example with kwargs
kwargs: DescribeMountTargetsRequestRequestTypeDef = {  # (1)
    "MaxItems": ...,
}

parent.describe_mount_targets(**kwargs)
  1. See DescribeMountTargetsRequestRequestTypeDef

describe_replication_configurations

Retrieves the replication configuration for a specific file system.

Type annotations and code completion for session.client("efs").describe_replication_configurations method. boto3 documentation

Method definition
await def describe_replication_configurations(
    self,
    *,
    FileSystemId: str = ...,
    NextToken: str = ...,
    MaxResults: int = ...,
) -> DescribeReplicationConfigurationsResponseTypeDef:  # (1)
    ...
  1. See DescribeReplicationConfigurationsResponseTypeDef
Usage example with kwargs
kwargs: DescribeReplicationConfigurationsRequestRequestTypeDef = {  # (1)
    "FileSystemId": ...,
}

parent.describe_replication_configurations(**kwargs)
  1. See DescribeReplicationConfigurationsRequestRequestTypeDef

describe_tags

.

Type annotations and code completion for session.client("efs").describe_tags method. boto3 documentation

Method definition
await def describe_tags(
    self,
    *,
    FileSystemId: str,
    MaxItems: int = ...,
    Marker: str = ...,
) -> DescribeTagsResponseTypeDef:  # (1)
    ...
  1. See DescribeTagsResponseTypeDef
Usage example with kwargs
kwargs: DescribeTagsRequestRequestTypeDef = {  # (1)
    "FileSystemId": ...,
}

parent.describe_tags(**kwargs)
  1. See DescribeTagsRequestRequestTypeDef

generate_presigned_url

Generate a presigned url given a client, its method, and arguments.

Type annotations and code completion for session.client("efs").generate_presigned_url method. boto3 documentation

Method definition
await def generate_presigned_url(
    self,
    ClientMethod: str,
    Params: Mapping[str, Any] = ...,
    ExpiresIn: int = 3600,
    HttpMethod: str = ...,
) -> str:
    ...

list_tags_for_resource

Lists all tags for a top-level EFS resource.

Type annotations and code completion for session.client("efs").list_tags_for_resource method. boto3 documentation

Method definition
await def list_tags_for_resource(
    self,
    *,
    ResourceId: str,
    MaxResults: int = ...,
    NextToken: str = ...,
) -> ListTagsForResourceResponseTypeDef:  # (1)
    ...
  1. See ListTagsForResourceResponseTypeDef
Usage example with kwargs
kwargs: ListTagsForResourceRequestRequestTypeDef = {  # (1)
    "ResourceId": ...,
}

parent.list_tags_for_resource(**kwargs)
  1. See ListTagsForResourceRequestRequestTypeDef

modify_mount_target_security_groups

Modifies the set of security groups in effect for a mount target.

Type annotations and code completion for session.client("efs").modify_mount_target_security_groups method. boto3 documentation

Method definition
await def modify_mount_target_security_groups(
    self,
    *,
    MountTargetId: str,
    SecurityGroups: Sequence[str] = ...,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
Usage example with kwargs
kwargs: ModifyMountTargetSecurityGroupsRequestRequestTypeDef = {  # (1)
    "MountTargetId": ...,
}

parent.modify_mount_target_security_groups(**kwargs)
  1. See ModifyMountTargetSecurityGroupsRequestRequestTypeDef

put_account_preferences

Use this operation to set the account preference in the current Amazon Web Services Region to use long 17 character (63 bit) or short 8 character (32 bit) resource IDs for new EFS file system and mount target resources.

Type annotations and code completion for session.client("efs").put_account_preferences method. boto3 documentation

Method definition
await def put_account_preferences(
    self,
    *,
    ResourceIdType: ResourceIdTypeType,  # (1)
) -> PutAccountPreferencesResponseTypeDef:  # (2)
    ...
  1. See ResourceIdTypeType
  2. See PutAccountPreferencesResponseTypeDef
Usage example with kwargs
kwargs: PutAccountPreferencesRequestRequestTypeDef = {  # (1)
    "ResourceIdType": ...,
}

parent.put_account_preferences(**kwargs)
  1. See PutAccountPreferencesRequestRequestTypeDef

put_backup_policy

Updates the file system's backup policy.

Type annotations and code completion for session.client("efs").put_backup_policy method. boto3 documentation

Method definition
await def put_backup_policy(
    self,
    *,
    FileSystemId: str,
    BackupPolicy: BackupPolicyTypeDef,  # (1)
) -> BackupPolicyDescriptionTypeDef:  # (2)
    ...
  1. See BackupPolicyTypeDef
  2. See BackupPolicyDescriptionTypeDef
Usage example with kwargs
kwargs: PutBackupPolicyRequestRequestTypeDef = {  # (1)
    "FileSystemId": ...,
    "BackupPolicy": ...,
}

parent.put_backup_policy(**kwargs)
  1. See PutBackupPolicyRequestRequestTypeDef

put_file_system_policy

Applies an Amazon EFS FileSystemPolicy to an Amazon EFS file system.

Type annotations and code completion for session.client("efs").put_file_system_policy method. boto3 documentation

Method definition
await def put_file_system_policy(
    self,
    *,
    FileSystemId: str,
    Policy: str,
    BypassPolicyLockoutSafetyCheck: bool = ...,
) -> FileSystemPolicyDescriptionTypeDef:  # (1)
    ...
  1. See FileSystemPolicyDescriptionTypeDef
Usage example with kwargs
kwargs: PutFileSystemPolicyRequestRequestTypeDef = {  # (1)
    "FileSystemId": ...,
    "Policy": ...,
}

parent.put_file_system_policy(**kwargs)
  1. See PutFileSystemPolicyRequestRequestTypeDef

put_lifecycle_configuration

Use this action to manage EFS lifecycle management and intelligent tiering.

Type annotations and code completion for session.client("efs").put_lifecycle_configuration method. boto3 documentation

Method definition
await def put_lifecycle_configuration(
    self,
    *,
    FileSystemId: str,
    LifecyclePolicies: Sequence[LifecyclePolicyTypeDef],  # (1)
) -> LifecycleConfigurationDescriptionTypeDef:  # (2)
    ...
  1. See LifecyclePolicyTypeDef
  2. See LifecycleConfigurationDescriptionTypeDef
Usage example with kwargs
kwargs: PutLifecycleConfigurationRequestRequestTypeDef = {  # (1)
    "FileSystemId": ...,
    "LifecyclePolicies": ...,
}

parent.put_lifecycle_configuration(**kwargs)
  1. See PutLifecycleConfigurationRequestRequestTypeDef

tag_resource

Creates a tag for an EFS resource.

Type annotations and code completion for session.client("efs").tag_resource method. boto3 documentation

Method definition
await def tag_resource(
    self,
    *,
    ResourceId: str,
    Tags: Sequence[TagTypeDef],  # (1)
) -> EmptyResponseMetadataTypeDef:  # (2)
    ...
  1. See TagTypeDef
  2. See EmptyResponseMetadataTypeDef
Usage example with kwargs
kwargs: TagResourceRequestRequestTypeDef = {  # (1)
    "ResourceId": ...,
    "Tags": ...,
}

parent.tag_resource(**kwargs)
  1. See TagResourceRequestRequestTypeDef

untag_resource

Removes tags from an EFS resource.

Type annotations and code completion for session.client("efs").untag_resource method. boto3 documentation

Method definition
await def untag_resource(
    self,
    *,
    ResourceId: str,
    TagKeys: Sequence[str],
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
Usage example with kwargs
kwargs: UntagResourceRequestRequestTypeDef = {  # (1)
    "ResourceId": ...,
    "TagKeys": ...,
}

parent.untag_resource(**kwargs)
  1. See UntagResourceRequestRequestTypeDef

update_file_system

Updates the throughput mode or the amount of provisioned throughput of an existing file system.

Type annotations and code completion for session.client("efs").update_file_system method. boto3 documentation

Method definition
await def update_file_system(
    self,
    *,
    FileSystemId: str,
    ThroughputMode: ThroughputModeType = ...,  # (1)
    ProvisionedThroughputInMibps: float = ...,
) -> FileSystemDescriptionResponseMetadataTypeDef:  # (2)
    ...
  1. See ThroughputModeType
  2. See FileSystemDescriptionResponseMetadataTypeDef
Usage example with kwargs
kwargs: UpdateFileSystemRequestRequestTypeDef = {  # (1)
    "FileSystemId": ...,
}

parent.update_file_system(**kwargs)
  1. See UpdateFileSystemRequestRequestTypeDef

__aenter__

Type annotations and code completion for session.client("efs").__aenter__ method. boto3 documentation

Method definition
await def __aenter__(
    self,
) -> EFSClient:
    ...

__aexit__

Type annotations and code completion for session.client("efs").__aexit__ method. boto3 documentation

Method definition
await def __aexit__(
    self,
    exc_type: Any,
    exc_val: Any,
    exc_tb: Any,
) -> Any:
    ...

get_paginator

Type annotations and code completion for session.client("efs").get_paginator method with overloads.