/* * Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ package com.amazonaws.services.fsx.model; import java.io.Serializable; import javax.annotation.Generated; import com.amazonaws.protocol.StructuredPojo; import com.amazonaws.protocol.ProtocolMarshaller; /** *
* The data repository configuration object for Lustre file systems returned in the response of the
* CreateFileSystem
operation.
*
* This data type is not supported on file systems with a data repository association. For file systems with a data * repository association, see . *
* * @see AWS * API Documentation */ @Generated("com.amazonaws:aws-java-sdk-code-generator") public class DataRepositoryConfiguration implements Serializable, Cloneable, StructuredPojo { /** ** Describes the state of the file system's S3 durable data repository, if it is configured with an S3 repository. * The lifecycle can have the following values: *
*
* CREATING
- The data repository configuration between the FSx file system and the linked S3 data
* repository is being created. The data repository is unavailable.
*
* AVAILABLE
- The data repository is available for use.
*
* MISCONFIGURED
- Amazon FSx cannot automatically import updates from the S3 bucket until the data
* repository configuration is corrected. For more information, see Troubleshooting a Misconfigured linked S3 bucket.
*
* UPDATING
- The data repository is undergoing a customer initiated update and availability may be
* impacted.
*
* FAILED
- The data repository is in a terminal state that cannot be recovered.
*
* The import path to the Amazon S3 bucket (and optional prefix) that you're using as the data repository for your
* FSx for Lustre file system, for example s3://import-bucket/optional-prefix
. If a prefix is specified
* after the Amazon S3 bucket name, only object keys with that prefix are loaded into the file system.
*
* The export path to the Amazon S3 bucket (and prefix) that you are using to store new and changed Lustre file * system files in S3. *
*/ private String exportPath; /** ** For files imported from a data repository, this value determines the stripe count and maximum amount of data per * file (in MiB) stored on a single physical disk. The maximum number of disks that a single file can be striped * across is limited by the total number of disks that make up the file system. *
** The default chunk size is 1,024 MiB (1 GiB) and can go as high as 512,000 MiB (500 GiB). Amazon S3 objects have a * maximum size of 5 TB. *
*/ private Integer importedFileChunkSize; /** *
* Describes the file system's linked S3 data repository's AutoImportPolicy
. The AutoImportPolicy
* configures how Amazon FSx keeps your file and directory listings up to date as you add or modify objects in your
* linked S3 bucket. AutoImportPolicy
can have the following values:
*
* NONE
- (Default) AutoImport is off. Amazon FSx only updates file and directory listings from the
* linked S3 bucket when the file system is created. FSx does not update file and directory listings for any new or
* changed objects after choosing this option.
*
* NEW
- AutoImport is on. Amazon FSx automatically imports directory listings of any new objects added
* to the linked S3 bucket that do not currently exist in the FSx file system.
*
* NEW_CHANGED
- AutoImport is on. Amazon FSx automatically imports file and directory listings of any
* new objects added to the S3 bucket and any existing objects that are changed in the S3 bucket after you choose
* this option.
*
* NEW_CHANGED_DELETED
- AutoImport is on. Amazon FSx automatically imports file and directory listings
* of any new objects added to the S3 bucket, any existing objects that are changed in the S3 bucket, and any
* objects that were deleted in the S3 bucket.
*
* Describes the state of the file system's S3 durable data repository, if it is configured with an S3 repository. * The lifecycle can have the following values: *
*
* CREATING
- The data repository configuration between the FSx file system and the linked S3 data
* repository is being created. The data repository is unavailable.
*
* AVAILABLE
- The data repository is available for use.
*
* MISCONFIGURED
- Amazon FSx cannot automatically import updates from the S3 bucket until the data
* repository configuration is corrected. For more information, see Troubleshooting a Misconfigured linked S3 bucket.
*
* UPDATING
- The data repository is undergoing a customer initiated update and availability may be
* impacted.
*
* FAILED
- The data repository is in a terminal state that cannot be recovered.
*
* CREATING
- The data repository configuration between the FSx file system and the linked S3
* data repository is being created. The data repository is unavailable.
*
* AVAILABLE
- The data repository is available for use.
*
* MISCONFIGURED
- Amazon FSx cannot automatically import updates from the S3 bucket until the
* data repository configuration is corrected. For more information, see Troubleshooting a Misconfigured linked S3 bucket.
*
* UPDATING
- The data repository is undergoing a customer initiated update and availability may
* be impacted.
*
* FAILED
- The data repository is in a terminal state that cannot be recovered.
*
* Describes the state of the file system's S3 durable data repository, if it is configured with an S3 repository. * The lifecycle can have the following values: *
*
* CREATING
- The data repository configuration between the FSx file system and the linked S3 data
* repository is being created. The data repository is unavailable.
*
* AVAILABLE
- The data repository is available for use.
*
* MISCONFIGURED
- Amazon FSx cannot automatically import updates from the S3 bucket until the data
* repository configuration is corrected. For more information, see Troubleshooting a Misconfigured linked S3 bucket.
*
* UPDATING
- The data repository is undergoing a customer initiated update and availability may be
* impacted.
*
* FAILED
- The data repository is in a terminal state that cannot be recovered.
*
* CREATING
- The data repository configuration between the FSx file system and the linked S3
* data repository is being created. The data repository is unavailable.
*
* AVAILABLE
- The data repository is available for use.
*
* MISCONFIGURED
- Amazon FSx cannot automatically import updates from the S3 bucket until the
* data repository configuration is corrected. For more information, see Troubleshooting a Misconfigured linked S3 bucket.
*
* UPDATING
- The data repository is undergoing a customer initiated update and availability
* may be impacted.
*
* FAILED
- The data repository is in a terminal state that cannot be recovered.
*
* Describes the state of the file system's S3 durable data repository, if it is configured with an S3 repository. * The lifecycle can have the following values: *
*
* CREATING
- The data repository configuration between the FSx file system and the linked S3 data
* repository is being created. The data repository is unavailable.
*
* AVAILABLE
- The data repository is available for use.
*
* MISCONFIGURED
- Amazon FSx cannot automatically import updates from the S3 bucket until the data
* repository configuration is corrected. For more information, see Troubleshooting a Misconfigured linked S3 bucket.
*
* UPDATING
- The data repository is undergoing a customer initiated update and availability may be
* impacted.
*
* FAILED
- The data repository is in a terminal state that cannot be recovered.
*
* CREATING
- The data repository configuration between the FSx file system and the linked S3
* data repository is being created. The data repository is unavailable.
*
* AVAILABLE
- The data repository is available for use.
*
* MISCONFIGURED
- Amazon FSx cannot automatically import updates from the S3 bucket until the
* data repository configuration is corrected. For more information, see Troubleshooting a Misconfigured linked S3 bucket.
*
* UPDATING
- The data repository is undergoing a customer initiated update and availability may
* be impacted.
*
* FAILED
- The data repository is in a terminal state that cannot be recovered.
*
* Describes the state of the file system's S3 durable data repository, if it is configured with an S3 repository. * The lifecycle can have the following values: *
*
* CREATING
- The data repository configuration between the FSx file system and the linked S3 data
* repository is being created. The data repository is unavailable.
*
* AVAILABLE
- The data repository is available for use.
*
* MISCONFIGURED
- Amazon FSx cannot automatically import updates from the S3 bucket until the data
* repository configuration is corrected. For more information, see Troubleshooting a Misconfigured linked S3 bucket.
*
* UPDATING
- The data repository is undergoing a customer initiated update and availability may be
* impacted.
*
* FAILED
- The data repository is in a terminal state that cannot be recovered.
*
* CREATING
- The data repository configuration between the FSx file system and the linked S3
* data repository is being created. The data repository is unavailable.
*
* AVAILABLE
- The data repository is available for use.
*
* MISCONFIGURED
- Amazon FSx cannot automatically import updates from the S3 bucket until the
* data repository configuration is corrected. For more information, see Troubleshooting a Misconfigured linked S3 bucket.
*
* UPDATING
- The data repository is undergoing a customer initiated update and availability may
* be impacted.
*
* FAILED
- The data repository is in a terminal state that cannot be recovered.
*
* The import path to the Amazon S3 bucket (and optional prefix) that you're using as the data repository for your
* FSx for Lustre file system, for example s3://import-bucket/optional-prefix
. If a prefix is specified
* after the Amazon S3 bucket name, only object keys with that prefix are loaded into the file system.
*
s3://import-bucket/optional-prefix
. If a prefix
* is specified after the Amazon S3 bucket name, only object keys with that prefix are loaded into the file
* system.
*/
public void setImportPath(String importPath) {
this.importPath = importPath;
}
/**
*
* The import path to the Amazon S3 bucket (and optional prefix) that you're using as the data repository for your
* FSx for Lustre file system, for example s3://import-bucket/optional-prefix
. If a prefix is specified
* after the Amazon S3 bucket name, only object keys with that prefix are loaded into the file system.
*
s3://import-bucket/optional-prefix
. If a
* prefix is specified after the Amazon S3 bucket name, only object keys with that prefix are loaded into
* the file system.
*/
public String getImportPath() {
return this.importPath;
}
/**
*
* The import path to the Amazon S3 bucket (and optional prefix) that you're using as the data repository for your
* FSx for Lustre file system, for example s3://import-bucket/optional-prefix
. If a prefix is specified
* after the Amazon S3 bucket name, only object keys with that prefix are loaded into the file system.
*
s3://import-bucket/optional-prefix
. If a prefix
* is specified after the Amazon S3 bucket name, only object keys with that prefix are loaded into the file
* system.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public DataRepositoryConfiguration withImportPath(String importPath) {
setImportPath(importPath);
return this;
}
/**
* * The export path to the Amazon S3 bucket (and prefix) that you are using to store new and changed Lustre file * system files in S3. *
* * @param exportPath * The export path to the Amazon S3 bucket (and prefix) that you are using to store new and changed Lustre * file system files in S3. */ public void setExportPath(String exportPath) { this.exportPath = exportPath; } /** ** The export path to the Amazon S3 bucket (and prefix) that you are using to store new and changed Lustre file * system files in S3. *
* * @return The export path to the Amazon S3 bucket (and prefix) that you are using to store new and changed Lustre * file system files in S3. */ public String getExportPath() { return this.exportPath; } /** ** The export path to the Amazon S3 bucket (and prefix) that you are using to store new and changed Lustre file * system files in S3. *
* * @param exportPath * The export path to the Amazon S3 bucket (and prefix) that you are using to store new and changed Lustre * file system files in S3. * @return Returns a reference to this object so that method calls can be chained together. */ public DataRepositoryConfiguration withExportPath(String exportPath) { setExportPath(exportPath); return this; } /** ** For files imported from a data repository, this value determines the stripe count and maximum amount of data per * file (in MiB) stored on a single physical disk. The maximum number of disks that a single file can be striped * across is limited by the total number of disks that make up the file system. *
** The default chunk size is 1,024 MiB (1 GiB) and can go as high as 512,000 MiB (500 GiB). Amazon S3 objects have a * maximum size of 5 TB. *
* * @param importedFileChunkSize * For files imported from a data repository, this value determines the stripe count and maximum amount of * data per file (in MiB) stored on a single physical disk. The maximum number of disks that a single file * can be striped across is limited by the total number of disks that make up the file system. ** The default chunk size is 1,024 MiB (1 GiB) and can go as high as 512,000 MiB (500 GiB). Amazon S3 objects * have a maximum size of 5 TB. */ public void setImportedFileChunkSize(Integer importedFileChunkSize) { this.importedFileChunkSize = importedFileChunkSize; } /** *
* For files imported from a data repository, this value determines the stripe count and maximum amount of data per * file (in MiB) stored on a single physical disk. The maximum number of disks that a single file can be striped * across is limited by the total number of disks that make up the file system. *
** The default chunk size is 1,024 MiB (1 GiB) and can go as high as 512,000 MiB (500 GiB). Amazon S3 objects have a * maximum size of 5 TB. *
* * @return For files imported from a data repository, this value determines the stripe count and maximum amount of * data per file (in MiB) stored on a single physical disk. The maximum number of disks that a single file * can be striped across is limited by the total number of disks that make up the file system. ** The default chunk size is 1,024 MiB (1 GiB) and can go as high as 512,000 MiB (500 GiB). Amazon S3 * objects have a maximum size of 5 TB. */ public Integer getImportedFileChunkSize() { return this.importedFileChunkSize; } /** *
* For files imported from a data repository, this value determines the stripe count and maximum amount of data per * file (in MiB) stored on a single physical disk. The maximum number of disks that a single file can be striped * across is limited by the total number of disks that make up the file system. *
** The default chunk size is 1,024 MiB (1 GiB) and can go as high as 512,000 MiB (500 GiB). Amazon S3 objects have a * maximum size of 5 TB. *
* * @param importedFileChunkSize * For files imported from a data repository, this value determines the stripe count and maximum amount of * data per file (in MiB) stored on a single physical disk. The maximum number of disks that a single file * can be striped across is limited by the total number of disks that make up the file system. ** The default chunk size is 1,024 MiB (1 GiB) and can go as high as 512,000 MiB (500 GiB). Amazon S3 objects * have a maximum size of 5 TB. * @return Returns a reference to this object so that method calls can be chained together. */ public DataRepositoryConfiguration withImportedFileChunkSize(Integer importedFileChunkSize) { setImportedFileChunkSize(importedFileChunkSize); return this; } /** *
* Describes the file system's linked S3 data repository's AutoImportPolicy
. The AutoImportPolicy
* configures how Amazon FSx keeps your file and directory listings up to date as you add or modify objects in your
* linked S3 bucket. AutoImportPolicy
can have the following values:
*
* NONE
- (Default) AutoImport is off. Amazon FSx only updates file and directory listings from the
* linked S3 bucket when the file system is created. FSx does not update file and directory listings for any new or
* changed objects after choosing this option.
*
* NEW
- AutoImport is on. Amazon FSx automatically imports directory listings of any new objects added
* to the linked S3 bucket that do not currently exist in the FSx file system.
*
* NEW_CHANGED
- AutoImport is on. Amazon FSx automatically imports file and directory listings of any
* new objects added to the S3 bucket and any existing objects that are changed in the S3 bucket after you choose
* this option.
*
* NEW_CHANGED_DELETED
- AutoImport is on. Amazon FSx automatically imports file and directory listings
* of any new objects added to the S3 bucket, any existing objects that are changed in the S3 bucket, and any
* objects that were deleted in the S3 bucket.
*
AutoImportPolicy
. The
* AutoImportPolicy configures how Amazon FSx keeps your file and directory listings up to date as you add or
* modify objects in your linked S3 bucket. AutoImportPolicy
can have the following values:
*
* NONE
- (Default) AutoImport is off. Amazon FSx only updates file and directory listings from
* the linked S3 bucket when the file system is created. FSx does not update file and directory listings for
* any new or changed objects after choosing this option.
*
* NEW
- AutoImport is on. Amazon FSx automatically imports directory listings of any new
* objects added to the linked S3 bucket that do not currently exist in the FSx file system.
*
* NEW_CHANGED
- AutoImport is on. Amazon FSx automatically imports file and directory listings
* of any new objects added to the S3 bucket and any existing objects that are changed in the S3 bucket after
* you choose this option.
*
* NEW_CHANGED_DELETED
- AutoImport is on. Amazon FSx automatically imports file and directory
* listings of any new objects added to the S3 bucket, any existing objects that are changed in the S3
* bucket, and any objects that were deleted in the S3 bucket.
*
* Describes the file system's linked S3 data repository's AutoImportPolicy
. The AutoImportPolicy
* configures how Amazon FSx keeps your file and directory listings up to date as you add or modify objects in your
* linked S3 bucket. AutoImportPolicy
can have the following values:
*
* NONE
- (Default) AutoImport is off. Amazon FSx only updates file and directory listings from the
* linked S3 bucket when the file system is created. FSx does not update file and directory listings for any new or
* changed objects after choosing this option.
*
* NEW
- AutoImport is on. Amazon FSx automatically imports directory listings of any new objects added
* to the linked S3 bucket that do not currently exist in the FSx file system.
*
* NEW_CHANGED
- AutoImport is on. Amazon FSx automatically imports file and directory listings of any
* new objects added to the S3 bucket and any existing objects that are changed in the S3 bucket after you choose
* this option.
*
* NEW_CHANGED_DELETED
- AutoImport is on. Amazon FSx automatically imports file and directory listings
* of any new objects added to the S3 bucket, any existing objects that are changed in the S3 bucket, and any
* objects that were deleted in the S3 bucket.
*
AutoImportPolicy
. The
* AutoImportPolicy configures how Amazon FSx keeps your file and directory listings up to date as you add
* or modify objects in your linked S3 bucket. AutoImportPolicy
can have the following
* values:
*
* NONE
- (Default) AutoImport is off. Amazon FSx only updates file and directory listings from
* the linked S3 bucket when the file system is created. FSx does not update file and directory listings for
* any new or changed objects after choosing this option.
*
* NEW
- AutoImport is on. Amazon FSx automatically imports directory listings of any new
* objects added to the linked S3 bucket that do not currently exist in the FSx file system.
*
* NEW_CHANGED
- AutoImport is on. Amazon FSx automatically imports file and directory listings
* of any new objects added to the S3 bucket and any existing objects that are changed in the S3 bucket
* after you choose this option.
*
* NEW_CHANGED_DELETED
- AutoImport is on. Amazon FSx automatically imports file and directory
* listings of any new objects added to the S3 bucket, any existing objects that are changed in the S3
* bucket, and any objects that were deleted in the S3 bucket.
*
* Describes the file system's linked S3 data repository's AutoImportPolicy
. The AutoImportPolicy
* configures how Amazon FSx keeps your file and directory listings up to date as you add or modify objects in your
* linked S3 bucket. AutoImportPolicy
can have the following values:
*
* NONE
- (Default) AutoImport is off. Amazon FSx only updates file and directory listings from the
* linked S3 bucket when the file system is created. FSx does not update file and directory listings for any new or
* changed objects after choosing this option.
*
* NEW
- AutoImport is on. Amazon FSx automatically imports directory listings of any new objects added
* to the linked S3 bucket that do not currently exist in the FSx file system.
*
* NEW_CHANGED
- AutoImport is on. Amazon FSx automatically imports file and directory listings of any
* new objects added to the S3 bucket and any existing objects that are changed in the S3 bucket after you choose
* this option.
*
* NEW_CHANGED_DELETED
- AutoImport is on. Amazon FSx automatically imports file and directory listings
* of any new objects added to the S3 bucket, any existing objects that are changed in the S3 bucket, and any
* objects that were deleted in the S3 bucket.
*
AutoImportPolicy
. The
* AutoImportPolicy configures how Amazon FSx keeps your file and directory listings up to date as you add or
* modify objects in your linked S3 bucket. AutoImportPolicy
can have the following values:
*
* NONE
- (Default) AutoImport is off. Amazon FSx only updates file and directory listings from
* the linked S3 bucket when the file system is created. FSx does not update file and directory listings for
* any new or changed objects after choosing this option.
*
* NEW
- AutoImport is on. Amazon FSx automatically imports directory listings of any new
* objects added to the linked S3 bucket that do not currently exist in the FSx file system.
*
* NEW_CHANGED
- AutoImport is on. Amazon FSx automatically imports file and directory listings
* of any new objects added to the S3 bucket and any existing objects that are changed in the S3 bucket after
* you choose this option.
*
* NEW_CHANGED_DELETED
- AutoImport is on. Amazon FSx automatically imports file and directory
* listings of any new objects added to the S3 bucket, any existing objects that are changed in the S3
* bucket, and any objects that were deleted in the S3 bucket.
*
* Describes the file system's linked S3 data repository's AutoImportPolicy
. The AutoImportPolicy
* configures how Amazon FSx keeps your file and directory listings up to date as you add or modify objects in your
* linked S3 bucket. AutoImportPolicy
can have the following values:
*
* NONE
- (Default) AutoImport is off. Amazon FSx only updates file and directory listings from the
* linked S3 bucket when the file system is created. FSx does not update file and directory listings for any new or
* changed objects after choosing this option.
*
* NEW
- AutoImport is on. Amazon FSx automatically imports directory listings of any new objects added
* to the linked S3 bucket that do not currently exist in the FSx file system.
*
* NEW_CHANGED
- AutoImport is on. Amazon FSx automatically imports file and directory listings of any
* new objects added to the S3 bucket and any existing objects that are changed in the S3 bucket after you choose
* this option.
*
* NEW_CHANGED_DELETED
- AutoImport is on. Amazon FSx automatically imports file and directory listings
* of any new objects added to the S3 bucket, any existing objects that are changed in the S3 bucket, and any
* objects that were deleted in the S3 bucket.
*
AutoImportPolicy
. The
* AutoImportPolicy configures how Amazon FSx keeps your file and directory listings up to date as you add or
* modify objects in your linked S3 bucket. AutoImportPolicy
can have the following values:
*
* NONE
- (Default) AutoImport is off. Amazon FSx only updates file and directory listings from
* the linked S3 bucket when the file system is created. FSx does not update file and directory listings for
* any new or changed objects after choosing this option.
*
* NEW
- AutoImport is on. Amazon FSx automatically imports directory listings of any new
* objects added to the linked S3 bucket that do not currently exist in the FSx file system.
*
* NEW_CHANGED
- AutoImport is on. Amazon FSx automatically imports file and directory listings
* of any new objects added to the S3 bucket and any existing objects that are changed in the S3 bucket after
* you choose this option.
*
* NEW_CHANGED_DELETED
- AutoImport is on. Amazon FSx automatically imports file and directory
* listings of any new objects added to the S3 bucket, any existing objects that are changed in the S3
* bucket, and any objects that were deleted in the S3 bucket.
*