Esta página foi traduzida pela API Cloud Translation.

Faça a gestão de tarefas de migração através da API

MySQL | PostgreSQL | PostgreSQL para AlloyDB

Vista geral

Nesta página, vai saber como usar a API Database Migration Service para gerir tarefas de migração para uma base de dados de origem do MySQL.

Existem duas formas de usar a API Database Migration Service. Pode fazer chamadas à API REST ou usar a CLI (interface de linha de comandos) do Google Cloud.

Para ver informações de alto nível sobre a utilização do gcloud para gerir tarefas de migração do Database Migration Service, clique aqui.

Crie um rascunho de uma tarefa de migração

O exemplo seguinte mostra um pedido para criar uma tarefa de migração no modo de rascunho. Desta forma, não tem de criar a tarefa de migração de uma só vez. Pode criar uma parte do mesmo e, em seguida, atualizá-lo através da operação PATCH.

Por exemplo, se quiser criar uma tarefa de migração, mas não tiver a base de dados de destino ou o método de conetividade de rede, pode usar o seguinte código:

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID da tarefa de migração
migration-job-name: o nome da tarefa de migração
source-connection-profile-id: o ID do perfil de ligação de origem
destination-connection-profile-id: o ID do perfil de associação de destino
provider: o fornecedor associado ao tipo de classificação da base de dados de origem.
- Para uma instância autónoma do MySQL, use DATABASE_PROVIDER_UNSPECIFIED, uma vez que este valor está associado a uma base de dados no local.
- Para uma instância do Cloud SQL para MySQL, use CLOUDSQL.
- Para qualquer serviço de base de dados gerido, use o valor ENUM correspondente. Consulte a referência do objeto DatabaseProvider.
cloud-storage-bucket (opcional): o contentor no Cloud Storage onde armazena o ficheiro de despejo.
dump-file (opcional): o ficheiro de despejo que armazena num contentor no Cloud Storage.
Se quiser fornecer o seu próprio ficheiro de despejo, armazene o ficheiro no Cloud Storage e, em seguida, indique o respetivo caminho.

Pode armazenar um ficheiro de despejo comprimido ou descomprimido num contentor no Cloud Storage.
- Para um ficheiro comprimido, use gzip_filename.gz. Por exemplo, gzip_dump.gz.
- Para um ficheiro descomprimido, use filename.sql. Por exemplo, dump.sql.
flag-name e flag-value (opcional): o nome e o valor de uma flag que está a adicionar ao utilitário mysqldump. Esta utilidade cria o ficheiro de despejo.
Pode adicionar uma ou várias flags ao ficheiro de despejo. Por exemplo, para adicionar as flags max-allowed-packet, ignore-error e add-locks ao ficheiro, 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 acerca destas flags, bem como de outras flags que pode adicionar ao seu ficheiro de despejo, consulte a documentação sobre a utilidade 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 do pedido:


{
  "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 o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

$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

Deve receber uma resposta JSON semelhante à seguinte:

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

Crie uma tarefa de migração contínua com conetividade de interligação de VPCs

O exemplo seguinte mostra um pedido para criar uma tarefa de migração contínua para migrar uma base de dados do MySQL (em execução numa VM do Google Compute Engine) para o Cloud SQL para MySQL, usando a conetividade de peering de VPC.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID da tarefa de migração
migration-job-name: o nome da tarefa de migração
source-connection-profile-id: o ID do perfil de ligação de origem
destination-connection-profile-id: o ID do perfil de associação de destino
provider: o fornecedor associado ao tipo de classificação da base de dados de origem.
- Para uma instância autónoma do MySQL, use DATABASE_PROVIDER_UNSPECIFIED, uma vez que este valor está associado a uma base de dados no local.
- Para uma instância do Cloud SQL para MySQL, use CLOUDSQL.
- Para qualquer serviço de base de dados gerido, use o valor ENUM correspondente. Consulte a referência do objeto DatabaseProvider.
cloud-storage-bucket (opcional): o contentor no Cloud Storage onde armazena o ficheiro de despejo.
dump-file (opcional): o ficheiro de despejo que armazena num contentor no Cloud Storage.
Se quiser fornecer o seu próprio ficheiro de despejo, armazene o ficheiro no Cloud Storage e, em seguida, indique o respetivo caminho.

Pode armazenar um ficheiro de despejo comprimido ou descomprimido num contentor no Cloud Storage.
- Para um ficheiro comprimido, use gzip_filename.gz. Por exemplo, gzip_dump.gz.
- Para um ficheiro descomprimido, use filename.sql. Por exemplo, dump.sql.
flag-name e flag-value (opcional): o nome e o valor de uma flag que está a adicionar ao utilitário mysqldump. Esta utilidade cria o ficheiro de despejo.
Pode adicionar uma ou várias flags ao ficheiro de despejo. Por exemplo, para adicionar as flags max-allowed-packet, ignore-error e add-locks ao ficheiro, 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 acerca destas flags, bem como de outras flags que pode adicionar ao seu ficheiro de despejo, consulte a documentação sobre a utilidade 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 do pedido:


{
  "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 o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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)

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

$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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 a utilização da gcloud para criar tarefas de migração do Database Migration Service, clique aqui.

Crie um trabalho de migração contínua com conetividade SSH inversa

O exemplo seguinte mostra um pedido para criar uma tarefa de migração em execução contínua para migrar uma base de dados do Amazon RDS MySQL para o Cloud SQL para MySQL, usando a conetividade SSH inversa.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID da tarefa de migração
migration-job-name: o nome da tarefa de migração
source-connection-profile-id: o ID do perfil de ligação de origem
destination-connection-profile-id: o ID do perfil de associaçã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 ligaçã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 fornecedor associado ao tipo de classificação da base de dados de origem.
- Para uma instância autónoma do MySQL, use DATABASE_PROVIDER_UNSPECIFIED, uma vez que este valor está associado a uma base de dados no local.
- Para uma instância do Cloud SQL para MySQL, use CLOUDSQL.
- Para qualquer serviço de base de dados gerido, use o valor ENUM correspondente. Consulte a referência do objeto DatabaseProvider.
cloud-storage-bucket (opcional): o contentor no Cloud Storage onde armazena o ficheiro de despejo.
dump-file (opcional): o ficheiro de despejo que armazena num contentor no Cloud Storage.
Se quiser fornecer o seu próprio ficheiro de despejo, armazene o ficheiro no Cloud Storage e, em seguida, indique o respetivo caminho.

Pode armazenar um ficheiro de despejo comprimido ou descomprimido num contentor no Cloud Storage.
- Para um ficheiro comprimido, use gzip_filename.gz. Por exemplo, gzip_dump.gz.
- Para um ficheiro descomprimido, use filename.sql. Por exemplo, dump.sql.
flag-name e flag-value (opcional): o nome e o valor de uma flag que está a adicionar ao utilitário mysqldump. Esta utilidade cria o ficheiro de despejo.
Pode adicionar uma ou várias flags ao ficheiro de despejo. Por exemplo, para adicionar as flags max-allowed-packet, ignore-error e add-locks ao ficheiro, 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 acerca destas flags, bem como de outras flags que pode adicionar ao seu ficheiro de despejo, consulte a documentação sobre a utilidade 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 do pedido:


{
  "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 o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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)

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

$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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 a utilização da gcloud para criar tarefas de migração do Database Migration Service, clique aqui.

Crie uma tarefa de migração com conetividade da lista de autorizações de IPs

O exemplo seguinte mostra um pedido para criar uma tarefa de migração para migrar uma instância MySQL autónoma ou um serviço de base de dados gerido para uma base de dados do Cloud SQL para MySQL, usando uma lista de autorizações de IPs.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID da tarefa de migração
migration-job-name: o nome da tarefa de migração
source-connection-profile-id: o ID do perfil de ligação de origem
destination-connection-profile-id: o ID do perfil de associação de destino
provider: o fornecedor associado ao tipo de classificação da base de dados de origem.
- Para uma instância autónoma do MySQL, use DATABASE_PROVIDER_UNSPECIFIED, uma vez que este valor está associado a uma base de dados no local.
- Para uma instância do Cloud SQL para MySQL, use CLOUDSQL.
- Para qualquer serviço de base de dados gerido, use o valor ENUM correspondente. Consulte a referência do objeto DatabaseProvider.
cloud-storage-bucket (opcional): o contentor no Cloud Storage onde armazena o ficheiro de despejo.
dump-file (opcional): o ficheiro de despejo que armazena num contentor no Cloud Storage.
Se quiser fornecer o seu próprio ficheiro de despejo, armazene o ficheiro no Cloud Storage e, em seguida, indique o respetivo caminho.

Pode armazenar um ficheiro de despejo comprimido ou descomprimido num contentor no Cloud Storage.
- Para um ficheiro comprimido, use gzip_filename.gz. Por exemplo, gzip_dump.gz.
- Para um ficheiro descomprimido, use filename.sql. Por exemplo, dump.sql.
flag-name e flag-value (opcional): o nome e o valor de uma flag que está a adicionar ao utilitário mysqldump. Esta utilidade cria o ficheiro de despejo.
Pode adicionar uma ou várias flags ao ficheiro de despejo. Por exemplo, para adicionar as flags max-allowed-packet, ignore-error e add-locks ao ficheiro, 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 acerca destas flags, bem como de outras flags que pode adicionar ao seu ficheiro de despejo, consulte a documentação sobre a utilidade 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 do pedido:


{
  "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 o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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)

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

$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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 a utilização da gcloud para criar tarefas de migração do Database Migration Service, clique aqui.

Obtenha informações sobre uma tarefa de migração

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID da tarefa 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 o seu pedido, 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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 obter informações sobre a tarefa de migração, clique aqui.

Apresentar tarefas de migração

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

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

Também pode filtrar a lista de tarefas de migração que o Database Migration Service obtém da seguinte forma:

orderBy: Use este filtro para obter uma lista de todas as tarefas de migração de uma determinada região por ordem alfabética. Por exemplo, o filtro orderBy=name devolve todas as tarefas de migração, por ordem alfabética, por nome.
pageSize: Use este filtro para especificar o número máximo de tarefas de migração que o serviço de migração de bases de dados obtém e apresenta numa página. Por exemplo, se definir pageSize=10, o Database Migration Service devolve até 10 tarefas de migração para uma página.

Se existirem mais de 10 tarefas de migração, estas aparecem noutras páginas. No final de cada página, é apresentado um parâmetro nextPageToken e um identificador exclusivo (por exemplo, oasndfoasdnoasun1241243ojsandf). Use o identificador para obter a lista de tarefas de migração da página seguinte. Na página final, o parâmetro nextPageToken e o identificador exclusivo não são apresentados.

Método HTTP e URL:

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

Para enviar o seu pedido, 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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 mais informações sobre a utilização do comando gcloud para obter informações sobre todas as suas tarefas de migração, clique aqui.

Gere um script de configuração de túnel SSH para uma tarefa de migração

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID da tarefa 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 do pedido:

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

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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)

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

$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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 a tarefa de migração, clique aqui.

Valide uma tarefa de migração

O exemplo seguinte mostra um pedido para validar uma tarefa de migração. Ao validar uma tarefa de migração, pode garantir que a tarefa é iniciada e executada com êxito.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID da tarefa 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 o seu pedido, 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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 a utilização da ferramenta gcloud para validar a tarefa de migração, clique aqui.

Atualize uma tarefa de migração

O exemplo seguinte mostra um pedido para atualizar o nome a apresentar de uma tarefa de migração existente. Ao usar o parâmetro updateMask no pedido, apenas estes campos têm de ser incluídos no corpo do pedido.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID da tarefa 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 do pedido:

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

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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)

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

$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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 o gcloud para atualizar a tarefa de migração, clique aqui.

Inicie uma tarefa de migração

O exemplo seguinte mostra um pedido para iniciar uma tarefa de migração.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID da tarefa 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 o seu pedido, 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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 a utilização do gcloud para iniciar a tarefa de migração, clique aqui.

Reinicie uma tarefa de migração com falha

O exemplo seguinte mostra um pedido para reiniciar uma tarefa de migração. Uma tarefa de migração pode ser reiniciada desde o início se a migração falhar e não for recuperável ou tiver sido interrompida durante o despejo completo.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID da tarefa 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 o seu pedido, 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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 a tarefa de migração, clique aqui.

Pare uma tarefa de migração

O exemplo seguinte mostra um pedido para parar uma tarefa de migração.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID da tarefa 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 o seu pedido, 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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 parar a tarefa de migração, clique aqui.

Retome uma tarefa de migração

Segue-se um pedido para retomar uma tarefa de migração.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID da tarefa 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 o seu pedido, 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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 a utilização do comando gcloud para retomar a tarefa de migração, clique aqui.

Promova uma tarefa de migração

A imagem seguinte mostra um pedido para promover uma tarefa de migração.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID da tarefa 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 o seu pedido, 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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 a utilização de gcloud para promover a sua tarefa de migração, clique aqui.

Elimine uma tarefa de migração

O exemplo seguinte mostra um pedido para eliminar uma tarefa de migração.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
migration-job-id: o ID da tarefa 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 o seu pedido, 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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 eliminar a tarefa de migração, clique aqui.

Faça a gestão de tarefas de migração através da API Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Vista geral

Crie um rascunho de uma tarefa de migração

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Crie uma tarefa de migração contínua com conetividade de interligação de VPCs

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Crie um trabalho de migração contínua com conetividade SSH inversa

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Crie uma tarefa de migração com conetividade da lista de autorizações de IPs

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Obtenha informações sobre uma tarefa de migração

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Apresentar tarefas de migração

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Gere um script de configuração de túnel SSH para uma tarefa de migração

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Valide uma tarefa de migração

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Atualize uma tarefa de migração

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Inicie uma tarefa de migração

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Reinicie uma tarefa de migração com falha

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Pare uma tarefa de migração

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Retome uma tarefa de migração

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Promova uma tarefa de migração

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Elimine uma tarefa de migração

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Faça a gestão de tarefas de migração através da API