Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

describe_location_efs

describe_location_efs(**kwargs)

Returns metadata about your DataSync location for an Amazon EFS file system.

See also: AWS API Documentation

Request Syntax

response = client.describe_location_efs(
    LocationArn='string'
)
Parameters
LocationArn (string) --

[REQUIRED]

The Amazon Resource Name (ARN) of the Amazon EFS file system location that you want information about.

Return type
dict
Returns
Response Syntax
{
    'LocationArn': 'string',
    'LocationUri': 'string',
    'Ec2Config': {
        'SubnetArn': 'string',
        'SecurityGroupArns': [
            'string',
        ]
    },
    'CreationTime': datetime(2015, 1, 1),
    'AccessPointArn': 'string',
    'FileSystemAccessRoleArn': 'string',
    'InTransitEncryption': 'NONE'|'TLS1_2'
}

Response Structure

  • (dict) --

    DescribeLocationEfsResponse

    • LocationArn (string) --

      The ARN of the Amazon EFS file system location.

    • LocationUri (string) --

      The URL of the Amazon EFS file system location.

    • Ec2Config (dict) --

      The subnet and security groups that DataSync uses to access your Amazon EFS file system.

      • SubnetArn (string) --

        Specifies the ARN of a subnet where DataSync creates the network interfaces for managing traffic during your transfer.

        The subnet must be located:

        • In the same virtual private cloud (VPC) as the Amazon EFS file system.
        • In the same Availability Zone as at least one mount target for the Amazon EFS file system.

        Note

        You don't need to specify a subnet that includes a file system mount target.

      • SecurityGroupArns (list) --

        Specifies the Amazon Resource Names (ARNs) of the security groups associated with an Amazon EFS file system's mount target.

        • (string) --
    • CreationTime (datetime) --

      The time that the location was created.

    • AccessPointArn (string) --

      The ARN of the access point that DataSync uses to access the Amazon EFS file system.

    • FileSystemAccessRoleArn (string) --

      The Identity and Access Management (IAM) role that DataSync assumes when mounting the Amazon EFS file system.

    • InTransitEncryption (string) --

      Describes whether DataSync uses Transport Layer Security (TLS) encryption when copying data to or from the Amazon EFS file system.

Exceptions

  • DataSync.Client.exceptions.InvalidRequestException
  • DataSync.Client.exceptions.InternalException