AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Creates an Amazon FSx for Lustre data repository association (DRA). A data repository association is a link between a directory on the file system and an Amazon S3 bucket or prefix. You can have a maximum of 8 data repository associations on a file system. Data repository associations are supported on all FSx for Lustre 2.12 and 2.15 file systems, excluding scratch_1 deployment type.

Each data repository association must have a unique Amazon FSx file system directory and a unique S3 bucket or prefix associated with it. You can configure a data repository association for automatic import only, for automatic export only, or for both. To learn more about linking a data repository to your file system, see Linking your file system to an S3 bucket.

CreateDataRepositoryAssociation isn't supported on Amazon File Cache resources. To create a DRA on Amazon File Cache, use the CreateFileCache operation.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginCreateDataRepositoryAssociation and EndCreateDataRepositoryAssociation.

Namespace: Amazon.FSx
Assembly: AWSSDK.FSx.dll
Version: 3.x.y.z

Syntax

C#
public abstract Task<CreateDataRepositoryAssociationResponse> CreateDataRepositoryAssociationAsync(
         CreateDataRepositoryAssociationRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.FSx.Model.CreateDataRepositoryAssociationRequest

Container for the necessary parameters to execute the CreateDataRepositoryAssociation service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the CreateDataRepositoryAssociation service method, as returned by FSx.

Exceptions

ExceptionCondition
BadRequestException A generic error indicating a failure with a client request.
FileSystemNotFoundException No Amazon FSx file systems were found based upon supplied parameters.
IncompatibleParameterErrorException The error returned when a second request is received with the same client request token but different parameters settings. A client request token should always uniquely identify a single request.
InternalServerErrorException A generic error indicating a server-side failure.
ServiceLimitExceededException An error indicating that a particular service limit was exceeded. You can increase some service limits by contacting Amazon Web Services Support.
UnsupportedOperationException The requested operation is not supported for this resource or API.

Version Information

.NET:
Supported in: 8.0 and newer, Core 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5 and newer

See Also