DatabaseMigrationService / Client / stop_replication

stop_replication

DatabaseMigrationService.Client.stop_replication(**kwargs)

For a given DMS Serverless replication configuration, DMS stops any and all ongoing DMS Serverless replications. This command doesn’t deprovision the stopped replications.

See also: AWS API Documentation

Request Syntax

response = client.stop_replication(
    ReplicationConfigArn='string'
)

Parameters:

ReplicationConfigArn (string) –

[REQUIRED]

The Amazon Resource Name of the replication to stop.

Return type:

dict

Returns:

Response Syntax

{
    'Replication': {
        'ReplicationConfigIdentifier': 'string',
        'ReplicationConfigArn': 'string',
        'SourceEndpointArn': 'string',
        'TargetEndpointArn': 'string',
        'ReplicationType': 'full-load'|'cdc'|'full-load-and-cdc',
        'Status': 'string',
        'ProvisionData': {
            'ProvisionState': 'string',
            'ProvisionedCapacityUnits': 123,
            'DateProvisioned': datetime(2015, 1, 1),
            'IsNewProvisioningAvailable': True|False,
            'DateNewProvisioningDataAvailable': datetime(2015, 1, 1),
            'ReasonForNewProvisioningData': 'string'
        },
        'StopReason': 'string',
        'FailureMessages': [
            'string',
        ],
        'ReplicationStats': {
            'FullLoadProgressPercent': 123,
            'ElapsedTimeMillis': 123,
            'TablesLoaded': 123,
            'TablesLoading': 123,
            'TablesQueued': 123,
            'TablesErrored': 123,
            'FreshStartDate': datetime(2015, 1, 1),
            'StartDate': datetime(2015, 1, 1),
            'StopDate': datetime(2015, 1, 1),
            'FullLoadStartDate': datetime(2015, 1, 1),
            'FullLoadFinishDate': datetime(2015, 1, 1)
        },
        'StartReplicationType': 'string',
        'CdcStartTime': datetime(2015, 1, 1),
        'CdcStartPosition': 'string',
        'CdcStopPosition': 'string',
        'RecoveryCheckpoint': 'string',
        'ReplicationCreateTime': datetime(2015, 1, 1),
        'ReplicationUpdateTime': datetime(2015, 1, 1),
        'ReplicationLastStopTime': datetime(2015, 1, 1)
    }
}

Response Structure

• (dict) –

  • Replication (dict) –

    The replication that DMS stopped.

    • ReplicationConfigIdentifier (string) –

      The identifier for the ReplicationConfig associated with the replication.

    • ReplicationConfigArn (string) –

      The Amazon Resource Name for the ReplicationConfig associated with the replication.

    • SourceEndpointArn (string) –

      The Amazon Resource Name for an existing Endpoint the serverless replication uses for its data source.

    • TargetEndpointArn (string) –

      The Amazon Resource Name for an existing Endpoint the serverless replication uses for its data target.

    • ReplicationType (string) –

      The type of the serverless replication.

    • Status (string) –

      The current status of the serverless replication.

    • ProvisionData (dict) –

      Information about provisioning resources for an DMS serverless replication.

      • ProvisionState (string) –

        The current provisioning state

      • ProvisionedCapacityUnits (integer) –

        The number of capacity units the replication is using.

      • DateProvisioned (datetime) –

        The timestamp when DMS provisioned replication resources.

      • IsNewProvisioningAvailable (boolean) –

        Whether the new provisioning is available to the replication.

      • DateNewProvisioningDataAvailable (datetime) –

        The timestamp when provisioning became available.

      • ReasonForNewProvisioningData (string) –

        A message describing the reason that DMS provisioned new resources for the serverless replication.

    • StopReason (string) –

      The reason the replication task was stopped. This response parameter can return one of the following values:

      • "Stop Reason NORMAL"

      • "Stop Reason RECOVERABLE_ERROR"

      • "Stop Reason FATAL_ERROR"

      • "Stop Reason FULL_LOAD_ONLY_FINISHED"

      • "Stop Reason STOPPED_AFTER_FULL_LOAD" – Full load completed, with cached changes not applied

      • "Stop Reason STOPPED_AFTER_CACHED_EVENTS" – Full load completed, with cached changes applied

      • "Stop Reason EXPRESS_LICENSE_LIMITS_REACHED"

      • "Stop Reason STOPPED_AFTER_DDL_APPLY" – User-defined stop task after DDL applied

      • "Stop Reason STOPPED_DUE_TO_LOW_MEMORY"

      • "Stop Reason STOPPED_DUE_TO_LOW_DISK"

      • "Stop Reason STOPPED_AT_SERVER_TIME" – User-defined server time for stopping task

      • "Stop Reason STOPPED_AT_COMMIT_TIME" – User-defined commit time for stopping task

      • "Stop Reason RECONFIGURATION_RESTART"

      • "Stop Reason RECYCLE_TASK"

    • FailureMessages (list) –

      Error and other information about why a serverless replication failed.

      • (string) –

    • ReplicationStats (dict) –

      This object provides a collection of statistics about a serverless replication.

      • FullLoadProgressPercent (integer) –

        The percent complete for the full load serverless replication.

      • ElapsedTimeMillis (integer) –

        The elapsed time of the replication, in milliseconds.

      • TablesLoaded (integer) –

        The number of tables loaded for this replication.

      • TablesLoading (integer) –

        The number of tables currently loading for this replication.

      • TablesQueued (integer) –

        The number of tables queued for this replication.

      • TablesErrored (integer) –

        The number of errors that have occured for this replication.

      • FreshStartDate (datetime) –

        The date the replication was started either with a fresh start or a target reload.

      • StartDate (datetime) –

        The date the replication is scheduled to start.

      • StopDate (datetime) –

        The date the replication was stopped.

      • FullLoadStartDate (datetime) –

        The date the replication full load was started.

      • FullLoadFinishDate (datetime) –

        The date the replication full load was finished.

    • StartReplicationType (string) –

      The replication type.

    • CdcStartTime (datetime) –

      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.

    • CdcStartPosition (string) –

      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.

    • CdcStopPosition (string) –

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

    • RecoveryCheckpoint (string) –

      Indicates the last checkpoint that occurred during a change data capture (CDC) operation. You can provide this value to the CdcStartPosition parameter to start a CDC operation that begins at that checkpoint.

    • ReplicationCreateTime (datetime) –

      The time the serverless replication was created.

    • ReplicationUpdateTime (datetime) –

      The time the serverless replication was updated.

    • ReplicationLastStopTime (datetime) –

      The timestamp when replication was last stopped.

Exceptions

• DatabaseMigrationService.Client.exceptions.ResourceNotFoundFault

• DatabaseMigrationService.Client.exceptions.InvalidResourceStateFault

• DatabaseMigrationService.Client.exceptions.AccessDeniedFault