Database Migration Service bietet eine REST API, mit der Sie Ihre Verbindungsprofile und Migrationsjobs programmatisch verwalten können. Die REST API wird durch Ressourcen definiert, die mit dem Erstellen und Verwalten von Verbindungsprofilen und Migrationsjobs verknüpft sind. Details zu allen Ressourcen und ihren Methoden finden Sie in der API-Referenz für den Database Migration Service.
Wenn Sie Anfragen direkt an die Database Migration Service REST API senden, müssen Sie die Anfrage im richtigen Format erstellen, die Anfrage als authentifizierter Nutzer autorisieren und alle zurückgegebenen Antworten verarbeiten. Viele der Aufgaben in dieser Dokumentation enthalten API-Beispiele, die curl verwenden.
Weitere Beispiele für die Verwendung der APIs finden Sie auf der Seite für die Anfrage in der API-Referenz für Database Migration Service. Jede Seite enthält Beispiele zum Aufrufen der API in mehreren Programmiersprachen sowie einen anfragespezifischen Explorer, mit dem Sie sehen können, was in einer wohlgeformte Anfrage enthalten ist und was in der Antwort zu erwarten ist.
Sie verwenden die Database Migration Service API auch indirekt, wenn Sie eine der folgenden Methoden zur Verwaltung von Instanzen verwenden:
Google Cloud CLI: Eine Befehlszeile, mit der Sie Ihre Instanzen verwalten können.
Google Cloud Console: Eine grafische Weboberfläche.
Der Vorteil dieser Methoden, insbesondere derGoogle Cloud Console, besteht darin, dass sie die Verwaltung Ihrer Verbindungsprofile und Migrationsjobs (je nach Anwendungsfall) erheblich vereinfachen können. Wenn Sie gerade erst mit Database Migration Service beginnen, empfehlen wir Ihnen, zuerst eines dieser Tools zu verwenden, bevor Sie direkt mit der REST API arbeiten.
API aktivieren
Wenn Sie die Database Migration Service API verwenden möchten, müssen Sie sie aktivieren:
Console
- Aktivieren Sie die Database Migration Service API.
- Wählen Sie Ihr Projekt aus.
- Klicken Sie dann auf Weiter.
gcloud
- Geben Sie Folgendes ein, um die Projekt-IDs für Ihre Google Cloud-Projekte aufzurufen:
gcloud projects list
- Legen Sie ein Standardprojekt fest:
gcloud config set project YOUR_PROJECT_ID
- Cloud SQL Admin API aktivieren
gcloud services enable datamigration.googleapis.com
Berechtigungen
Sie benötigen die erforderlichen Berechtigungen, um die Database Migration Service API zu verwenden. Dazu gehören:
- Database Migration Admin: Mit dieser Berechtigung erhält ein Nutzer Zugriff auf alle Ressourcen von Database Migration Service, die zum Verwalten von Verbindungsprofilen und Migrationsjobs verwendet werden.
- Database Migration Viewer: Mit dieser Berechtigung hat ein Nutzer Lesezugriff auf Verbindungsprofile und Migrationsjobs in Database Migration Service.
- Cloud SQL Admin: Mit dieser Berechtigung kann ein Nutzer Verbindungsprofile und Migrationsjobs für Cloud SQL in Database Migration Service erstellen und verwalten.