Diese Seite wurde von der Cloud Translation API übersetzt.

Migrationsjobs mit der API verwalten

MySQL | PostgreSQL | PostgreSQL zu AlloyDB

Übersicht

Auf dieser Seite erfahren Sie, wie Sie die Database Migration Service API verwenden, um Migrationsjobs für eine PostgreSQL-Quelldatenbank zu verwalten.

Sie können die Database Migration Service API auf zwei Arten verwenden. Sie können REST API-Aufrufe ausführen oder die Google Cloud CLI (CLI) verwenden.

Allgemeine Informationen zur Verwendung von gcloud für die Verwaltung von Database Migration Service-Migrationsjobs finden Sie hier.

Migrationsjobentwurf erstellen

Im Folgenden sehen Sie eine Anfrage zum Erstellen eines Migrationsjobs im Draft-Modus. So müssen Sie den Migrationsjob nicht auf einmal erstellen. Sie können einen Teil davon erstellen und ihn dann mit dem Vorgang PATCH aktualisieren.

Wenn Sie beispielsweise einen Migrationsjob erstellen möchten, aber nicht über die Zieldatenbank oder die Methode zur Netzwerkverbindung verfügen, können Sie den folgenden Code verwenden:

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
region: Die Projektregion
migration-job-id: Die ID des Migrationsjobs
migration-job-name: Der Name des Migrationsjobs
source-connection-profile-id: Die ID des Quellverbindungsprofils
destination-connection-profile-id: Die ID des Zielverbindungsprofils
provider: Der Anbieter, der dem Klassifizierungstyp der Quelldatenbank zugeordnet ist.
- Verwenden Sie für eine eigenständige PostgreSQL-Instanz DATABASE_PROVIDER_UNSPECIFIED, da dieser Wert mit einer lokalen Datenbank verknüpft ist.
- Verwenden Sie für eine Cloud SQL for PostgreSQL-Instanz CLOUDSQL.
- Verwenden Sie für jeden verwalteten Datenbankdienst den entsprechenden ENUM-Wert. Weitere Informationen finden Sie in der Objektreferenz zu DatabaseProvider.

HTTP-Methode und URL:

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

JSON-Text anfordern:


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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

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)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Kontinuierlichen Migrationsjob mit VPC-Peering-Verbindung erstellen

Im Folgenden sehen Sie eine Anfrage zum Erstellen eines kontinuierlichen Migrationsjobs für die Migration einer PostgreSQL-Datenbank (die auf einer Google Compute Engine-VM ausgeführt wird) zu Cloud SQL for PostgreSQL mit VPC-Peering-Verbindung.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
region: Die Projektregion
migration-job-id: Die ID des Migrationsjobs
migration-job-name: Der Name des Migrationsjobs
source-connection-profile-id: Die ID des Quellverbindungsprofils
destination-connection-profile-id: Die ID des Zielverbindungsprofils
provider: Der Anbieter, der dem Klassifizierungstyp der Quelldatenbank zugeordnet ist.
- Verwenden Sie für eine eigenständige PostgreSQL-Instanz DATABASE_PROVIDER_UNSPECIFIED, da dieser Wert mit einer lokalen Datenbank verknüpft ist.
- Verwenden Sie für eine Cloud SQL for PostgreSQL-Instanz CLOUDSQL.
- Verwenden Sie für jeden verwalteten Datenbankdienst den entsprechenden ENUM-Wert. Weitere Informationen finden Sie in der Objektreferenz zu DatabaseProvider.

HTTP-Methode und URL:

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

JSON-Text anfordern:


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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

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)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Weitere Informationen zur Verwendung von gcloud zum Erstellen von Database Migration Service-Migrationsjobs finden Sie hier.

Kontinuierlichen Migrationsjob mit Reverse-SSH-Verbindung erstellen

Im Folgenden sehen Sie eine Anfrage zum Erstellen eines kontinuierlich ausgeführten Migrationsjobs zum Migrieren einer Amazon RDS PostgreSQL-Datenbank zu Cloud SQL for PostgreSQL mit Reverse-SSH-Verbindung.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
region: Die Projektregion
migration-job-id: Die ID des Migrationsjobs
migration-job-name: Der Name des Migrationsjobs
source-connection-profile-id: Die ID des Quellverbindungsprofils
destination-connection-profile-id: Die ID des Zielverbindungsprofils
vm-name: Der Name der SSH-VM. Beispiel: dms-ssh-bastion.
vm-ip-address: Die IP-Adresse der SSH-VM. Beispiel: 11.22.33.44.
vm-port: Der Verbindungsport der SSH-VM. Beispiel: 3306.
vpc-name: der Name des VPC-Netzwerks. Beispiel: projects/project-id/global/networks/test-network.
provider: Der Anbieter, der dem Klassifizierungstyp der Quelldatenbank zugeordnet ist.
- Verwenden Sie für eine eigenständige PostgreSQL-Instanz DATABASE_PROVIDER_UNSPECIFIED, da dieser Wert mit einer lokalen Datenbank verknüpft ist.
- Verwenden Sie für eine Cloud SQL for PostgreSQL-Instanz CLOUDSQL.
- Verwenden Sie für jeden verwalteten Datenbankdienst den entsprechenden ENUM-Wert. Weitere Informationen finden Sie in der Objektreferenz zu DatabaseProvider.

HTTP-Methode und URL:

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

JSON-Text anfordern:


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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

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)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Weitere Informationen zur Verwendung von gcloud zum Erstellen von Database Migration Service-Migrationsjobs finden Sie hier.

Migrationsjob mit IP-Zulassungslistenverbindung erstellen

Im Folgenden sehen Sie eine Anfrage zum Erstellen eines Migrationsjobs zum Migrieren einer eigenständigen PostgreSQL-Instanz oder eines verwalteten Datenbankdienstes zu einer Cloud SQL for PostgreSQL-Datenbank mit einer IP-Zulassungsliste.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
region: Die Projektregion
migration-job-id: Die ID des Migrationsjobs
migration-job-name: Der Name des Migrationsjobs
source-connection-profile-id: Die ID des Quellverbindungsprofils
destination-connection-profile-id: Die ID des Zielverbindungsprofils
provider: Der Anbieter, der dem Klassifizierungstyp der Quelldatenbank zugeordnet ist.
- Verwenden Sie für eine eigenständige PostgreSQL-Instanz DATABASE_PROVIDER_UNSPECIFIED, da dieser Wert mit einer lokalen Datenbank verknüpft ist.
- Verwenden Sie für eine Cloud SQL for PostgreSQL-Instanz CLOUDSQL.
- Verwenden Sie für jeden verwalteten Datenbankdienst den entsprechenden ENUM-Wert. Weitere Informationen finden Sie in der Objektreferenz zu DatabaseProvider.

HTTP-Methode und URL:

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

JSON-Text anfordern:


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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

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)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Weitere Informationen zur Verwendung von gcloud zum Erstellen von Database Migration Service-Migrationsjobs finden Sie hier.

Informationen zu einem Migrationsjob abrufen

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
region: Die Projektregion
migration-job-id: Die ID des Migrationsjobs

HTTP-Methode und URL:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

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)

Führen Sie folgenden Befehl aus:

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Weitere Informationen zur Verwendung von gcloud zum Abrufen von Informationen zu Ihrem Migrationsjob finden Sie hier.

Migrationsjobs auflisten

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
region: Die Projektregion

Sie können die Liste der Migrationsjobs, die Database Migration Service abruft, auch so filtern:

orderBy: Mit diesem Filter können Sie eine Liste aller Migrationsjobs für eine bestimmte Region in alphabetischer Reihenfolge abrufen. Der Filter orderBy=name gibt beispielsweise alle Migrationsjobs alphabetisch nach Namen zurück.
pageSize: Mit diesem Filter können Sie die maximale Anzahl von Migrationsjobs angeben, die vom Database Migration Service abgerufen und auf einer Seite angezeigt werden. Wenn Sie beispielsweise pageSize=10 festlegen, gibt Database Migration Service bis zu 10 Migrationsjobs für eine Seite zurück.

Wenn es mehr als 10 Migrationsjobs gibt, werden sie auf anderen Seiten angezeigt. Am Ende jeder Seite werden ein nextPageToken-Parameter und eine eindeutige ID angezeigt, z. B. oasndfoasdnoasun1241243ojsandf. Verwenden Sie die ID, um die Liste der Migrationsjobs für die nächste Seite abzurufen. Auf der letzten Seite werden der nextPageToken-Parameter und die eindeutige Kennung nicht angezeigt.

HTTP-Methode und URL:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

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

PowerShell (Windows)

Führen Sie folgenden Befehl aus:

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Weitere Informationen zur Verwendung von gcloud zum Abrufen von Informationen zu allen Migrationsjobs finden Sie hier.

SSH-Tunnelkonfigurationsskript für einen Migrationsjob generieren

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
region: Die Projektregion
migration-job-id: Die ID des Migrationsjobs

HTTP-Methode und URL:

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

JSON-Text anfordern:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

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)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Weitere Informationen zur Verwendung von gcloud zum Generieren eines SSH-Skripts für Ihren Migrationsjob finden Sie hier.

Migrationsjob überprüfen

Das Folgende zeigt eine Anfrage zum Überprüfen eines Migrationsjobs. Wenn Sie einen Migrationsjob überprüfen, können Sie sicherstellen, dass der Job gestartet und erfolgreich ausgeführt wird.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
region: Die Projektregion
migration-job-id: Die ID des Migrationsjobs

HTTP-Methode und URL:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

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)

Führen Sie folgenden Befehl aus:

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Weitere Informationen zur Verwendung von gcloud zum Überprüfen Ihres Migrationsjobs finden Sie hier.

Migrationsjob aktualisieren

Im Folgenden sehen Sie eine Anfrage zum Aktualisieren des Anzeigenamens eines vorhandenen Migrationsjobs. Bei Verwendung des Parameters updateMask in der Anfrage müssen nur diese Felder im Anfragetext enthalten sein.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
region: Die Projektregion
migration-job-id: Die ID des Migrationsjobs

HTTP-Methode und URL:

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

JSON-Text anfordern:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

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)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Weitere Informationen zur Verwendung von gcloud zum Aktualisieren Ihres Migrationsjobs finden Sie hier.

Migrationsjob starten

Im Folgenden sehen Sie eine Anfrage zum Starten eines Migrationsjobs.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
region: Die Projektregion
migration-job-id: Die ID des Migrationsjobs

HTTP-Methode und URL:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

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)

Führen Sie folgenden Befehl aus:

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Weitere Informationen zur Verwendung von gcloud zum Starten des Migrationsjobs finden Sie hier.

Fehlgeschlagenen Migrationsjob neu starten

Im Folgenden sehen Sie eine Anfrage zum Neustarten eines Migrationsjobs. Ein Migrationsjob kann von Anfang an neu gestartet werden, wenn die Migration fehlgeschlagen ist und nicht wiederhergestellt werden kann oder während des vollständigen Dumps beendet wurde.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
region: Die Projektregion
migration-job-id: Die ID des Migrationsjobs

HTTP-Methode und URL:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

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)

Führen Sie folgenden Befehl aus:

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Weitere Informationen zur Verwendung von gcloud zum Neustarten eines Migrationsjobs finden Sie hier.

Migrationsjob beenden

Im Folgenden sehen Sie eine Anfrage zum Beenden eines Migrationsjobs.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
region: Die Projektregion
migration-job-id: Die ID des Migrationsjobs

HTTP-Methode und URL:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

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)

Führen Sie folgenden Befehl aus:

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Weitere Informationen zur Verwendung von gcloud zum Beenden eines Migrationsjobs finden Sie hier.

Migrationsjob fortsetzen

Im Folgenden sehen Sie eine Anfrage zum Fortsetzen eines Migrationsjobs.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
region: Die Projektregion
migration-job-id: Die ID des Migrationsjobs

HTTP-Methode und URL:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

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)

Führen Sie folgenden Befehl aus:

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Weitere Informationen zur Verwendung von gcloud zum Fortsetzen des Migrationsjobs finden Sie hier.

Migrationsjob hochstufen

Im Folgenden sehen Sie eine Anfrage zum Hochstufen eines Migrationsjobs.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
region: Die Projektregion
migration-job-id: Die ID des Migrationsjobs

HTTP-Methode und URL:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

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)

Führen Sie folgenden Befehl aus:

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Weitere Informationen zur Verwendung von gcloud zum Hochstufen Ihres Migrationsjobs finden Sie hier.

Migrationsjob löschen

Im Folgenden sehen Sie eine Anfrage zum Löschen eines Migrationsjobs.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
region: Die Projektregion
migration-job-id: Die ID des Migrationsjobs

HTTP-Methode und URL:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

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)

Führen Sie folgenden Befehl aus:

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Weitere Informationen zur Verwendung von gcloud zum Löschen eines Migrationsjobs finden Sie hier.

Migrationsjobs mit der API verwalten Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Übersicht

Migrationsjobentwurf erstellen

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

Kontinuierlichen Migrationsjob mit VPC-Peering-Verbindung erstellen

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

gcloud

Kontinuierlichen Migrationsjob mit Reverse-SSH-Verbindung erstellen

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

gcloud

Migrationsjob mit IP-Zulassungslistenverbindung erstellen

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

gcloud

Informationen zu einem Migrationsjob abrufen

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

gcloud

Migrationsjobs auflisten

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

gcloud

SSH-Tunnelkonfigurationsskript für einen Migrationsjob generieren

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

gcloud

Migrationsjob überprüfen

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

gcloud

Migrationsjob aktualisieren

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

gcloud

Migrationsjob starten

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

gcloud

Fehlgeschlagenen Migrationsjob neu starten

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

gcloud

Migrationsjob beenden

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

gcloud

Migrationsjob fortsetzen

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

gcloud

Migrationsjob hochstufen

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

gcloud

Migrationsjob löschen

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

gcloud

Migrationsjobs mit der API verwalten