Gestire i profili di connessione utilizzando l'API
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
In questa pagina imparerai a utilizzare l'API Database Migration Service per gestire i profili di connessione per un database di origine PostgreSQL e una destinazione AlloyDB.
Esistono due modi per utilizzare l'API Database Migration Service. Puoi effettuare chiamate API REST o utilizzare Google Cloud CLI (CLI).
Per visualizzare informazioni di alto livello sull'utilizzo di gcloud per gestire i profili di connessione di Database Migration Service, fai clic qui.
Crea un profilo di connessione per un database di origine PostgreSQL
Di seguito è riportata una richiesta per creare un profilo di connessione per un database di origine PostgreSQL.
REST
Prima di utilizzare i dati della richiesta,
apporta le seguenti sostituzioni:
project-id: l'ID progetto
region: La regione del progetto
connection-profile-id: l'ID del profilo di connessione
connection-profile-display-name: il nome visualizzato del profilo di connessione
host-ip-address: L'indirizzo IP di origine
username: Il nome utente del database
password: La password dell'utente del database
Metodo HTTP e URL:
POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id
Corpo JSON della richiesta:
Per inviare la richiesta, espandi una di queste opzioni:
curl (Linux, macOS o Cloud Shell)
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
Dovresti ricevere una risposta JSON simile alla seguente:
gcloud
Per saperne di più sull'utilizzo di gcloud per recuperare informazioni sul tuo profilo di connessione, fai clic qui.
Crea un profilo di connessione per un database di origine Cloud SQL per PostgreSQL
Di seguito è riportata una richiesta per creare un profilo di connessione per un database di origine Cloud SQL per PostgreSQL. Questo esempio utilizza un profilo di connessione PostgreSQL perché
si connette almotore del databasee PostgreSQL e non al livello di gestione di Cloud SQL.
Per creare l'accoppiamento tra l'origine e la replica utilizzando Cloud SQL, devi fornire l'ID istanza per il tuo database Cloud SQL. Puoi trovare il valore dell'ID istanza utilizzando il metodo
databases/list
dell'API Cloud SQL Admin.
REST
Prima di utilizzare i dati della richiesta,
apporta le seguenti sostituzioni:
project-id: l'ID progetto
region: La regione del progetto
connection-profile-id: l'ID del profilo di connessione
connection-profile-display-name: il nome visualizzato del profilo di connessione
host-ip-address: L'indirizzo IP di origine
username: Il nome utente del database
password: La password dell'utente del database
cloud-sql-instance-id: l'ID istanza Cloud SQL
Metodo HTTP e URL:
POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id
Corpo JSON della richiesta:
Per inviare la richiesta, espandi una di queste opzioni:
curl (Linux, macOS o Cloud Shell)
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
Per visualizzare informazioni di alto livello sull'utilizzo di gcloud per creare profili di connessione di Database Migration Service, fai clic qui.
Crea un profilo di connessione per una destinazione AlloyDB per PostgreSQL
Di seguito è riportata una richiesta per creare un profilo di connessione per una destinazione AlloyDB per PostgreSQL.
Database Migration Service utilizza le informazioni contenute in questa richiesta per creare una nuova istanza AlloyDB.
REST
Prima di utilizzare i dati della richiesta,
apporta le seguenti sostituzioni:
project-id: l'ID progetto
region: La regione del progetto
connection-profile-id: l'ID del profilo di connessione
connection-profile-display-name: il nome visualizzato del profilo di connessione
cluster-id: l'ID del cluster AlloyDB da creare
user: Il nome utente da assegnare all'utente iniziale
password: la password da assegnare all'utente iniziale
vpc-network: la rete VPC a cui verrà connesso il cluster AlloyDB
instance-id: l'ID dell'istanza AlloyDB da creare
cpu-count: Il numero di CPU con cui configurare l'istanza
Tutti i dati archiviati in Google Cloud sono criptati in modalità non attiva mediante gli stessi sistemi avanzati di gestione delle chiavi che utilizziamo per i nostri dati criptati. Questi sistemi di gestione delle chiavi forniscono
controlli e processi di revisione rigorosi per l'accesso alle chiavi, oltre a criptare i dati utente at-rest utilizzando gli standard di crittografia AES-256. Non è richiesta alcuna configurazione o gestione. Google CloudLa crittografia predefinita
a riposo di è la scelta migliore per gli utenti che non hanno requisiti specifici relativi a
conformità o località del materiale crittografico.
Metodo HTTP e URL:
POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id
Dovresti ricevere una risposta JSON simile alla seguente:
gcloud
Per saperne di più sull'utilizzo di gcloud per recuperare informazioni sul tuo profilo di connessione, fai clic qui.
Elenca i profili di connessione
Di seguito è riportata una richiesta per recuperare informazioni su tutti i tuoi profili di connessione.
REST
Prima di utilizzare i dati della richiesta,
apporta le seguenti sostituzioni:
project-id: l'ID progetto
region: La regione del progetto
Puoi anche filtrare l'elenco dei profili di connessione recuperati da Database Migration Service nel seguente modo:
orderBy: Utilizza questo filtro per recuperare un elenco di tutti i profili di connessione per una determinata regione in ordine alfabetico. Ad esempio, il filtro orderBy=name restituisce tutti i profili di connessione in ordine alfabetico per nome.
pageSize: Utilizza questo filtro per specificare il numero massimo di profili di connessione che Database Migration Service recupera e visualizza in una pagina. Ad esempio, se imposti pageSize=10, Database Migration Service restituirà fino a 10 profili di connessione per una pagina.
Se sono presenti più di 10 profili di connessione, questi vengono visualizzati in altre pagine. Alla fine di ogni pagina, vengono visualizzati un parametro nextPageToken e un identificatore univoco. Utilizza l'identificatore per recuperare l'elenco dei profili di connessione per la pagina seguente.
Metodo HTTP e URL:
GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
gcloud
Per saperne di più sull'utilizzo di gcloud per recuperare informazioni su tutti i tuoi profili di connessione, fai clic qui.
Aggiorna un profilo di connessione
Di seguito è riportata una richiesta di aggiornamento dei campi nome utente e password di un profilo di connessione esistente. Se utilizzi il parametro updateMask nella richiesta,
solo questi campi devono essere inclusi nel corpo della richiesta.
REST
Prima di utilizzare i dati della richiesta,
apporta le seguenti sostituzioni:
project-id: l'ID progetto
region: La regione del progetto
connection-profile-id: l'ID del profilo di connessione
username: Il nome utente del database
password: La password dell'utente del database
Metodo HTTP e URL:
PATCH
Corpo JSON della richiesta:
Per inviare la richiesta, espandi una di queste opzioni:
curl (Linux, macOS o Cloud Shell)
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
Per saperne di più sull'utilizzo di gcloud per eliminare il profilo di connessione, fai clic qui.
Eliminazione di un profilo di connessione e dell'istanza AlloyDB associata
Di seguito è riportata una richiesta di eliminazione di un profilo di connessione di destinazione, nonché l'eliminazione a cascata dell'istanza AlloyDB associata.
REST
Prima di utilizzare i dati della richiesta,
apporta le seguenti sostituzioni:
project-id: l'ID progetto
region: La regione del progetto
connection-profile-id: l'ID del profilo di connessione
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-10-19 UTC."],[],[]]