Database Migration Service proporciona una API de REST para administrar tus perfiles de conexión y trabajos de migración de forma programática. La API de REST se define por los recursos asociados con la creación y administración de perfiles de conexión y trabajos de migración. Para obtener detalles 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 de REST de Database Migration Service, debes crear el formato correcto de la solicitud, autorizarla como un usuario autenticado y procesar las respuestas que se devuelvan. Muchas de las tareas de esta documentación proporcionan ejemplos de API 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 de Database Migration Service. Cada página tiene ejemplos de llamadas a la API en varios lenguajes de programación, así como un Explorador específico de la solicitud para ayudarte a ver qué se incluye en una solicitud bien formada y qué esperar en la respuesta.
También usas la API de Database Migration Service, de forma indirecta, cuando usas cualquiera de las siguientes formas de administrar instancias:
Google Cloud CLI: Es una interfaz de línea de comandos (CLI) que puedes usar para trabajar con tus instancias.
Consola deGoogle Cloud : Es una interfaz web gráfica.
La ventaja de usar estos métodos, en especial la consola deGoogle Cloud , es que pueden simplificar en gran medida la administración de tus perfiles de conexión y trabajos de migración (según tu caso de uso). Si recién comienzas a usar Database Migration Service, te recomendamos que primero uses una de estas herramientas antes de trabajar directamente con la API de REST.
Habilita la API
Para usar la API de Database Migration Service, debes habilitarla:
Console
- Habilita la API de Database Migration Service.
- Elige tu proyecto.
- Selecciona Continuar.
gcloud
- Ingresa lo siguiente para mostrar los IDs de tus proyectos de Google Cloud:
gcloud projects list
- Configura tu proyecto predeterminado:
gcloud config set project YOUR_PROJECT_ID
- Habilita la API de Cloud SQL Admin:
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 Database Migration: Con este permiso, un usuario obtiene acceso a todos los recursos de Database Migration Service que se usan para administrar perfiles de conexión y trabajos de migración.
- Visualizador de Database Migration: Con este permiso, un usuario tiene acceso de solo lectura a los perfiles de conexión y los trabajos de migración en Database Migration Service.
- Administrador de Cloud SQL: Con este permiso, un usuario puede crear y administrar perfiles de conexión y trabajos de migración para Cloud SQL en Database Migration Service.