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

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

MySQL | PostgreSQL | PostgreSQL a AlloyDB

Descripción general

En esta página, aprenderá a utilizar la API del servicio de migración de bases de datos para administrar trabajos de migración para una base de datos de origen PostgreSQL.

Hay dos formas de utilizar la API del servicio de migración de bases de datos. Puede realizar llamadas a la API REST o puede utilizar la CLI de Google Cloud (CLI).

Para ver información de alto nivel sobre el uso de gcloud para administrar trabajos de migración del Servicio de migración de bases de datos, haga clic aquí .

Crear un borrador de un trabajo de migración

A continuación se muestra una solicitud para crear un trabajo de migración en modo borrador. De esta manera, no es necesario crear el trabajo de migración de una sola vez. Puede crear una parte y luego actualizarla mediante la operación PATCH .

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

DESCANSAR

Antes de utilizar cualquiera de los datos de la solicitud, realice los siguientes reemplazos:

project-id : el ID del proyecto.
region : La región del proyecto
migration-job-id : el ID del trabajo de migración.
migration-job-name : El nombre del trabajo de migración
source-connection-profile-id : ID del perfil de conexión de origen
destination-connection-profile-id : ID del perfil de conexión de destino.
provider : El proveedor asociado con el tipo de clasificación de la base de datos de origen.
- Para una instancia de PostgreSQL independiente, utilice DATABASE_PROVIDER_UNSPECIFIED porque este valor está asociado con una base de datos local.
- Para una instancia de Cloud SQL para PostgreSQL, use CLOUDSQL .
- Para cualquier servicio de base de datos administrado, utilice su valor ENUM correspondiente. Consulte 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

Solicitar cuerpo JSON:


{
  "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 su solicitud, expanda una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: El siguiente comando supone que iniciaste sesión en la CLI gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o usando Cloud Shell , que inicia sesión automáticamente en la CLI gcloud . Puedes verificar la cuenta actualmente activa ejecutando gcloud auth list .

Guarde el cuerpo de la solicitud en un archivo llamado request.json y ejecute 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 supone que has iniciado sesión en la CLI gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Puedes verificar la cuenta actualmente activa ejecutando gcloud auth list .

Guarde el cuerpo de la solicitud en un archivo llamado request.json y ejecute 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ía 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
}

Cree un trabajo de migración continua con conectividad de peering de VPC

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

DESCANSAR

Antes de utilizar cualquiera de los datos de la solicitud, realice los siguientes reemplazos:

project-id : el ID del proyecto.
region : La región del proyecto
migration-job-id : el ID del trabajo de migración.
migration-job-name : El nombre del trabajo de migración
source-connection-profile-id : ID del perfil de conexión de origen
destination-connection-profile-id : ID del perfil de conexión de destino.
provider : El proveedor asociado con el tipo de clasificación de la base de datos de origen.
- Para una instancia de PostgreSQL independiente, utilice DATABASE_PROVIDER_UNSPECIFIED porque este valor está asociado con una base de datos local.
- Para una instancia de Cloud SQL para PostgreSQL, use CLOUDSQL .
- Para cualquier servicio de base de datos administrado, utilice su valor ENUM correspondiente. Consulte 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

Solicitar cuerpo JSON:


{
  "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 su solicitud, expanda una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarde el cuerpo de la solicitud en un archivo llamado request.json y ejecute 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)

Guarde el cuerpo de la solicitud en un archivo llamado request.json y ejecute 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ía 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
}

nube de gcloud

Para obtener más información sobre el uso de gcloud para crear trabajos de migración del Servicio de migración de bases de datos, haga clic aquí .

Cree un trabajo de migración continua con conectividad SSH inversa

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

DESCANSAR

Antes de utilizar cualquiera de los datos de la solicitud, realice los siguientes reemplazos:

project-id : el ID del proyecto.
region : La región del proyecto
migration-job-id : el ID del trabajo de migración.
migration-job-name : El nombre del trabajo de migración
source-connection-profile-id : ID del perfil de conexión de origen
destination-connection-profile-id : ID del perfil de conexión de destino.
vm-name : el nombre de la máquina virtual SSH. Por ejemplo, dms-ssh-bastion.
vm-ip-address : la dirección IP de la máquina virtual SSH. Por ejemplo, 11.22.33.44.
vm-port : el puerto de conexión de la máquina virtual SSH. Por ejemplo, 3306.
vpc-name : el nombre de la red VPC. Por ejemplo, proyectos/ project-id /global/networks/test-network.
provider : El proveedor asociado con el tipo de clasificación de la base de datos de origen.
- Para una instancia de PostgreSQL independiente, utilice DATABASE_PROVIDER_UNSPECIFIED porque este valor está asociado con una base de datos local.
- Para una instancia de Cloud SQL para PostgreSQL, use CLOUDSQL .
- Para cualquier servicio de base de datos administrado, utilice su valor ENUM correspondiente. Consulte 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

Solicitar cuerpo JSON:


{
  "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 su solicitud, expanda una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarde el cuerpo de la solicitud en un archivo llamado request.json y ejecute 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)

Guarde el cuerpo de la solicitud en un archivo llamado request.json y ejecute 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ía 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
}

nube de gcloud

Para obtener más información sobre el uso de gcloud para crear trabajos de migración del Servicio de migración de bases de datos, haga clic aquí .

Crear un trabajo de migración con conectividad de lista de direcciones IP 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 administrado a una base de datos de Cloud SQL para PostgreSQL, usando una lista de direcciones IP permitidas.

DESCANSAR

Antes de utilizar cualquiera de los datos de la solicitud, realice los siguientes reemplazos:

project-id : el ID del proyecto.
region : La región del proyecto
migration-job-id : el ID del trabajo de migración.
migration-job-name : El nombre del trabajo de migración
source-connection-profile-id : ID del perfil de conexión de origen
destination-connection-profile-id : ID del perfil de conexión de destino.
provider : El proveedor asociado con el tipo de clasificación de la base de datos de origen.
- Para una instancia de PostgreSQL independiente, utilice DATABASE_PROVIDER_UNSPECIFIED porque este valor está asociado con una base de datos local.
- Para una instancia de Cloud SQL para PostgreSQL, use CLOUDSQL .
- Para cualquier servicio de base de datos administrado, utilice su valor ENUM correspondiente. Consulte 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

Solicitar cuerpo JSON:


{
  "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 su solicitud, expanda una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarde el cuerpo de la solicitud en un archivo llamado request.json y ejecute 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)

Guarde el cuerpo de la solicitud en un archivo llamado request.json y ejecute 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ía 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
}

nube de gcloud

Para obtener más información sobre el uso de gcloud para crear trabajos de migración del Servicio de migración de bases de datos, haga clic aquí .

Obtener información sobre un trabajo de migración

DESCANSAR

Antes de utilizar cualquiera de los datos de la solicitud, realice los siguientes reemplazos:

project-id : el ID del proyecto.
region : La región del proyecto
migration-job-id : el ID del trabajo 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 su solicitud, expanda una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecute el siguiente comando:

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)

Ejecute el siguiente comando:

$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ía 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"
  }
}

nube de gcloud

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

Listar trabajos de migración

DESCANSAR

Antes de utilizar cualquiera de los datos de la solicitud, realice los siguientes reemplazos:

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

También puede filtrar la lista de trabajos de migración que recupera el Servicio de migración de base de datos, de la siguiente manera:

orderBy: utilice este filtro para recuperar una lista de todos los trabajos de migración para una región particular en orden alfabético. Por ejemplo, el filtro orderBy=name devuelve todos los trabajos de migración, alfabéticamente, por nombre.
pageSize: utilice este filtro para especificar el número máximo de trabajos de migración que el Servicio de migración de base de datos recupera y muestra en una página. Por ejemplo, al establecer pageSize=10 , el servicio de migración de bases de datos devolverá hasta 10 trabajos de migración para una página.

Si hay más de 10 trabajos 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 recuperar la lista de trabajos de migración para la siguiente página. En la página final, el parámetro nextPageToken y el identificador único no aparecen.

Método HTTP y URL:

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

Para enviar su solicitud, expanda una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecute el siguiente comando:

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

PowerShell (Windows)

Ejecute el siguiente comando:

$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ía 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"
}

nube de gcloud

Para obtener más información sobre el uso gcloud para recuperar información sobre todos tus trabajos de migración, haz clic aquí .

Genere un script de configuración de túnel SSH para un trabajo de migración

DESCANSAR

Antes de utilizar cualquiera de los datos de la solicitud, realice los siguientes reemplazos:

project-id : el ID del proyecto.
region : La región del proyecto
migration-job-id : el ID del trabajo de migración.

Método HTTP y URL:

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

Solicitar cuerpo JSON:

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

Para enviar su solicitud, expanda una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarde el cuerpo de la solicitud en un archivo llamado request.json y ejecute 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)

Guarde el cuerpo de la solicitud en un archivo llamado request.json y ejecute 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ía 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
}

nube de gcloud

Para obtener más información sobre el uso de gcloud para generar un script SSH para tu trabajo de migración, haz clic aquí .

Verificar un trabajo de migración

A continuación se muestra una solicitud para verificar un trabajo de migración. Al verificar un trabajo de migración, puede asegurarse de que el trabajo se iniciará y ejecutará correctamente.

DESCANSAR

Antes de utilizar cualquiera de los datos de la solicitud, realice los siguientes reemplazos:

project-id : el ID del proyecto.
region : La región del proyecto
migration-job-id : el ID del trabajo 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 su solicitud, expanda una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecute el siguiente comando:

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)

Ejecute el siguiente comando:

$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ía 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
}

nube de gcloud

Para obtener más información sobre el uso de gcloud para verificar tu trabajo de migración, haz clic aquí .

Actualizar un trabajo de migración

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

DESCANSAR

Antes de utilizar cualquiera de los datos de la solicitud, realice los siguientes reemplazos:

project-id : el ID del proyecto.
region : La región del proyecto
migration-job-id : el ID del trabajo 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

Solicitar cuerpo JSON:

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

Para enviar su solicitud, expanda una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarde el cuerpo de la solicitud en un archivo llamado request.json y ejecute 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)

Guarde el cuerpo de la solicitud en un archivo llamado request.json y ejecute 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ía 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
}

nube de gcloud

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

Iniciar un trabajo de migración

A continuación se muestra una solicitud para iniciar un trabajo de migración.

DESCANSAR

Antes de utilizar cualquiera de los datos de la solicitud, realice los siguientes reemplazos:

project-id : el ID del proyecto.
region : La región del proyecto
migration-job-id : el ID del trabajo 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 su solicitud, expanda una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecute el siguiente comando:

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)

Ejecute el siguiente comando:

$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ía 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
}

nube de gcloud

Para obtener más información sobre el uso de gcloud para iniciar su trabajo de migración, haga clic aquí .

Reiniciar un trabajo de migración fallido

A continuación se muestra una solicitud para reiniciar un trabajo de migración. Un trabajo de migración se puede reiniciar desde el principio si la migración falló y no es recuperable, o si se detuvo durante el volcado completo.

DESCANSAR

Antes de utilizar cualquiera de los datos de la solicitud, realice los siguientes reemplazos:

project-id : el ID del proyecto.
region : La región del proyecto
migration-job-id : el ID del trabajo 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 su solicitud, expanda una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecute el siguiente comando:

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)

Ejecute el siguiente comando:

$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ía 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
}

nube de gcloud

Para obtener más información sobre el uso de gcloud para reiniciar tu trabajo de migración, haz clic aquí .

Detener un trabajo de migración

A continuación se muestra una solicitud para detener un trabajo de migración.

DESCANSAR

Antes de utilizar cualquiera de los datos de la solicitud, realice los siguientes reemplazos:

project-id : el ID del proyecto.
region : La región del proyecto
migration-job-id : el ID del trabajo 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 su solicitud, expanda una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecute el siguiente comando:

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)

Ejecute el siguiente comando:

$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ía 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
}

nube de gcloud

Para obtener más información sobre el uso de gcloud para detener tu trabajo de migración, haz clic aquí .

Reanudar un trabajo de migración

A continuación se muestra una solicitud para reanudar un trabajo de migración.

DESCANSAR

Antes de utilizar cualquiera de los datos de la solicitud, realice los siguientes reemplazos:

project-id : el ID del proyecto.
region : La región del proyecto
migration-job-id : el ID del trabajo 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 su solicitud, expanda una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecute el siguiente comando:

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)

Ejecute el siguiente comando:

$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ía 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
}

nube de gcloud

Para obtener más información sobre el uso de gcloud para reanudar tu trabajo de migración, haz clic aquí .

Promocionar un trabajo de migración

A continuación se muestra una solicitud para promover un trabajo de migración.

DESCANSAR

Antes de utilizar cualquiera de los datos de la solicitud, realice los siguientes reemplazos:

project-id : el ID del proyecto.
region : La región del proyecto
migration-job-id : el ID del trabajo 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 su solicitud, expanda una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecute el siguiente comando:

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)

Ejecute el siguiente comando:

$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ía 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
}

nube de gcloud

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

Eliminar un trabajo de migración

A continuación se muestra una solicitud para eliminar un trabajo de migración.

DESCANSAR

Antes de utilizar cualquiera de los datos de la solicitud, realice los siguientes reemplazos:

project-id : el ID del proyecto.
region : La región del proyecto
migration-job-id : el ID del trabajo 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 su solicitud, expanda una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecute el siguiente comando:

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)

Ejecute el siguiente comando:

$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ía 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
}

nube de gcloud

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

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

Descripción general

Crear un borrador de un trabajo de migración

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Cree un trabajo de migración continua con conectividad de peering de VPC

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Cree un trabajo de migración continua con conectividad SSH inversa

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Crear un trabajo de migración con conectividad de lista de direcciones IP permitidas

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Obtener información sobre un trabajo de migración

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Listar trabajos de migración

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Genere un script de configuración de túnel SSH para un trabajo de migración

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Verificar un trabajo de migración

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Actualizar un trabajo de migración

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Iniciar un trabajo de migración

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Reiniciar un trabajo de migración fallido

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Detener un trabajo de migración

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Reanudar un trabajo de migración

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Promocionar un trabajo de migración

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Eliminar un trabajo de migración

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

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