Database Migration Service fournit une API REST pour administrer vos profils de connexion et vos jobs de migration de manière programmatique. L'API REST est définie par des ressources associées à la création et à la gestion des profils de connexion et des jobs de migration. Pour en savoir plus sur l'ensemble des ressources et de leurs méthodes, consultez la documentation de référence de l'API Database Migration Service.
Lorsque vous envoyez des requêtes directement à l'API REST Database Migration Service, vous devez créer la forme de requête appropriée, autoriser la requête en tant qu'utilisateur authentifié et traiter les réponses renvoyées. De nombreuses tâches de cette documentation fournissent des exemples d'API utilisant curl.
Pour obtenir d'autres exemples d'utilisation des API, consultez la page de la requête dans la documentation de référence de l'API Database Migration Service. Chaque page contient des exemples d'appel de l'API dans plusieurs langages de programmation, ainsi qu'un explorateur spécifique à la requête pour vous aider à voir ce qui entre dans une requête bien formée et ce à quoi vous attendre dans la réponse.
Vous utilisez également l'API Database Migration Service, indirectement, lorsque vous utilisez l'un des moyens suivants pour administrer des instances :
Google Cloud CLI : interface de ligne de commande (CLI) que vous pouvez utiliser pour travailler avec vos instances.
Google Cloud console : interface Web graphique.
L'avantage de ces méthodes, en particulier de la consoleGoogle Cloud , est qu'elles peuvent simplifier considérablement l'administration de vos profils de connexion et de vos jobs de migration (en fonction de votre cas d'utilisation). Si vous débutez avec Database Migration Service, nous vous recommandons de commencer par l'un de ces outils avant d'utiliser directement l'API REST.
Activer l'API
Pour utiliser l'API Database Migration Service, vous devez l'activer :
Console
- Activez l'API Database Migration Service.
- Sélectionnez votre projet.
- Cliquez sur Continuer.
gcloud
- Saisissez la commande suivante pour afficher les ID de vos projets Google Cloud :
gcloud projects list
- Définissez le projet par défaut :
gcloud config set project YOUR_PROJECT_ID
- Activez l'API Cloud SQL Admin :
gcloud services enable datamigration.googleapis.com
Autorisations
Vous devez disposer des autorisations requises pour utiliser l'API Database Migration Service. Ces autorisations incluent :
- Administrateur Database Migration Service : cette autorisation permet à un utilisateur d'accéder à toutes les ressources de Database Migration Service utilisées pour gérer les profils de connexion et les jobs de migration.
- Lecteur Database Migration Service : avec cette autorisation, un utilisateur dispose d'un accès en lecture seule aux profils de connexion et aux jobs de migration dans Database Migration Service.
- Administrateur Cloud SQL : cette autorisation permet à un utilisateur de créer et de gérer des profils de connexion et des jobs de migration pour Cloud SQL dans Database Migration Service.