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 mit der Database Migration Service API Migrationsjobs für eine MySQL-Quelldatenbank 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 verwenden.

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

Entwurf eines Migrationsjobs erstellen

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

Wenn Sie beispielsweise einen Migrationsjob erstellen möchten, aber nicht über die Zieldatenbank oder die Netzwerkverbindungsmethode 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 mit dem Klassifizierungstyp der Quelldatenbank verknüpft ist.
- Verwenden Sie für eine eigenständige MySQL-Instanz DATABASE_PROVIDER_UNSPECIFIED, da dieser Wert mit einer lokalen Datenbank verknüpft ist.
- Verwenden Sie für eine Cloud SQL for MySQL-Instanz CLOUDSQL.
- Verwenden Sie für jeden verwalteten Datenbankdienst den entsprechenden ENUM-Wert. Weitere Informationen finden Sie in der Objektreferenz für DatabaseProvider.
cloud-storage-bucket (optional): Der Bucket in Cloud Storage, in dem Sie die Dumpdatei speichern.
dump-file (optional): Die Dumpdatei, die Sie in einem Bucket in Cloud Storage speichern.
Wenn Sie Ihre eigene Dumpdatei angeben möchten, speichern Sie die Datei in Cloud Storage und geben Sie dann den Pfad zu dieser Datei an.

Sie können eine gezippte oder entpackte Dumpdatei in einem Bucket in Cloud Storage speichern.
- Verwenden Sie für eine ZIP-Datei gzip_filename.gz. Beispiel: gzip_dump.gz.
- Verwenden Sie für eine entpackte Datei filename.sql. Beispiel: dump.sql.
flag-name und flag-value (optional): Der Name und Wert eines Flags, das Sie dem mysqldump-Dienstprogramm hinzufügen. Mit diesem Dienstprogramm wird die Dumpdatei erstellt.
Sie können der Dumpdatei ein oder mehrere Flags hinzufügen. Wenn Sie der Datei beispielsweise die Flags max-allowed-packet, ignore-error und add-locks hinzufügen möchten, verwenden Sie die folgenden Codezeilen:
```
      "dump_flags": {"dump_flags":[
         {"name": "max-allowed-packet", "value": "24MB"},
         {"name": "ignore-error", "value": "12345, 34567"},
         {"name": "add-locks", "value": ""}, ]}
```
Weitere Informationen zu diesen und anderen Flags, die Sie Ihrer Dumpdatei hinzufügen können, finden Sie in der Dokumentation zum Dienstprogramm mysqldump im MySQL 8.0-Referenzhandbuch.

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": "MYSQL",
    "provider": "provider"
  },
  //"vpcPeeringConnectivity": {
  //"vpc": "default"
  //},
    "dump_path": "gs://cloud-storage-bucket/dump-file"
    "dump_flags": {"dump_flags":[{"name": "flag-name", "value": "flag-value"}]}
}

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
}

Fortlaufenden Migrationsjob mit VPC-Peering-Verbindung erstellen

Im Folgenden sehen Sie eine Anfrage zum Erstellen eines kontinuierlichen Migrationsjobs für die Migration einer MySQL-Datenbank (die auf einer Google Compute Engine-VM ausgeführt wird) zu Cloud SQL for MySQL 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 mit dem Klassifizierungstyp der Quelldatenbank verknüpft ist.
- Verwenden Sie für eine eigenständige MySQL-Instanz DATABASE_PROVIDER_UNSPECIFIED, da dieser Wert mit einer lokalen Datenbank verknüpft ist.
- Verwenden Sie für eine Cloud SQL for MySQL-Instanz CLOUDSQL.
- Verwenden Sie für jeden verwalteten Datenbankdienst den entsprechenden ENUM-Wert. Weitere Informationen finden Sie in der Objektreferenz für DatabaseProvider.
cloud-storage-bucket (optional): Der Bucket in Cloud Storage, in dem Sie die Dumpdatei speichern.
dump-file (optional): Die Dumpdatei, die Sie in einem Bucket in Cloud Storage speichern.
Wenn Sie Ihre eigene Dumpdatei angeben möchten, speichern Sie die Datei in Cloud Storage und geben Sie dann den Pfad zu dieser Datei an.

Sie können eine gezippte oder entpackte Dumpdatei in einem Bucket in Cloud Storage speichern.
- Verwenden Sie für eine ZIP-Datei gzip_filename.gz. Beispiel: gzip_dump.gz.
- Verwenden Sie für eine entpackte Datei filename.sql. Beispiel: dump.sql.
flag-name und flag-value (optional): Der Name und Wert eines Flags, das Sie dem mysqldump-Dienstprogramm hinzufügen. Mit diesem Dienstprogramm wird die Dumpdatei erstellt.
Sie können der Dumpdatei ein oder mehrere Flags hinzufügen. Wenn Sie der Datei beispielsweise die Flags max-allowed-packet, ignore-error und add-locks hinzufügen möchten, verwenden Sie die folgenden Codezeilen:
```
      "dump_flags": {"dump_flags":[
         {"name": "max-allowed-packet", "value": "24MB"},
         {"name": "ignore-error", "value": "12345, 34567"},
         {"name": "add-locks", "value": ""}, ]}
```
Weitere Informationen zu diesen und anderen Flags, die Sie Ihrer Dumpdatei hinzufügen können, finden Sie in der Dokumentation zum Dienstprogramm mysqldump im MySQL 8.0-Referenzhandbuch.

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": "MYSQL",
    "provider": "provider"
  },
  "vpcPeeringConnectivity": {
    "vpc": "default"
  },
  "dump_path": "gs://cloud-storage-bucket/dump-file"
  "dump_flags": {"dump_flags":[{"name": "flag-name", "value": "flag-value"}]}
}

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 zum Erstellen von Migrationsjobs für den Database Migration Service mit gcloud finden Sie hier.

Fortlaufenden Migrationsjob mit umgekehrter SSH-Verbindung erstellen

Im Folgenden sehen Sie eine Anfrage zum Erstellen eines fortlaufend laufenden Migrationsjobs für die Migration einer Amazon RDS-MySQL-Datenbank zu Cloud SQL for MySQL mithilfe einer umgekehrten 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 mit dem Klassifizierungstyp der Quelldatenbank verknüpft ist.
- Verwenden Sie für eine eigenständige MySQL-Instanz DATABASE_PROVIDER_UNSPECIFIED, da dieser Wert mit einer lokalen Datenbank verknüpft ist.
- Verwenden Sie für eine Cloud SQL for MySQL-Instanz CLOUDSQL.
- Verwenden Sie für jeden verwalteten Datenbankdienst den entsprechenden ENUM-Wert. Weitere Informationen finden Sie in der Objektreferenz für DatabaseProvider.
cloud-storage-bucket (optional): Der Bucket in Cloud Storage, in dem Sie die Dumpdatei speichern.
dump-file (optional): Die Dumpdatei, die Sie in einem Bucket in Cloud Storage speichern.
Wenn Sie Ihre eigene Dumpdatei angeben möchten, speichern Sie die Datei in Cloud Storage und geben Sie dann den Pfad zu dieser Datei an.

Sie können eine gezippte oder entpackte Dumpdatei in einem Bucket in Cloud Storage speichern.
- Verwenden Sie für eine ZIP-Datei gzip_filename.gz. Beispiel: gzip_dump.gz.
- Verwenden Sie für eine entpackte Datei filename.sql. Beispiel: dump.sql.
flag-name und flag-value (optional): Der Name und Wert eines Flags, das Sie dem mysqldump-Dienstprogramm hinzufügen. Mit diesem Dienstprogramm wird die Dumpdatei erstellt.
Sie können der Dumpdatei ein oder mehrere Flags hinzufügen. Wenn Sie der Datei beispielsweise die Flags max-allowed-packet, ignore-error und add-locks hinzufügen möchten, verwenden Sie die folgenden Codezeilen:
```
      "dump_flags": {"dump_flags":[
         {"name": "max-allowed-packet", "value": "24MB"},
         {"name": "ignore-error", "value": "12345, 34567"},
         {"name": "add-locks", "value": ""}, ]}
```
Weitere Informationen zu diesen und anderen Flags, die Sie Ihrer Dumpdatei hinzufügen können, finden Sie in der Dokumentation zum Dienstprogramm mysqldump im MySQL 8.0-Referenzhandbuch.

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": "MYSQL",
    "provider": "provider"
  },
  "reverseSshConnectivity": {
    "vm": "vm-name",
    "vm_ip": "vm-ip-address",
    "vm_port": vm-port,
    "vpc": "vpc-name"
  },
  "dump_path": "gs://cloud-storage-bucket/dump-file"
  "dump_flags": {"dump_flags":[{"name": "flag-name", "value": "flag-value"}]}
}

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 zum Erstellen von Migrationsjobs für den Database Migration Service mit gcloud finden Sie hier.

Migrationsjob mit IP-Zulassungslistenverbindung erstellen

Im Folgenden sehen Sie eine Anfrage zum Erstellen eines Migrationsjobs, um entweder eine eigenständige MySQL-Instanz oder einen verwalteten Datenbankdienst mithilfe einer IP-Zulassungsliste zu einer Cloud SQL for MySQL-Datenbank zu migrieren.

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 mit dem Klassifizierungstyp der Quelldatenbank verknüpft ist.
- Verwenden Sie für eine eigenständige MySQL-Instanz DATABASE_PROVIDER_UNSPECIFIED, da dieser Wert mit einer lokalen Datenbank verknüpft ist.
- Verwenden Sie für eine Cloud SQL for MySQL-Instanz CLOUDSQL.
- Verwenden Sie für jeden verwalteten Datenbankdienst den entsprechenden ENUM-Wert. Weitere Informationen finden Sie in der Objektreferenz für DatabaseProvider.
cloud-storage-bucket (optional): Der Bucket in Cloud Storage, in dem Sie die Dumpdatei speichern.
dump-file (optional): Die Dumpdatei, die Sie in einem Bucket in Cloud Storage speichern.
Wenn Sie Ihre eigene Dumpdatei angeben möchten, speichern Sie die Datei in Cloud Storage und geben Sie dann den Pfad zu dieser Datei an.

Sie können eine gezippte oder entpackte Dumpdatei in einem Bucket in Cloud Storage speichern.
- Verwenden Sie für eine ZIP-Datei gzip_filename.gz. Beispiel: gzip_dump.gz.
- Verwenden Sie für eine entpackte Datei filename.sql. Beispiel: dump.sql.
flag-name und flag-value (optional): Der Name und Wert eines Flags, das Sie dem mysqldump-Dienstprogramm hinzufügen. Mit diesem Dienstprogramm wird die Dumpdatei erstellt.
Sie können der Dumpdatei ein oder mehrere Flags hinzufügen. Wenn Sie der Datei beispielsweise die Flags max-allowed-packet, ignore-error und add-locks hinzufügen möchten, verwenden Sie die folgenden Codezeilen:
```
      "dump_flags": {"dump_flags":[
         {"name": "max-allowed-packet", "value": "24MB"},
         {"name": "ignore-error", "value": "12345, 34567"},
         {"name": "add-locks", "value": ""}, ]}
```
Weitere Informationen zu diesen und anderen Flags, die Sie Ihrer Dumpdatei hinzufügen können, finden Sie in der Dokumentation zum Dienstprogramm mysqldump im MySQL 8.0-Referenzhandbuch.

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": "MYSQL",
    "provider": "provider"
  },
  "staticIpConnectivity": {}
    "dump_path": "gs://cloud-storage-bucket/dump-file"
    "dump_flags": {"dump_flags":[{"name": "flag-name", "value": "flag-value"}]}
}

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 zum Erstellen von Migrationsjobs für den Database Migration Service mit gcloud 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": "MYSQL"
  },
  "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 vom Database Migration Service abgerufen werden, 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 Name zurück.
pageSize: Mit diesem Filter können Sie die maximale Anzahl von Migrationsjobs angeben, die vom Database Migration Service auf einer Seite abgerufen und angezeigt werden. Wenn Sie beispielsweise pageSize=10 festlegen, gibt der 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 Kennung (z. B. oasndfoasdnoasun1241243ojsandf) angezeigt. Verwenden Sie die Kennung, um die Liste der Migrationsjobs für die folgende Seite abzurufen. Auf der letzten Seite werden der Parameter nextPageToken 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": "MYSQL"
      },
      "destinationDatabase": {
        "provider": "CLOUDSQL"
      },
      
      "vpcPeeringConnectivity": {
        "vpc": "default"
      }
    }
    {
      "name": "projects/project-id/locations/region/migrationJobs/name-of-second-migration-job",
      "createTime": "2021-02-13T11:59:39.104613835Z",
      "updateTime": "2021-02-13T12:01:38.666093835Z",
      "displayName": "display-name-of-second-migration-job",
      "state": "RUNNING",
      "type": "CONTINUOUS",
      "source": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
      "destination": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
      
      "sourceDatabase": {
        "engine": "MYSQL"
      },
      "destinationDatabase": {
        "provider": "CLOUDSQL"
      },
      
      "staticIpConnectivity": {}
        "vpc": "default"
    }
  ],
  "nextPageToken": "unique-identifier"
}

gcloud

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-Scripts für Ihren Migrationsjob finden Sie hier.

Migrationsjob überprüfen

Im Folgenden sehen Sie eine Anfrage zum Überprüfen eines Migrationsjobs. Durch die Überprüfung eines Migrationsjobs können Sie dafür sorgen, 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 zum Überprüfen des Migrationsjobs mit gcloud

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 eines 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 zum Starten eines Migrationsjobs mit gcloud

Fehlgeschlagenen Migrationsjob neu starten

Im Folgenden sehen Sie eine Anfrage zum Neustarten eines Migrationsjobs. Ein Migrationsjob kann von vorn neu gestartet werden, wenn die Migration fehlgeschlagen ist und nicht wiederhergestellt werden kann oder während des vollständigen Dumps angehalten 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 anhalten

Im Folgenden sehen Sie eine Anfrage zum Stoppen 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 Anhalten 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 eines Migrationsjobs

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 eines Migrationsjobs

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.