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

Administrar perfiles de conexió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 perfiles de conexión para una base de datos de origen PostgreSQL y un 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 los perfiles de conexión del Servicio de migración de bases de datos, haga clic aquí .

Crear un perfil de conexión para una base de datos fuente PostgreSQL

A continuación se muestra una solicitud para crear un perfil de conexión para una base de datos de origen PostgreSQL.

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
connection-profile-id : ID del perfil de conexión.
connection-profile-display-name : el nombre para mostrar del perfil de conexión.
host-ip-address : la dirección IP de origen
username : el nombre de usuario de la base de datos
password : la contraseña del usuario de la base de datos

Método HTTP y URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id

Solicitar cuerpo JSON:

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/connectionProfiles?connectionProfileId=connection-profile-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/connectionProfiles?connectionProfileId=connection-profile-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/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

nube de gcloud

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

Después de la creación, puede ver la información sobre su perfil de conexión llamando al método connectionProfiles/get .

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
connection-profile-id : ID del perfil de conexión.

Método HTTP y URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-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/connectionProfiles/connection-profile-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/connectionProfiles/connection-profile-id" | Select-Object -Expand Content

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

nube de gcloud

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

Crear un perfil de conexión para una base de datos de origen de Cloud SQL para PostgreSQL

A continuación se muestra una solicitud para crear un perfil de conexión para una base de datos de origen de Cloud SQL para PostgreSQL. Este ejemplo utiliza un perfil de conexión de PostgreSQL porque se conecta al motor de base de datos de PostgreSQL y no a la capa de administración de Cloud SQL.

Para crear el emparejamiento entre el origen y la réplica usando Cloud SQL, debes proporcionar el ID de instancia para tu base de datos de Cloud SQL. Puede encontrar el valor de ID de instancia utilizando el método databases/list de la API de administración de Cloud SQL.

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
connection-profile-id : ID del perfil de conexión.
connection-profile-display-name : el nombre para mostrar del perfil de conexión.
host-ip-address : la dirección IP de origen
username : el nombre de usuario de la base de datos
password : la contraseña del usuario de la base de datos
cloud-sql-instance-id : el ID de la instancia de Cloud SQL.

Método HTTP y URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id

Solicitar cuerpo JSON:

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/connectionProfiles?connectionProfileId=connection-profile-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/connectionProfiles?connectionProfileId=connection-profile-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/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

nube de gcloud

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

Cree un perfil de conexión para un destino AlloyDB para PostgreSQL

A continuación se muestra una solicitud para crear un perfil de conexión para un destino AlloyDB para PostgreSQL. El servicio de migración de bases de datos utiliza la información de esta solicitud para crear una nueva instancia de AlloyDB.

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
connection-profile-id : ID del perfil de conexión.
connection-profile-display-name : el nombre para mostrar del perfil de conexión.
cluster-id : El ID del clúster de AlloyDB para crear
user : el nombre de usuario que se le dará al usuario inicial.
password : La contraseña para darle al usuario inicial
vpc-network : la red VPC a la que se conectará el clúster AlloyDB.
instance-id : El ID de instancia de AlloyDB para crear
cpu-count : el número de CPU con las que configurar la instancia.

Todos los datos almacenados dentro Google Cloud se cifra en reposo utilizando los mismos sistemas de administración de claves reforzados que utilizamos para nuestros propios datos cifrados. Estos sistemas de administración de claves brindan auditorías y controles estrictos de acceso a las claves, y cifran los datos del usuario en reposo utilizando los estándares de cifrado AES-256. No se requiere instalación, configuración ni administración. Google CloudEl cifrado en reposo predeterminado de es la mejor opción para los usuarios que no tienen requisitos específicos relacionados con el cumplimiento o la localidad del material criptográfico.

Método HTTP y URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id

Solicitar cuerpo JSON:

{
  "displayName": "connection-profile-display-name",
  "alloydb": {
    "cluster_id": "cluster-id"
    "settings": {
      "initial_user": {
        "user": "user",
        "password": "password",
      }
      "vpc_network": "vpc-network",
      "primary_instance_settings": {
        "id": "instance-id",
        "machine_config": {
          "cpu_count": cpu-count
        }
      }
    }
  }
}

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/connectionProfiles?connectionProfileId=connection-profile-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/connectionProfiles?connectionProfileId=connection-profile-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/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

nube de gcloud

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

Obtener información sobre un perfil de conexió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
connection-profile-id : ID del perfil de conexión.

Método HTTP y URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-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/connectionProfiles/connection-profile-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/connectionProfiles/connection-profile-id" | Select-Object -Expand Content

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

nube de gcloud

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

Listar perfiles de conexión

A continuación se muestra una solicitud para recuperar información sobre todos sus perfiles de conexió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 perfiles de conexió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 perfiles de conexión para una región particular en orden alfabético. Por ejemplo, el filtro orderBy=name devuelve todos los perfiles de conexión, alfabéticamente, por nombre.
pageSize: utilice este filtro para especificar el número máximo de perfiles de conexión que el Servicio de migración de bases de datos recupera y muestra en una página. Por ejemplo, al configurar pageSize=10 , el servicio de migración de bases de datos devolverá hasta 10 perfiles de conexión para una página.

Si hay más de 10 perfiles de conexión, aparecerán en otras páginas. Al final de cada página, aparece un parámetro nextPageToken y un identificador único. Utilice el identificador para recuperar la lista de perfiles de conexión para la siguiente página.

Método HTTP y URL:

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

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/connectionProfiles"

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/connectionProfiles" | Select-Object -Expand Content

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

nube de gcloud

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

Actualizar un perfil de conexión

A continuación se muestra una solicitud para actualizar los campos de nombre de usuario y contraseña de un perfil de conexió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
connection-profile-id : ID del perfil de conexión.
username : el nombre de usuario de la base de datos
password : la contraseña del usuario de la base de datos

Método HTTP y URL:

PATCH

Solicitar cuerpo JSON:

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 \
     ""

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 "" | 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/connectionProfiles/connection-profile-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 su perfil de conexión, haga clic aquí .

Eliminar un perfil de conexión

Importante: Puede eliminar un perfil de conexión solo si no hay trabajos de migración activos asociados con el perfil. Si un perfil de conexión tiene trabajos de migración activos, promueva o elimine los trabajos.

Para ver si un perfil de conexión tiene trabajos de migración activos asociados, ejecute el siguiente comando:

GET https://datamigration.googleapis.com/v1/projects/ project-id /locations/ region /migrationJobs?filter=state: STATE_NAME OR state: STATE_NAME AND source:projects/ project-id /locations/ region /connectionProfiles/ connection-profile-id

Por ejemplo:

GET https://datamigration.googleapis.com/v1/projects/myproject/locations/myregion/migrationJobs?filter=state:RUNNING OR state:FAILED AND source:projects/myproject/locations/myregion/connectionProfiles/postgresql-to-alloydb-src1

Los distintos estados (estados) del trabajo de migración son:

NOT STARTED: el trabajo de migración se crea, pero no se ha iniciado.
STARTING: El trabajo de migración está en proceso de iniciarse.
RUNNING: el trabajo de migración se está ejecutando y se puede utilizar para migrar datos desde la base de datos de origen a la base de datos de destino.
STOPPING: El trabajo de migración está en proceso de detenerse.
STOPPED: el trabajo de migración está en pausa y ya no migra datos a la base de datos de destino.
RESUMING: el trabajo de migración pausado se está ejecutando.
FAILED: Se produjo un problema mientras se ejecutaba el trabajo de migración.
RESTARTING: el servicio de migración de bases de datos toma una nueva instantánea de la base de datos de origen, carga el volcado inicial en la base de datos de destino y procesa los cambios continuos de datos desde la base de datos de origen a la base de datos de destino.

Si un usuario tiene un trabajo de migración en cualquiera de estos estados y si intenta eliminar el perfil de conexión, fallará.

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
connection-profile-id : ID del perfil de conexión.

Método HTTP y URL:

DELETE https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-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/connectionProfiles/connection-profile-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/connectionProfiles/connection-profile-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/connectionProfiles/connection-profile-id",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

nube de gcloud

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

Eliminar un perfil de conexión y la instancia de AlloyDB asociada

A continuación se muestra una solicitud para eliminar un perfil de conexión de destino, así como la eliminación en cascada de la instancia de AlloyDB asociada.

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
connection-profile-id : ID del perfil de conexión.

Método HTTP y URL:

DELETE https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?force=true

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/connectionProfiles/connection-profile-id?force=true"

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/connectionProfiles/connection-profile-id?force=true" | 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/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

nube de gcloud

Para obtener más información sobre el uso gcloud para eliminar tanto su perfil de conexión como la instancia de AlloyDB asociada, haga clic aquí .

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 perfiles de conexión para una base de datos de origen PostgreSQL y un 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 los perfiles de conexión del Servicio de migración de bases de datos, haga clic aquí .

Crear un perfil de conexión para una base de datos fuente PostgreSQL

A continuación se muestra una solicitud para crear un perfil de conexión para una base de datos de origen PostgreSQL.

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
connection-profile-id : ID del perfil de conexión.
connection-profile-display-name : el nombre para mostrar del perfil de conexión.
host-ip-address : la dirección IP de origen
username : el nombre de usuario de la base de datos
password : la contraseña del usuario de la base de datos

Método HTTP y URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id

Solicitar cuerpo JSON:

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/connectionProfiles?connectionProfileId=connection-profile-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/connectionProfiles?connectionProfileId=connection-profile-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/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

nube de gcloud

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

Después de la creación, puede ver la información sobre su perfil de conexión llamando al método connectionProfiles/get .

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
connection-profile-id : ID del perfil de conexión.

Método HTTP y URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-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/connectionProfiles/connection-profile-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/connectionProfiles/connection-profile-id" | Select-Object -Expand Content

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

nube de gcloud

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

Crear un perfil de conexión para una base de datos de origen de Cloud SQL para PostgreSQL

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
connection-profile-id : ID del perfil de conexión.
connection-profile-display-name : el nombre para mostrar del perfil de conexión.
host-ip-address : la dirección IP de origen
username : el nombre de usuario de la base de datos
password : la contraseña del usuario de la base de datos
cloud-sql-instance-id : el ID de la instancia de Cloud SQL.

Método HTTP y URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id

Solicitar cuerpo JSON:

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/connectionProfiles?connectionProfileId=connection-profile-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/connectionProfiles?connectionProfileId=connection-profile-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/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

nube de gcloud

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

Cree un perfil de conexión para un destino AlloyDB para PostgreSQL

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
connection-profile-id : ID del perfil de conexión.
connection-profile-display-name : el nombre para mostrar del perfil de conexión.
cluster-id : El ID del clúster de AlloyDB para crear
user : el nombre de usuario que se le dará al usuario inicial.
password : La contraseña para darle al usuario inicial
vpc-network : la red VPC a la que se conectará el clúster AlloyDB.
instance-id : El ID de instancia de AlloyDB para crear
cpu-count : el número de CPU con las que configurar la instancia.

Método HTTP y URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id

Solicitar cuerpo JSON:

{
  "displayName": "connection-profile-display-name",
  "alloydb": {
    "cluster_id": "cluster-id"
    "settings": {
      "initial_user": {
        "user": "user",
        "password": "password",
      }
      "vpc_network": "vpc-network",
      "primary_instance_settings": {
        "id": "instance-id",
        "machine_config": {
          "cpu_count": cpu-count
        }
      }
    }
  }
}

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/connectionProfiles?connectionProfileId=connection-profile-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/connectionProfiles?connectionProfileId=connection-profile-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/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

nube de gcloud

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

Obtener información sobre un perfil de conexió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
connection-profile-id : ID del perfil de conexión.

Método HTTP y URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-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/connectionProfiles/connection-profile-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/connectionProfiles/connection-profile-id" | Select-Object -Expand Content

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

nube de gcloud

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

Listar perfiles de conexión

A continuación se muestra una solicitud para recuperar información sobre todos sus perfiles de conexió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 perfiles de conexió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 perfiles de conexión para una región particular en orden alfabético. Por ejemplo, el filtro orderBy=name devuelve todos los perfiles de conexión, alfabéticamente, por nombre.
pageSize: utilice este filtro para especificar el número máximo de perfiles de conexión que el Servicio de migración de bases de datos recupera y muestra en una página. Por ejemplo, al configurar pageSize=10 , el servicio de migración de bases de datos devolverá hasta 10 perfiles de conexión para una página.

Método HTTP y URL:

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

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/connectionProfiles"

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/connectionProfiles" | Select-Object -Expand Content

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

nube de gcloud

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

Actualizar un perfil de conexió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
connection-profile-id : ID del perfil de conexión.
username : el nombre de usuario de la base de datos
password : la contraseña del usuario de la base de datos

Método HTTP y URL:

PATCH

Solicitar cuerpo JSON:

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 \
     ""

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 "" | 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/connectionProfiles/connection-profile-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 su perfil de conexión, haga clic aquí .

Eliminar un perfil de conexión

Para ver si un perfil de conexión tiene trabajos de migración activos asociados, ejecute el siguiente comando:

Por ejemplo:

Los distintos estados (estados) del trabajo de migración son:

NOT STARTED: el trabajo de migración se crea, pero no se ha iniciado.
STARTING: El trabajo de migración está en proceso de iniciarse.
RUNNING: el trabajo de migración se está ejecutando y se puede utilizar para migrar datos desde la base de datos de origen a la base de datos de destino.
STOPPING: El trabajo de migración está en proceso de detenerse.
STOPPED: el trabajo de migración está en pausa y ya no migra datos a la base de datos de destino.
RESUMING: el trabajo de migración pausado se está ejecutando.
FAILED: Se produjo un problema mientras se ejecutaba el trabajo de migración.
RESTARTING: el servicio de migración de bases de datos toma una nueva instantánea de la base de datos de origen, carga el volcado inicial en la base de datos de destino y procesa los cambios continuos de datos desde la base de datos de origen a la base de datos de destino.

Si un usuario tiene un trabajo de migración en cualquiera de estos estados y si intenta eliminar el perfil de conexión, fallará.

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
connection-profile-id : ID del perfil de conexión.

Método HTTP y URL:

DELETE https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-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/connectionProfiles/connection-profile-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/connectionProfiles/connection-profile-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/connectionProfiles/connection-profile-id",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

nube de gcloud

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

Eliminar un perfil de conexión y la instancia de AlloyDB asociada

A continuación se muestra una solicitud para eliminar un perfil de conexión de destino, así como la eliminación en cascada de la instancia de AlloyDB asociada.

DESCANSAR

Antes de usar cualquiera de los datos de solicitud, haga los siguientes reemplazos:

project-id : la identificación del proyecto
region : la región del proyecto
connection-profile-id : la identificación del perfil de conexión

Método HTTP y URL:

DELETE https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?force=true

Para enviar su solicitud, expanda una de estas opciones:

Curl (Linux, macOS o Shell Shell)

Nota: El siguiente comando supone que ha iniciado sesión en la CLI gcloud con su cuenta de usuario ejecutando gcloud init o gcloud auth login , o utilizando Cloud Shell , que lo registra automáticamente en el CLI gcloud . Puede consultar la cuenta actualmente activa ejecutando gcloud auth list .

Ejecutar el siguiente comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?force=true"

PowerShell (Windows)

Nota: El siguiente comando supone que ha iniciado sesión en la CLI gcloud con su cuenta de usuario ejecutando gcloud init o gcloud auth login . Puede consultar la cuenta actualmente activa ejecutando gcloud auth list .

Ejecutar 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/connectionProfiles/connection-profile-id?force=true" | 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/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

nube de gcloud

Para obtener más información sobre el uso de gcloud para eliminar tanto su perfil de conexión como la instancia de AlloyDB asociada, haga clic aquí .

Administrar perfiles de conexión usando la API Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Descripción general

Crear un perfil de conexión para una base de datos fuente PostgreSQL

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Crear un perfil de conexión para una base de datos de origen de Cloud SQL para PostgreSQL

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Cree un perfil de conexión para un destino AlloyDB para PostgreSQL

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Obtener información sobre un perfil de conexión

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Listar perfiles de conexión

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Actualizar un perfil de conexión

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Eliminar un perfil de conexión

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Eliminar un perfil de conexión y la instancia de AlloyDB asociada

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Descripción general

Crear un perfil de conexión para una base de datos fuente PostgreSQL

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Crear un perfil de conexión para una base de datos de origen de Cloud SQL para PostgreSQL

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Cree un perfil de conexión para un destino AlloyDB para PostgreSQL

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Obtener información sobre un perfil de conexión

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Listar perfiles de conexión

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

nube de gcloud

Actualizar un perfil de conexión

DESCANSAR

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Administrar perfiles de conexión usando la API
Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.