Gestire i profili di connessione utilizzando l'API

MySQL   |  PostgreSQL   |  PostgreSQL ad AlloyDB

Panoramica

In questa pagina scoprirai come utilizzare l'API Database Migration Service per gestire i profili di connessione per un database di origine PostgreSQL e una destinazione PostgreSQL.

Puoi utilizzare l'API Database Migration Service in due modi. Puoi effettuare chiamate all'API REST o utilizzare Google Cloud CLI (interfaccia a riga di comando).

Per informazioni di alto livello sull'utilizzo di gcloud per gestire i profili di connessione di Database Migration Service, fai clic qui.

Il completamento di alcune chiamate API per Database Migration Service può richiedere del tempo. Poiché l'API è asincrona, la chiamata viene restituita immediatamente, anche se l'operazione è ancora in corso. Se una chiamata API successiva utilizza un oggetto appena creato, devi attendere il completamento della prima operazione prima di procedere.

Crea un profilo di connessione per un database di origine PostgreSQL

Di seguito è riportata una richiesta di creazione di 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 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
• client-key: la chiave privata non criptata con codifica PEM PKCS#1 o PKCS#8 associata al certificato client. Se viene utilizzato questo campo, il campo clientCertificate è obbligatorio.
• client-certificate: il certificato x509 con codifica PEM che verrà utilizzato dalla replica per eseguire l'autenticazione nel server di database di origine.Se viene utilizzato questo campo, il campo clientKey è obbligatorio.
• ca-certificate: obbligatorio. Il certificato x509 con codifica PEM della CA che ha firmato il certificato del server di database di origine. La replica utilizzerà questo certificato per verificare la connessione all'host corretto.

Metodo HTTP e URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id

Corpo JSON della richiesta:

{
"displayName": "connection-profile-display-name",
  "postgres": {
      "host": "host-ip-address",
      "port": 5432,
      "username": "username",
      "password": "password",
      "ssl": {
        "clientKey": "client-key",
        "clientCertificate": "client-certificate",
        "caCertificate": "ca-certificate"
      }
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id"

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso alla CLI gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Per informazioni di alto livello sull'utilizzo di gcloud per creare profili di connessione di Database Migration Service, fai clic qui.

Dopo la creazione, puoi visualizzare le informazioni sul tuo profilo di connessione chiamando il metodo connectionProfiles/get.

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 profilo di connessione

Metodo HTTP e URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id"

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso alla CLI gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
  "createTime": "2019-12-22T16:17:37.159786963Z",
  "updateTime": "2019-12-24T13:13:39.455857411Z",
  "state": "READY",
  "displayName": "connection-profile-display-name",
  "postgres": {
    "host": "host-ip-address",
    "port": 5432,
    "username": "username"
  }
}

gcloud

Per ulteriori informazioni sull'utilizzo di gcloud per recuperare informazioni sul profilo di connessione, fai clic qui.

Creare un profilo di connessione per un database di origine Cloud SQL per PostgreSQL

Di seguito è riportata una richiesta di creazione di un profilo di connessione per un database di origine Cloud SQL per PostgreSQL. Questo esempio utilizza un profilo di connessione PostgreSQL perché si connette al motore del database PostgreSQL e non al livello di gestione 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 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:

{
"displayName": "connection-profile-display-name",
  "postgres": {
      "host": "host-ip-address",
      "port": 5432,
      "username": "username",
      "password": "password",
      "cloud_sql_id": "cloud-sql-instance-id"
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id"

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso alla CLI gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Per informazioni di alto livello sull'utilizzo di gcloud per creare profili di connessione di Database Migration Service, fai clic qui.

Per saperne di più sull'utilizzo di gcloud per creare un profilo di connessione per un database di origine Cloud SQL per PostgreSQL, fai clic qui.

Crea un profilo di connessione per la destinazione Cloud SQL per PostgreSQL

Di seguito è riportata una richiesta di creazione di un profilo di connessione per una destinazione Cloud SQL per PostgreSQL. Database Migration Service utilizza le informazioni contenute in questa richiesta per creare una nuova istanza Cloud SQL per 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 profilo di connessione
• connection-profile-display-name: il nome visualizzato del profilo di connessione
• database-version: la versione del database. Ad esempio, POSTGRES_12.
• tier: il tipo di macchina. Ad esempio, db-custom-1-4096.
• data-disk-type: il tipo di disco dati. Ad esempio PD_SSD.
• data-disk-size-gb: la dimensione del disco dati in GB. Ad esempio, 20.
• zone: la zona nella regione del progetto
• cmek_key_name: Facoltativo: il percorso completo e il nome di una chiave di crittografia gestita dal cliente (CMEK). Ad esempio, "projects/project-id/locations/location/keyRings/ring/cryptoKeys/customer-managed-encryption-key".

Tutti i dati archiviati in Google Cloud sono criptati a riposo utilizzando gli stessi sistemi di gestione delle chiavi rafforzati che utilizziamo per i nostri dati criptati. Questi sistemi di gestione delle chiavi forniscono controlli e verifiche rigorosi dell'accesso alle chiavi e criptano i dati utente at-rest utilizzando gli standard di crittografia AES-256. Non è richiesta alcuna configurazione o gestione.La crittografia at-rest predefinita di Google Cloudè la scelta migliore per gli utenti che non hanno requisiti specifici relativi alla conformità o alla località del materiale crittografico.

Se hai bisogno di un maggiore controllo sulle chiavi utilizzate per criptare i dati a riposo all'interno di un progetto Google Cloud , Database Migration Service offre la possibilità di proteggere i dati utilizzando le chiavi di crittografia gestite da te in Cloud Key Management Service (KMS). Queste chiavi di crittografia sono chiamate chiavi di crittografia gestite dal cliente (CMEK). Quando proteggi i dati in Database Migration Service con CMEK, sei tu ad avere il controllo del CMEK.

Il parametro cmek_key_name è associato a un CMEK che Database Migration Service può utilizzare per criptare i dati di cui è stata eseguita la migrazione dall'origine alla destinazione. Il CMEK è rappresentato dal segnaposto customer-managed-encryption-key.

Il segnaposto ring rappresenta il keyring per il tuo CMEK. Un mazzo di chiavi organizza le chiavi in una posizione specifica di Google Cloud e ti consente di gestire il controllo dell'accesso su gruppi di chiavi. Il nome di un mazzo di chiavi non deve essere univoco in un progetto Google Cloud , ma deve essere univoco all'interno di una determinata posizione. Per ulteriori informazioni sui mazzi di chiavi, consulta le risorse Cloud KMS.

Durante la creazione del profilo di connessione, Database Migration Service verificherà che la chiave CMEK esista e che Database Migration Service disponga delle autorizzazioni per utilizzarla.

Se una di queste condizioni non viene soddisfatta, viene restituito il seguente messaggio di errore:

CMEK_DOES_NOT_EXIST_OR_MISSING_PERMISSIONS

Per risolvere il problema, verifica che la chiave che hai fornito esista e che l'account di servizio Database Migration Service disponga dell'autorizzazione cloudkms.cryptoKeys.get per la chiave.

Se preferisci utilizzare il sistema di gestione delle chiavi interno di Google Cloudanziché un CMEK per criptare i dati, non includere il parametro e il valore cmek_key_name nella richiesta API.

Metodo HTTP e URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id

Corpo JSON della richiesta:

{
  "displayName": "connection-profile-display-name",
  "cloudsql": {
    "settings": {
      "databaseVersion": "database-version",
      "tier": "machine-type",
      "storageAutoResizeLimit": 0,
      "activationPolicy": "ALWAYS",
      "ipConfig":
        {
        "authorizedNetworks": [],
        "enableIpv4": true,
        "privateNetwork": null
      },
      "autoStorageIncrease": false,
      "dataDiskType": "data-disk-type",
      "dataDiskSizeGb": "data-disk-size",
      "zone": "zone",
      "sourceId": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
      "cmek_key_name": "projects/project-id/locations/location/keyRings/ring/cryptoKeys/customer-managed-encryption-key"
    }
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id"

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso alla CLI gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/project-id/locations/region/operations/operation-1591975557292-5a7e4b195623c-e350e3da-713dee7d",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T15:25:57.430715421Z",
    "target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Per informazioni di alto livello sull'utilizzo di gcloud per creare profili di connessione di Database Migration Service, fai clic qui.

Visualizzare le informazioni su un profilo di connessione

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 profilo di connessione

Metodo HTTP e URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id"

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso alla CLI gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
  "createTime": "2019-12-22T16:17:37.159786963Z",
  "updateTime": "2019-12-24T13:13:39.455857411Z",
  "state": "READY",
  "displayName": "connection-profile-display-name",
  "postgres": {
    "host": "host-ip-address",
    "port": 5432,
    "username": "username"
  }
}

gcloud

Per ulteriori informazioni sull'utilizzo di gcloud per recuperare informazioni sul 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 come segue:

• 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 mostra in una pagina. Ad esempio, impostando 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:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles"

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso alla CLI gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "connectionProfiles": [
    {
      "name": "projects/project-id/locations/region/connectionProfiles/name-of-first-connection-profile",
      "createTime": "2019-12-22T16:17:37.159786963Z",
      "updateTime": "2019-12-24T13:13:39.455857411Z",
      "state": "READY",
      "displayName": "display-name-of-first-connection-profile",
      "postgres": {
        "host": "host-ip-address-of-first-connection-profile",
        "port": port-number-of-first-connection-profile,
        "username": "username-of-first-connection-profile",
        "password_set": "true"
      }
    }
    {
      "name": "projects/project-id/locations/region/connectionProfiles/name-of-second-connection-profile",
      "createTime": "2020-11-21T19:22:25.153824963Z",
      "updateTime": "2020-11-11T11:15:14.451046111Z",
      "state": "READY",
      "displayName": "display-name-of-second-connection-profile",
      "postgres": {
        "host": "host-ip-address-of-second-connection-profile",
        "port": port-number-of-second-connection-profile,
        "username": "username-of-second-connection-profile",
        "password_set": "true"
      }
    }
  ]
}

gcloud

Per ulteriori informazioni sull'utilizzo di gcloud per recuperare informazioni su tutti i tuoi profili di connessione, fai clic qui.

Aggiornare 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 profilo di connessione
• username: il nome utente del database
• password: la password dell'utente del database

Metodo HTTP e URL:

PATCH https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?updateMask=postgres.username,postgres.password

Corpo JSON della richiesta:

{
  "postgres" {
    "username": "username",
    "password": "password"
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?updateMask=postgres.username,postgres.password"

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso alla CLI gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?updateMask=postgres.username,postgres.password" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Per ulteriori informazioni sull'utilizzo di gcloud per aggiornare il profilo di connessione, fai clic qui.

Eliminazione di un profilo di connessione

Importante:puoi eliminare un profilo di connessione solo se non sono presenti job di migrazione attivi associati al profilo. Se un profilo di connessione ha job di migrazione attivi, promuovi o elimina i job.

Per verificare se a un profilo di connessione sono associati job di migrazione attivi, esegui il seguente comando:


GET
https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?filter=state:STATE_NAME OR state:STATE_NAME AND source:projects/project-id/locations/region/connectionProfiles/connection-profile-id

Ad esempio:

GET https://datamigration.googleapis.com/v1/projects/myproject/locations/myregion/migrationJobs?filter=state:RUNNING OR state:FAILED AND source:projects/myproject/locations/myregion/connectionProfiles/postgres-src1

I vari stati del job di migrazione sono:

• NOT STARTED: Il job di migrazione è stato creato, ma non è stato avviato.
• STARTING: Il job di migrazione è in fase di avvio.
• RUNNING: Il job di migrazione è in esecuzione e può essere utilizzato per eseguire la migrazione dei dati dal database di origine a quello di destinazione.
• STOPPING: Il job di migrazione è in fase di arresto.
• STOPPED: Il job di migrazione è in pausa e non esegue più la migrazione dei dati nel database di destinazione.
• RESUMING: Il job di migrazione in pausa è in esecuzione.
• FAILED: Si è verificato un problema durante l'esecuzione del job di migrazione.
• RESTARTING: Database Migration Service acquisisce un nuovo snapshot del database di origine, carica il dump iniziale nel database di destinazione ed elabora le modifiche in corso dei dati dal database di origine al database di destinazione.

Se un utente ha un job di migrazione in uno di questi stati e tenta di eliminare il profilo di connessione, l'operazione non andrà a buon fine.

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 profilo di connessione

Metodo HTTP e URL:

DELETE https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id"

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso alla CLI gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Per saperne di più sull'utilizzo di gcloud per eliminare il profilo di connessione, fai clic qui.

Eliminare un profilo di connessione e l'istanza Cloud SQL associata

Di seguito è riportata una richiesta di eliminazione di un profilo di connessione di destinazione, nonché l'eliminazione in cascata dell'istanza Cloud SQL associata.

Importante:prima di eliminare il profilo di connessione, assicurati di:

• Esegui la promozione di tutti i job di migrazione che utilizzano il profilo di connessione di destinazione.
• Completa o elimina le bozze dei job di migrazione associati al profilo di connessione.

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 profilo di connessione

Metodo HTTP e URL:

DELETE https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?force=true

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?force=true"

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso alla CLI gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?force=true" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Per ulteriori informazioni sull'utilizzo di gcloud per eliminare sia il profilo di connessione sia l'istanza Cloud SQL associata, fai clic qui.