---
title: "POST /v1/{+name}:restart"
method: POST
path: "/v1/{+name}:restart"
tags: ["projects"]
---

# POST /v1/{+name}:restart

`POST /v1/{+name}:restart`

Restart a stopped or failed migration job, resetting the destination instance to its original state and starting the migration process from scratch.

## Path parameters

- `name` string, required

## Request body

- RestartMigrationJobRequest — Request message for 'RestartMigrationJob' request.
  - `objectsFilter` MigrationJobObjectsConfig — Configuration for the objects to be migrated.
    - `sourceObjectsConfig` SourceObjectsConfig — List of configurations for the source objects to be migrated.
      - `objectsSelectionType` 'OBJECTS_SELECTION_TYPE_UNSPECIFIED' | 'ALL_OBJECTS' | 'SPECIFIED_OBJECTS' — Optional. The objects selection type of the migration job.
      - `objectConfigs` SourceObjectConfig[] — Optional. The list of the objects to be migrated.
        - `objectIdentifier` SourceObjectIdentifier — An identifier for the Migration Job Object.
          - `database` string — Optional. The database name. This will be required only if the object uses a database name as part of its unique identifier.
          - `table` string — Optional. The table name. This will be required only if the object is a level below database or schema.
          - `type` 'MIGRATION_JOB_OBJECT_TYPE_UNSPECIFIED' | 'DATABASE' | 'SCHEMA' | 'TABLE' — Required. The type of the migration job object.
          - `schema` string — Optional. The schema name. This will be required only if the object uses a schema name as part of its unique identifier.
  - `skipValidation` boolean — Optional. Restart the migration job without running prior configuration verification. Defaults to `false`.
  - `restartFailedObjects` boolean — Optional. If true, only failed objects will be restarted.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/datamigration.md) · [All operations](https://skmtc.dev/google/apis/datamigration/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/datamigration/revisions/d77bd66e25e6/schema)
