File: //snap/google-cloud-cli/394/lib/surface/migration/vms/machine_image_imports/create.yaml
- release_tracks: [ALPHA, GA]
help_text:
brief: import machine images to Google Compute Engine.
description: |
{command} Imports machine images such as OVA and OVF 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 ub-14.04.5.ova 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-machine-image-import \
--source-file=gs://my-images-bucket/ub-14.04.5.ova \
--image-name=my-ubuntu-machine-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:FixCreateMachineImageImportRequest
arguments:
resource:
help_text: The Image Import resource you want to create. This would be the machine image name if --machine-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.machine_image_import.flags:machine_image_name
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.machine_image_import.flags:target_project
- _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.machine_image_import.flags:skip_os_adaptation
- group:
params:
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.machine_image_import.flags:generalize
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.machine_image_import.flags:license_type
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.machine_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
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.machine_image_import.flags:description
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.machine_image_import.flags:single_region_storage
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.machine_image_import.flags:machine_type
- group:
help_text: The service account to assign to the instance created by the machine image.
required: false
params:
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.machine_image_import.flags:service_account
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.machine_image_import.flags:scopes
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.machine_image_import.flags:additional_licenses
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.machine_image_import.flags:labels
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.machine_image_import.flags:tags
- group:
help_text: Shielded instance configuration.
required: false
params:
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.machine_image_import.flags:secure_boot
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.machine_image_import.flags:enable_vtpm
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.machine_image_import.flags:enable_integrity_monitoring
- _REF_: googlecloudsdk.command_lib.migration.vms.image_import.machine_image_import.flags:network_interface