libZSservicesZSamazonka-dmsZSamazonka-dms
Copyright(c) 2013-2021 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone

Amazonka.DMS.StartReplicationTask

Description

Starts the replication task.

For more information about DMS tasks, see Working with Migration Tasks in the Database Migration Service User Guide.

Synopsis

Creating a Request

data StartReplicationTask Source #

See: newStartReplicationTask smart constructor.

Constructors

StartReplicationTask' 

Fields

  • cdcStartPosition :: Maybe Text

    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:V1mysql-bin-changelog.157832:1975:-1:2002:677883278264080:mysql-bin-changelog.157832:187600#93"

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

    When you use this task setting with a source PostgreSQL database, a logical replication slot should already be created and associated with the source endpoint. You can verify this by setting the slotName extra connection attribute to the name of this logical replication slot. For more information, see Extra Connection Attributes When Using PostgreSQL as a Source for DMS.

  • cdcStopPosition :: Maybe Text

    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:2018-02-09T12:12:12”

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

  • cdcStartTime :: Maybe POSIX

    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”

  • replicationTaskArn :: Text

    The Amazon Resource Name (ARN) of the replication task to be started.

  • startReplicationTaskType :: StartReplicationTaskTypeValue

    A type of replication task.

Instances

Instances details
Eq StartReplicationTask Source # 
Instance details

Defined in Amazonka.DMS.StartReplicationTask

Read StartReplicationTask Source # 
Instance details

Defined in Amazonka.DMS.StartReplicationTask

Show StartReplicationTask Source # 
Instance details

Defined in Amazonka.DMS.StartReplicationTask

Generic StartReplicationTask Source # 
Instance details

Defined in Amazonka.DMS.StartReplicationTask

Associated Types

type Rep StartReplicationTask :: Type -> Type #

NFData StartReplicationTask Source # 
Instance details

Defined in Amazonka.DMS.StartReplicationTask

Methods

rnf :: StartReplicationTask -> () #

Hashable StartReplicationTask Source # 
Instance details

Defined in Amazonka.DMS.StartReplicationTask

ToJSON StartReplicationTask Source # 
Instance details

Defined in Amazonka.DMS.StartReplicationTask

AWSRequest StartReplicationTask Source # 
Instance details

Defined in Amazonka.DMS.StartReplicationTask

Associated Types

type AWSResponse StartReplicationTask #

ToHeaders StartReplicationTask Source # 
Instance details

Defined in Amazonka.DMS.StartReplicationTask

ToPath StartReplicationTask Source # 
Instance details

Defined in Amazonka.DMS.StartReplicationTask

ToQuery StartReplicationTask Source # 
Instance details

Defined in Amazonka.DMS.StartReplicationTask

type Rep StartReplicationTask Source # 
Instance details

Defined in Amazonka.DMS.StartReplicationTask

type Rep StartReplicationTask = D1 ('MetaData "StartReplicationTask" "Amazonka.DMS.StartReplicationTask" "libZSservicesZSamazonka-dmsZSamazonka-dms" 'False) (C1 ('MetaCons "StartReplicationTask'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "cdcStartPosition") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "cdcStopPosition") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "cdcStartTime") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe POSIX)) :*: (S1 ('MetaSel ('Just "replicationTaskArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "startReplicationTaskType") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 StartReplicationTaskTypeValue)))))
type AWSResponse StartReplicationTask Source # 
Instance details

Defined in Amazonka.DMS.StartReplicationTask

newStartReplicationTask Source #

Create a value of StartReplicationTask with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:cdcStartPosition:StartReplicationTask', startReplicationTask_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:V1mysql-bin-changelog.157832:1975:-1:2002:677883278264080:mysql-bin-changelog.157832:187600#93"

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

When you use this task setting with a source PostgreSQL database, a logical replication slot should already be created and associated with the source endpoint. You can verify this by setting the slotName extra connection attribute to the name of this logical replication slot. For more information, see Extra Connection Attributes When Using PostgreSQL as a Source for DMS.

$sel:cdcStopPosition:StartReplicationTask', startReplicationTask_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:2018-02-09T12:12:12”

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

$sel:cdcStartTime:StartReplicationTask', startReplicationTask_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”

$sel:replicationTaskArn:StartReplicationTask', startReplicationTask_replicationTaskArn - The Amazon Resource Name (ARN) of the replication task to be started.

$sel:startReplicationTaskType:StartReplicationTask', startReplicationTask_startReplicationTaskType - A type of replication task.

Request Lenses

startReplicationTask_cdcStartPosition :: Lens' StartReplicationTask (Maybe Text) Source #

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:V1mysql-bin-changelog.157832:1975:-1:2002:677883278264080:mysql-bin-changelog.157832:187600#93"

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

When you use this task setting with a source PostgreSQL database, a logical replication slot should already be created and associated with the source endpoint. You can verify this by setting the slotName extra connection attribute to the name of this logical replication slot. For more information, see Extra Connection Attributes When Using PostgreSQL as a Source for DMS.

startReplicationTask_cdcStopPosition :: Lens' StartReplicationTask (Maybe Text) Source #

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:2018-02-09T12:12:12”

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

startReplicationTask_cdcStartTime :: Lens' StartReplicationTask (Maybe UTCTime) Source #

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”

startReplicationTask_replicationTaskArn :: Lens' StartReplicationTask Text Source #

The Amazon Resource Name (ARN) of the replication task to be started.

Destructuring the Response

data StartReplicationTaskResponse Source #

See: newStartReplicationTaskResponse smart constructor.

Constructors

StartReplicationTaskResponse' 

Fields

Instances

Instances details
Eq StartReplicationTaskResponse Source # 
Instance details

Defined in Amazonka.DMS.StartReplicationTask

Read StartReplicationTaskResponse Source # 
Instance details

Defined in Amazonka.DMS.StartReplicationTask

Show StartReplicationTaskResponse Source # 
Instance details

Defined in Amazonka.DMS.StartReplicationTask

Generic StartReplicationTaskResponse Source # 
Instance details

Defined in Amazonka.DMS.StartReplicationTask

Associated Types

type Rep StartReplicationTaskResponse :: Type -> Type #

NFData StartReplicationTaskResponse Source # 
Instance details

Defined in Amazonka.DMS.StartReplicationTask

type Rep StartReplicationTaskResponse Source # 
Instance details

Defined in Amazonka.DMS.StartReplicationTask

type Rep StartReplicationTaskResponse = D1 ('MetaData "StartReplicationTaskResponse" "Amazonka.DMS.StartReplicationTask" "libZSservicesZSamazonka-dmsZSamazonka-dms" 'False) (C1 ('MetaCons "StartReplicationTaskResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "replicationTask") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ReplicationTask)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newStartReplicationTaskResponse Source #

Create a value of StartReplicationTaskResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:replicationTask:StartReplicationTaskResponse', startReplicationTaskResponse_replicationTask - The replication task started.

$sel:httpStatus:StartReplicationTaskResponse', startReplicationTaskResponse_httpStatus - The response's http status code.

Response Lenses