AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Container for the parameters to the CreateReplicationTask operation. Creates a replication task using the specified parameters.

Inheritance Hierarchy

System.Object
  Amazon.Runtime.AmazonWebServiceRequest
    Amazon.DatabaseMigrationService.AmazonDatabaseMigrationServiceRequest
      Amazon.DatabaseMigrationService.Model.CreateReplicationTaskRequest

Namespace: Amazon.DatabaseMigrationService.Model
Assembly: AWSSDK.DatabaseMigrationService.dll
Version: 3.x.y.z

Syntax

C#
public class CreateReplicationTaskRequest : AmazonDatabaseMigrationServiceRequest
         IAmazonWebServiceRequest

The CreateReplicationTaskRequest type exposes the following members

Constructors

Properties

NameTypeDescription
Public Property CdcStartPosition System.String

Gets and sets the property CdcStartPosition.

Indicates when you want a change data capture (CDC) operation to start. Use either CdcStartPosition or CdcStartTime to specify when you want a CDC operation to start. Specifying both values results in an error.

The value can be in date, checkpoint, or LSN/SCN format.

Date Example: --cdc-start-position “2018-03-08T12:12:12”

Checkpoint Example: --cdc-start-position "checkpoint:V1#27#mysql-bin-changelog.157832:1975:-1:2002:677883278264080:mysql-bin-changelog.157832:1876#0#0#*#0#93"

LSN Example: --cdc-start-position “mysql-bin-changelog.000024:373”

Public Property CdcStartTime System.DateTime

Gets and sets the property CdcStartTime.

Indicates the start time for a change data capture (CDC) operation. Use either CdcStartTime or CdcStartPosition to specify when you want a CDC operation to start. Specifying both values results in an error.

Timestamp Example: --cdc-start-time “2018-03-08T12:12:12”

Public Property CdcStopPosition System.String

Gets and sets the property CdcStopPosition.

Indicates when you want a change data capture (CDC) operation to stop. The value can be either server time or commit time.

Server time example: --cdc-stop-position “server_time:3018-02-09T12:12:12”

Commit time example: --cdc-stop-position “commit_time: 3018-02-09T12:12:12 “

Public Property MigrationType Amazon.DatabaseMigrationService.MigrationTypeValue

Gets and sets the property MigrationType.

The migration type.

Public Property ReplicationInstanceArn System.String

Gets and sets the property ReplicationInstanceArn.

The Amazon Resource Name (ARN) of the replication instance.

Public Property ReplicationTaskIdentifier System.String

Gets and sets the property ReplicationTaskIdentifier.

The replication task identifier.

Constraints:

  • Must contain from 1 to 255 alphanumeric characters or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

Public Property ReplicationTaskSettings System.String

Gets and sets the property ReplicationTaskSettings.

Settings for the task, such as target metadata settings. For a complete list of task settings, see Task Settings for AWS Database Migration Service Tasks.

Public Property SourceEndpointArn System.String

Gets and sets the property SourceEndpointArn.

The Amazon Resource Name (ARN) string that uniquely identifies the endpoint.

Public Property TableMappings System.String

Gets and sets the property TableMappings.

When using the AWS CLI or boto3, provide the path of the JSON file that contains the table mappings. Precede the path with "file://". When working with the DMS API, provide the JSON as the parameter value.

For example, --table-mappings file://mappingfile.json

Public Property Tags System.Collections.Generic.List<Amazon.DatabaseMigrationService.Model.Tag>

Gets and sets the property Tags.

Tags to be added to the replication instance.

Public Property TargetEndpointArn System.String

Gets and sets the property TargetEndpointArn.

The Amazon Resource Name (ARN) string that uniquely identifies the endpoint.

Examples

Creates a replication task using the specified parameters.

Create replication task


var response = client.CreateReplicationTask(new CreateReplicationTaskRequest 
{
    CdcStartTime = new DateTime(2016, 12, 14, 10, 25, 43),
    MigrationType = "full-load",
    ReplicationInstanceArn = "arn:aws:dms:us-east-1:123456789012:rep:6UTDJGBOUS3VI3SUWA66XFJCJQ",
    ReplicationTaskIdentifier = "task1",
    ReplicationTaskSettings = "",
    SourceEndpointArn = "arn:aws:dms:us-east-1:123456789012:endpoint:ZW5UAN6P4E77EC7YWHK4RZZ3BE",
    TableMappings = "file://mappingfile.json",
    Tags = new List {
        new Tag {
            Key = "Acount",
            Value = "24352226"
        }
    },
    TargetEndpointArn = "arn:aws:dms:us-east-1:123456789012:endpoint:ASXWXJZLNWNT5HTWCGV2BUJQ7E"
});

ReplicationTask replicationTask = response.ReplicationTask;

            

Version Information

.NET Standard:
Supported in: 1.3

.NET Framework:
Supported in: 4.5, 4.0, 3.5

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms