DatabaseMigrationService / Client / describe_replications

describe_replications#

DatabaseMigrationService.Client.describe_replications(**kwargs)#

Provides details on replication progress by returning status information for one or more provisioned DMS Serverless replications.

See also: AWS API Documentation

Request Syntax

response = client.describe_replications(
    Filters=[
        {
            'Name': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    MaxRecords=123,
    Marker='string'
)
Parameters:
  • Filters (list) –

    Filters applied to the replications.

    • (dict) –

      Identifies the name and value of a filter object. This filter is used to limit the number and type of DMS objects that are returned for a particular Describe* call or similar operation. Filters are used as an optional parameter for certain API operations.

      • Name (string) – [REQUIRED]

        The name of the filter as specified for a Describe* or similar operation.

      • Values (list) – [REQUIRED]

        The filter value, which can specify one or more values used to narrow the returned results.

        • (string) –

  • MaxRecords (integer) – The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

  • Marker (string) – An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

Return type:

dict

Returns:

Response Syntax

{
    'Marker': 'string',
    'Replications': [
        {
            '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),
            'ReplicationDeprovisionTime': datetime(2015, 1, 1)
        },
    ]
}

Response Structure

  • (dict) –

    • Marker (string) –

      An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

    • Replications (list) –

      The replication descriptions.

      • (dict) –

        Provides information that describes a serverless replication created by the CreateReplication operation.

        • 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.

        • ReplicationDeprovisionTime (datetime) –

          The timestamp when DMS will deprovision the replication.

Exceptions

  • DatabaseMigrationService.Client.exceptions.ResourceNotFoundFault