---
title: "POST /v1/{+parent}/diskMigrationJobs"
method: POST
path: "/v1/{+parent}/diskMigrationJobs"
tags: ["projects"]
---

# POST /v1/{+parent}/diskMigrationJobs

`POST /v1/{+parent}/diskMigrationJobs`

Creates a new disk migration job in a given Source.

## Path parameters

- `parent` string, required

## Query parameters

- `diskMigrationJobId` string
- `requestId` string

## Request body

- DiskMigrationJob — Describes the disk which will be migrated from the source environment. The source disk has to be unattached.
  - `awsSourceDiskDetails` AwsSourceDiskDetails — Represents the source AWS Disk details.
    - `sizeGib` string, int64 — Output only. Size in GiB.
    - `diskType` 'TYPE_UNSPECIFIED' | 'GP2' | 'GP3' | 'IO1' | 'IO2' | 'ST1' | 'SC1' | 'STANDARD' — Optional. Output only. Disk type.
    - `volumeId` string — Required. AWS volume ID.
    - `tags` object — Optional. Output only. A map of AWS volume tags.
  - `updateTime` string, google-datetime — Output only. The last time the DiskMigrationJob resource was updated.
  - `errors` Status[] — Output only. Provides details on the errors that led to the disk migration job's state in case of an error.
    - `details` object[] — A list of messages that carry the error details. There is a common set of message types for APIs to use.
    - `message` string — A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
    - `code` integer — The status code, which should be an enum value of google.rpc.Code.
  - `targetDetails` DiskMigrationJobTargetDetails — Details of the target disk in Compute Engine.
    - `encryption` Encryption — Encryption message describes the details of the applied encryption.
      - `kmsKey` string — Required. The name of the encryption key that is stored in Google Cloud KMS.
    - `targetDisk` ComputeEngineDisk — Compute Engine disk target details.
      - `replicaZones` string[] — Optional. Replication zones of the regional disk. Should be of the form: projects/{target-project}/locations/{replica-zone} Currently only one replica zone is supported.
      - `diskType` 'COMPUTE_ENGINE_DISK_TYPE_UNSPECIFIED' | 'COMPUTE_ENGINE_DISK_TYPE_STANDARD' | 'COMPUTE_ENGINE_DISK_TYPE_SSD' | 'COMPUTE_ENGINE_DISK_TYPE_BALANCED' | 'COMPUTE_ENGINE_DISK_TYPE_HYPERDISK_BALANCED' | 'COMPUTE_ENGINE_DISK_TYPE_HYPERDISK_BALANCED_HIGH_AVAILABILITY' — Required. The disk type to use.
      - `diskId` string — Optional. Target Compute Engine Disk ID. This is the resource ID segment of the Compute Engine Disk to create. In the resource name compute/v1/projects/{project}/zones/{zone}/disks/disk1 "disk1" is the resource ID for the disk.
      - `zone` string — Required. The Compute Engine zone in which to create the disk. Should be of the form: projects/{target-project}/locations/{zone}
    - `labels` object — Optional. A map of labels to associate with the disk.
    - `targetProject` string — Required. The name of the resource of type TargetProject which represents the Compute Engine project in which to create the disk. Should be of the form: projects/{project}/locations/global/targetProjects/{target-project}
  - `createTime` string, google-datetime — Output only. The time the DiskMigrationJob resource was created.
  - `state` 'STATE_UNSPECIFIED' | 'READY' | 'RUNNING' | 'SUCCEEDED' | 'CANCELLING' | 'CANCELLED' | 'FAILED' — Output only. State of the DiskMigrationJob.
  - `name` string — Output only. Identifier. The identifier of the DiskMigrationJob.
  - `steps` DiskMigrationStep[] — Output only. The disk migration steps list representing its progress.
    - `endTime` string, google-datetime — Output only. The time the step has ended.
    - `provisioningTargetDisk` ProvisioningTargetDiskStep — ProvisioningTargetDiskStep contains specific step details.
    - `creatingSourceDiskSnapshot` CreatingSourceDiskSnapshotStep — CreatingSourceDiskSnapshotStep contains specific step details.
    - `startTime` string, google-datetime — Output only. The time the step has started.
    - `copyingSourceDiskSnapshot` CopyingSourceDiskSnapshotStep — CopyingSourceDiskSnapshotStep contains specific step details.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/vmmigration.md) · [All operations](https://skmtc.net/google/apis/vmmigration/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/vmmigration/versions/c812c34615f3/schema)