Database Migration Service proporciona una API REST para administrar tus perfiles de conexión y tareas de migración de forma programática. La API REST se define mediante recursos asociados a la creación y gestión de perfiles de conexión y tareas de migración. Para obtener información detallada sobre todos los recursos y sus métodos, consulta la referencia de la API de Database Migration Service.
Cuando envías solicitudes directamente a la API REST de Database Migration Service, debes crear la forma correcta de la solicitud, autorizarla como usuario autenticado y procesar las respuestas devueltas. Muchas de las tareas de esta documentación proporcionan ejemplos de APIs con cURL.
Para ver más ejemplos de uso de las APIs, consulta la página de la solicitud en la referencia de la API Database Migration Service. Cada página incluye ejemplos de llamadas a la API en varios lenguajes de programación, así como un explorador específico de solicitudes que te ayudará a ver qué se incluye en una solicitud bien formada y qué puedes esperar en la respuesta.
También usas la API de Database Migration Service de forma indirecta cuando utilizas cualquiera de las siguientes formas de administrar instancias:
CLI de Google Cloud: una interfaz de línea de comandos (CLI) que puedes usar para trabajar con tus instancias.
Google Cloud Consola: interfaz web gráfica.
La ventaja de usar estos métodos, especialmente laGoogle Cloud consola, es que pueden simplificar en gran medida la administración de tus perfiles de conexión y tareas de migración (en función de tu caso práctico). Si acabas de empezar a usar Database Migration Service, te recomendamos que primero utilices una de estas herramientas antes de trabajar directamente con la API REST.
Activar la API
Para usar la API de Database Migration Service, debes habilitarla:
Consola
- Habilita la API de Database Migration Service.
- Selecciona el proyecto.
- Selecciona Continuar.
gcloud
- Introduce lo siguiente para mostrar los IDs de tus Google Cloud
proyectos:
gcloud projects list
- Configura tu proyecto predeterminado:
gcloud config set project YOUR_PROJECT_ID
- Habilita la API Admin de Cloud SQL:
gcloud services enable datamigration.googleapis.com
Permisos
Debes tener los permisos necesarios para usar la API de Database Migration Service. Estos permisos incluyen lo siguiente:
- Administrador de migración de bases de datos: con este permiso, un usuario obtiene acceso a todos los recursos de Database Migration Service que se utilizan para gestionar los perfiles de conexión y las tareas de migración.
- Lector de migración de bases de datos: con este permiso, un usuario tiene acceso de solo lectura a los perfiles de conexión y a las tareas de migración en Database Migration Service.
- Administrador de Cloud SQL: con este permiso, un usuario puede crear y gestionar perfiles de conexión y trabajos de migración de Cloud SQL en Database Migration Service.
Google Cloud ofrece Gestión de Identidades y Accesos (IAM), que te permite conceder un acceso más granular a recursos Google Cloud específicos e impide el acceso no deseado a otros recursos. Puedes obtener y definir permisos para Database Migration Service mediante la Google Cloud consola, los métodos de gestión de identidades y accesos de la API o la CLI de Google Cloud. Para obtener más información, consulta Conceder, cambiar y revocar el acceso a los recursos.
Proporcionar datos JSON de un archivo
Cuando usas la API con cURL, proporcionas los valores de las propiedades mediante la línea de comandos. Si trabaja con valores sensibles, como contraseñas o claves de seguridad, proporcionarlos en la línea de comandos supone un riesgo para la seguridad. Para aumentar la seguridad, puede crear un archivo que contenga los datos JSON de la llamada a la API y proporcionar la ruta al archivo en la línea de comandos.
Para proporcionar datos JSON a tu llamada a la API cURL desde un archivo, sigue estos pasos:
Crea un archivo que contenga todo lo que esté entre comillas simples en el campo
--data.Incluye las llaves, pero no las comillas simples.
En la línea de comandos, proporciona la ruta del archivo, precedida del carácter
@, como parámetro--data:--data @<path-to-file>/<filename>
Trabajar con llamadas a la API de larga duración
Algunas llamadas a la API, como la creación de objetos, pueden tardar un tiempo en completarse. Como la API es asíncrona, la llamada se devuelve inmediatamente, aunque la operación aún esté en curso. Si una llamada a la API posterior usa el objeto recién creado, debes esperar a que se complete la primera operación antes de continuar.
Puedes usar la API de Database Migration Service para gestionar operaciones. Entre los datos que recoge se incluyen los siguientes:
Database Migration Service y Google APIs Discovery Service
El servicio de descubrimiento para APIs de Google es un servicio que puedes usar para descubrir APIs de Google. Por ejemplo, cuando usas la herramienta Explorador de APIs de Google, estás usando el servicio de descubrimiento.En Discovery Service, Database Migration Service se representa como "datamigration" (por ejemplo, https://datamigration.googleapis.com/$discovery/rest?version=v1).