Esta página foi traduzida pela API Cloud Translation.

Gerenciar jobs de migração usando a API

MySQL | PostgreSQL | PostgreSQL para AlloyDB

Visão geral

Nesta página, você vai aprender a usar a API Database Migration Service para gerenciar jobs de migração de um banco de dados de origem MySQL.

Há duas maneiras de usar a API Database Migration Service. É possível fazer chamadas da API REST ou usar a Google Cloud CLI.

Para conferir informações gerais sobre como usar o gcloud para gerenciar jobs de migração do Database Migration Service, clique aqui.

Criar um rascunho de um job de migração

A seguir, mostramos uma solicitação para criar um job de migração no modo rascunho. Assim, você não precisa criar o job de migração de uma só vez. É possível criar uma parte dele e depois atualizar usando a operação PATCH.

Por exemplo, se você quiser criar um job de migração, mas não tiver o banco de dados de destino ou o método de conectividade de rede, use este código:

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID do job de migração
migration-job-name: o nome do job de migração
source-connection-profile-id: o ID do perfil de conexão de origem
destination-connection-profile-id: o ID do perfil de conexão de destino
provider: o provedor associado ao tipo de classificação do banco de dados de origem.
- Para uma instância MySQL independente, use DATABASE_PROVIDER_UNSPECIFIED, porque esse valor está associado a um banco de dados local.
- Para uma instância do Cloud SQL para MySQL, use CLOUDSQL.
- Para qualquer serviço de banco de dados gerenciado, use o valor ENUM correspondente. Consulte a referência do objeto DatabaseProvider.
cloud-storage-bucket (opcional): o bucket do Cloud Storage em que você armazena o arquivo dump.
dump-file (opcional): o arquivo dump armazenado em um bucket do Cloud Storage.
Se você quiser fornecer seu próprio arquivo dump, armazene-o no Cloud Storage e informe o caminho dele.

É possível armazenar um arquivo dump compactado ou descompactado em um bucket do Cloud Storage.
- Para um arquivo compactado, use gzip_filename.gz. Por exemplo, gzip_dump.gz.
- Para um arquivo descompactado, use filename.sql. Por exemplo, dump.sql.
flag-name e flag-value (opcional): o nome e o valor de uma flag que você está adicionando ao utilitário mysqldump. Esse utilitário cria o arquivo dump.
É possível adicionar uma ou várias flags ao arquivo dump. Por exemplo, para adicionar as flags max-allowed-packet, ignore-error e add-locks ao arquivo, use as seguintes linhas de código:
```
      "dump_flags": {"dump_flags":[
         {"name": "max-allowed-packet", "value": "24MB"},
         {"name": "ignore-error", "value": "12345, 34567"},
         {"name": "add-locks", "value": ""}, ]}
```
Para mais informações sobre essas flags e outras que podem ser adicionadas ao arquivo de despejo, consulte a documentação sobre o utilitário mysqldump no Manual de referência do MySQL 8.0.

Método HTTP e URL:

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

Corpo JSON da solicitação:


{
  "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"}]}
}

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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

Você receberá uma resposta JSON semelhante a esta:

{
  "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
}

Criar um job contínuo de migração com conectividade de peering de VPC

O exemplo a seguir mostra uma solicitação para criar um job de migração contínua para migrar um banco de dados MySQL (em execução em uma VM do Google Compute Engine) para o Cloud SQL para MySQL usando a conectividade de peering de VPC.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID do job de migração
migration-job-name: o nome do job de migração
source-connection-profile-id: o ID do perfil de conexão de origem
destination-connection-profile-id: o ID do perfil de conexão de destino
provider: o provedor associado ao tipo de classificação do banco de dados de origem.
- Para uma instância MySQL independente, use DATABASE_PROVIDER_UNSPECIFIED, porque esse valor está associado a um banco de dados local.
- Para uma instância do Cloud SQL para MySQL, use CLOUDSQL.
- Para qualquer serviço de banco de dados gerenciado, use o valor ENUM correspondente. Consulte a referência do objeto DatabaseProvider.
cloud-storage-bucket (opcional): o bucket no Cloud Storage em que você armazena o arquivo dump.
dump-file (opcional): o arquivo dump armazenado em um bucket do Cloud Storage.
Se você quiser fornecer seu próprio arquivo dump, armazene-o no Cloud Storage e informe o caminho dele.

É possível armazenar um arquivo dump compactado ou descompactado em um bucket do Cloud Storage.
- Para um arquivo compactado, use gzip_filename.gz. Por exemplo, gzip_dump.gz.
- Para um arquivo descompactado, use filename.sql. Por exemplo, dump.sql.
flag-name e flag-value (opcional): o nome e o valor de uma flag que você está adicionando ao utilitário mysqldump. Esse utilitário cria o arquivo dump.
É possível adicionar uma ou várias flags ao arquivo dump. Por exemplo, para adicionar as flags max-allowed-packet, ignore-error e add-locks ao arquivo, use as seguintes linhas de código:
```
      "dump_flags": {"dump_flags":[
         {"name": "max-allowed-packet", "value": "24MB"},
         {"name": "ignore-error", "value": "12345, 34567"},
         {"name": "add-locks", "value": ""}, ]}
```
Para mais informações sobre essas flags e outras que podem ser adicionadas ao arquivo de despejo, consulte a documentação sobre o utilitário mysqldump no Manual de referência do MySQL 8.0.

Método HTTP e URL:

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

Corpo JSON da solicitação:


{
  "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"}]}
}

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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

Você receberá uma resposta JSON semelhante a esta:

{
  "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

Para mais informações sobre como usar gcloud para criar jobs de migração do Database Migration Service, clique aqui.

Criar um job contínuo de migração com conectividade SSH reversa

O exemplo a seguir mostra uma solicitação para criar um job de migração em execução contínua para migrar um banco de dados MySQL do Amazon RDS para o Cloud SQL para MySQL usando a conectividade SSH reversa.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID do job de migração
migration-job-name: o nome do job de migração
source-connection-profile-id: o ID do perfil de conexão de origem
destination-connection-profile-id: o ID do perfil de conexão de destino
vm-name: o nome da VM SSH. Por exemplo, dms-ssh-bastion.
vm-ip-address: o endereço IP da VM SSH. Por exemplo, 11.22.33.44.
vm-port: a porta de conexão da VM SSH. Por exemplo, 3306.
vpc-name: o nome da rede VPC. Por exemplo, projects/project-id/global/networks/test-network.
provider: o provedor associado ao tipo de classificação do banco de dados de origem.
- Para uma instância MySQL independente, use DATABASE_PROVIDER_UNSPECIFIED, porque esse valor está associado a um banco de dados local.
- Para uma instância do Cloud SQL para MySQL, use CLOUDSQL.
- Para qualquer serviço de banco de dados gerenciado, use o valor ENUM correspondente. Consulte a referência do objeto DatabaseProvider.
cloud-storage-bucket (opcional): o bucket do Cloud Storage em que você armazena o arquivo dump.
dump-file (opcional): o arquivo dump armazenado em um bucket do Cloud Storage.
Se você quiser fornecer seu próprio arquivo dump, armazene-o no Cloud Storage e informe o caminho dele.

É possível armazenar um arquivo dump compactado ou descompactado em um bucket do Cloud Storage.
- Para um arquivo compactado, use gzip_filename.gz. Por exemplo, gzip_dump.gz.
- Para um arquivo descompactado, use filename.sql. Por exemplo, dump.sql.
flag-name e flag-value (opcional): o nome e o valor de uma flag que você está adicionando ao utilitário mysqldump. Esse utilitário cria o arquivo dump.
É possível adicionar uma ou várias flags ao arquivo dump. Por exemplo, para adicionar as flags max-allowed-packet, ignore-error e add-locks ao arquivo, use as seguintes linhas de código:
```
      "dump_flags": {"dump_flags":[
         {"name": "max-allowed-packet", "value": "24MB"},
         {"name": "ignore-error", "value": "12345, 34567"},
         {"name": "add-locks", "value": ""}, ]}
```
Para mais informações sobre essas flags e outras que podem ser adicionadas ao arquivo de despejo, consulte a documentação sobre o utilitário mysqldump no Manual de referência do MySQL 8.0.

Método HTTP e URL:

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

Corpo JSON da solicitação:


{
  "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"}]}
}

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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

Você receberá uma resposta JSON semelhante a esta:

{
  "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

Para mais informações sobre como usar gcloud para criar jobs de migração do Database Migration Service, clique aqui.

Criar um job de migração com conectividade de lista de permissões de IP

A seguir, mostramos uma solicitação para criar um job de migração de uma instância do MySQL independente ou um serviço de banco de dados gerenciado para um banco de dados do Cloud SQL para MySQL usando uma lista de permissões de IP.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID do job de migração
migration-job-name: o nome do job de migração
source-connection-profile-id: o ID do perfil de conexão de origem
destination-connection-profile-id: o ID do perfil de conexão de destino
provider: o provedor associado ao tipo de classificação do banco de dados de origem.
- Para uma instância MySQL independente, use DATABASE_PROVIDER_UNSPECIFIED, porque esse valor está associado a um banco de dados local.
- Para uma instância do Cloud SQL para MySQL, use CLOUDSQL.
- Para qualquer serviço de banco de dados gerenciado, use o valor ENUM correspondente. Consulte a referência do objeto DatabaseProvider.
cloud-storage-bucket (opcional): o bucket no Cloud Storage em que você armazena o arquivo dump.
dump-file (opcional): o arquivo dump armazenado em um bucket do Cloud Storage.
Se você quiser fornecer seu próprio arquivo dump, armazene-o no Cloud Storage e informe o caminho dele.

É possível armazenar um arquivo dump compactado ou descompactado em um bucket do Cloud Storage.
- Para um arquivo compactado, use gzip_filename.gz. Por exemplo, gzip_dump.gz.
- Para um arquivo descompactado, use filename.sql. Por exemplo, dump.sql.
flag-name e flag-value (opcional): o nome e o valor de uma flag que você está adicionando ao utilitário mysqldump. Esse utilitário cria o arquivo dump.
É possível adicionar uma ou várias flags ao arquivo dump. Por exemplo, para adicionar as flags max-allowed-packet, ignore-error e add-locks ao arquivo, use as seguintes linhas de código:
```
      "dump_flags": {"dump_flags":[
         {"name": "max-allowed-packet", "value": "24MB"},
         {"name": "ignore-error", "value": "12345, 34567"},
         {"name": "add-locks", "value": ""}, ]}
```
Para mais informações sobre essas flags e outras que podem ser adicionadas ao arquivo de despejo, consulte a documentação sobre o utilitário mysqldump no Manual de referência do MySQL 8.0.

Método HTTP e URL:

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

Corpo JSON da solicitação:


{
  "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"}]}
}

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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

Você receberá uma resposta JSON semelhante a esta:

{
  "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

Para mais informações sobre como usar gcloud para criar jobs de migração do Database Migration Service, clique aqui.

Conferir informações sobre um job de migração

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID do job de migração

Método HTTP e URL:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

execute o seguinte 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)

execute o seguinte 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

Você receberá uma resposta JSON semelhante a esta:

{
  "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

Para mais informações sobre como usar gcloud para recuperar informações sobre seu job de migração, clique aqui.

Listar jobs de migração

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

project-id: o ID do projeto
region: a região do projeto

Também é possível filtrar a lista de jobs de migração que o Database Migration Service recupera, da seguinte maneira:

orderBy: Use esse filtro para recuperar uma lista de todos os jobs de migração de uma região específica em ordem alfabética. Por exemplo, o filtro orderBy=name retorna todos os jobs de migração, em ordem alfabética, por nome.
pageSize: Use esse filtro para especificar o número máximo de jobs de migração que o Database Migration Service recupera e exibe em uma página. Por exemplo, ao definir pageSize=10, o Database Migration Service vai retornar até 10 jobs de migração para uma página.

Se houver mais de 10 jobs de migração, eles vão aparecer em outras páginas. No final de cada página, um parâmetro nextPageToken e um identificador exclusivo aparecem (por exemplo, oasndfoasdnoasun1241243ojsandf). Use o identificador para recuperar a lista dos jobs de migração da página seguinte. Na página final, o parâmetro nextPageToken e o identificador exclusivo não aparecem.

Método HTTP e URL:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

execute o seguinte 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)

execute o seguinte 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

Você receberá uma resposta JSON semelhante a esta:

{
  "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

Para saber como usar o gcloud para recuperar informações sobre todos os seus jobs de migração, clique aqui.

Gerar um script de configuração de túnel SSH para um job de migração

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID do job de migração

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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

Você receberá uma resposta JSON semelhante a esta:

{
  "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

Para mais informações sobre como usar o gcloud para gerar um script SSH para seu job de migração, clique aqui.

Verificar um job de migração

A seguir, mostramos uma solicitação para verificar um job de migração. Ao verificar um job de migração, você garante que ele será iniciado e executado.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID do job de migração

Método HTTP e URL:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

execute o seguinte 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)

execute o seguinte 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

Você receberá uma resposta JSON semelhante a esta:

{
  "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

Para mais informações sobre como usar gcloud para verificar seu job de migração, clique aqui.

Atualizar um job de migração

A seguir, mostramos uma solicitação para atualizar o nome de exibição de um job de migração. Usando o parâmetro updateMask na solicitação, apenas esses campos precisam ser incluídos no corpo da solicitação.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID do job de migração

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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

Você receberá uma resposta JSON semelhante a esta:

{
  "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

Para mais informações sobre como usar gcloud para atualizar o job de migração, clique aqui.

Iniciar um job de migração

A seguir, mostramos uma solicitação para iniciar um job de migração.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID do job de migração

Método HTTP e URL:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

execute o seguinte 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)

execute o seguinte 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

Você receberá uma resposta JSON semelhante a esta:

{
  "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

Para mais informações sobre como usar gcloud para iniciar o job de migração, clique aqui.

Reiniciar um job de migração com falha

A seguir, mostramos uma solicitação para reiniciar um job de migração. Um job de migração pode ser reiniciado do início se a migração falhar e não puder ser recuperada ou for interrompida durante o despejo completo.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID do job de migração

Método HTTP e URL:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

execute o seguinte 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)

execute o seguinte 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

Você receberá uma resposta JSON semelhante a esta:

{
  "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

Para mais informações sobre como usar gcloud para reiniciar o job de migração, clique aqui.

Interromper um job de migração

A seguir, mostramos uma solicitação para interromper um job de migração.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID do job de migração

Método HTTP e URL:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

execute o seguinte 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)

execute o seguinte 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

Você receberá uma resposta JSON semelhante a esta:

{
  "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

Para mais informações sobre como usar gcloud para interromper o job de migração, clique aqui.

Retomar um job de migração

A seguir, mostramos uma solicitação para retomar um job de migração.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID do job de migração

Método HTTP e URL:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

execute o seguinte 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)

execute o seguinte 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

Você receberá uma resposta JSON semelhante a esta:

{
  "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

Para mais informações sobre como usar gcloud para retomar o job de migração, clique aqui.

Promover um job de migração

A seguir, mostramos uma solicitação para promover um job de migração.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID do job de migração

Método HTTP e URL:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

execute o seguinte 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)

execute o seguinte 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

Você receberá uma resposta JSON semelhante a esta:

{
  "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

Para mais informações sobre como usar gcloud para promover o job de migração, clique aqui.

Excluir um job de migração

A seguir, mostramos uma solicitação para excluir um job de migração.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID do job de migração

Método HTTP e URL:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

execute o seguinte 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)

execute o seguinte 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

Você receberá uma resposta JSON semelhante a esta:

{
  "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

Para mais informações sobre como usar gcloud para excluir seu job de migração, clique aqui.