Struct StartTaskExecutionInput

#[non_exhaustive]
pub struct StartTaskExecutionInput {
    pub task_arn: Option<String>,
    pub override_options: Option<Options>,
    pub includes: Option<Vec<FilterRule>>,
    pub excludes: Option<Vec<FilterRule>>,
    pub manifest_config: Option<ManifestConfig>,
    pub task_report_config: Option<TaskReportConfig>,
    pub tags: Option<Vec<TagListEntry>>,
}

StartTaskExecutionRequest

Fields (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_arn: Option<String>

Specifies the Amazon Resource Name (ARN) of the task that you want to start.

override_options: Option<Options>

Indicates how your transfer task is configured. These options include how DataSync handles files, objects, and their associated metadata during your transfer. You also can specify how to verify data integrity, set bandwidth limits for your task, among other options.

Each option has a default value. Unless you need to, you don't have to configure any option before calling StartTaskExecution.

You also can override your task options for each task execution. For example, you might want to adjust the LogLevel for an individual execution.

includes: Option<Vec<FilterRule>>

Specifies a list of filter rules that determines which files to include when running a task. The pattern should contain a single filter string that consists of the patterns to include. The patterns are delimited by "|" (that is, a pipe), for example, "/folder1|/folder2".

excludes: Option<Vec<FilterRule>>

Specifies a list of filter rules that determines which files to exclude from a task. The list contains a single filter string that consists of the patterns to exclude. The patterns are delimited by "|" (that is, a pipe), for example, "/folder1|/folder2".

manifest_config: Option<ManifestConfig>

Configures a manifest, which is a list of files or objects that you want DataSync to transfer. For more information and configuration examples, see Specifying what DataSync transfers by using a manifest.

When using this parameter, your caller identity (the role that you're using DataSync with) must have the iam:PassRole permission. The AWSDataSyncFullAccess policy includes this permission.

To remove a manifest configuration, specify this parameter with an empty value.

task_report_config: Option<TaskReportConfig>

Specifies how you want to configure a task report, which provides detailed information about your DataSync transfer. For more information, see Monitoring your DataSync transfers with task reports.

When using this parameter, your caller identity (the role that you're using DataSync with) must have the iam:PassRole permission. The AWSDataSyncFullAccess policy includes this permission.

To remove a task report configuration, specify this parameter as empty.

tags: Option<Vec<TagListEntry>>

Specifies the tags that you want to apply to the Amazon Resource Name (ARN) representing the task execution.

Tags are key-value pairs that help you manage, filter, and search for your DataSync resources.

Implementations

impl StartTaskExecutionInput

pub fn task_arn(&self) -> Option<&str>

Specifies the Amazon Resource Name (ARN) of the task that you want to start.

pub fn override_options(&self) -> Option<&Options>

Indicates how your transfer task is configured. These options include how DataSync handles files, objects, and their associated metadata during your transfer. You also can specify how to verify data integrity, set bandwidth limits for your task, among other options.

Each option has a default value. Unless you need to, you don't have to configure any option before calling StartTaskExecution.

You also can override your task options for each task execution. For example, you might want to adjust the LogLevel for an individual execution.

pub fn includes(&self) -> &[FilterRule]

Specifies a list of filter rules that determines which files to include when running a task. The pattern should contain a single filter string that consists of the patterns to include. The patterns are delimited by "|" (that is, a pipe), for example, "/folder1|/folder2".

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .includes.is_none().

pub fn excludes(&self) -> &[FilterRule]

Specifies a list of filter rules that determines which files to exclude from a task. The list contains a single filter string that consists of the patterns to exclude. The patterns are delimited by "|" (that is, a pipe), for example, "/folder1|/folder2".

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .excludes.is_none().

pub fn manifest_config(&self) -> Option<&ManifestConfig>

Configures a manifest, which is a list of files or objects that you want DataSync to transfer. For more information and configuration examples, see Specifying what DataSync transfers by using a manifest.

When using this parameter, your caller identity (the role that you're using DataSync with) must have the iam:PassRole permission. The AWSDataSyncFullAccess policy includes this permission.

To remove a manifest configuration, specify this parameter with an empty value.

pub fn task_report_config(&self) -> Option<&TaskReportConfig>

Specifies how you want to configure a task report, which provides detailed information about your DataSync transfer. For more information, see Monitoring your DataSync transfers with task reports.

When using this parameter, your caller identity (the role that you're using DataSync with) must have the iam:PassRole permission. The AWSDataSyncFullAccess policy includes this permission.

To remove a task report configuration, specify this parameter as empty.

pub fn tags(&self) -> &[TagListEntry]

Specifies the tags that you want to apply to the Amazon Resource Name (ARN) representing the task execution.

Tags are key-value pairs that help you manage, filter, and search for your DataSync resources.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .tags.is_none().

impl StartTaskExecutionInput

pub fn builder() -> StartTaskExecutionInputBuilder

Creates a new builder-style object to manufacture StartTaskExecutionInput.

Trait Implementations

impl Clone for StartTaskExecutionInput

fn clone(&self) -> StartTaskExecutionInput

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for StartTaskExecutionInput

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for StartTaskExecutionInput

fn eq(&self, other: &StartTaskExecutionInput) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for StartTaskExecutionInput