Esta página foi traduzida pela API Cloud Translation.

Gerenciar tarefas de migração usando a API
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

MySQL | PostgreSQL | PostgreSQL para AlloyDB

Visão geral

Nesta página, você aprende como usar a API do Database Migration Service para gerenciar trabalhos de migração para um banco de dados de origem PostgreSQL.

Há duas maneiras de usar a API do Database Migration Service. Você pode fazer chamadas à API REST ou usar a Google Cloud CLI (CLI).

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

Crie um rascunho de um trabalho de migração

Veja a seguir uma solicitação para criar um trabalho de migração no modo rascunho. Dessa forma, você não precisa criar o trabalho de migração de uma só vez. Você pode criar uma parte dele e atualizá-lo usando a operação PATCH .

Por exemplo, se quiser criar um trabalho de migração, mas não tiver o banco de dados de destino ou o método de conectividade de rede, você poderá usar o seguinte código:

DESCANSAR

Antes de usar qualquer um dos dados da solicitação, faça as seguintes substituições:

project-id : o ID do projeto
region : A região do projeto
migration-job-id : o ID do trabalho de migração
migration-job-name : o nome do trabalho 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 PostgreSQL autônoma, use DATABASE_PROVIDER_UNSPECIFIED porque esse valor está associado a um banco de dados local.
- Para uma instância do Cloud SQL para PostgreSQL, use CLOUDSQL .
- Para qualquer serviço de banco de dados gerenciado, use o valor ENUM correspondente. Consulte a referência do objeto DatabaseProvider .

Método HTTP e URL:

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

Solicitar corpo JSON:


{
  "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": "POSTGRESQL",
    "provider": "provider"
  },
  //"vpcPeeringConnectivity": {
  //"vpc": "default"
  //}
}

Para enviar sua 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 Cloud Shell , que faz login automaticamente na CLI gcloud . Você pode verificar a conta atualmente ativa executando gcloud auth list .

Salve o corpo da solicitação em um arquivo chamado 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)

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 . Você pode verificar a conta atualmente ativa executando gcloud auth list .

Salve o corpo da solicitação em um arquivo chamado 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

Você deverá 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
}

Crie um job de migração contínua com conectividade de peering de VPC

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

DESCANSAR

Antes de usar qualquer um dos dados da solicitação, faça as seguintes substituições:

project-id : o ID do projeto
region : A região do projeto
migration-job-id : o ID do trabalho de migração
migration-job-name : o nome do trabalho 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 PostgreSQL autônoma, use DATABASE_PROVIDER_UNSPECIFIED porque esse valor está associado a um banco de dados local.
- Para uma instância do Cloud SQL para PostgreSQL, use CLOUDSQL .
- Para qualquer serviço de banco de dados gerenciado, use o valor ENUM correspondente. Consulte a referência do objeto DatabaseProvider .

Método HTTP e URL:

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

Solicitar corpo JSON:


{
  "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": "POSTGRESQL",
    "provider": "provider"
  },
  "vpcPeeringConnectivity": {
    "vpc": "default"
  }
}

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

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo chamado 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)

Salve o corpo da solicitação em um arquivo chamado 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

Você deverá 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 obter mais informações sobre como usar gcloud para criar trabalhos de migração do Database Migration Service, clique aqui .

Crie um trabalho de migração contínua com conectividade SSH reversa

Veja a seguir uma solicitação para criar um trabalho de migração em execução contínua para migrar um banco de dados PostgreSQL do Amazon RDS para o Cloud SQL para PostgreSQL usando conectividade SSH reversa.

DESCANSAR

Antes de usar qualquer um dos dados da solicitação, faça as seguintes substituições:

project-id : o ID do projeto
region : A região do projeto
migration-job-id : o ID do trabalho de migração
migration-job-name : o nome do trabalho 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, projetos/ project-id /global/redes/rede-teste.
provider : o provedor associado ao tipo de classificação do banco de dados de origem.
- Para uma instância PostgreSQL autônoma, use DATABASE_PROVIDER_UNSPECIFIED porque esse valor está associado a um banco de dados local.
- Para uma instância do Cloud SQL para PostgreSQL, use CLOUDSQL .
- Para qualquer serviço de banco de dados gerenciado, use o valor ENUM correspondente. Consulte a referência do objeto DatabaseProvider .

Método HTTP e URL:

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

Solicitar corpo JSON:


{
  "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": "POSTGRESQL",
    "provider": "provider"
  },
  
  "reverseSshConnectivity": {
    "vm": "vm-name",
    "vm_ip": "vm-ip-address",
    "vm_port": vm-port,
    "vpc": "vpc-name"
  }
}

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

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo chamado 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)

Salve o corpo da solicitação em um arquivo chamado 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

Você deverá 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 obter mais informações sobre como usar gcloud para criar trabalhos de migração do Database Migration Service, clique aqui .

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

Veja a seguir uma solicitação para criar um job de migração para migrar uma instância autônoma do PostgreSQL ou um serviço de banco de dados gerenciado para um banco de dados Cloud SQL para PostgreSQL usando uma lista de permissões de IP.

DESCANSAR

Antes de usar qualquer um dos dados da solicitação, faça as seguintes substituições:

project-id : o ID do projeto
region : A região do projeto
migration-job-id : o ID do trabalho de migração
migration-job-name : o nome do trabalho 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 PostgreSQL autônoma, use DATABASE_PROVIDER_UNSPECIFIED porque esse valor está associado a um banco de dados local.
- Para uma instância do Cloud SQL para PostgreSQL, use CLOUDSQL .
- Para qualquer serviço de banco de dados gerenciado, use o valor ENUM correspondente. Consulte a referência do objeto DatabaseProvider .

Método HTTP e URL:

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

Solicitar corpo JSON:


{
  "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": "POSTGRESQL",
    "provider": "provider"
  },
  "staticIpConnectivity": {}
}

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

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo chamado 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)

Salve o corpo da solicitação em um arquivo chamado 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

Você deverá 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 obter mais informações sobre como usar gcloud para criar trabalhos de migração do Database Migration Service, clique aqui .

Obtenha informações sobre um trabalho de migração

DESCANSAR

Antes de usar qualquer um dos dados da solicitação, faça as seguintes substituições:

project-id : o ID do projeto
region : A região do projeto
migration-job-id : o ID do trabalho 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 sua 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ê deverá 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": "POSTGRESQL"
  },
  "destinationDatabase": {
    "provider": "CLOUDSQL"
  },
  
  "vpcPeeringConnectivity": {
    "vpc": "default"
  }
}

gcloud

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

Listar jobs de migração

DESCANSAR

Antes de usar qualquer um dos dados da solicitação, faça as seguintes substituições:

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

Você também pode filtrar a lista de trabalhos de migração que o Database Migration Service recupera, da seguinte maneira:

orderBy: Use este filtro para recuperar uma listagem de todos os trabalhos de migração para uma determinada região em ordem alfabética. Por exemplo, o filtro orderBy=name retorna todos os trabalhos de migração, em ordem alfabética, por nome.
pageSize: use esse filtro para especificar o número máximo de trabalhos 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 retornará até 10 trabalhos de migração para uma página.

Se houver mais de 10 trabalhos de migração, eles aparecerão 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 listagem dos trabalhos 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 sua 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ê deverá 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": "POSTGRESQL"
      },
      "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": "POSTGRESQL"
      },
      "destinationDatabase": {
        "provider": "CLOUDSQL"
      },
      
      "staticIpConnectivity": {}
        "vpc": "default"
    }
  ],
  "nextPageToken": "unique-identifier"
}

gcloud

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

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

DESCANSAR

Antes de usar qualquer um dos dados da solicitação, faça as seguintes substituições:

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

Método HTTP e URL:

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

Solicitar corpo JSON:

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

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

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo chamado 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)

Salve o corpo da solicitação em um arquivo chamado 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

Você deverá 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 obter mais informações sobre como usar gcloud para gerar um script SSH para seu trabalho de migração, clique aqui .

Verifique um trabalho de migração

Veja a seguir uma solicitação para verificar um trabalho de migração. Ao verificar um trabalho de migração, você pode garantir que o trabalho será iniciado e executado com êxito.

DESCANSAR

Antes de usar qualquer um dos dados da solicitação, faça as seguintes substituições:

project-id : o ID do projeto
region : A região do projeto
migration-job-id : o ID do trabalho 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 sua 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ê deverá 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 obter mais informações sobre como usar gcloud para verificar seu trabalho de migração, clique aqui .

Atualizar um trabalho de migração

Veja a seguir uma solicitação para atualizar o nome de exibição de um trabalho de migração existente. Ao usar o parâmetro updateMask na solicitação, apenas esses campos precisam ser incluídos no corpo da solicitação.

DESCANSAR

Antes de usar qualquer um dos dados da solicitação, faça as seguintes substituições:

project-id : o ID do projeto
region : A região do projeto
migration-job-id : o ID do trabalho 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

Solicitar corpo JSON:

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

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

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo chamado 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)

Salve o corpo da solicitação em um arquivo chamado 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

Você deverá 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 obter mais informações sobre como usar gcloud para atualizar seu trabalho de migração, clique aqui .

Iniciar um trabalho de migração

Veja a seguir uma solicitação para iniciar um trabalho de migração.

DESCANSAR

Antes de usar qualquer um dos dados da solicitação, faça as seguintes substituições:

project-id : o ID do projeto
region : A região do projeto
migration-job-id : o ID do trabalho 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 sua 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ê deverá 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 obter mais informações sobre como usar gcloud para iniciar seu trabalho de migração, clique aqui .

Reinicie um trabalho de migração com falha

Veja a seguir uma solicitação para reiniciar um trabalho de migração. Uma tarefa de migração poderá ser reiniciada desde o início se a migração falhar e não for recuperável ou se tiver sido interrompida durante o dump completo.

DESCANSAR

Antes de usar qualquer um dos dados da solicitação, faça as seguintes substituições:

project-id : o ID do projeto
region : A região do projeto
migration-job-id : o ID do trabalho 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 sua 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ê deverá 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 obter mais informações sobre como usar gcloud para reiniciar seu trabalho de migração, clique aqui .

Interromper um trabalho de migração

Veja a seguir uma solicitação para interromper um trabalho de migração.

DESCANSAR

Antes de usar qualquer um dos dados da solicitação, faça as seguintes substituições:

project-id : o ID do projeto
region : A região do projeto
migration-job-id : o ID do trabalho 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 sua 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ê deverá 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 obter mais informações sobre como usar gcloud para interromper seu trabalho de migração, clique aqui .

Retomar um trabalho de migração

Veja a seguir uma solicitação para retomar um trabalho de migração.

DESCANSAR

Antes de usar qualquer um dos dados da solicitação, faça as seguintes substituições:

project-id : o ID do projeto
region : A região do projeto
migration-job-id : o ID do trabalho 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 sua 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ê deverá 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 obter mais informações sobre como usar gcloud para retomar seu trabalho de migração, clique aqui .

Promova um trabalho de migração

Veja a seguir uma solicitação para promover um trabalho de migração.

DESCANSAR

Antes de usar qualquer um dos dados da solicitação, faça as seguintes substituições:

project-id : o ID do projeto
region : A região do projeto
migration-job-id : o ID do trabalho 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 sua 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ê deverá 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 obter mais informações sobre como usar gcloud para promover seu trabalho de migração, clique aqui .

Excluir um job de migração

Veja a seguir uma solicitação para excluir um trabalho de migração.

DESCANSAR

Antes de usar qualquer um dos dados da solicitação, faça as seguintes substituições:

project-id : o ID do projeto
region : A região do projeto
migration-job-id : o ID do trabalho 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 sua 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ê deverá 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 obter mais informações sobre como usar gcloud para excluir seu trabalho de migração, clique aqui .

Gerenciar tarefas de migração usando a API Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Visão geral

Crie um rascunho de um trabalho de migração

DESCANSAR

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Crie um job de migração contínua com conectividade de peering de VPC

DESCANSAR

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Crie um trabalho de migração contínua com conectividade SSH reversa

DESCANSAR

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

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

DESCANSAR

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Obtenha informações sobre um trabalho de migração

DESCANSAR

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Listar jobs de migração

DESCANSAR

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

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

DESCANSAR

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Verifique um trabalho de migração

DESCANSAR

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Atualizar um trabalho de migração

DESCANSAR

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Iniciar um trabalho de migração

DESCANSAR

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Reinicie um trabalho de migração com falha

DESCANSAR

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Interromper um trabalho de migração

DESCANSAR

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Retomar um trabalho de migração

DESCANSAR

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Promova um trabalho de migração

DESCANSAR

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Excluir um job de migração

DESCANSAR

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Gerenciar tarefas de migração usando a API
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.