Cette page a été traduite par l'API Cloud Translation.

Gérer les tâches de migration à l'aide de l'API

MySQL | PostgreSQL | PostgreSQL vers AlloyDB

Présentation

Sur cette page, vous apprendrez à utiliser l'API Database Migration Service pour gérer les jobs de migration d'une base de données source PostgreSQL.

Vous pouvez utiliser l'API Database Migration Service de deux manières. Vous pouvez effectuer des appels d'API REST ou utiliser la Google Cloud CLI.

Pour obtenir des informations générales sur l'utilisation de gcloud afin de gérer les tâches de migration Database Migration Service, cliquez ici.

Créer un brouillon de job de migration

L'exemple suivant montre une requête permettant de créer un job de migration en mode brouillon. De cette façon, vous n'avez pas besoin de créer le job de migration en une seule fois. Vous pouvez en créer une partie, puis la mettre à jour à l'aide de l'opération PATCH.

Par exemple, si vous souhaitez créer un job de migration, mais que vous ne disposez pas de la base de données de destination ni de la méthode de connectivité réseau, vous pouvez utiliser le code suivant :

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

project-id : ID du projet
region : région du projet
migration-job-id : ID du job de migration
migration-job-name : nom du job de migration.
source-connection-profile-id : ID du profil de connexion source
destination-connection-profile-id : ID du profil de connexion de destination
provider : fournisseur associé au type de classification de la base de données source.
- Pour une instance PostgreSQL autonome, utilisez DATABASE_PROVIDER_UNSPECIFIED, car cette valeur est associée à une base de données sur site.
- Pour une instance Cloud SQL pour PostgreSQL, utilisez CLOUDSQL.
- Pour tout service de base de données géré, utilisez la valeur ENUM correspondante. Consultez la documentation de référence sur l'objet DatabaseProvider.

Méthode HTTP et URL :

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

Corps JSON de la requête :


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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Créer un job de migration continu avec une connectivité d'appairage de VPC

L'exemple suivant montre une requête de création d'un job de migration continu pour migrer une base de données PostgreSQL (s'exécutant sur une VM Google Compute Engine) vers Cloud SQL pour PostgreSQL, en utilisant la connectivité par appairage de VPC.

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

project-id : ID du projet
region : région du projet
migration-job-id : ID du job de migration
migration-job-name : nom du job de migration.
source-connection-profile-id : ID du profil de connexion source
destination-connection-profile-id : ID du profil de connexion de destination
provider : fournisseur associé au type de classification de la base de données source.
- Pour une instance PostgreSQL autonome, utilisez DATABASE_PROVIDER_UNSPECIFIED, car cette valeur est associée à une base de données sur site.
- Pour une instance Cloud SQL pour PostgreSQL, utilisez CLOUDSQL.
- Pour tout service de base de données géré, utilisez la valeur ENUM correspondante. Consultez la documentation de référence sur l'objet DatabaseProvider.

Méthode HTTP et URL :

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

Corps JSON de la requête :


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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Pour en savoir plus sur l'utilisation de gcloud afin de créer des jobs de migration Database Migration Service, cliquez ici.

Créer un job de migration continu avec une connectivité SSH inversée

L'exemple suivant montre une requête permettant de créer un job de migration continu pour migrer une base de données Amazon RDS PostgreSQL vers Cloud SQL pour PostgreSQL, à l'aide de la connectivité SSH inversée.

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

project-id : ID du projet
region : région du projet
migration-job-id : ID du job de migration
migration-job-name : nom du job de migration.
source-connection-profile-id : ID du profil de connexion source
destination-connection-profile-id : ID du profil de connexion de destination
vm-name : nom de la VM SSH. Par exemple, "dms-ssh-bastion".
vm-ip-address : adresse IP de la VM SSH. Par exemple, 11.22.33.44.
vm-port : port de connexion de la VM SSH. Par exemple, 3306.
vpc-name : nom du réseau VPC. Par exemple, projects/project-id/global/networks/test-network.
provider : fournisseur associé au type de classification de la base de données source.
- Pour une instance PostgreSQL autonome, utilisez DATABASE_PROVIDER_UNSPECIFIED, car cette valeur est associée à une base de données sur site.
- Pour une instance Cloud SQL pour PostgreSQL, utilisez CLOUDSQL.
- Pour tout service de base de données géré, utilisez la valeur ENUM correspondante. Consultez la documentation de référence sur l'objet DatabaseProvider.

Méthode HTTP et URL :

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

Corps JSON de la requête :


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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Pour en savoir plus sur l'utilisation de gcloud afin de créer des jobs de migration Database Migration Service, cliquez ici.

Créer un job de migration avec une connectivité via une liste d'autorisation d'adresses IP

L'exemple suivant montre une requête permettant de créer un job de migration pour migrer une instance PostgreSQL autonome ou un service de base de données géré vers une base de données Cloud SQL pour PostgreSQL, à l'aide d'une liste d'adresses IP autorisées.

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

project-id : ID du projet
region : région du projet
migration-job-id : ID du job de migration
migration-job-name : nom du job de migration.
source-connection-profile-id : ID du profil de connexion source
destination-connection-profile-id : ID du profil de connexion de destination
provider : fournisseur associé au type de classification de la base de données source.
- Pour une instance PostgreSQL autonome, utilisez DATABASE_PROVIDER_UNSPECIFIED, car cette valeur est associée à une base de données sur site.
- Pour une instance Cloud SQL pour PostgreSQL, utilisez CLOUDSQL.
- Pour tout service de base de données géré, utilisez la valeur ENUM correspondante. Consultez la documentation de référence sur l'objet DatabaseProvider.

Méthode HTTP et URL :

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

Corps JSON de la requête :


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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Pour en savoir plus sur l'utilisation de gcloud afin de créer des jobs de migration Database Migration Service, cliquez ici.

Obtenir des informations sur une tâche de migration

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

project-id : ID du projet
region : région du projet
migration-job-id : ID du job de migration

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

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)

Exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Pour en savoir plus sur l'utilisation de gcloud afin de récupérer des informations sur votre job de migration, cliquez ici.

Lister les tâches de migration

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

project-id : ID du projet
region : région du projet

Vous pouvez également filtrer la liste des jobs de migration récupérés par Database Migration Service, comme suit :

orderBy: Utilisez ce filtre pour récupérer la liste de tous les jobs de migration d'une région spécifique par ordre alphabétique. Par exemple, le filtre orderBy=name renvoie tous les jobs de migration, par ordre alphabétique, par nom.
pageSize: Utilisez ce filtre pour spécifier le nombre maximal de jobs de migration que Database Migration Service récupère et affiche sur une page. Par exemple, en définissant pageSize=10, Database Migration Service renverra jusqu'à 10 jobs de migration pour une page.

S'il y a plus de 10 jobs de migration, ils s'affichent sur d'autres pages. À la fin de chaque page, un paramètre nextPageToken et un identifiant unique s'affichent (par exemple, oasndfoasdnoasun1241243ojsandf). Utilisez l'identifiant pour récupérer la liste des tâches de migration pour la page suivante. Sur la dernière page, le paramètre nextPageToken et l'identifiant unique n'apparaissent pas.

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

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

PowerShell (Windows)

Exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Pour en savoir plus sur l'utilisation de gcloud afin de récupérer des informations sur tous vos jobs de migration, cliquez ici.

Générer un script de configuration de tunnel SSH pour un job de migration

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

project-id : ID du projet
region : région du projet
migration-job-id : ID du job de migration

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Pour en savoir plus sur l'utilisation de gcloud afin de générer un script SSH pour votre job de migration, cliquez ici.

Valider une tâche de migration

L'exemple suivant montre une requête permettant de vérifier un job de migration. En validant un job de migration, vous pouvez vous assurer qu'il démarrera et s'exécutera correctement.

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

project-id : ID du projet
region : région du projet
migration-job-id : ID du job de migration

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

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)

Exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Pour en savoir plus sur l'utilisation de gcloud afin de vérifier votre job de migration, cliquez ici.

Mettre à jour un job de migration

L'exemple suivant montre une requête permettant de mettre à jour le nom à afficher d'une tâche de migration existante. Si vous utilisez le paramètre updateMask dans la requête, seuls ces champs doivent être inclus dans le corps de la requête.

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

project-id : ID du projet
region : région du projet
migration-job-id : ID du job de migration

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Pour en savoir plus sur l'utilisation de gcloud afin de mettre à jour votre job de migration, cliquez ici.

Démarrer un job de migration

L'exemple suivant montre une requête permettant de démarrer un job de migration.

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

project-id : ID du projet
region : région du projet
migration-job-id : ID du job de migration

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

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)

Exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Pour en savoir plus sur l'utilisation de gcloud pour démarrer votre tâche de migration, cliquez ici.

Redémarrer une tâche de migration ayant échoué

Vous trouverez ci-dessous une requête permettant de redémarrer une tâche de migration. Un job de migration peut être redémarré depuis le début si la migration a échoué et n'est pas récupérable, ou si elle a été arrêtée pendant le vidage complet.

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

project-id : ID du projet
region : région du projet
migration-job-id : ID du job de migration

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

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)

Exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Pour en savoir plus sur l'utilisation de gcloud afin de redémarrer votre job de migration, cliquez ici.

Arrêter une tâche de migration

L'exemple suivant montre comment demander l'arrêt d'une tâche de migration.

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

project-id : ID du projet
region : région du projet
migration-job-id : ID du job de migration

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

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)

Exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Pour en savoir plus sur l'arrêt de votre job de migration à l'aide de gcloud, cliquez ici.

Reprendre une tâche de migration

Vous trouverez ci-dessous une requête permettant de reprendre une tâche de migration.

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

project-id : ID du projet
region : région du projet
migration-job-id : ID du job de migration

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

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)

Exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Pour en savoir plus sur l'utilisation de gcloud afin de reprendre votre job de migration, cliquez ici.

Promouvoir un job de migration

Vous trouverez ci-dessous une requête permettant de promouvoir une tâche de migration.

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

project-id : ID du projet
region : région du projet
migration-job-id : ID du job de migration

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

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)

Exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Pour en savoir plus sur l'utilisation de gcloud afin de promouvoir votre job de migration, cliquez ici.

Supprimer un job de migration

Voici une requête de suppression d'un job de migration.

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

project-id : ID du projet
region : région du projet
migration-job-id : ID du job de migration

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

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)

Exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Pour en savoir plus sur la suppression de votre tâche de migration à l'aide de gcloud, cliquez ici.

Gérer les tâches de migration à l'aide de l'API Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Présentation

Créer un brouillon de job de migration

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Créer un job de migration continu avec une connectivité d'appairage de VPC

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Créer un job de migration continu avec une connectivité SSH inversée

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Créer un job de migration avec une connectivité via une liste d'autorisation d'adresses IP

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Obtenir des informations sur une tâche de migration

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Lister les tâches de migration

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Générer un script de configuration de tunnel SSH pour un job de migration

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Valider une tâche de migration

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Mettre à jour un job de migration

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Démarrer un job de migration

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Redémarrer une tâche de migration ayant échoué

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Arrêter une tâche de migration

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Reprendre une tâche de migration

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Promouvoir un job de migration

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Supprimer un job de migration

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Gérer les tâches de migration à l'aide de l'API