Package software.amazon.awssdk.services.fsx.model

Interface DataRepositoryTask.Builder

    • Method Detail

      • taskId

        DataRepositoryTask.Builder taskId​(String taskId)

        The system-generated, unique 17-digit ID of the data repository task.

        Parameters:
        taskId - The system-generated, unique 17-digit ID of the data repository task.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • lifecycle

        DataRepositoryTask.Builder lifecycle​(String lifecycle)

        The lifecycle status of the data repository task, as follows:

        • PENDING - The task has not started.

        • EXECUTING - The task is in process.

        • FAILED - The task was not able to be completed. For example, there may be files the task failed to process. The DataRepositoryTaskFailureDetails property provides more information about task failures.

        • SUCCEEDED - The task has completed successfully.

        • CANCELED - The task was canceled and it did not complete.

        • CANCELING - The task is in process of being canceled.

        You cannot delete an FSx for Lustre file system if there are data repository tasks for the file system in the PENDING or EXECUTING states. Please retry when the data repository task is finished (with a status of CANCELED, SUCCEEDED, or FAILED). You can use the DescribeDataRepositoryTask action to monitor the task status. Contact the FSx team if you need to delete your file system immediately.

        Parameters:
        lifecycle - The lifecycle status of the data repository task, as follows:

        • PENDING - The task has not started.

        • EXECUTING - The task is in process.

        • FAILED - The task was not able to be completed. For example, there may be files the task failed to process. The DataRepositoryTaskFailureDetails property provides more information about task failures.

        • SUCCEEDED - The task has completed successfully.

        • CANCELED - The task was canceled and it did not complete.

        • CANCELING - The task is in process of being canceled.

        You cannot delete an FSx for Lustre file system if there are data repository tasks for the file system in the PENDING or EXECUTING states. Please retry when the data repository task is finished (with a status of CANCELED, SUCCEEDED, or FAILED). You can use the DescribeDataRepositoryTask action to monitor the task status. Contact the FSx team if you need to delete your file system immediately.

        Returns:
        Returns a reference to this object so that method calls can be chained together.
        See Also:
        DataRepositoryTaskLifecycle, DataRepositoryTaskLifecycle

      • lifecycle

        DataRepositoryTask.Builder lifecycle​(DataRepositoryTaskLifecycle lifecycle)

        The lifecycle status of the data repository task, as follows:

        • PENDING - The task has not started.

        • EXECUTING - The task is in process.

        • FAILED - The task was not able to be completed. For example, there may be files the task failed to process. The DataRepositoryTaskFailureDetails property provides more information about task failures.

        • SUCCEEDED - The task has completed successfully.

        • CANCELED - The task was canceled and it did not complete.

        • CANCELING - The task is in process of being canceled.

        You cannot delete an FSx for Lustre file system if there are data repository tasks for the file system in the PENDING or EXECUTING states. Please retry when the data repository task is finished (with a status of CANCELED, SUCCEEDED, or FAILED). You can use the DescribeDataRepositoryTask action to monitor the task status. Contact the FSx team if you need to delete your file system immediately.

        Parameters:
        lifecycle - The lifecycle status of the data repository task, as follows:

        • PENDING - The task has not started.

        • EXECUTING - The task is in process.

        • FAILED - The task was not able to be completed. For example, there may be files the task failed to process. The DataRepositoryTaskFailureDetails property provides more information about task failures.

        • SUCCEEDED - The task has completed successfully.

        • CANCELED - The task was canceled and it did not complete.

        • CANCELING - The task is in process of being canceled.

        You cannot delete an FSx for Lustre file system if there are data repository tasks for the file system in the PENDING or EXECUTING states. Please retry when the data repository task is finished (with a status of CANCELED, SUCCEEDED, or FAILED). You can use the DescribeDataRepositoryTask action to monitor the task status. Contact the FSx team if you need to delete your file system immediately.

        Returns:
        Returns a reference to this object so that method calls can be chained together.
        See Also:
        DataRepositoryTaskLifecycle, DataRepositoryTaskLifecycle

      • type

        DataRepositoryTask.Builder type​(String type)

        The type of data repository task.

        • EXPORT_TO_REPOSITORY tasks export from your Amazon FSx for Lustre file system to a linked data repository.

        • IMPORT_METADATA_FROM_REPOSITORY tasks import metadata changes from a linked S3 bucket to your Amazon FSx for Lustre file system.

        • RELEASE_DATA_FROM_FILESYSTEM tasks release files in your Amazon FSx for Lustre file system that have been exported to a linked S3 bucket and that meet your specified release criteria.

        • AUTO_RELEASE_DATA tasks automatically release files from an Amazon File Cache resource.

        Parameters:
        type - The type of data repository task.

        • EXPORT_TO_REPOSITORY tasks export from your Amazon FSx for Lustre file system to a linked data repository.

        • IMPORT_METADATA_FROM_REPOSITORY tasks import metadata changes from a linked S3 bucket to your Amazon FSx for Lustre file system.

        • RELEASE_DATA_FROM_FILESYSTEM tasks release files in your Amazon FSx for Lustre file system that have been exported to a linked S3 bucket and that meet your specified release criteria.

        • AUTO_RELEASE_DATA tasks automatically release files from an Amazon File Cache resource.

        Returns:
        Returns a reference to this object so that method calls can be chained together.
        See Also:
        DataRepositoryTaskType, DataRepositoryTaskType

      • type

        DataRepositoryTask.Builder type​(DataRepositoryTaskType type)

        The type of data repository task.

        • EXPORT_TO_REPOSITORY tasks export from your Amazon FSx for Lustre file system to a linked data repository.

        • IMPORT_METADATA_FROM_REPOSITORY tasks import metadata changes from a linked S3 bucket to your Amazon FSx for Lustre file system.

        • RELEASE_DATA_FROM_FILESYSTEM tasks release files in your Amazon FSx for Lustre file system that have been exported to a linked S3 bucket and that meet your specified release criteria.

        • AUTO_RELEASE_DATA tasks automatically release files from an Amazon File Cache resource.

        Parameters:
        type - The type of data repository task.

        • EXPORT_TO_REPOSITORY tasks export from your Amazon FSx for Lustre file system to a linked data repository.

        • IMPORT_METADATA_FROM_REPOSITORY tasks import metadata changes from a linked S3 bucket to your Amazon FSx for Lustre file system.

        • RELEASE_DATA_FROM_FILESYSTEM tasks release files in your Amazon FSx for Lustre file system that have been exported to a linked S3 bucket and that meet your specified release criteria.

        • AUTO_RELEASE_DATA tasks automatically release files from an Amazon File Cache resource.

        Returns:
        Returns a reference to this object so that method calls can be chained together.
        See Also:
        DataRepositoryTaskType, DataRepositoryTaskType

      • creationTime

        DataRepositoryTask.Builder creationTime​(Instant creationTime)
        Sets the value of the CreationTime property for this object.
        Parameters:
        creationTime - The new value for the CreationTime property for this object.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • startTime

        DataRepositoryTask.Builder startTime​(Instant startTime)

        The time the system began processing the task.

        Parameters:
        startTime - The time the system began processing the task.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • endTime

        DataRepositoryTask.Builder endTime​(Instant endTime)

        The time the system completed processing the task, populated after the task is complete.

        Parameters:
        endTime - The time the system completed processing the task, populated after the task is complete.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • resourceARN

        DataRepositoryTask.Builder resourceARN​(String resourceARN)
        Sets the value of the ResourceARN property for this object.
        Parameters:
        resourceARN - The new value for the ResourceARN property for this object.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • tags

        DataRepositoryTask.Builder tags​(Collection<Tag> tags)
        Sets the value of the Tags property for this object.
        Parameters:
        tags - The new value for the Tags property for this object.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • tags

        DataRepositoryTask.Builder tags​(Tag... tags)
        Sets the value of the Tags property for this object.
        Parameters:
        tags - The new value for the Tags property for this object.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • tags

        DataRepositoryTask.Builder tags​(Consumer<Tag.Builder>... tags)
        Sets the value of the Tags property for this object. This is a convenience method that creates an instance of the Tag.Builder avoiding the need to create one manually via Tag.builder().

        When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to #tags(List).

        Parameters:
        tags - a consumer that will call methods on Tag.Builder
        Returns:
        Returns a reference to this object so that method calls can be chained together.
        See Also:
        #tags(java.util.Collection)

      • fileSystemId

        DataRepositoryTask.Builder fileSystemId​(String fileSystemId)

        The globally unique ID of the file system.

        Parameters:
        fileSystemId - The globally unique ID of the file system.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • paths

        DataRepositoryTask.Builder paths​(Collection<String> paths)

        An array of paths that specify the data for the data repository task to process. For example, in an EXPORT_TO_REPOSITORY task, the paths specify which data to export to the linked data repository.

        (Default) If Paths is not specified, Amazon FSx uses the file system root directory.

        Parameters:
        paths - An array of paths that specify the data for the data repository task to process. For example, in an EXPORT_TO_REPOSITORY task, the paths specify which data to export to the linked data repository.

        (Default) If Paths is not specified, Amazon FSx uses the file system root directory.

        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • paths

        DataRepositoryTask.Builder paths​(String... paths)

        An array of paths that specify the data for the data repository task to process. For example, in an EXPORT_TO_REPOSITORY task, the paths specify which data to export to the linked data repository.

        (Default) If Paths is not specified, Amazon FSx uses the file system root directory.

        Parameters:
        paths - An array of paths that specify the data for the data repository task to process. For example, in an EXPORT_TO_REPOSITORY task, the paths specify which data to export to the linked data repository.

        (Default) If Paths is not specified, Amazon FSx uses the file system root directory.

        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • failureDetails

        DataRepositoryTask.Builder failureDetails​(DataRepositoryTaskFailureDetails failureDetails)

        Failure message describing why the task failed, it is populated only when Lifecycle is set to FAILED.

        Parameters:
        failureDetails - Failure message describing why the task failed, it is populated only when Lifecycle is set to FAILED.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • status

        DataRepositoryTask.Builder status​(DataRepositoryTaskStatus status)

        Provides the status of the number of files that the task has processed successfully and failed to process.

        Parameters:
        status - Provides the status of the number of files that the task has processed successfully and failed to process.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • report

        DataRepositoryTask.Builder report​(CompletionReport report)
        Sets the value of the Report property for this object.
        Parameters:
        report - The new value for the Report property for this object.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • capacityToRelease

        DataRepositoryTask.Builder capacityToRelease​(Long capacityToRelease)

        Specifies the amount of data to release, in GiB, by an Amazon File Cache AUTO_RELEASE_DATA task that automatically releases files from the cache.

        Parameters:
        capacityToRelease - Specifies the amount of data to release, in GiB, by an Amazon File Cache AUTO_RELEASE_DATA task that automatically releases files from the cache.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • fileCacheId

        DataRepositoryTask.Builder fileCacheId​(String fileCacheId)

        The system-generated, unique ID of the cache.

        Parameters:
        fileCacheId - The system-generated, unique ID of the cache.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • releaseConfiguration

        DataRepositoryTask.Builder releaseConfiguration​(ReleaseConfiguration releaseConfiguration)

        The configuration that specifies the last accessed time criteria for files that will be released from an Amazon FSx for Lustre file system.

        Parameters:
        releaseConfiguration - The configuration that specifies the last accessed time criteria for files that will be released from an Amazon FSx for Lustre file system.
        Returns:
        Returns a reference to this object so that method calls can be chained together.