Try AWS Native preview for resources not in the classic version.
aws.datasync.Task
Explore with Pulumi AI
Try AWS Native preview for resources not in the classic version.
Manages an AWS DataSync Task, which represents a configuration for synchronization. Starting an execution of these DataSync Tasks (actually synchronizing files) is performed outside of this resource.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = new aws.datasync.Task("example", {
destinationLocationArn: destination.arn,
name: "example",
sourceLocationArn: source.arn,
options: {
bytesPerSecond: -1,
},
});
import pulumi
import pulumi_aws as aws
example = aws.datasync.Task("example",
destination_location_arn=destination["arn"],
name="example",
source_location_arn=source["arn"],
options={
"bytesPerSecond": -1,
})
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws"
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/datasync"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := datasync.NewTask(ctx, "example", &datasync.TaskArgs{
DestinationLocationArn: pulumi.Any(destination.Arn),
Name: pulumi.String("example"),
SourceLocationArn: pulumi.Any(source.Arn),
Options: &datasync.TaskOptionsArgs{
BytesPerSecond: -1,
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var example = new Aws.DataSync.Task("example", new()
{
DestinationLocationArn = destination.Arn,
Name = "example",
SourceLocationArn = source.Arn,
Options = new Aws.DataSync.Inputs.TaskOptionsArgs
{
BytesPerSecond = -1,
},
});
});
Coming soon!
resources:
example:
type: aws:datasync:Task
properties:
destinationLocationArn: ${destination.arn}
name: example
sourceLocationArn: ${source.arn}
options:
bytesPerSecond: -1
With Scheduling
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = new aws.datasync.Task("example", {
destinationLocationArn: destination.arn,
name: "example",
sourceLocationArn: source.arn,
schedule: {
scheduleExpression: "cron(0 12 ? * SUN,WED *)",
},
});
import pulumi
import pulumi_aws as aws
example = aws.datasync.Task("example",
destination_location_arn=destination["arn"],
name="example",
source_location_arn=source["arn"],
schedule={
"scheduleExpression": "cron(0 12 ? * SUN,WED *)",
})
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws"
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/datasync"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := datasync.NewTask(ctx, "example", &datasync.TaskArgs{
DestinationLocationArn: pulumi.Any(destination.Arn),
Name: pulumi.String("example"),
SourceLocationArn: pulumi.Any(source.Arn),
Schedule: &datasync.TaskScheduleArgs{
ScheduleExpression: pulumi.String("cron(0 12 ? * SUN,WED *)"),
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var example = new Aws.DataSync.Task("example", new()
{
DestinationLocationArn = destination.Arn,
Name = "example",
SourceLocationArn = source.Arn,
Schedule = new Aws.DataSync.Inputs.TaskScheduleArgs
{
ScheduleExpression = "cron(0 12 ? * SUN,WED *)",
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.datasync.Task;
import com.pulumi.aws.datasync.TaskArgs;
import com.pulumi.aws.datasync.inputs.TaskScheduleArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example = new Task("example", TaskArgs.builder()
.destinationLocationArn(destination.arn())
.name("example")
.sourceLocationArn(source.arn())
.schedule(TaskScheduleArgs.builder()
.scheduleExpression("cron(0 12 ? * SUN,WED *)")
.build())
.build());
}
}
resources:
example:
type: aws:datasync:Task
properties:
destinationLocationArn: ${destination.arn}
name: example
sourceLocationArn: ${source.arn}
schedule:
scheduleExpression: cron(0 12 ? * SUN,WED *)
With Filtering
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = new aws.datasync.Task("example", {
destinationLocationArn: destination.arn,
name: "example",
sourceLocationArn: source.arn,
excludes: {
filterType: "SIMPLE_PATTERN",
value: "/folder1|/folder2",
},
includes: {
filterType: "SIMPLE_PATTERN",
value: "/folder1|/folder2",
},
});
import pulumi
import pulumi_aws as aws
example = aws.datasync.Task("example",
destination_location_arn=destination["arn"],
name="example",
source_location_arn=source["arn"],
excludes={
"filterType": "SIMPLE_PATTERN",
"value": "/folder1|/folder2",
},
includes={
"filterType": "SIMPLE_PATTERN",
"value": "/folder1|/folder2",
})
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws"
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/datasync"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := datasync.NewTask(ctx, "example", &datasync.TaskArgs{
DestinationLocationArn: pulumi.Any(destination.Arn),
Name: pulumi.String("example"),
SourceLocationArn: pulumi.Any(source.Arn),
Excludes: &datasync.TaskExcludesArgs{
FilterType: pulumi.String("SIMPLE_PATTERN"),
Value: pulumi.String("/folder1|/folder2"),
},
Includes: &datasync.TaskIncludesArgs{
FilterType: pulumi.String("SIMPLE_PATTERN"),
Value: pulumi.String("/folder1|/folder2"),
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var example = new Aws.DataSync.Task("example", new()
{
DestinationLocationArn = destination.Arn,
Name = "example",
SourceLocationArn = source.Arn,
Excludes = new Aws.DataSync.Inputs.TaskExcludesArgs
{
FilterType = "SIMPLE_PATTERN",
Value = "/folder1|/folder2",
},
Includes = new Aws.DataSync.Inputs.TaskIncludesArgs
{
FilterType = "SIMPLE_PATTERN",
Value = "/folder1|/folder2",
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.datasync.Task;
import com.pulumi.aws.datasync.TaskArgs;
import com.pulumi.aws.datasync.inputs.TaskExcludesArgs;
import com.pulumi.aws.datasync.inputs.TaskIncludesArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example = new Task("example", TaskArgs.builder()
.destinationLocationArn(destination.arn())
.name("example")
.sourceLocationArn(source.arn())
.excludes(TaskExcludesArgs.builder()
.filterType("SIMPLE_PATTERN")
.value("/folder1|/folder2")
.build())
.includes(TaskIncludesArgs.builder()
.filterType("SIMPLE_PATTERN")
.value("/folder1|/folder2")
.build())
.build());
}
}
resources:
example:
type: aws:datasync:Task
properties:
destinationLocationArn: ${destination.arn}
name: example
sourceLocationArn: ${source.arn}
excludes:
filterType: SIMPLE_PATTERN
value: /folder1|/folder2
includes:
filterType: SIMPLE_PATTERN
value: /folder1|/folder2
Create Task Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Task(name: string, args: TaskArgs, opts?: CustomResourceOptions);
@overload
def Task(resource_name: str,
args: TaskArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Task(resource_name: str,
opts: Optional[ResourceOptions] = None,
destination_location_arn: Optional[str] = None,
source_location_arn: Optional[str] = None,
cloudwatch_log_group_arn: Optional[str] = None,
excludes: Optional[TaskExcludesArgs] = None,
includes: Optional[TaskIncludesArgs] = None,
name: Optional[str] = None,
options: Optional[TaskOptionsArgs] = None,
schedule: Optional[TaskScheduleArgs] = None,
tags: Optional[Mapping[str, str]] = None,
task_report_config: Optional[TaskTaskReportConfigArgs] = None)
func NewTask(ctx *Context, name string, args TaskArgs, opts ...ResourceOption) (*Task, error)
public Task(string name, TaskArgs args, CustomResourceOptions? opts = null)
type: aws:datasync:Task
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args TaskArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args TaskArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args TaskArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args TaskArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args TaskArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var taskResource = new Aws.DataSync.Task("taskResource", new()
{
DestinationLocationArn = "string",
SourceLocationArn = "string",
CloudwatchLogGroupArn = "string",
Excludes = new Aws.DataSync.Inputs.TaskExcludesArgs
{
FilterType = "string",
Value = "string",
},
Includes = new Aws.DataSync.Inputs.TaskIncludesArgs
{
FilterType = "string",
Value = "string",
},
Name = "string",
Options = new Aws.DataSync.Inputs.TaskOptionsArgs
{
Atime = "string",
BytesPerSecond = 0,
Gid = "string",
LogLevel = "string",
Mtime = "string",
ObjectTags = "string",
OverwriteMode = "string",
PosixPermissions = "string",
PreserveDeletedFiles = "string",
PreserveDevices = "string",
SecurityDescriptorCopyFlags = "string",
TaskQueueing = "string",
TransferMode = "string",
Uid = "string",
VerifyMode = "string",
},
Schedule = new Aws.DataSync.Inputs.TaskScheduleArgs
{
ScheduleExpression = "string",
},
Tags =
{
{ "string", "string" },
},
TaskReportConfig = new Aws.DataSync.Inputs.TaskTaskReportConfigArgs
{
S3Destination = new Aws.DataSync.Inputs.TaskTaskReportConfigS3DestinationArgs
{
BucketAccessRoleArn = "string",
S3BucketArn = "string",
Subdirectory = "string",
},
OutputType = "string",
ReportLevel = "string",
ReportOverrides = new Aws.DataSync.Inputs.TaskTaskReportConfigReportOverridesArgs
{
DeletedOverride = "string",
SkippedOverride = "string",
TransferredOverride = "string",
VerifiedOverride = "string",
},
S3ObjectVersioning = "string",
},
});
example, err := datasync.NewTask(ctx, "taskResource", &datasync.TaskArgs{
DestinationLocationArn: pulumi.String("string"),
SourceLocationArn: pulumi.String("string"),
CloudwatchLogGroupArn: pulumi.String("string"),
Excludes: &datasync.TaskExcludesArgs{
FilterType: pulumi.String("string"),
Value: pulumi.String("string"),
},
Includes: &datasync.TaskIncludesArgs{
FilterType: pulumi.String("string"),
Value: pulumi.String("string"),
},
Name: pulumi.String("string"),
Options: &datasync.TaskOptionsArgs{
Atime: pulumi.String("string"),
BytesPerSecond: pulumi.Int(0),
Gid: pulumi.String("string"),
LogLevel: pulumi.String("string"),
Mtime: pulumi.String("string"),
ObjectTags: pulumi.String("string"),
OverwriteMode: pulumi.String("string"),
PosixPermissions: pulumi.String("string"),
PreserveDeletedFiles: pulumi.String("string"),
PreserveDevices: pulumi.String("string"),
SecurityDescriptorCopyFlags: pulumi.String("string"),
TaskQueueing: pulumi.String("string"),
TransferMode: pulumi.String("string"),
Uid: pulumi.String("string"),
VerifyMode: pulumi.String("string"),
},
Schedule: &datasync.TaskScheduleArgs{
ScheduleExpression: pulumi.String("string"),
},
Tags: pulumi.StringMap{
"string": pulumi.String("string"),
},
TaskReportConfig: &datasync.TaskTaskReportConfigArgs{
S3Destination: &datasync.TaskTaskReportConfigS3DestinationArgs{
BucketAccessRoleArn: pulumi.String("string"),
S3BucketArn: pulumi.String("string"),
Subdirectory: pulumi.String("string"),
},
OutputType: pulumi.String("string"),
ReportLevel: pulumi.String("string"),
ReportOverrides: &datasync.TaskTaskReportConfigReportOverridesArgs{
DeletedOverride: pulumi.String("string"),
SkippedOverride: pulumi.String("string"),
TransferredOverride: pulumi.String("string"),
VerifiedOverride: pulumi.String("string"),
},
S3ObjectVersioning: pulumi.String("string"),
},
})
var taskResource = new Task("taskResource", TaskArgs.builder()
.destinationLocationArn("string")
.sourceLocationArn("string")
.cloudwatchLogGroupArn("string")
.excludes(TaskExcludesArgs.builder()
.filterType("string")
.value("string")
.build())
.includes(TaskIncludesArgs.builder()
.filterType("string")
.value("string")
.build())
.name("string")
.options(TaskOptionsArgs.builder()
.atime("string")
.bytesPerSecond(0)
.gid("string")
.logLevel("string")
.mtime("string")
.objectTags("string")
.overwriteMode("string")
.posixPermissions("string")
.preserveDeletedFiles("string")
.preserveDevices("string")
.securityDescriptorCopyFlags("string")
.taskQueueing("string")
.transferMode("string")
.uid("string")
.verifyMode("string")
.build())
.schedule(TaskScheduleArgs.builder()
.scheduleExpression("string")
.build())
.tags(Map.of("string", "string"))
.taskReportConfig(TaskTaskReportConfigArgs.builder()
.s3Destination(TaskTaskReportConfigS3DestinationArgs.builder()
.bucketAccessRoleArn("string")
.s3BucketArn("string")
.subdirectory("string")
.build())
.outputType("string")
.reportLevel("string")
.reportOverrides(TaskTaskReportConfigReportOverridesArgs.builder()
.deletedOverride("string")
.skippedOverride("string")
.transferredOverride("string")
.verifiedOverride("string")
.build())
.s3ObjectVersioning("string")
.build())
.build());
task_resource = aws.datasync.Task("taskResource",
destination_location_arn="string",
source_location_arn="string",
cloudwatch_log_group_arn="string",
excludes={
"filterType": "string",
"value": "string",
},
includes={
"filterType": "string",
"value": "string",
},
name="string",
options={
"atime": "string",
"bytesPerSecond": 0,
"gid": "string",
"logLevel": "string",
"mtime": "string",
"objectTags": "string",
"overwriteMode": "string",
"posixPermissions": "string",
"preserveDeletedFiles": "string",
"preserveDevices": "string",
"securityDescriptorCopyFlags": "string",
"taskQueueing": "string",
"transferMode": "string",
"uid": "string",
"verifyMode": "string",
},
schedule={
"scheduleExpression": "string",
},
tags={
"string": "string",
},
task_report_config={
"s3Destination": {
"bucketAccessRoleArn": "string",
"s3BucketArn": "string",
"subdirectory": "string",
},
"outputType": "string",
"reportLevel": "string",
"reportOverrides": {
"deletedOverride": "string",
"skippedOverride": "string",
"transferredOverride": "string",
"verifiedOverride": "string",
},
"s3ObjectVersioning": "string",
})
const taskResource = new aws.datasync.Task("taskResource", {
destinationLocationArn: "string",
sourceLocationArn: "string",
cloudwatchLogGroupArn: "string",
excludes: {
filterType: "string",
value: "string",
},
includes: {
filterType: "string",
value: "string",
},
name: "string",
options: {
atime: "string",
bytesPerSecond: 0,
gid: "string",
logLevel: "string",
mtime: "string",
objectTags: "string",
overwriteMode: "string",
posixPermissions: "string",
preserveDeletedFiles: "string",
preserveDevices: "string",
securityDescriptorCopyFlags: "string",
taskQueueing: "string",
transferMode: "string",
uid: "string",
verifyMode: "string",
},
schedule: {
scheduleExpression: "string",
},
tags: {
string: "string",
},
taskReportConfig: {
s3Destination: {
bucketAccessRoleArn: "string",
s3BucketArn: "string",
subdirectory: "string",
},
outputType: "string",
reportLevel: "string",
reportOverrides: {
deletedOverride: "string",
skippedOverride: "string",
transferredOverride: "string",
verifiedOverride: "string",
},
s3ObjectVersioning: "string",
},
});
type: aws:datasync:Task
properties:
cloudwatchLogGroupArn: string
destinationLocationArn: string
excludes:
filterType: string
value: string
includes:
filterType: string
value: string
name: string
options:
atime: string
bytesPerSecond: 0
gid: string
logLevel: string
mtime: string
objectTags: string
overwriteMode: string
posixPermissions: string
preserveDeletedFiles: string
preserveDevices: string
securityDescriptorCopyFlags: string
taskQueueing: string
transferMode: string
uid: string
verifyMode: string
schedule:
scheduleExpression: string
sourceLocationArn: string
tags:
string: string
taskReportConfig:
outputType: string
reportLevel: string
reportOverrides:
deletedOverride: string
skippedOverride: string
transferredOverride: string
verifiedOverride: string
s3Destination:
bucketAccessRoleArn: string
s3BucketArn: string
subdirectory: string
s3ObjectVersioning: string
Task Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The Task resource accepts the following input properties:
- Destination
Location stringArn - Amazon Resource Name (ARN) of destination DataSync Location.
- Source
Location stringArn - Amazon Resource Name (ARN) of source DataSync Location.
- Cloudwatch
Log stringGroup Arn - Amazon Resource Name (ARN) of the CloudWatch Log Group that is used to monitor and log events in the sync task.
- Excludes
Task
Excludes - Filter rules that determines which files to exclude from a task.
- Includes
Task
Includes - Filter rules that determines which files to include in a task.
- Name string
- Name of the DataSync Task.
- Options
Task
Options - Configuration block containing option that controls the default behavior when you start an execution of this DataSync Task. For each individual task execution, you can override these options by specifying an overriding configuration in those executions.
- Schedule
Task
Schedule - Specifies a schedule used to periodically transfer files from a source to a destination location.
- Dictionary<string, string>
- Key-value pairs of resource tags to assign to the DataSync Task. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Task
Report TaskConfig Task Report Config - Configuration block containing the configuration of a DataSync Task Report. See
task_report_config
below.
- Destination
Location stringArn - Amazon Resource Name (ARN) of destination DataSync Location.
- Source
Location stringArn - Amazon Resource Name (ARN) of source DataSync Location.
- Cloudwatch
Log stringGroup Arn - Amazon Resource Name (ARN) of the CloudWatch Log Group that is used to monitor and log events in the sync task.
- Excludes
Task
Excludes Args - Filter rules that determines which files to exclude from a task.
- Includes
Task
Includes Args - Filter rules that determines which files to include in a task.
- Name string
- Name of the DataSync Task.
- Options
Task
Options Args - Configuration block containing option that controls the default behavior when you start an execution of this DataSync Task. For each individual task execution, you can override these options by specifying an overriding configuration in those executions.
- Schedule
Task
Schedule Args - Specifies a schedule used to periodically transfer files from a source to a destination location.
- map[string]string
- Key-value pairs of resource tags to assign to the DataSync Task. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Task
Report TaskConfig Task Report Config Args - Configuration block containing the configuration of a DataSync Task Report. See
task_report_config
below.
- destination
Location StringArn - Amazon Resource Name (ARN) of destination DataSync Location.
- source
Location StringArn - Amazon Resource Name (ARN) of source DataSync Location.
- cloudwatch
Log StringGroup Arn - Amazon Resource Name (ARN) of the CloudWatch Log Group that is used to monitor and log events in the sync task.
- excludes
Task
Excludes - Filter rules that determines which files to exclude from a task.
- includes
Task
Includes - Filter rules that determines which files to include in a task.
- name String
- Name of the DataSync Task.
- options
Task
Options - Configuration block containing option that controls the default behavior when you start an execution of this DataSync Task. For each individual task execution, you can override these options by specifying an overriding configuration in those executions.
- schedule
Task
Schedule - Specifies a schedule used to periodically transfer files from a source to a destination location.
- Map<String,String>
- Key-value pairs of resource tags to assign to the DataSync Task. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - task
Report TaskConfig Task Report Config - Configuration block containing the configuration of a DataSync Task Report. See
task_report_config
below.
- destination
Location ARNArn - Amazon Resource Name (ARN) of destination DataSync Location.
- source
Location ARNArn - Amazon Resource Name (ARN) of source DataSync Location.
- cloudwatch
Log ARNGroup Arn - Amazon Resource Name (ARN) of the CloudWatch Log Group that is used to monitor and log events in the sync task.
- excludes
Task
Excludes - Filter rules that determines which files to exclude from a task.
- includes
Task
Includes - Filter rules that determines which files to include in a task.
- name string
- Name of the DataSync Task.
- options
Task
Options - Configuration block containing option that controls the default behavior when you start an execution of this DataSync Task. For each individual task execution, you can override these options by specifying an overriding configuration in those executions.
- schedule
Task
Schedule - Specifies a schedule used to periodically transfer files from a source to a destination location.
- {[key: string]: string}
- Key-value pairs of resource tags to assign to the DataSync Task. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - task
Report TaskConfig Task Report Config - Configuration block containing the configuration of a DataSync Task Report. See
task_report_config
below.
- destination_
location_ strarn - Amazon Resource Name (ARN) of destination DataSync Location.
- source_
location_ strarn - Amazon Resource Name (ARN) of source DataSync Location.
- cloudwatch_
log_ strgroup_ arn - Amazon Resource Name (ARN) of the CloudWatch Log Group that is used to monitor and log events in the sync task.
- excludes
Task
Excludes Args - Filter rules that determines which files to exclude from a task.
- includes
Task
Includes Args - Filter rules that determines which files to include in a task.
- name str
- Name of the DataSync Task.
- options
Task
Options Args - Configuration block containing option that controls the default behavior when you start an execution of this DataSync Task. For each individual task execution, you can override these options by specifying an overriding configuration in those executions.
- schedule
Task
Schedule Args - Specifies a schedule used to periodically transfer files from a source to a destination location.
- Mapping[str, str]
- Key-value pairs of resource tags to assign to the DataSync Task. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - task_
report_ Taskconfig Task Report Config Args - Configuration block containing the configuration of a DataSync Task Report. See
task_report_config
below.
- destination
Location Arn - Amazon Resource Name (ARN) of destination DataSync Location.
- source
Location Arn - Amazon Resource Name (ARN) of source DataSync Location.
- cloudwatch
Log Group Arn - Amazon Resource Name (ARN) of the CloudWatch Log Group that is used to monitor and log events in the sync task.
- excludes Property Map
- Filter rules that determines which files to exclude from a task.
- includes Property Map
- Filter rules that determines which files to include in a task.
- name String
- Name of the DataSync Task.
- options Property Map
- Configuration block containing option that controls the default behavior when you start an execution of this DataSync Task. For each individual task execution, you can override these options by specifying an overriding configuration in those executions.
- schedule Property Map
- Specifies a schedule used to periodically transfer files from a source to a destination location.
- Map<String>
- Key-value pairs of resource tags to assign to the DataSync Task. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - task
Report Property MapConfig - Configuration block containing the configuration of a DataSync Task Report. See
task_report_config
below.
Outputs
All input properties are implicitly available as output properties. Additionally, the Task resource produces the following output properties:
Look up Existing Task Resource
Get an existing Task resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: TaskState, opts?: CustomResourceOptions): Task
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
arn: Optional[str] = None,
cloudwatch_log_group_arn: Optional[str] = None,
destination_location_arn: Optional[str] = None,
excludes: Optional[TaskExcludesArgs] = None,
includes: Optional[TaskIncludesArgs] = None,
name: Optional[str] = None,
options: Optional[TaskOptionsArgs] = None,
schedule: Optional[TaskScheduleArgs] = None,
source_location_arn: Optional[str] = None,
tags: Optional[Mapping[str, str]] = None,
tags_all: Optional[Mapping[str, str]] = None,
task_report_config: Optional[TaskTaskReportConfigArgs] = None) -> Task
func GetTask(ctx *Context, name string, id IDInput, state *TaskState, opts ...ResourceOption) (*Task, error)
public static Task Get(string name, Input<string> id, TaskState? state, CustomResourceOptions? opts = null)
public static Task get(String name, Output<String> id, TaskState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Arn string
- Amazon Resource Name (ARN) of the DataSync Task.
- Cloudwatch
Log stringGroup Arn - Amazon Resource Name (ARN) of the CloudWatch Log Group that is used to monitor and log events in the sync task.
- Destination
Location stringArn - Amazon Resource Name (ARN) of destination DataSync Location.
- Excludes
Task
Excludes - Filter rules that determines which files to exclude from a task.
- Includes
Task
Includes - Filter rules that determines which files to include in a task.
- Name string
- Name of the DataSync Task.
- Options
Task
Options - Configuration block containing option that controls the default behavior when you start an execution of this DataSync Task. For each individual task execution, you can override these options by specifying an overriding configuration in those executions.
- Schedule
Task
Schedule - Specifies a schedule used to periodically transfer files from a source to a destination location.
- Source
Location stringArn - Amazon Resource Name (ARN) of source DataSync Location.
- Dictionary<string, string>
- Key-value pairs of resource tags to assign to the DataSync Task. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Dictionary<string, string>
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block. - Task
Report TaskConfig Task Report Config - Configuration block containing the configuration of a DataSync Task Report. See
task_report_config
below.
- Arn string
- Amazon Resource Name (ARN) of the DataSync Task.
- Cloudwatch
Log stringGroup Arn - Amazon Resource Name (ARN) of the CloudWatch Log Group that is used to monitor and log events in the sync task.
- Destination
Location stringArn - Amazon Resource Name (ARN) of destination DataSync Location.
- Excludes
Task
Excludes Args - Filter rules that determines which files to exclude from a task.
- Includes
Task
Includes Args - Filter rules that determines which files to include in a task.
- Name string
- Name of the DataSync Task.
- Options
Task
Options Args - Configuration block containing option that controls the default behavior when you start an execution of this DataSync Task. For each individual task execution, you can override these options by specifying an overriding configuration in those executions.
- Schedule
Task
Schedule Args - Specifies a schedule used to periodically transfer files from a source to a destination location.
- Source
Location stringArn - Amazon Resource Name (ARN) of source DataSync Location.
- map[string]string
- Key-value pairs of resource tags to assign to the DataSync Task. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - map[string]string
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block. - Task
Report TaskConfig Task Report Config Args - Configuration block containing the configuration of a DataSync Task Report. See
task_report_config
below.
- arn String
- Amazon Resource Name (ARN) of the DataSync Task.
- cloudwatch
Log StringGroup Arn - Amazon Resource Name (ARN) of the CloudWatch Log Group that is used to monitor and log events in the sync task.
- destination
Location StringArn - Amazon Resource Name (ARN) of destination DataSync Location.
- excludes
Task
Excludes - Filter rules that determines which files to exclude from a task.
- includes
Task
Includes - Filter rules that determines which files to include in a task.
- name String
- Name of the DataSync Task.
- options
Task
Options - Configuration block containing option that controls the default behavior when you start an execution of this DataSync Task. For each individual task execution, you can override these options by specifying an overriding configuration in those executions.
- schedule
Task
Schedule - Specifies a schedule used to periodically transfer files from a source to a destination location.
- source
Location StringArn - Amazon Resource Name (ARN) of source DataSync Location.
- Map<String,String>
- Key-value pairs of resource tags to assign to the DataSync Task. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Map<String,String>
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block. - task
Report TaskConfig Task Report Config - Configuration block containing the configuration of a DataSync Task Report. See
task_report_config
below.
- arn string
- Amazon Resource Name (ARN) of the DataSync Task.
- cloudwatch
Log ARNGroup Arn - Amazon Resource Name (ARN) of the CloudWatch Log Group that is used to monitor and log events in the sync task.
- destination
Location ARNArn - Amazon Resource Name (ARN) of destination DataSync Location.
- excludes
Task
Excludes - Filter rules that determines which files to exclude from a task.
- includes
Task
Includes - Filter rules that determines which files to include in a task.
- name string
- Name of the DataSync Task.
- options
Task
Options - Configuration block containing option that controls the default behavior when you start an execution of this DataSync Task. For each individual task execution, you can override these options by specifying an overriding configuration in those executions.
- schedule
Task
Schedule - Specifies a schedule used to periodically transfer files from a source to a destination location.
- source
Location ARNArn - Amazon Resource Name (ARN) of source DataSync Location.
- {[key: string]: string}
- Key-value pairs of resource tags to assign to the DataSync Task. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - {[key: string]: string}
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block. - task
Report TaskConfig Task Report Config - Configuration block containing the configuration of a DataSync Task Report. See
task_report_config
below.
- arn str
- Amazon Resource Name (ARN) of the DataSync Task.
- cloudwatch_
log_ strgroup_ arn - Amazon Resource Name (ARN) of the CloudWatch Log Group that is used to monitor and log events in the sync task.
- destination_
location_ strarn - Amazon Resource Name (ARN) of destination DataSync Location.
- excludes
Task
Excludes Args - Filter rules that determines which files to exclude from a task.
- includes
Task
Includes Args - Filter rules that determines which files to include in a task.
- name str
- Name of the DataSync Task.
- options
Task
Options Args - Configuration block containing option that controls the default behavior when you start an execution of this DataSync Task. For each individual task execution, you can override these options by specifying an overriding configuration in those executions.
- schedule
Task
Schedule Args - Specifies a schedule used to periodically transfer files from a source to a destination location.
- source_
location_ strarn - Amazon Resource Name (ARN) of source DataSync Location.
- Mapping[str, str]
- Key-value pairs of resource tags to assign to the DataSync Task. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Mapping[str, str]
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block. - task_
report_ Taskconfig Task Report Config Args - Configuration block containing the configuration of a DataSync Task Report. See
task_report_config
below.
- arn String
- Amazon Resource Name (ARN) of the DataSync Task.
- cloudwatch
Log Group Arn - Amazon Resource Name (ARN) of the CloudWatch Log Group that is used to monitor and log events in the sync task.
- destination
Location Arn - Amazon Resource Name (ARN) of destination DataSync Location.
- excludes Property Map
- Filter rules that determines which files to exclude from a task.
- includes Property Map
- Filter rules that determines which files to include in a task.
- name String
- Name of the DataSync Task.
- options Property Map
- Configuration block containing option that controls the default behavior when you start an execution of this DataSync Task. For each individual task execution, you can override these options by specifying an overriding configuration in those executions.
- schedule Property Map
- Specifies a schedule used to periodically transfer files from a source to a destination location.
- source
Location Arn - Amazon Resource Name (ARN) of source DataSync Location.
- Map<String>
- Key-value pairs of resource tags to assign to the DataSync Task. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Map<String>
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block. - task
Report Property MapConfig - Configuration block containing the configuration of a DataSync Task Report. See
task_report_config
below.
Supporting Types
TaskExcludes, TaskExcludesArgs
- Filter
Type string - The type of filter rule to apply. Valid values:
SIMPLE_PATTERN
. - Value string
- A single filter string that consists of the patterns to exclude. The patterns are delimited by "|" (that is, a pipe), for example:
/folder1|/folder2
- Filter
Type string - The type of filter rule to apply. Valid values:
SIMPLE_PATTERN
. - Value string
- A single filter string that consists of the patterns to exclude. The patterns are delimited by "|" (that is, a pipe), for example:
/folder1|/folder2
- filter
Type String - The type of filter rule to apply. Valid values:
SIMPLE_PATTERN
. - value String
- A single filter string that consists of the patterns to exclude. The patterns are delimited by "|" (that is, a pipe), for example:
/folder1|/folder2
- filter
Type string - The type of filter rule to apply. Valid values:
SIMPLE_PATTERN
. - value string
- A single filter string that consists of the patterns to exclude. The patterns are delimited by "|" (that is, a pipe), for example:
/folder1|/folder2
- filter_
type str - The type of filter rule to apply. Valid values:
SIMPLE_PATTERN
. - value str
- A single filter string that consists of the patterns to exclude. The patterns are delimited by "|" (that is, a pipe), for example:
/folder1|/folder2
- filter
Type String - The type of filter rule to apply. Valid values:
SIMPLE_PATTERN
. - value String
- A single filter string that consists of the patterns to exclude. The patterns are delimited by "|" (that is, a pipe), for example:
/folder1|/folder2
TaskIncludes, TaskIncludesArgs
- Filter
Type string - The type of filter rule to apply. Valid values:
SIMPLE_PATTERN
. - Value string
- A single filter string that consists of the patterns to include. The patterns are delimited by "|" (that is, a pipe), for example:
/folder1|/folder2
- Filter
Type string - The type of filter rule to apply. Valid values:
SIMPLE_PATTERN
. - Value string
- A single filter string that consists of the patterns to include. The patterns are delimited by "|" (that is, a pipe), for example:
/folder1|/folder2
- filter
Type String - The type of filter rule to apply. Valid values:
SIMPLE_PATTERN
. - value String
- A single filter string that consists of the patterns to include. The patterns are delimited by "|" (that is, a pipe), for example:
/folder1|/folder2
- filter
Type string - The type of filter rule to apply. Valid values:
SIMPLE_PATTERN
. - value string
- A single filter string that consists of the patterns to include. The patterns are delimited by "|" (that is, a pipe), for example:
/folder1|/folder2
- filter_
type str - The type of filter rule to apply. Valid values:
SIMPLE_PATTERN
. - value str
- A single filter string that consists of the patterns to include. The patterns are delimited by "|" (that is, a pipe), for example:
/folder1|/folder2
- filter
Type String - The type of filter rule to apply. Valid values:
SIMPLE_PATTERN
. - value String
- A single filter string that consists of the patterns to include. The patterns are delimited by "|" (that is, a pipe), for example:
/folder1|/folder2
TaskOptions, TaskOptionsArgs
- Atime string
- A file metadata that shows the last time a file was accessed (that is when the file was read or written to). If set to
BEST_EFFORT
, the DataSync Task attempts to preserve the original (that is, the version before syncPREPARING
phase)atime
attribute on all source files. Valid values:BEST_EFFORT
,NONE
. Default:BEST_EFFORT
. - Bytes
Per intSecond - Limits the bandwidth utilized. For example, to set a maximum of 1 MB, set this value to
1048576
. Value values:-1
or greater. Default:-1
(unlimited). - Gid string
- Group identifier of the file's owners. Valid values:
BOTH
,INT_VALUE
,NAME
,NONE
. Default:INT_VALUE
(preserve integer value of the ID). - Log
Level string - Determines the type of logs that DataSync publishes to a log stream in the Amazon CloudWatch log group that you provide. Valid values:
OFF
,BASIC
,TRANSFER
. Default:OFF
. - Mtime string
- A file metadata that indicates the last time a file was modified (written to) before the sync
PREPARING
phase. Value values:NONE
,PRESERVE
. Default:PRESERVE
. - string
- Specifies whether object tags are maintained when transferring between object storage systems. If you want your DataSync task to ignore object tags, specify the NONE value. Valid values:
PRESERVE
,NONE
. Default value:PRESERVE
. - Overwrite
Mode string - Determines whether files at the destination should be overwritten or preserved when copying files. Valid values:
ALWAYS
,NEVER
. Default:ALWAYS
. - Posix
Permissions string - Determines which users or groups can access a file for a specific purpose such as reading, writing, or execution of the file. Valid values:
NONE
,PRESERVE
. Default:PRESERVE
. - Preserve
Deleted stringFiles - Whether files deleted in the source should be removed or preserved in the destination file system. Valid values:
PRESERVE
,REMOVE
. Default:PRESERVE
. - Preserve
Devices string - Whether the DataSync Task should preserve the metadata of block and character devices in the source files system, and recreate the files with that device name and metadata on the destination. The DataSync Task can’t sync the actual contents of such devices, because many of the devices are non-terminal and don’t return an end of file (EOF) marker. Valid values:
NONE
,PRESERVE
. Default:NONE
(ignore special devices). - Security
Descriptor stringCopy Flags - Determines which components of the SMB security descriptor are copied from source to destination objects. This value is only used for transfers between SMB and Amazon FSx for Windows File Server locations, or between two Amazon FSx for Windows File Server locations. Valid values:
NONE
,OWNER_DACL
,OWNER_DACL_SACL
. Default:OWNER_DACL
. - Task
Queueing string - Determines whether tasks should be queued before executing the tasks. Valid values:
ENABLED
,DISABLED
. DefaultENABLED
. - Transfer
Mode string - Determines whether DataSync transfers only the data and metadata that differ between the source and the destination location, or whether DataSync transfers all the content from the source, without comparing to the destination location. Valid values:
CHANGED
,ALL
. Default:CHANGED
- Uid string
- User identifier of the file's owners. Valid values:
BOTH
,INT_VALUE
,NAME
,NONE
. Default:INT_VALUE
(preserve integer value of the ID). - Verify
Mode string - Whether a data integrity verification should be performed at the end of a task execution after all data and metadata have been transferred. Valid values:
NONE
,POINT_IN_TIME_CONSISTENT
,ONLY_FILES_TRANSFERRED
. Default:POINT_IN_TIME_CONSISTENT
.
- Atime string
- A file metadata that shows the last time a file was accessed (that is when the file was read or written to). If set to
BEST_EFFORT
, the DataSync Task attempts to preserve the original (that is, the version before syncPREPARING
phase)atime
attribute on all source files. Valid values:BEST_EFFORT
,NONE
. Default:BEST_EFFORT
. - Bytes
Per intSecond - Limits the bandwidth utilized. For example, to set a maximum of 1 MB, set this value to
1048576
. Value values:-1
or greater. Default:-1
(unlimited). - Gid string
- Group identifier of the file's owners. Valid values:
BOTH
,INT_VALUE
,NAME
,NONE
. Default:INT_VALUE
(preserve integer value of the ID). - Log
Level string - Determines the type of logs that DataSync publishes to a log stream in the Amazon CloudWatch log group that you provide. Valid values:
OFF
,BASIC
,TRANSFER
. Default:OFF
. - Mtime string
- A file metadata that indicates the last time a file was modified (written to) before the sync
PREPARING
phase. Value values:NONE
,PRESERVE
. Default:PRESERVE
. - string
- Specifies whether object tags are maintained when transferring between object storage systems. If you want your DataSync task to ignore object tags, specify the NONE value. Valid values:
PRESERVE
,NONE
. Default value:PRESERVE
. - Overwrite
Mode string - Determines whether files at the destination should be overwritten or preserved when copying files. Valid values:
ALWAYS
,NEVER
. Default:ALWAYS
. - Posix
Permissions string - Determines which users or groups can access a file for a specific purpose such as reading, writing, or execution of the file. Valid values:
NONE
,PRESERVE
. Default:PRESERVE
. - Preserve
Deleted stringFiles - Whether files deleted in the source should be removed or preserved in the destination file system. Valid values:
PRESERVE
,REMOVE
. Default:PRESERVE
. - Preserve
Devices string - Whether the DataSync Task should preserve the metadata of block and character devices in the source files system, and recreate the files with that device name and metadata on the destination. The DataSync Task can’t sync the actual contents of such devices, because many of the devices are non-terminal and don’t return an end of file (EOF) marker. Valid values:
NONE
,PRESERVE
. Default:NONE
(ignore special devices). - Security
Descriptor stringCopy Flags - Determines which components of the SMB security descriptor are copied from source to destination objects. This value is only used for transfers between SMB and Amazon FSx for Windows File Server locations, or between two Amazon FSx for Windows File Server locations. Valid values:
NONE
,OWNER_DACL
,OWNER_DACL_SACL
. Default:OWNER_DACL
. - Task
Queueing string - Determines whether tasks should be queued before executing the tasks. Valid values:
ENABLED
,DISABLED
. DefaultENABLED
. - Transfer
Mode string - Determines whether DataSync transfers only the data and metadata that differ between the source and the destination location, or whether DataSync transfers all the content from the source, without comparing to the destination location. Valid values:
CHANGED
,ALL
. Default:CHANGED
- Uid string
- User identifier of the file's owners. Valid values:
BOTH
,INT_VALUE
,NAME
,NONE
. Default:INT_VALUE
(preserve integer value of the ID). - Verify
Mode string - Whether a data integrity verification should be performed at the end of a task execution after all data and metadata have been transferred. Valid values:
NONE
,POINT_IN_TIME_CONSISTENT
,ONLY_FILES_TRANSFERRED
. Default:POINT_IN_TIME_CONSISTENT
.
- atime String
- A file metadata that shows the last time a file was accessed (that is when the file was read or written to). If set to
BEST_EFFORT
, the DataSync Task attempts to preserve the original (that is, the version before syncPREPARING
phase)atime
attribute on all source files. Valid values:BEST_EFFORT
,NONE
. Default:BEST_EFFORT
. - bytes
Per IntegerSecond - Limits the bandwidth utilized. For example, to set a maximum of 1 MB, set this value to
1048576
. Value values:-1
or greater. Default:-1
(unlimited). - gid String
- Group identifier of the file's owners. Valid values:
BOTH
,INT_VALUE
,NAME
,NONE
. Default:INT_VALUE
(preserve integer value of the ID). - log
Level String - Determines the type of logs that DataSync publishes to a log stream in the Amazon CloudWatch log group that you provide. Valid values:
OFF
,BASIC
,TRANSFER
. Default:OFF
. - mtime String
- A file metadata that indicates the last time a file was modified (written to) before the sync
PREPARING
phase. Value values:NONE
,PRESERVE
. Default:PRESERVE
. - String
- Specifies whether object tags are maintained when transferring between object storage systems. If you want your DataSync task to ignore object tags, specify the NONE value. Valid values:
PRESERVE
,NONE
. Default value:PRESERVE
. - overwrite
Mode String - Determines whether files at the destination should be overwritten or preserved when copying files. Valid values:
ALWAYS
,NEVER
. Default:ALWAYS
. - posix
Permissions String - Determines which users or groups can access a file for a specific purpose such as reading, writing, or execution of the file. Valid values:
NONE
,PRESERVE
. Default:PRESERVE
. - preserve
Deleted StringFiles - Whether files deleted in the source should be removed or preserved in the destination file system. Valid values:
PRESERVE
,REMOVE
. Default:PRESERVE
. - preserve
Devices String - Whether the DataSync Task should preserve the metadata of block and character devices in the source files system, and recreate the files with that device name and metadata on the destination. The DataSync Task can’t sync the actual contents of such devices, because many of the devices are non-terminal and don’t return an end of file (EOF) marker. Valid values:
NONE
,PRESERVE
. Default:NONE
(ignore special devices). - security
Descriptor StringCopy Flags - Determines which components of the SMB security descriptor are copied from source to destination objects. This value is only used for transfers between SMB and Amazon FSx for Windows File Server locations, or between two Amazon FSx for Windows File Server locations. Valid values:
NONE
,OWNER_DACL
,OWNER_DACL_SACL
. Default:OWNER_DACL
. - task
Queueing String - Determines whether tasks should be queued before executing the tasks. Valid values:
ENABLED
,DISABLED
. DefaultENABLED
. - transfer
Mode String - Determines whether DataSync transfers only the data and metadata that differ between the source and the destination location, or whether DataSync transfers all the content from the source, without comparing to the destination location. Valid values:
CHANGED
,ALL
. Default:CHANGED
- uid String
- User identifier of the file's owners. Valid values:
BOTH
,INT_VALUE
,NAME
,NONE
. Default:INT_VALUE
(preserve integer value of the ID). - verify
Mode String - Whether a data integrity verification should be performed at the end of a task execution after all data and metadata have been transferred. Valid values:
NONE
,POINT_IN_TIME_CONSISTENT
,ONLY_FILES_TRANSFERRED
. Default:POINT_IN_TIME_CONSISTENT
.
- atime string
- A file metadata that shows the last time a file was accessed (that is when the file was read or written to). If set to
BEST_EFFORT
, the DataSync Task attempts to preserve the original (that is, the version before syncPREPARING
phase)atime
attribute on all source files. Valid values:BEST_EFFORT
,NONE
. Default:BEST_EFFORT
. - bytes
Per numberSecond - Limits the bandwidth utilized. For example, to set a maximum of 1 MB, set this value to
1048576
. Value values:-1
or greater. Default:-1
(unlimited). - gid string
- Group identifier of the file's owners. Valid values:
BOTH
,INT_VALUE
,NAME
,NONE
. Default:INT_VALUE
(preserve integer value of the ID). - log
Level string - Determines the type of logs that DataSync publishes to a log stream in the Amazon CloudWatch log group that you provide. Valid values:
OFF
,BASIC
,TRANSFER
. Default:OFF
. - mtime string
- A file metadata that indicates the last time a file was modified (written to) before the sync
PREPARING
phase. Value values:NONE
,PRESERVE
. Default:PRESERVE
. - string
- Specifies whether object tags are maintained when transferring between object storage systems. If you want your DataSync task to ignore object tags, specify the NONE value. Valid values:
PRESERVE
,NONE
. Default value:PRESERVE
. - overwrite
Mode string - Determines whether files at the destination should be overwritten or preserved when copying files. Valid values:
ALWAYS
,NEVER
. Default:ALWAYS
. - posix
Permissions string - Determines which users or groups can access a file for a specific purpose such as reading, writing, or execution of the file. Valid values:
NONE
,PRESERVE
. Default:PRESERVE
. - preserve
Deleted stringFiles - Whether files deleted in the source should be removed or preserved in the destination file system. Valid values:
PRESERVE
,REMOVE
. Default:PRESERVE
. - preserve
Devices string - Whether the DataSync Task should preserve the metadata of block and character devices in the source files system, and recreate the files with that device name and metadata on the destination. The DataSync Task can’t sync the actual contents of such devices, because many of the devices are non-terminal and don’t return an end of file (EOF) marker. Valid values:
NONE
,PRESERVE
. Default:NONE
(ignore special devices). - security
Descriptor stringCopy Flags - Determines which components of the SMB security descriptor are copied from source to destination objects. This value is only used for transfers between SMB and Amazon FSx for Windows File Server locations, or between two Amazon FSx for Windows File Server locations. Valid values:
NONE
,OWNER_DACL
,OWNER_DACL_SACL
. Default:OWNER_DACL
. - task
Queueing string - Determines whether tasks should be queued before executing the tasks. Valid values:
ENABLED
,DISABLED
. DefaultENABLED
. - transfer
Mode string - Determines whether DataSync transfers only the data and metadata that differ between the source and the destination location, or whether DataSync transfers all the content from the source, without comparing to the destination location. Valid values:
CHANGED
,ALL
. Default:CHANGED
- uid string
- User identifier of the file's owners. Valid values:
BOTH
,INT_VALUE
,NAME
,NONE
. Default:INT_VALUE
(preserve integer value of the ID). - verify
Mode string - Whether a data integrity verification should be performed at the end of a task execution after all data and metadata have been transferred. Valid values:
NONE
,POINT_IN_TIME_CONSISTENT
,ONLY_FILES_TRANSFERRED
. Default:POINT_IN_TIME_CONSISTENT
.
- atime str
- A file metadata that shows the last time a file was accessed (that is when the file was read or written to). If set to
BEST_EFFORT
, the DataSync Task attempts to preserve the original (that is, the version before syncPREPARING
phase)atime
attribute on all source files. Valid values:BEST_EFFORT
,NONE
. Default:BEST_EFFORT
. - bytes_
per_ intsecond - Limits the bandwidth utilized. For example, to set a maximum of 1 MB, set this value to
1048576
. Value values:-1
or greater. Default:-1
(unlimited). - gid str
- Group identifier of the file's owners. Valid values:
BOTH
,INT_VALUE
,NAME
,NONE
. Default:INT_VALUE
(preserve integer value of the ID). - log_
level str - Determines the type of logs that DataSync publishes to a log stream in the Amazon CloudWatch log group that you provide. Valid values:
OFF
,BASIC
,TRANSFER
. Default:OFF
. - mtime str
- A file metadata that indicates the last time a file was modified (written to) before the sync
PREPARING
phase. Value values:NONE
,PRESERVE
. Default:PRESERVE
. - str
- Specifies whether object tags are maintained when transferring between object storage systems. If you want your DataSync task to ignore object tags, specify the NONE value. Valid values:
PRESERVE
,NONE
. Default value:PRESERVE
. - overwrite_
mode str - Determines whether files at the destination should be overwritten or preserved when copying files. Valid values:
ALWAYS
,NEVER
. Default:ALWAYS
. - posix_
permissions str - Determines which users or groups can access a file for a specific purpose such as reading, writing, or execution of the file. Valid values:
NONE
,PRESERVE
. Default:PRESERVE
. - preserve_
deleted_ strfiles - Whether files deleted in the source should be removed or preserved in the destination file system. Valid values:
PRESERVE
,REMOVE
. Default:PRESERVE
. - preserve_
devices str - Whether the DataSync Task should preserve the metadata of block and character devices in the source files system, and recreate the files with that device name and metadata on the destination. The DataSync Task can’t sync the actual contents of such devices, because many of the devices are non-terminal and don’t return an end of file (EOF) marker. Valid values:
NONE
,PRESERVE
. Default:NONE
(ignore special devices). - security_
descriptor_ strcopy_ flags - Determines which components of the SMB security descriptor are copied from source to destination objects. This value is only used for transfers between SMB and Amazon FSx for Windows File Server locations, or between two Amazon FSx for Windows File Server locations. Valid values:
NONE
,OWNER_DACL
,OWNER_DACL_SACL
. Default:OWNER_DACL
. - task_
queueing str - Determines whether tasks should be queued before executing the tasks. Valid values:
ENABLED
,DISABLED
. DefaultENABLED
. - transfer_
mode str - Determines whether DataSync transfers only the data and metadata that differ between the source and the destination location, or whether DataSync transfers all the content from the source, without comparing to the destination location. Valid values:
CHANGED
,ALL
. Default:CHANGED
- uid str
- User identifier of the file's owners. Valid values:
BOTH
,INT_VALUE
,NAME
,NONE
. Default:INT_VALUE
(preserve integer value of the ID). - verify_
mode str - Whether a data integrity verification should be performed at the end of a task execution after all data and metadata have been transferred. Valid values:
NONE
,POINT_IN_TIME_CONSISTENT
,ONLY_FILES_TRANSFERRED
. Default:POINT_IN_TIME_CONSISTENT
.
- atime String
- A file metadata that shows the last time a file was accessed (that is when the file was read or written to). If set to
BEST_EFFORT
, the DataSync Task attempts to preserve the original (that is, the version before syncPREPARING
phase)atime
attribute on all source files. Valid values:BEST_EFFORT
,NONE
. Default:BEST_EFFORT
. - bytes
Per NumberSecond - Limits the bandwidth utilized. For example, to set a maximum of 1 MB, set this value to
1048576
. Value values:-1
or greater. Default:-1
(unlimited). - gid String
- Group identifier of the file's owners. Valid values:
BOTH
,INT_VALUE
,NAME
,NONE
. Default:INT_VALUE
(preserve integer value of the ID). - log
Level String - Determines the type of logs that DataSync publishes to a log stream in the Amazon CloudWatch log group that you provide. Valid values:
OFF
,BASIC
,TRANSFER
. Default:OFF
. - mtime String
- A file metadata that indicates the last time a file was modified (written to) before the sync
PREPARING
phase. Value values:NONE
,PRESERVE
. Default:PRESERVE
. - String
- Specifies whether object tags are maintained when transferring between object storage systems. If you want your DataSync task to ignore object tags, specify the NONE value. Valid values:
PRESERVE
,NONE
. Default value:PRESERVE
. - overwrite
Mode String - Determines whether files at the destination should be overwritten or preserved when copying files. Valid values:
ALWAYS
,NEVER
. Default:ALWAYS
. - posix
Permissions String - Determines which users or groups can access a file for a specific purpose such as reading, writing, or execution of the file. Valid values:
NONE
,PRESERVE
. Default:PRESERVE
. - preserve
Deleted StringFiles - Whether files deleted in the source should be removed or preserved in the destination file system. Valid values:
PRESERVE
,REMOVE
. Default:PRESERVE
. - preserve
Devices String - Whether the DataSync Task should preserve the metadata of block and character devices in the source files system, and recreate the files with that device name and metadata on the destination. The DataSync Task can’t sync the actual contents of such devices, because many of the devices are non-terminal and don’t return an end of file (EOF) marker. Valid values:
NONE
,PRESERVE
. Default:NONE
(ignore special devices). - security
Descriptor StringCopy Flags - Determines which components of the SMB security descriptor are copied from source to destination objects. This value is only used for transfers between SMB and Amazon FSx for Windows File Server locations, or between two Amazon FSx for Windows File Server locations. Valid values:
NONE
,OWNER_DACL
,OWNER_DACL_SACL
. Default:OWNER_DACL
. - task
Queueing String - Determines whether tasks should be queued before executing the tasks. Valid values:
ENABLED
,DISABLED
. DefaultENABLED
. - transfer
Mode String - Determines whether DataSync transfers only the data and metadata that differ between the source and the destination location, or whether DataSync transfers all the content from the source, without comparing to the destination location. Valid values:
CHANGED
,ALL
. Default:CHANGED
- uid String
- User identifier of the file's owners. Valid values:
BOTH
,INT_VALUE
,NAME
,NONE
. Default:INT_VALUE
(preserve integer value of the ID). - verify
Mode String - Whether a data integrity verification should be performed at the end of a task execution after all data and metadata have been transferred. Valid values:
NONE
,POINT_IN_TIME_CONSISTENT
,ONLY_FILES_TRANSFERRED
. Default:POINT_IN_TIME_CONSISTENT
.
TaskSchedule, TaskScheduleArgs
- Schedule
Expression string - Specifies the schedule you want your task to use for repeated executions. For more information, see Schedule Expressions for Rules.
- Schedule
Expression string - Specifies the schedule you want your task to use for repeated executions. For more information, see Schedule Expressions for Rules.
- schedule
Expression String - Specifies the schedule you want your task to use for repeated executions. For more information, see Schedule Expressions for Rules.
- schedule
Expression string - Specifies the schedule you want your task to use for repeated executions. For more information, see Schedule Expressions for Rules.
- schedule_
expression str - Specifies the schedule you want your task to use for repeated executions. For more information, see Schedule Expressions for Rules.
- schedule
Expression String - Specifies the schedule you want your task to use for repeated executions. For more information, see Schedule Expressions for Rules.
TaskTaskReportConfig, TaskTaskReportConfigArgs
- S3Destination
Task
Task Report Config S3Destination - Configuration block containing the configuration for the Amazon S3 bucket where DataSync uploads your task report. See
s3_destination
below. - Output
Type string - Specifies the type of task report you'd like. Valid values:
SUMMARY_ONLY
andSTANDARD
. - Report
Level string - Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - Report
Overrides TaskTask Report Config Report Overrides - Configuration block containing the configuration of the reporting level for aspects of your task report. See
report_overrides
below. - S3Object
Versioning string - Specifies whether your task report includes the new version of each object transferred into an S3 bucket. This only applies if you enable versioning on your bucket. Keep in mind that setting this to INCLUDE can increase the duration of your task execution. Valid values:
INCLUDE
andNONE
.
- S3Destination
Task
Task Report Config S3Destination - Configuration block containing the configuration for the Amazon S3 bucket where DataSync uploads your task report. See
s3_destination
below. - Output
Type string - Specifies the type of task report you'd like. Valid values:
SUMMARY_ONLY
andSTANDARD
. - Report
Level string - Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - Report
Overrides TaskTask Report Config Report Overrides - Configuration block containing the configuration of the reporting level for aspects of your task report. See
report_overrides
below. - S3Object
Versioning string - Specifies whether your task report includes the new version of each object transferred into an S3 bucket. This only applies if you enable versioning on your bucket. Keep in mind that setting this to INCLUDE can increase the duration of your task execution. Valid values:
INCLUDE
andNONE
.
- s3Destination
Task
Task Report Config S3Destination - Configuration block containing the configuration for the Amazon S3 bucket where DataSync uploads your task report. See
s3_destination
below. - output
Type String - Specifies the type of task report you'd like. Valid values:
SUMMARY_ONLY
andSTANDARD
. - report
Level String - Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - report
Overrides TaskTask Report Config Report Overrides - Configuration block containing the configuration of the reporting level for aspects of your task report. See
report_overrides
below. - s3Object
Versioning String - Specifies whether your task report includes the new version of each object transferred into an S3 bucket. This only applies if you enable versioning on your bucket. Keep in mind that setting this to INCLUDE can increase the duration of your task execution. Valid values:
INCLUDE
andNONE
.
- s3Destination
Task
Task Report Config S3Destination - Configuration block containing the configuration for the Amazon S3 bucket where DataSync uploads your task report. See
s3_destination
below. - output
Type string - Specifies the type of task report you'd like. Valid values:
SUMMARY_ONLY
andSTANDARD
. - report
Level string - Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - report
Overrides TaskTask Report Config Report Overrides - Configuration block containing the configuration of the reporting level for aspects of your task report. See
report_overrides
below. - s3Object
Versioning string - Specifies whether your task report includes the new version of each object transferred into an S3 bucket. This only applies if you enable versioning on your bucket. Keep in mind that setting this to INCLUDE can increase the duration of your task execution. Valid values:
INCLUDE
andNONE
.
- s3_
destination TaskTask Report Config S3Destination - Configuration block containing the configuration for the Amazon S3 bucket where DataSync uploads your task report. See
s3_destination
below. - output_
type str - Specifies the type of task report you'd like. Valid values:
SUMMARY_ONLY
andSTANDARD
. - report_
level str - Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - report_
overrides TaskTask Report Config Report Overrides - Configuration block containing the configuration of the reporting level for aspects of your task report. See
report_overrides
below. - s3_
object_ strversioning - Specifies whether your task report includes the new version of each object transferred into an S3 bucket. This only applies if you enable versioning on your bucket. Keep in mind that setting this to INCLUDE can increase the duration of your task execution. Valid values:
INCLUDE
andNONE
.
- s3Destination Property Map
- Configuration block containing the configuration for the Amazon S3 bucket where DataSync uploads your task report. See
s3_destination
below. - output
Type String - Specifies the type of task report you'd like. Valid values:
SUMMARY_ONLY
andSTANDARD
. - report
Level String - Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - report
Overrides Property Map - Configuration block containing the configuration of the reporting level for aspects of your task report. See
report_overrides
below. - s3Object
Versioning String - Specifies whether your task report includes the new version of each object transferred into an S3 bucket. This only applies if you enable versioning on your bucket. Keep in mind that setting this to INCLUDE can increase the duration of your task execution. Valid values:
INCLUDE
andNONE
.
TaskTaskReportConfigReportOverrides, TaskTaskReportConfigReportOverridesArgs
- Deleted
Override string - Specifies the level of reporting for the files, objects, and directories that DataSync attempted to delete in your destination location. This only applies if you configure your task to delete data in the destination that isn't in the source. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - Skipped
Override string - Specifies the level of reporting for the files, objects, and directories that DataSync attempted to skip during your transfer. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - Transferred
Override string - Specifies the level of reporting for the files, objects, and directories that DataSync attempted to transfer. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - Verified
Override string Specifies the level of reporting for the files, objects, and directories that DataSync attempted to verify at the end of your transfer. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
.NOTE: If any
report_overrides
are set to the same value astask_report_config.report_level
, they will always be flagged as changed. Only set overrides to a value that differs fromtask_report_config.report_level
.
- Deleted
Override string - Specifies the level of reporting for the files, objects, and directories that DataSync attempted to delete in your destination location. This only applies if you configure your task to delete data in the destination that isn't in the source. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - Skipped
Override string - Specifies the level of reporting for the files, objects, and directories that DataSync attempted to skip during your transfer. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - Transferred
Override string - Specifies the level of reporting for the files, objects, and directories that DataSync attempted to transfer. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - Verified
Override string Specifies the level of reporting for the files, objects, and directories that DataSync attempted to verify at the end of your transfer. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
.NOTE: If any
report_overrides
are set to the same value astask_report_config.report_level
, they will always be flagged as changed. Only set overrides to a value that differs fromtask_report_config.report_level
.
- deleted
Override String - Specifies the level of reporting for the files, objects, and directories that DataSync attempted to delete in your destination location. This only applies if you configure your task to delete data in the destination that isn't in the source. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - skipped
Override String - Specifies the level of reporting for the files, objects, and directories that DataSync attempted to skip during your transfer. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - transferred
Override String - Specifies the level of reporting for the files, objects, and directories that DataSync attempted to transfer. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - verified
Override String Specifies the level of reporting for the files, objects, and directories that DataSync attempted to verify at the end of your transfer. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
.NOTE: If any
report_overrides
are set to the same value astask_report_config.report_level
, they will always be flagged as changed. Only set overrides to a value that differs fromtask_report_config.report_level
.
- deleted
Override string - Specifies the level of reporting for the files, objects, and directories that DataSync attempted to delete in your destination location. This only applies if you configure your task to delete data in the destination that isn't in the source. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - skipped
Override string - Specifies the level of reporting for the files, objects, and directories that DataSync attempted to skip during your transfer. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - transferred
Override string - Specifies the level of reporting for the files, objects, and directories that DataSync attempted to transfer. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - verified
Override string Specifies the level of reporting for the files, objects, and directories that DataSync attempted to verify at the end of your transfer. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
.NOTE: If any
report_overrides
are set to the same value astask_report_config.report_level
, they will always be flagged as changed. Only set overrides to a value that differs fromtask_report_config.report_level
.
- deleted_
override str - Specifies the level of reporting for the files, objects, and directories that DataSync attempted to delete in your destination location. This only applies if you configure your task to delete data in the destination that isn't in the source. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - skipped_
override str - Specifies the level of reporting for the files, objects, and directories that DataSync attempted to skip during your transfer. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - transferred_
override str - Specifies the level of reporting for the files, objects, and directories that DataSync attempted to transfer. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - verified_
override str Specifies the level of reporting for the files, objects, and directories that DataSync attempted to verify at the end of your transfer. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
.NOTE: If any
report_overrides
are set to the same value astask_report_config.report_level
, they will always be flagged as changed. Only set overrides to a value that differs fromtask_report_config.report_level
.
- deleted
Override String - Specifies the level of reporting for the files, objects, and directories that DataSync attempted to delete in your destination location. This only applies if you configure your task to delete data in the destination that isn't in the source. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - skipped
Override String - Specifies the level of reporting for the files, objects, and directories that DataSync attempted to skip during your transfer. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - transferred
Override String - Specifies the level of reporting for the files, objects, and directories that DataSync attempted to transfer. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
. - verified
Override String Specifies the level of reporting for the files, objects, and directories that DataSync attempted to verify at the end of your transfer. Valid values:
ERRORS_ONLY
andSUCCESSES_AND_ERRORS
.NOTE: If any
report_overrides
are set to the same value astask_report_config.report_level
, they will always be flagged as changed. Only set overrides to a value that differs fromtask_report_config.report_level
.
TaskTaskReportConfigS3Destination, TaskTaskReportConfigS3DestinationArgs
- Bucket
Access stringRole Arn - Specifies the Amazon Resource Name (ARN) of the IAM policy that allows DataSync to upload a task report to your S3 bucket.
- S3Bucket
Arn string - Specifies the ARN of the S3 bucket where DataSync uploads your report.
- Subdirectory string
- Specifies a bucket prefix for your report.
- Bucket
Access stringRole Arn - Specifies the Amazon Resource Name (ARN) of the IAM policy that allows DataSync to upload a task report to your S3 bucket.
- S3Bucket
Arn string - Specifies the ARN of the S3 bucket where DataSync uploads your report.
- Subdirectory string
- Specifies a bucket prefix for your report.
- bucket
Access StringRole Arn - Specifies the Amazon Resource Name (ARN) of the IAM policy that allows DataSync to upload a task report to your S3 bucket.
- s3Bucket
Arn String - Specifies the ARN of the S3 bucket where DataSync uploads your report.
- subdirectory String
- Specifies a bucket prefix for your report.
- bucket
Access stringRole Arn - Specifies the Amazon Resource Name (ARN) of the IAM policy that allows DataSync to upload a task report to your S3 bucket.
- s3Bucket
Arn string - Specifies the ARN of the S3 bucket where DataSync uploads your report.
- subdirectory string
- Specifies a bucket prefix for your report.
- bucket_
access_ strrole_ arn - Specifies the Amazon Resource Name (ARN) of the IAM policy that allows DataSync to upload a task report to your S3 bucket.
- s3_
bucket_ strarn - Specifies the ARN of the S3 bucket where DataSync uploads your report.
- subdirectory str
- Specifies a bucket prefix for your report.
- bucket
Access StringRole Arn - Specifies the Amazon Resource Name (ARN) of the IAM policy that allows DataSync to upload a task report to your S3 bucket.
- s3Bucket
Arn String - Specifies the ARN of the S3 bucket where DataSync uploads your report.
- subdirectory String
- Specifies a bucket prefix for your report.
Import
Using pulumi import
, import aws_datasync_task
using the DataSync Task Amazon Resource Name (ARN). For example:
$ pulumi import aws:datasync/task:Task example arn:aws:datasync:us-east-1:123456789012:task/task-12345678901234567
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- AWS Classic pulumi/pulumi-aws
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
aws
Terraform Provider.
Try AWS Native preview for resources not in the classic version.