DataSync / Client / create_location_fsx_lustre

create_location_fsx_lustre#

DataSync.Client.create_location_fsx_lustre(**kwargs)#

Creates a transfer location for an Amazon FSx for Lustre file system. DataSync can use this location as a source or destination for transferring data.

Before you begin, make sure that you understand how DataSync accesses FSx for Lustre file systems.

See also: AWS API Documentation

Request Syntax

response = client.create_location_fsx_lustre(
    FsxFilesystemArn='string',
    SecurityGroupArns=[
        'string',
    ],
    Subdirectory='string',
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)
Parameters:

  • FsxFilesystemArn (string) –

    [REQUIRED]

    Specifies the Amazon Resource Name (ARN) of the FSx for Lustre file system.

  • SecurityGroupArns (list) –

    [REQUIRED]

    Specifies the Amazon Resource Names (ARNs) of up to five security groups that provide access to your FSx for Lustre file system.

    The security groups must be able to access the file system’s ports. The file system must also allow access from the security groups. For information about file system access, see the Amazon FSx for Lustre User Guide.

    • (string) –

  • Subdirectory (string) –

    Specifies a mount path for your FSx for Lustre file system. The path can include subdirectories.

    When the location is used as a source, DataSync reads data from the mount path. When the location is used as a destination, DataSync writes data to the mount path. If you don’t include this parameter, DataSync uses the file system’s root directory ( /).

  • Tags (list) –

    Specifies labels that help you categorize, filter, and search for your Amazon Web Services resources. We recommend creating at least a name tag for your location.

    • (dict) –

      A key-value pair representing a single tag that’s been applied to an Amazon Web Services resource.

      • Key (string) – [REQUIRED]

        The key for an Amazon Web Services resource tag.

      • Value (string) –

        The value for an Amazon Web Services resource tag.

Return type:

dict

Returns:

Response Syntax

{
    'LocationArn': 'string'
}

Response Structure

  • (dict) –

    • LocationArn (string) –

      The Amazon Resource Name (ARN) of the FSx for Lustre file system location that you created.

Exceptions

  • DataSync.Client.exceptions.InvalidRequestException

  • DataSync.Client.exceptions.InternalException