Request Syntax Request Parameters Response Syntax Response Elements Errors See Also

StartDataMigration

Starts the specified data migration.

Request Syntax


{
   "DataMigrationIdentifier": "string",
   "StartType": "string"
}

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

DataMigrationIdentifier

The identifier (name or ARN) of the data migration to start.

Type: String

Required: Yes

StartType

Specifies the start type for the data migration. Valid values include start-replication, reload-target, and resume-processing.

Type: String

Valid Values: reload-target | resume-processing | start-replication

Required: Yes

Response Syntax


{
   "DataMigration": { 
      "DataMigrationArn": "string",
      "DataMigrationCidrBlocks": [ "string" ],
      "DataMigrationCreateTime": "string",
      "DataMigrationEndTime": "string",
      "DataMigrationName": "string",
      "DataMigrationSettings": { 
         "CloudwatchLogsEnabled": boolean,
         "NumberOfJobs": number,
         "SelectionRules": "string"
      },
      "DataMigrationStartTime": "string",
      "DataMigrationStatistics": { 
         "CDCLatency": number,
         "ElapsedTimeMillis": number,
         "FullLoadPercentage": number,
         "StartTime": "string",
         "StopTime": "string",
         "TablesErrored": number,
         "TablesLoaded": number,
         "TablesLoading": number,
         "TablesQueued": number
      },
      "DataMigrationStatus": "string",
      "DataMigrationType": "string",
      "LastFailureMessage": "string",
      "MigrationProjectArn": "string",
      "PublicIpAddresses": [ "string" ],
      "ServiceAccessRoleArn": "string",
      "SourceDataSettings": [ 
         { 
            "CDCStartPosition": "string",
            "CDCStartTime": "string",
            "CDCStopTime": "string",
            "SlotName": "string"
         }
      ],
      "StopReason": "string"
   }
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

DataMigration

The data migration that DMS started.

Type: DataMigration object

Errors

For information about the errors that are common to all actions, see Common Errors.

FailedDependencyFault

A dependency threw an exception.

HTTP Status Code: 400

InvalidOperationFault

The action or operation requested isn't valid.

HTTP Status Code: 400

InvalidResourceStateFault

The resource is in a state that prevents it from being used for database migration.

HTTP Status Code: 400

ResourceNotFoundFault

The resource could not be found.

HTTP Status Code: 400

ResourceQuotaExceededFault

The quota for this resource quota has been exceeded.

HTTP Status Code: 400