Esta página se ha traducido con Cloud Translation API.

Gestionar tareas de migración con la API

MySQL | PostgreSQL | PostgreSQL a AlloyDB

Información general

En esta página se explica cómo usar la API de Database Migration Service para gestionar los trabajos de migración de una base de datos de origen PostgreSQL.

Hay dos formas de usar la API de Database Migration Service. Puedes hacer llamadas a la API REST o usar Google Cloud CLI (CLI).

Para ver información general sobre cómo usar gcloud para gestionar los trabajos de migración de Database Migration Service, haz clic aquí.

Crear un borrador de una tarea de migración

A continuación, se muestra una solicitud para crear una tarea de migración en modo borrador. De esta forma, no tendrás que crear la tarea de migración de una vez. Puedes crear una parte y, después, actualizarla con la operación PATCH.

Por ejemplo, si quieres crear un trabajo de migración, pero no tienes la base de datos de destino o el método de conectividad de red, puedes usar el siguiente código:

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

project-id: el ID del proyecto
region: la región del proyecto
migration-job-id: ID de la tarea de migración
migration-job-name: el nombre de la tarea de migración
source-connection-profile-id: ID de perfil de conexión de origen
destination-connection-profile-id: ID del perfil de conexión de destino
provider: el proveedor asociado al tipo de clasificación de la base de datos de origen.
- En el caso de una instancia de PostgreSQL independiente, usa DATABASE_PROVIDER_UNSPECIFIED, ya que este valor está asociado a una base de datos local.
- En el caso de una instancia de Cloud SQL para PostgreSQL, usa CLOUDSQL.
- En el caso de los servicios de bases de datos gestionadas, usa el valor ENUM correspondiente. Consulta la referencia del objeto DatabaseProvider.

Método HTTP y URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id

Cuerpo JSON de la solicitud:


{
  "displayName": "migration-job-name",
  "state": "DRAFT",
  "type": "CONTINUOUS",
  "source": "projects/project-id/locations/region/connectionProfiles/source-connection-profile-id",
  //"destination":"projects/project-id/locations/region/connectionProfiles/destination-connection-profile-id",
  "sourceDatabase": {
    "engine": "POSTGRESQL",
    "provider": "provider"
  },
  //"vpcPeeringConnectivity": {
  //"vpc": "default"
  //}
}

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id"

PowerShell (Windows)

Nota: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "name": "projects/project-id/locations/region/operations/operation-1591975557292-5a7e4b195623c-e350e3da-713dee7d",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T15:25:57.430715421Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Crear una tarea de migración continua con conectividad de intercambio de tráfico entre VPCs

A continuación, se muestra una solicitud para crear un trabajo de migración continua para migrar una base de datos de PostgreSQL (que se ejecuta en una VM de Google Compute Engine) a Cloud SQL para PostgreSQL mediante la conectividad de peering de VPC.

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

project-id: el ID del proyecto
region: la región del proyecto
migration-job-id: ID de la tarea de migración
migration-job-name: el nombre de la tarea de migración
source-connection-profile-id: ID de perfil de conexión de origen
destination-connection-profile-id: ID del perfil de conexión de destino
provider: el proveedor asociado al tipo de clasificación de la base de datos de origen.
- En el caso de una instancia de PostgreSQL independiente, usa DATABASE_PROVIDER_UNSPECIFIED, ya que este valor está asociado a una base de datos local.
- En el caso de una instancia de Cloud SQL para PostgreSQL, usa CLOUDSQL.
- En el caso de los servicios de bases de datos gestionadas, usa el valor ENUM correspondiente. Consulta la referencia del objeto DatabaseProvider.

Método HTTP y URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id

Cuerpo JSON de la solicitud:


{
  "displayName": "migration-job-name",
  "state": "NOT_STARTED",
  "type": "CONTINUOUS",
  "source": "projects/project-id/locations/region/connectionProfiles/source-connection-profile-id",
  "destination":"projects/project-id/locations/region/connectionProfiles/destination-connection-profile-id",
  "sourceDatabase": {
    "engine": "POSTGRESQL",
    "provider": "provider"
  },
  "vpcPeeringConnectivity": {
    "vpc": "default"
  }
}

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "name": "projects/project-id/locations/region/operations/operation-1591975557292-5a7e4b195623c-e350e3da-713dee7d",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T15:25:57.430715421Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Para obtener más información sobre cómo usar gcloud para crear tareas de migración de Database Migration Service, haz clic aquí.

Crear una tarea de migración continua con conectividad SSH inversa

A continuación, se muestra una solicitud para crear un trabajo de migración de ejecución continua para migrar una base de datos de PostgreSQL de Amazon RDS a Cloud SQL para PostgreSQL mediante conectividad SSH inversa.

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

project-id: el ID del proyecto
region: la región del proyecto
migration-job-id: ID de la tarea de migración
migration-job-name: el nombre de la tarea de migración
source-connection-profile-id: ID de perfil de conexión de origen
destination-connection-profile-id: ID del perfil de conexión de destino
vm-name: nombre de la VM SSH. Por ejemplo, dms-ssh-bastion.
vm-ip-address: la dirección IP de la VM SSH. Por ejemplo, 11.22.33.44.
vm-port: puerto de conexión de la VM SSH. Por ejemplo, 3306.
vpc-name: nombre de la red de VPC. Por ejemplo, projects/project-id/global/networks/test-network.
provider: el proveedor asociado al tipo de clasificación de la base de datos de origen.
- En el caso de una instancia de PostgreSQL independiente, usa DATABASE_PROVIDER_UNSPECIFIED, ya que este valor está asociado a una base de datos local.
- En el caso de una instancia de Cloud SQL para PostgreSQL, usa CLOUDSQL.
- En el caso de los servicios de bases de datos gestionadas, usa el valor ENUM correspondiente. Consulta la referencia del objeto DatabaseProvider.

Método HTTP y URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id

Cuerpo JSON de la solicitud:


{
  "displayName": "migration-job-name",
  "state": "NOT_STARTED",
  "type": "CONTINUOUS",
  "source": "projects/project-id/locations/region/connectionProfiles/source-connection-profile-id",
  "destination":"projects/project-id/locations/region/connectionProfiles/destination-connection-profile-id",
  
  "sourceDatabase": {
    "engine": "POSTGRESQL",
    "provider": "provider"
  },
  
  "reverseSshConnectivity": {
    "vm": "vm-name",
    "vm_ip": "vm-ip-address",
    "vm_port": vm-port,
    "vpc": "vpc-name"
  }
}

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Para obtener más información sobre cómo usar gcloud para crear tareas de migración de Database Migration Service, haz clic aquí.

Crear una tarea de migración con conectividad de lista de IPs permitidas

A continuación, se muestra una solicitud para crear un trabajo de migración para migrar una instancia de PostgreSQL independiente o un servicio de base de datos gestionado a una base de datos de Cloud SQL para PostgreSQL mediante una lista de permitidos de IPs.

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

project-id: el ID del proyecto
region: la región del proyecto
migration-job-id: ID de la tarea de migración
migration-job-name: el nombre de la tarea de migración
source-connection-profile-id: ID de perfil de conexión de origen
destination-connection-profile-id: ID del perfil de conexión de destino
provider: el proveedor asociado al tipo de clasificación de la base de datos de origen.
- En el caso de una instancia de PostgreSQL independiente, usa DATABASE_PROVIDER_UNSPECIFIED, ya que este valor está asociado a una base de datos local.
- En el caso de una instancia de Cloud SQL para PostgreSQL, usa CLOUDSQL.
- En el caso de los servicios de bases de datos gestionadas, usa el valor ENUM correspondiente. Consulta la referencia del objeto DatabaseProvider.

Método HTTP y URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id

Cuerpo JSON de la solicitud:


{
  "displayName": "migration-job-name",
  "state": "NOT_STARTED",
  "type": "CONTINUOUS",
  "source": "projects/project-id/locations/region/connectionProfiles/source-connection-profile-id",
  "destination":"projects/project-id/locations/region/connectionProfiles/destination-connection-profile-id",
  "sourceDatabase": {
    "engine": "POSTGRESQL",
    "provider": "provider"
  },
  "staticIpConnectivity": {}
}

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Para obtener más información sobre cómo usar gcloud para crear tareas de migración de Database Migration Service, haz clic aquí.

Obtener información sobre una tarea de migración

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

project-id: el ID del proyecto
region: la región del proyecto
migration-job-id: ID de la tarea de migración

Método HTTP y URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecuta el comando siguiente:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id"

PowerShell (Windows)

Ejecuta el comando siguiente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "name": "projects/project-id/locations/region/migrationJobs/one-time-vpc-job",
  "createTime": "2020-06-12T15:48:39.666093835Z",
  "updateTime": "2020-06-12T15:48:39.666093835Z",
  "displayName": "migration-job-display-name",
  "state": "CREATING",
  "type": "CONTINUOUS",
  "source": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
  "destination": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
  
  "sourceDatabase": {
    "engine": "POSTGRESQL"
  },
  "destinationDatabase": {
    "provider": "CLOUDSQL"
  },
  
  "vpcPeeringConnectivity": {
    "vpc": "default"
  }
}

gcloud

Para obtener más información sobre cómo usar gcloud para recuperar información sobre tu trabajo de migración, haz clic aquí.

Mostrar tareas de migración

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

project-id: el ID del proyecto
region: la región del proyecto

También puede filtrar la lista de tareas de migración que recupera Database Migration Service de la siguiente manera:

orderBy: Use este filtro para obtener una lista de todos los trabajos de migración de una región concreta en orden alfabético. Por ejemplo, el filtro orderBy=name devuelve todos los trabajos de migración ordenados alfabéticamente por nombre.
pageSize: Use este filtro para especificar el número máximo de tareas de migración que recupera y muestra el servicio de migración de bases de datos en una página. Por ejemplo, si se define pageSize=10, el servicio de migración de bases de datos devolverá hasta 10 tareas de migración por página.

Si hay más de 10 tareas de migración, aparecerán en otras páginas. Al final de cada página, aparecen un parámetro nextPageToken y un identificador único (por ejemplo, oasndfoasdnoasun1241243ojsandf). Utilice el identificador para obtener la lista de los trabajos de migración de la página siguiente. En la página final, no aparecen el parámetro nextPageToken ni el identificador único.

Método HTTP y URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecuta el comando siguiente:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs"

PowerShell (Windows)

Ejecuta el comando siguiente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "migrationJobs": [
    {
      "name": "projects/project-id/locations/region/migrationJobs/name-of-first-migration-job",
      "createTime": "2020-06-12T15:48:39.666093835Z",
      "updateTime": "2020-06-12T15:48:39.666093835Z",
      "displayName": "display-name-of-first-migration-job",
      "state": "NOT_STARTED",
      "type": "CONTINUOUS",
      "source": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
      "destination": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
      
      "sourceDatabase": {
        "engine": "POSTGRESQL"
      },
      "destinationDatabase": {
        "provider": "CLOUDSQL"
      },
      
      "vpcPeeringConnectivity": {
        "vpc": "default"
      }
    }
    {
      "name": "projects/project-id/locations/region/migrationJobs/name-of-second-migration-job",
      "createTime": "2021-02-13T11:59:39.104613835Z",
      "updateTime": "2021-02-13T12:01:38.666093835Z",
      "displayName": "display-name-of-second-migration-job",
      "state": "RUNNING",
      "type": "CONTINUOUS",
      "source": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
      "destination": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
      
      "sourceDatabase": {
        "engine": "POSTGRESQL"
      },
      "destinationDatabase": {
        "provider": "CLOUDSQL"
      },
      
      "staticIpConnectivity": {}
        "vpc": "default"
    }
  ],
  "nextPageToken": "unique-identifier"
}

gcloud

Para obtener más información sobre cómo usar gcloud para recuperar información sobre todas sus tareas de migración, haga clic aquí.

Generar una secuencia de comandos de configuración de túnel SSH para una tarea de migración

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

project-id: el ID del proyecto
region: la región del proyecto
migration-job-id: ID de la tarea de migración

Método HTTP y URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:generateSshScript

Cuerpo JSON de la solicitud:

{
  "vm":"vm-name",
  "vmCreationConfig":{
    "vmMachineType":"machine-type",
    "subnet":"subnet-name"
	}
}

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:generateSshScript"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:generateSshScript" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "generate",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Para obtener más información sobre cómo usar gcloud para generar una secuencia de comandos SSH para tu tarea de migración, haz clic aquí.

Verificar una tarea de migración

A continuación, se muestra una solicitud para verificar una tarea de migración. Al verificar una tarea de migración, puedes asegurarte de que se iniciará y se ejecutará correctamente.

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

project-id: el ID del proyecto
region: la región del proyecto
migration-job-id: ID de la tarea de migración

Método HTTP y URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:verify

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecuta el comando siguiente:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:verify"

PowerShell (Windows)

Ejecuta el comando siguiente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:verify" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "verify",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Para obtener más información sobre cómo usar gcloud para verificar tu tarea de migración, haz clic aquí.

Actualizar una tarea de migración

A continuación, se muestra una solicitud para actualizar el nombre visible de un trabajo de migración. Si usas el parámetro updateMask en la solicitud, solo es necesario incluir estos campos en el cuerpo de la solicitud.

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

project-id: el ID del proyecto
region: la región del proyecto
migration-job-id: ID de la tarea de migración

Método HTTP y URL:

PATCH https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?updateMask=displayName

Cuerpo JSON de la solicitud:

{
  "displayName": "updated-display-name",
}

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?updateMask=displayName"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?updateMask=displayName" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Para obtener más información sobre cómo usar gcloud para actualizar tu trabajo de migración, haz clic aquí.

Iniciar una tarea de migración

A continuación, se muestra una solicitud para iniciar una tarea de migración.

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

project-id: el ID del proyecto
region: la región del proyecto
migration-job-id: ID de la tarea de migración

Método HTTP y URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:start

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecuta el comando siguiente:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:start"

PowerShell (Windows)

Ejecuta el comando siguiente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:start" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "start",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Para obtener más información sobre cómo usar gcloud para iniciar el trabajo de migración, haz clic aquí.

Reiniciar una tarea de migración fallida

A continuación, se muestra una solicitud para reiniciar una tarea de migración. Una tarea de migración se puede reiniciar desde el principio si la migración ha fallado y no se puede recuperar, o si se ha detenido durante el volcado completo.

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

project-id: el ID del proyecto
region: la región del proyecto
migration-job-id: ID de la tarea de migración

Método HTTP y URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:restart

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecuta el comando siguiente:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:restart"

PowerShell (Windows)

Ejecuta el comando siguiente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:restart" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "restart",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Para obtener más información sobre cómo usar gcloud para reiniciar la tarea de migración, haz clic aquí.

Detener una tarea de migración

A continuación, se muestra una solicitud para detener una tarea de migración.

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

project-id: el ID del proyecto
region: la región del proyecto
migration-job-id: ID de la tarea de migración

Método HTTP y URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:stop

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecuta el comando siguiente:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:stop"

PowerShell (Windows)

Ejecuta el comando siguiente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:stop" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "stop",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Para obtener más información sobre cómo usar gcloud para detener un trabajo de migración, haz clic aquí.

Reanudar una tarea de migración

A continuación, se muestra una solicitud para reanudar una tarea de migración.

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

project-id: el ID del proyecto
region: la región del proyecto
migration-job-id: ID de la tarea de migración

Método HTTP y URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:resume

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecuta el comando siguiente:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:resume"

PowerShell (Windows)

Ejecuta el comando siguiente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:resume" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "resume",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Para obtener más información sobre cómo usar gcloud para reanudar la tarea de migración, haz clic aquí.

Promocionar una tarea de migración

A continuación, se muestra una solicitud para promocionar una tarea de migración.

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

project-id: el ID del proyecto
region: la región del proyecto
migration-job-id: ID de la tarea de migración

Método HTTP y URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:promote

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecuta el comando siguiente:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:promote"

PowerShell (Windows)

Ejecuta el comando siguiente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:promote" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "promote",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Para obtener más información sobre cómo usar gcloud para promocionar tu trabajo de migración, haz clic aquí.

Eliminar una tarea de migración

A continuación, se muestra una solicitud para eliminar una tarea de migración.

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

project-id: el ID del proyecto
region: la región del proyecto
migration-job-id: ID de la tarea de migración

Método HTTP y URL:

DELETE https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecuta el comando siguiente:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id"

PowerShell (Windows)

Ejecuta el comando siguiente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Para obtener más información sobre cómo usar gcloud para eliminar tu trabajo de migración, haz clic aquí.

Gestionar tareas de migración con la API Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Información general

Crear un borrador de una tarea de migración

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Crear una tarea de migración continua con conectividad de intercambio de tráfico entre VPCs

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

gcloud

Crear una tarea de migración continua con conectividad SSH inversa

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

gcloud

Crear una tarea de migración con conectividad de lista de IPs permitidas

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

gcloud

Obtener información sobre una tarea de migración

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

gcloud

Mostrar tareas de migración

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

gcloud

Generar una secuencia de comandos de configuración de túnel SSH para una tarea de migración

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

gcloud

Verificar una tarea de migración

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

gcloud

Actualizar una tarea de migración

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

gcloud

Iniciar una tarea de migración

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

gcloud

Reiniciar una tarea de migración fallida

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

gcloud

Detener una tarea de migración

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

gcloud

Reanudar una tarea de migración

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

gcloud

Promocionar una tarea de migración

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

gcloud

Eliminar una tarea de migración

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

gcloud

Gestionar tareas de migración con la API