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 destino AlloyDB.
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.
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" }, //"vpcPeeringConnectivity": { //"vpc": "default" //} }
Para enviar su solicitud, expanda una de estas opciones:
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 de PostgreSQL a AlloyDB (que se ejecuta en una máquina virtual de Google Compute Engine) a Cloud SQL para PostgreSQL a AlloyDB, usando 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.
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" }, "vpcPeeringConnectivity": { "vpc": "default" } }
Para enviar su solicitud, expanda una de estas opciones:
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 de Amazon RDS PostgreSQL a AlloyDB a Cloud SQL para PostgreSQL a AlloyDB, 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 independiente de PostgreSQL a AlloyDB, utilice
DATABASE_PROVIDER_UNSPECIFIED
porque este valor está asociado con una base de datos local. - Para una instancia de Cloud SQL para PostgreSQL a AlloyDB, use
CLOUDSQL
. - Para cualquier servicio de base de datos administrado, utilice su valor
ENUM
correspondiente. Consulte la referencia del objetoDatabaseProvider
.
- Para una instancia independiente de PostgreSQL a AlloyDB, utilice
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:
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:
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": "ALLOYDB" }, "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
-
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 filtroorderBy=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 bases de datos recupera y muestra en una página. Por ejemplo, al establecerpageSize=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:
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": "ALLOYDB" }, "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": "ALLOYDB" }, "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:
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:
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:
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:
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:
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:
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:
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:
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:
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í .
A menos que se indique lo contrario, el contenido de esta página está sujeto a la licencia Reconocimiento 4.0 de Creative Commons y las muestras de código están sujetas a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio web de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-05-15 (UTC).