Database Migration Service fornisce un'API REST per amministrare i profili di connessione e i job di migrazione in modo programmatico. L'API REST è definita dalle risorse associate alla creazione e alla gestione dei profili di connessione e dei job di migrazione. Per informazioni dettagliate su tutte le risorse e sui relativi metodi, consulta il Riferimento API Database Migration Service.
Quando invii richieste direttamente all'API REST di Database Migration Service, devi creare il modulo corretto della richiesta, autorizzarla come utente autenticato ed elaborare le risposte restituite. Molte delle attività descritte in questa documentazione forniscono esempi di API che utilizzano curl.
Per altri esempi di utilizzo delle API, consulta la pagina relativa alla richiesta nel Riferimento API Database Migration Service. Ogni pagina contiene esempi di chiamate all'API in diversi linguaggi di programmazione, nonché uno strumento Explorer specifico per le richieste che ti aiuta a capire cosa contiene una richiesta ben formata e cosa aspettarti nella risposta.
Utilizzi anche l'API Database Migration Service, indirettamente, quando utilizzi uno dei seguenti modi per amministrare le istanze:
Google Cloud CLI: un'interfaccia a riga di comando (CLI) che puoi utilizzare per lavorare con le tue istanze.
ConsoleGoogle Cloud : un'interfaccia web grafica.
Il vantaggio di utilizzare questi metodi, in particolare la consoleGoogle Cloud , è che possono semplificare notevolmente l'amministrazione dei profili di connessione e dei job di migrazione (a seconda del caso d'uso). Se hai appena iniziato a utilizzare Database Migration Service, ti consigliamo di iniziare con uno di questi strumenti prima di lavorare direttamente con l'API REST.
Abilita l'API
Per utilizzare l'API Database Migration Service, devi abilitarla:
Console
- Abilita l'API Database Migration Service.
- Seleziona il progetto.
- Seleziona Continua.
gcloud
- Inserisci quanto segue per visualizzare gli ID progetto dei tuoi progetti Google Cloud:
gcloud projects list
- Imposta il progetto predefinito:
gcloud config set project YOUR_PROJECT_ID
- Abilita l'API Cloud SQL Admin:
gcloud services enable datamigration.googleapis.com
Autorizzazioni
Devi disporre delle autorizzazioni necessarie per utilizzare l'API Database Migration Service. Queste autorizzazioni includono:
- Database Migration Admin: con questa autorizzazione, un utente ottiene l'accesso a tutte le risorse di Database Migration Service utilizzate per gestire i profili di connessione e i job di migrazione.
- Database Migration Viewer: con questa autorizzazione, un utente ha accesso di sola lettura ai profili di connessione e ai job di migrazione in Database Migration Service.
- Amministratore Cloud SQL: con questa autorizzazione, un utente può creare e gestire profili di connessione e job di migrazione per Cloud SQL in Database Migration Service.