#[non_exhaustive]
pub struct DataRepositoryTask {
Show 13 fields pub task_id: Option<String>, pub lifecycle: Option<DataRepositoryTaskLifecycle>, pub type: Option<DataRepositoryTaskType>, pub creation_time: Option<DateTime>, pub start_time: Option<DateTime>, pub end_time: Option<DateTime>, pub resource_arn: Option<String>, pub tags: Option<Vec<Tag>>, pub file_system_id: Option<String>, pub paths: Option<Vec<String>>, pub failure_details: Option<DataRepositoryTaskFailureDetails>, pub status: Option<DataRepositoryTaskStatus>, pub report: Option<CompletionReport>,
}
Expand description

A description of the data repository task. You use data repository tasks to perform bulk transfer operations between your Amazon FSx file system and a linked data repository.

Fields (Non-exhaustive)

This struct is marked as non-exhaustive
Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.
task_id: Option<String>

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

lifecycle: Option<DataRepositoryTaskLifecycle>

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

  • PENDING - Amazon FSx has not started the task.

  • EXECUTING - Amazon FSx is processing the task.

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

  • SUCCEEDED - FSx completed the task successfully.

  • CANCELED - Amazon FSx canceled the task and it did not complete.

  • CANCELING - FSx is in process of canceling the task.

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.

type: Option<DataRepositoryTaskType>

The type of data repository task.

  • The EXPORT_TO_REPOSITORY data repository task exports from your Lustre file system from to a linked S3 bucket.

  • The IMPORT_METADATA_FROM_REPOSITORY data repository task imports metadata changes from a linked S3 bucket to your Lustre file system.

creation_time: Option<DateTime>

The time that the resource was created, in seconds (since 1970-01-01T00:00:00Z), also known as Unix time.

start_time: Option<DateTime>

The time that Amazon FSx began processing the task.

end_time: Option<DateTime>

The time that Amazon FSx completed processing the task, populated after the task is complete.

resource_arn: Option<String>

The Amazon Resource Name (ARN) for a given resource. ARNs uniquely identify Amazon Web Services resources. We require an ARN when you need to specify a resource unambiguously across all of Amazon Web Services. For more information, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference.

tags: Option<Vec<Tag>>

A list of Tag values, with a maximum of 50 elements.

file_system_id: Option<String>

The globally unique ID of the file system, assigned by Amazon FSx.

paths: Option<Vec<String>>

An array of paths on the Amazon FSx for Lustre file system 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.

failure_details: Option<DataRepositoryTaskFailureDetails>

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

status: Option<DataRepositoryTaskStatus>

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

report: Option<CompletionReport>

Provides a report detailing the data repository task results of the files processed that match the criteria specified in the report Scope parameter. FSx delivers the report to the file system's linked data repository in Amazon S3, using the path specified in the report Path parameter. You can specify whether or not a report gets generated for a task using the Enabled parameter.

Implementations

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

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

  • PENDING - Amazon FSx has not started the task.

  • EXECUTING - Amazon FSx is processing the task.

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

  • SUCCEEDED - FSx completed the task successfully.

  • CANCELED - Amazon FSx canceled the task and it did not complete.

  • CANCELING - FSx is in process of canceling the task.

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.

The type of data repository task.

  • The EXPORT_TO_REPOSITORY data repository task exports from your Lustre file system from to a linked S3 bucket.

  • The IMPORT_METADATA_FROM_REPOSITORY data repository task imports metadata changes from a linked S3 bucket to your Lustre file system.

The time that the resource was created, in seconds (since 1970-01-01T00:00:00Z), also known as Unix time.

The time that Amazon FSx began processing the task.

The time that Amazon FSx completed processing the task, populated after the task is complete.

The Amazon Resource Name (ARN) for a given resource. ARNs uniquely identify Amazon Web Services resources. We require an ARN when you need to specify a resource unambiguously across all of Amazon Web Services. For more information, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference.

A list of Tag values, with a maximum of 50 elements.

The globally unique ID of the file system, assigned by Amazon FSx.

An array of paths on the Amazon FSx for Lustre file system 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.

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

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

Provides a report detailing the data repository task results of the files processed that match the criteria specified in the report Scope parameter. FSx delivers the report to the file system's linked data repository in Amazon S3, using the path specified in the report Path parameter. You can specify whether or not a report gets generated for a task using the Enabled parameter.

Creates a new builder-style object to manufacture DataRepositoryTask

Trait Implementations

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

Formats the value using the given formatter. Read more

This method tests for self and other values to be equal, and is used by ==. Read more

This method tests for !=.

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Returns the argument unchanged.

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

The resulting type after obtaining ownership.

Creates owned data from borrowed data, usually by cloning. Read more

Uses borrowed data to replace owned data, usually by cloning. Read more

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more