File: //snap/google-cloud-cli/current/lib/surface/migration/vms/image_imports/create.yaml
- release_tracks: [ALPHA, GA]
help_text:
brief: import Virtual Disk images to Google Compute Engine.
description: |
{command} imports images such as VMWare VMDK files and VHD files, from a Google Cloud Storage
file (gs://...) to Google Compute Engine, using the Migrate to Virtual Machines service API.
This command creates an Image Import resource with a nested Image Import Job
resource. The Image Import Job resource tracks the image import progress.
To use this command, you must enable VM Migration API in your project.
examples: |
To import my-ubuntu22.04.vmdk from my-images-bucket to my-target-project in us-central1,
create my-image-import resource in my-project in us-central1.
Run:
$ {command} my-image-import \
--source-file=gs://my-images-bucket/my-ubuntu22.04.vmdk \
--image-name=my-ubuntu-image \
--location=us-central1 \
--target-project=projects/my-project/locations/global/targetProjects/my-target-project
--project=my-project
request:
collection: vmmigration.projects.locations.imageImports
modify_request_hooks:
- googlecloudsdk.command_lib.migration.vms.image_import.hooks:FixCreateDiskImageImportRequest
arguments:
resource:
help_text: The Image Import resource you want to create. This would be the image name if --image-name is not given.
spec: !REF googlecloudsdk.command_lib.migration.vms.resources:imageImport
params:
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.flags:source_file
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.disk_image_import.flags:image_name
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.disk_image_import.flags:target_project
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.disk_image_import.flags:description
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.disk_image_import.flags:family_name
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.disk_image_import.flags:labels
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.disk_image_import.flags:additional_licenses
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.disk_image_import.flags:single_region_storage
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.flags:kms_key
- group:
help_text: OS adaptation parameters
required: false
mutex: true
params:
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.disk_image_import.flags:skip_os_adaptation
- group:
params:
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.disk_image_import.flags:generalize
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.disk_image_import.flags:license_type
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.disk_image_import.flags:boot_conversion
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.disk_image_import.flags:adaptation_modifiers
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.disk_image_import.flags:rootfs_uuid