FileCacheDataRepositoryAssociation - Amazon FSx
ContentsSee Also
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

FileCacheDataRepositoryAssociation

The configuration for a data repository association (DRA) to be created during the Amazon File Cache resource creation. The DRA links the cache to either an Amazon S3 bucket or prefix, or a Network File System (NFS) data repository that supports the NFSv3 protocol.

The DRA does not support automatic import or automatic export.

Contents

DataRepositoryPath

The path to the S3 or NFS data repository that links to the cache. You must provide one of the following paths:

  • The path can be an NFS data repository that links to the cache. The path can be in one of two formats:

    • If you are not using the DataRepositorySubdirectories parameter, the path is to an NFS Export directory (or one of its subdirectories) in the format nsf://nfs-domain-name/exportpath. You can therefore link a single NFS Export to a single data repository association.

    • If you are using the DataRepositorySubdirectories parameter, the path is the domain name of the NFS file system in the format nfs://filer-domain-name, which indicates the root of the subdirectories specified with the DataRepositorySubdirectories parameter.

  • The path can be an S3 bucket or prefix in the format s3://myBucket/myPrefix/.

Type: String

Length Constraints: Minimum length of 3. Maximum length of 4357.

Pattern: ^[^\u0000\u0085\u2028\u2029\r\n]{3,4357}$

Required: Yes

FileCachePath

A path on the cache that points to a high-level directory (such as /ns1/) or subdirectory (such as /ns1/subdir/) that will be mapped 1-1 with DataRepositoryPath. The leading forward slash in the name is required. Two data repository associations cannot have overlapping cache paths. For example, if a data repository is associated with cache path /ns1/, then you cannot link another data repository with cache path /ns1/ns2.

This path specifies where in your cache files will be exported from. This cache directory can be linked to only one data repository, and no data repository other can be linked to the directory.

Note

The cache path can only be set to root (/) on an NFS DRA when DataRepositorySubdirectories is specified. If you specify root (/) as the cache path, you can create only one DRA on the cache.

The cache path cannot be set to root (/) for an S3 DRA.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 4096.

Pattern: ^[^\u0000\u0085\u2028\u2029\r\n]{1,4096}$

Required: Yes

DataRepositorySubdirectories

A list of NFS Exports that will be linked with this data repository association. The Export paths are in the format /exportpath1. To use this parameter, you must configure DataRepositoryPath as the domain name of the NFS file system. The NFS file system domain name in effect is the root of the subdirectories. Note that DataRepositorySubdirectories is not supported for S3 data repositories.

Type: Array of strings

Array Members: Maximum number of 500 items.

Length Constraints: Minimum length of 1. Maximum length of 4096.

Pattern: ^[^\u0000\u0085\u2028\u2029\r\n]{1,4096}$

Required: No

NFS

The configuration for a data repository association that links an Amazon File Cache resource to an NFS data repository.

Type: FileCacheNFSConfiguration object

Required: No

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: