Questa pagina è stata tradotta dall'API Cloud Translation.

Gestire i job di migrazione utilizzando l'API

MySQL | PostgreSQL | PostgreSQL ad AlloyDB

Panoramica

In questa pagina scoprirai come utilizzare l'API Database Migration Service per gestire i job di migrazione per un database di origine MySQL.

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 job di migrazione di Database Migration Service, fai clic qui.

Creare una bozza di un job di migrazione

Di seguito è riportata una richiesta di creazione di un job di migrazione in modalità bozza. In questo modo, non devi creare il job di migrazione tutto in una volta. Puoi crearne una parte e poi aggiornarla utilizzando l'operazione PATCH.

Ad esempio, se vuoi creare un job di migrazione, ma non disponi del database di destinazione o del metodo di connettività di rete, puoi utilizzare il seguente codice:

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

project-id: l'ID progetto
region: la regione del progetto
migration-job-id: l'ID job di migrazione
migration-job-name: il nome del job di migrazione
source-connection-profile-id: l'ID del profilo di connessione di origine
destination-connection-profile-id: l'ID del profilo di connessione di destinazione
provider: il provider associato al tipo di classificazione del database di origine.
- Per un'istanza MySQL autonoma, utilizza DATABASE_PROVIDER_UNSPECIFIED perché questo valore è associato a un database on-premise.
- Per un'istanza Cloud SQL per MySQL, utilizza CLOUDSQL.
- Per qualsiasi servizio di database gestito, utilizza il valore ENUM corrispondente. Consulta il riferimento all'oggetto DatabaseProvider.
cloud-storage-bucket (facoltativo): il bucket in Cloud Storage in cui memorizzi il file dump.
dump-file (facoltativo): il file dump archiviato in un bucket in Cloud Storage.
Se vuoi fornire il tuo file di dump, archivialo in Cloud Storage e fornisci il relativo percorso.

Puoi archiviare un file dump compresso o non compresso in un bucket Cloud Storage.
- Per un file compresso, utilizza gzip_filename.gz. Ad esempio, gzip_dump.gz.
- Per un file non decompresso, utilizza filename.sql. Ad esempio, dump.sql.
flag-name e flag-value (facoltativo): il nome e il valore di un flag che stai aggiungendo all'utilità mysqldump. Questa utility crea il file di dump.
Puoi aggiungere uno o più flag al file dump. Ad esempio, per aggiungere i flag max-allowed-packet, ignore-error e add-locks al file, utilizza le seguenti righe di codice:
```
      "dump_flags": {"dump_flags":[
         {"name": "max-allowed-packet", "value": "24MB"},
         {"name": "ignore-error", "value": "12345, 34567"},
         {"name": "add-locks", "value": ""}, ]}
```
Per ulteriori informazioni su questi flag e su altri flag che puoi aggiungere al file dump, consulta la documentazione sull'utilità mysqldump nel Manuale di riferimento di MySQL 8.0.

Metodo HTTP e URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id

Corpo JSON della richiesta:


{
  "displayName": "migration-job-name",
  "state": "DRAFT",
  "type": "CONTINUOUS",
  "source": "projects/project-id/locations/region/connectionProfiles/source-connection-profile-id",
  //"destination":"projects/project-id/locations/region/connectionProfiles/destination-connection-profile-id",
  "sourceDatabase": {
    "engine": "MYSQL",
    "provider": "provider"
  },
  //"vpcPeeringConnectivity": {
  //"vpc": "default"
  //},
    "dump_path": "gs://cloud-storage-bucket/dump-file"
    "dump_flags": {"dump_flags":[{"name": "flag-name", "value": "flag-value"}]}
}

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/migrationJobs?migrationJobId=migration-job-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/migrationJobs?migrationJobId=migration-job-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/migrationJobs/migration-job-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Crea un job di migrazione continua con connettività di peering VPC

Di seguito è riportata una richiesta di creazione di un job di migrazione continua per la migrazione di un database MySQL (in esecuzione su una VM Google Compute Engine) a Cloud SQL per MySQL utilizzando la connettività mediante peering VPC.

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

project-id: l'ID progetto
region: la regione del progetto
migration-job-id: l'ID job di migrazione
migration-job-name: il nome del job di migrazione
source-connection-profile-id: l'ID del profilo di connessione di origine
destination-connection-profile-id: l'ID del profilo di connessione di destinazione
provider: il provider associato al tipo di classificazione del database di origine.
- Per un'istanza MySQL autonoma, utilizza DATABASE_PROVIDER_UNSPECIFIED perché questo valore è associato a un database on-premise.
- Per un'istanza Cloud SQL per MySQL, utilizza CLOUDSQL.
- Per qualsiasi servizio di database gestito, utilizza il valore ENUM corrispondente. Consulta il riferimento all'oggetto DatabaseProvider.
cloud-storage-bucket (facoltativo): il bucket in Cloud Storage in cui memorizzi il file dump.
dump-file (facoltativo): il file dump archiviato in un bucket in Cloud Storage.
Se vuoi fornire il tuo file di dump, archivialo in Cloud Storage e fornisci il relativo percorso.

Puoi archiviare un file dump compresso o non compresso in un bucket Cloud Storage.
- Per un file compresso, utilizza gzip_filename.gz. Ad esempio, gzip_dump.gz.
- Per un file non decompresso, utilizza filename.sql. Ad esempio, dump.sql.
flag-name e flag-value (facoltativo): il nome e il valore di un flag che stai aggiungendo all'utilità mysqldump. Questa utility crea il file di dump.
Puoi aggiungere uno o più flag al file dump. Ad esempio, per aggiungere i flag max-allowed-packet, ignore-error e add-locks al file, utilizza le seguenti righe di codice:
```
      "dump_flags": {"dump_flags":[
         {"name": "max-allowed-packet", "value": "24MB"},
         {"name": "ignore-error", "value": "12345, 34567"},
         {"name": "add-locks", "value": ""}, ]}
```
Per ulteriori informazioni su questi flag e su altri flag che puoi aggiungere al file dump, consulta la documentazione sull'utilità mysqldump nel Manuale di riferimento di MySQL 8.0.

Metodo HTTP e URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id

Corpo JSON della richiesta:


{
  "displayName": "migration-job-name",
  "state": "NOT_STARTED",
  "type": "CONTINUOUS",
  "source": "projects/project-id/locations/region/connectionProfiles/source-connection-profile-id",
  "destination":"projects/project-id/locations/region/connectionProfiles/destination-connection-profile-id",
  "sourceDatabase": {
    "engine": "MYSQL",
    "provider": "provider"
  },
  "vpcPeeringConnectivity": {
    "vpc": "default"
  },
  "dump_path": "gs://cloud-storage-bucket/dump-file"
  "dump_flags": {"dump_flags":[{"name": "flag-name", "value": "flag-value"}]}
}

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:

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/migrationJobs?migrationJobId=migration-job-id"

PowerShell (Windows)

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/migrationJobs?migrationJobId=migration-job-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/migrationJobs/migration-job-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Per ulteriori informazioni sull'utilizzo di gcloud per creare job di migrazione di Database Migration Service, fai clic qui.

Crea un job di migrazione continua con connettività SSH inversa

Di seguito è riportata una richiesta di creazione di un job di migrazione in esecuzione continua per la migrazione di un database MySQL Amazon RDS a Cloud SQL per MySQL utilizzando la connettività SSH inversa.

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

project-id: l'ID progetto
region: la regione del progetto
migration-job-id: l'ID job di migrazione
migration-job-name: il nome del job di migrazione
source-connection-profile-id: l'ID del profilo di connessione di origine
destination-connection-profile-id: l'ID del profilo di connessione di destinazione
vm-name: il nome della VM SSH. Ad esempio, dms-ssh-bastion.
vm-ip-address: l'indirizzo IP della VM SSH. Ad esempio, 11.22.33.44.
vm-port: la porta di connessione della VM SSH. Ad esempio, 3306.
vpc-name: il nome della rete VPC. Ad esempio, projects/project-id/global/networks/test-network.
provider: il provider associato al tipo di classificazione del database di origine.
- Per un'istanza MySQL autonoma, utilizza DATABASE_PROVIDER_UNSPECIFIED perché questo valore è associato a un database on-premise.
- Per un'istanza Cloud SQL per MySQL, utilizza CLOUDSQL.
- Per qualsiasi servizio di database gestito, utilizza il valore ENUM corrispondente. Consulta il riferimento all'oggetto DatabaseProvider.
cloud-storage-bucket (facoltativo): il bucket in Cloud Storage in cui memorizzi il file dump.
dump-file (facoltativo): il file dump archiviato in un bucket in Cloud Storage.
Se vuoi fornire il tuo file di dump, archivialo in Cloud Storage e fornisci il relativo percorso.

Puoi archiviare un file dump compresso o non compresso in un bucket Cloud Storage.
- Per un file compresso, utilizza gzip_filename.gz. Ad esempio, gzip_dump.gz.
- Per un file non decompresso, utilizza filename.sql. Ad esempio, dump.sql.
flag-name e flag-value (facoltativo): il nome e il valore di un flag che stai aggiungendo all'utilità mysqldump. Questa utility crea il file di dump.
Puoi aggiungere uno o più flag al file dump. Ad esempio, per aggiungere i flag max-allowed-packet, ignore-error e add-locks al file, utilizza le seguenti righe di codice:
```
      "dump_flags": {"dump_flags":[
         {"name": "max-allowed-packet", "value": "24MB"},
         {"name": "ignore-error", "value": "12345, 34567"},
         {"name": "add-locks", "value": ""}, ]}
```
Per ulteriori informazioni su questi flag e su altri flag che puoi aggiungere al file dump, consulta la documentazione sull'utilità mysqldump nel Manuale di riferimento di MySQL 8.0.

Metodo HTTP e URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id

Corpo JSON della richiesta:


{
  "displayName": "migration-job-name",
  "state": "NOT_STARTED",
  "type": "CONTINUOUS",
  "source": "projects/project-id/locations/region/connectionProfiles/source-connection-profile-id",
  "destination":"projects/project-id/locations/region/connectionProfiles/destination-connection-profile-id",
  "sourceDatabase": {
    "engine": "MYSQL",
    "provider": "provider"
  },
  "reverseSshConnectivity": {
    "vm": "vm-name",
    "vm_ip": "vm-ip-address",
    "vm_port": vm-port,
    "vpc": "vpc-name"
  },
  "dump_path": "gs://cloud-storage-bucket/dump-file"
  "dump_flags": {"dump_flags":[{"name": "flag-name", "value": "flag-value"}]}
}

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:

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/migrationJobs?migrationJobId=migration-job-id"

PowerShell (Windows)

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/migrationJobs?migrationJobId=migration-job-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/migrationJobs/migration-job-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Per ulteriori informazioni sull'utilizzo di gcloud per creare job di migrazione di Database Migration Service, fai clic qui.

Creare un job di migrazione con connettività della lista consentita IP

Di seguito è riportata una richiesta di creazione di un job di migrazione per la migrazione di un'istanza MySQL autonoma o di un servizio di database gestito a un database Cloud SQL per MySQL utilizzando una lista consentita di IP.

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

project-id: l'ID progetto
region: la regione del progetto
migration-job-id: l'ID job di migrazione
migration-job-name: il nome del job di migrazione
source-connection-profile-id: l'ID del profilo di connessione di origine
destination-connection-profile-id: l'ID del profilo di connessione di destinazione
provider: il provider associato al tipo di classificazione del database di origine.
- Per un'istanza MySQL autonoma, utilizza DATABASE_PROVIDER_UNSPECIFIED perché questo valore è associato a un database on-premise.
- Per un'istanza Cloud SQL per MySQL, utilizza CLOUDSQL.
- Per qualsiasi servizio di database gestito, utilizza il valore ENUM corrispondente. Consulta il riferimento all'oggetto DatabaseProvider.
cloud-storage-bucket (facoltativo): il bucket in Cloud Storage in cui memorizzi il file dump.
dump-file (facoltativo): il file dump archiviato in un bucket in Cloud Storage.
Se vuoi fornire il tuo file di dump, archivialo in Cloud Storage e fornisci il relativo percorso.

Puoi archiviare un file dump compresso o non compresso in un bucket Cloud Storage.
- Per un file compresso, utilizza gzip_filename.gz. Ad esempio, gzip_dump.gz.
- Per un file non decompresso, utilizza filename.sql. Ad esempio, dump.sql.
flag-name e flag-value (facoltativo): il nome e il valore di un flag che stai aggiungendo all'utilità mysqldump. Questa utility crea il file di dump.
Puoi aggiungere uno o più flag al file dump. Ad esempio, per aggiungere i flag max-allowed-packet, ignore-error e add-locks al file, utilizza le seguenti righe di codice:
```
      "dump_flags": {"dump_flags":[
         {"name": "max-allowed-packet", "value": "24MB"},
         {"name": "ignore-error", "value": "12345, 34567"},
         {"name": "add-locks", "value": ""}, ]}
```
Per ulteriori informazioni su questi flag e su altri flag che puoi aggiungere al file dump, consulta la documentazione sull'utilità mysqldump nel Manuale di riferimento di MySQL 8.0.

Metodo HTTP e URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id

Corpo JSON della richiesta:


{
  "displayName": "migration-job-name",
  "state": "NOT_STARTED",
  "type": "CONTINUOUS",
  "source": "projects/project-id/locations/region/connectionProfiles/source-connection-profile-id",
  "destination":"projects/project-id/locations/region/connectionProfiles/destination-connection-profile-id",
  "sourceDatabase": {
    "engine": "MYSQL",
    "provider": "provider"
  },
  "staticIpConnectivity": {}
    "dump_path": "gs://cloud-storage-bucket/dump-file"
    "dump_flags": {"dump_flags":[{"name": "flag-name", "value": "flag-value"}]}
}

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:

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/migrationJobs?migrationJobId=migration-job-id"

PowerShell (Windows)

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/migrationJobs?migrationJobId=migration-job-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/migrationJobs/migration-job-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Per ulteriori informazioni sull'utilizzo di gcloud per creare job di migrazione di Database Migration Service, fai clic qui.

Visualizzare informazioni su un job di migrazione

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

project-id: l'ID progetto
region: la regione del progetto
migration-job-id: l'ID job di migrazione

Metodo HTTP e URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

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

PowerShell (Windows)

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/migrationJobs/migration-job-id" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/project-id/locations/region/migrationJobs/one-time-vpc-job",
  "createTime": "2020-06-12T15:48:39.666093835Z",
  "updateTime": "2020-06-12T15:48:39.666093835Z",
  "displayName": "migration-job-display-name",
  "state": "CREATING",
  "type": "CONTINUOUS",
  "source": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
  "destination": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
  
  "sourceDatabase": {
    "engine": "MYSQL"
  },
  "destinationDatabase": {
    "provider": "CLOUDSQL"
  },
  
  "vpcPeeringConnectivity": {
    "vpc": "default"
  }
}

gcloud

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

Elenco job di migrazione

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 job di migrazione recuperati da Database Migration Service come segue:

orderBy: Utilizza questo filtro per recuperare un elenco di tutti i job di migrazione per una determinata regione in ordine alfabetico. Ad esempio, il filtro orderBy=name restituisce tutti i job di migrazione in ordine alfabetico per nome.
pageSize: Utilizza questo filtro per specificare il numero massimo di job di migrazione che Database Migration Service recupera e mostra in una pagina. Ad esempio, impostando pageSize=10, Database Migration Service restituirà fino a 10 job di migrazione per una pagina.

Se sono presenti più di 10 job di migrazione, questi vengono visualizzati in altre pagine. Alla fine di ogni pagina vengono visualizzati un parametro nextPageToken e un identificatore univoco (ad esempio oasndfoasdnoasun1241243ojsandf). Utilizza l'identificatore per recuperare l'elenco dei job di migrazione per la pagina successiva. Nella pagina finale, il parametro nextPageToken e l'identificatore univoco non vengono visualizzati.

Metodo HTTP e URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

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

PowerShell (Windows)

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/migrationJobs" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "migrationJobs": [
    {
      "name": "projects/project-id/locations/region/migrationJobs/name-of-first-migration-job",
      "createTime": "2020-06-12T15:48:39.666093835Z",
      "updateTime": "2020-06-12T15:48:39.666093835Z",
      "displayName": "display-name-of-first-migration-job",
      "state": "NOT_STARTED",
      "type": "CONTINUOUS",
      "source": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
      "destination": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
      
      "sourceDatabase": {
        "engine": "MYSQL"
      },
      "destinationDatabase": {
        "provider": "CLOUDSQL"
      },
      
      "vpcPeeringConnectivity": {
        "vpc": "default"
      }
    }
    {
      "name": "projects/project-id/locations/region/migrationJobs/name-of-second-migration-job",
      "createTime": "2021-02-13T11:59:39.104613835Z",
      "updateTime": "2021-02-13T12:01:38.666093835Z",
      "displayName": "display-name-of-second-migration-job",
      "state": "RUNNING",
      "type": "CONTINUOUS",
      "source": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
      "destination": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
      
      "sourceDatabase": {
        "engine": "MYSQL"
      },
      "destinationDatabase": {
        "provider": "CLOUDSQL"
      },
      
      "staticIpConnectivity": {}
        "vpc": "default"
    }
  ],
  "nextPageToken": "unique-identifier"
}

gcloud

Per ulteriori informazioni sull'utilizzo di gcloud per recuperare informazioni su tutti i job di migrazione, fai clic qui.

Genera uno script di configurazione del tunnel SSH per un job di migrazione

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

project-id: l'ID progetto
region: la regione del progetto
migration-job-id: l'ID job di migrazione

Metodo HTTP e URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:generateSshScript

Corpo JSON della richiesta:

{
  "vm":"vm-name",
  "vmCreationConfig":{
    "vmMachineType":"machine-type",
    "subnet":"subnet-name"
	}
}

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:

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/migrationJobs/migration-job-id:generateSshScript"

PowerShell (Windows)

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/migrationJobs/migration-job-id:generateSshScript" | 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/migrationJobs/migration-job-id",
    "verb": "generate",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Per ulteriori informazioni sull'utilizzo di gcloud per generare uno script SSH per il job di migrazione, fai clic qui.

Verificare un job di migrazione

Di seguito è riportata una richiesta di verifica di un job di migrazione. Verificando un job di migrazione, puoi assicurarti che venga avviato ed eseguito correttamente.

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

project-id: l'ID progetto
region: la regione del progetto
migration-job-id: l'ID job di migrazione

Metodo HTTP e URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:verify

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:verify"

PowerShell (Windows)

Esegui questo comando:

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:verify" | 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/migrationJobs/migration-job-id",
    "verb": "verify",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Per ulteriori informazioni sull'utilizzo di gcloud per verificare il job di migrazione, fai clic qui.

Aggiornare un job di migrazione

Di seguito è riportata una richiesta di aggiornamento del nome visualizzato di un job di migrazione esistente. Se utilizzi il parametro updateMask nella richiesta, devi includere solo questi campi 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
migration-job-id: l'ID job di migrazione

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "displayName": "updated-display-name",
}

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:

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=displayName"

PowerShell (Windows)

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=displayName" | 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/migrationJobs/migration-job-id",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

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

Avviare un job di migrazione

Di seguito è riportata una richiesta di avvio di un job di migrazione.

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

project-id: l'ID progetto
region: la regione del progetto
migration-job-id: l'ID job di migrazione

Metodo HTTP e URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:start

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:start"

PowerShell (Windows)

Esegui questo comando:

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:start" | 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/migrationJobs/migration-job-id",
    "verb": "start",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Per ulteriori informazioni sull'utilizzo di gcloud per avviare il job di migrazione, fai clic qui.

Riavviare un job di migrazione non riuscito

Di seguito è riportata una richiesta di riavvio di un job di migrazione. Un job di migrazione può essere riavviato dall'inizio se la migrazione non è riuscita e non è recuperabile o se è stata interrotta durante il dump completo.

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

project-id: l'ID progetto
region: la regione del progetto
migration-job-id: l'ID job di migrazione

Metodo HTTP e URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:restart

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:restart"

PowerShell (Windows)

Esegui questo comando:

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:restart" | 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/migrationJobs/migration-job-id",
    "verb": "restart",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Per ulteriori informazioni sull'utilizzo di gcloud per riavviare il job di migrazione, fai clic qui.

Interrompere un job di migrazione

Di seguito è riportata una richiesta di arresto di un job di migrazione.

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

project-id: l'ID progetto
region: la regione del progetto
migration-job-id: l'ID job di migrazione

Metodo HTTP e URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:stop

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:stop"

PowerShell (Windows)

Esegui questo comando:

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:stop" | 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/migrationJobs/migration-job-id",
    "verb": "stop",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Per ulteriori informazioni sull'utilizzo di gcloud per interrompere il job di migrazione, fai clic qui.

Riprendere un job di migrazione

Di seguito è riportata una richiesta di ripresa di un job di migrazione.

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

project-id: l'ID progetto
region: la regione del progetto
migration-job-id: l'ID job di migrazione

Metodo HTTP e URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:resume

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:resume"

PowerShell (Windows)

Esegui questo comando:

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:resume" | 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/migrationJobs/migration-job-id",
    "verb": "resume",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Per ulteriori informazioni sull'utilizzo di gcloud per riprendere il job di migrazione, fai clic qui.

Promuovere un job di migrazione

Di seguito è riportata una richiesta di promozione di un job di migrazione.

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

project-id: l'ID progetto
region: la regione del progetto
migration-job-id: l'ID job di migrazione

Metodo HTTP e URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:promote

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:promote"

PowerShell (Windows)

Esegui questo comando:

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:promote" | 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/migrationJobs/migration-job-id",
    "verb": "promote",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Per ulteriori informazioni sull'utilizzo di gcloud per promuovere il job di migrazione, fai clic qui.

Eliminare un job di migrazione

Di seguito è riportata una richiesta di eliminazione di un job di migrazione.

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

project-id: l'ID progetto
region: la regione del progetto
migration-job-id: l'ID job di migrazione

Metodo HTTP e URL:

DELETE https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

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

PowerShell (Windows)

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/migrationJobs/migration-job-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/migrationJobs/migration-job-id",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Per ulteriori informazioni sull'utilizzo di gcloud per eliminare il job di migrazione, fai clic qui.