- NAME
-
- gcloud alpha migration vms machine-image-imports create - import machine images to Google Compute Engine
- SYNOPSIS
-
-
gcloud alpha migration vms machine-image-imports create
(IMAGE_IMPORT_NAME
:--location
=LOCATION
)--source-file
=SOURCE_FILE
[--additional-licenses
=[ADDITIONAL_LICENSES
,…]] [--description
=DESCRIPTION
] [--labels
=[KEY
=VALUE
,…]] [--machine-image-name
=MACHINE_IMAGE_NAME
] [--machine-type
=MACHINE_TYPE
] [--network-interface
=[network
=NETWORK
],[networkTier
=NETWORKTIER
],[subnetwork
=SUBNETWORK
]] [--single-region-storage
] [--tags
=[TAGS
,…]] [--target-project
=TARGET_PROJECT
] [--enable-integrity-monitoring
--enable-vtpm
--secure-boot
=SECURE_BOOT
] [--scopes
=[SCOPES
,…]--service-account
=SERVICE_ACCOUNT
] [--skip-os-adaptation
|--generalize
--license-type
=LICENSE_TYPE
] [GCLOUD_WIDE_FLAG …
]
-
- DESCRIPTION
-
(ALPHA)
gcloud alpha migration vms machine-image-imports create 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:
gcloud alpha migration vms machine-image-imports create 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
- POSITIONAL ARGUMENTS
-
-
Image import resource - The Image Import resource you want to create. This would
be the machine image name if --machine-image-name is not given. The arguments in
this group can be used to specify the attributes of this resource. (NOTE) Some
attributes are not given arguments in this group but can be set in other ways.
To set the
project
attribute:-
provide the argument
image_import_name
on the command line with a fully specified name; -
provide the argument
--project
on the command line; -
set the property
core/project
.
This must be specified.
IMAGE_IMPORT_NAME
-
ID of the image_import or fully qualified identifier for the image_import.
To set the
image_import_name
attribute:-
provide the argument
image_import_name
on the command line.
This positional argument must be specified if any of the other arguments in this group are specified.
-
provide the argument
--location
=LOCATION
-
Resource location.
To set the
location
attribute:-
provide the argument
image_import_name
on the command line with a fully specified name; -
provide the argument
--location
on the command line; -
set the property
compute/region
.
-
provide the argument
-
provide the argument
-
Image import resource - The Image Import resource you want to create. This would
be the machine image name if --machine-image-name is not given. The arguments in
this group can be used to specify the attributes of this resource. (NOTE) Some
attributes are not given arguments in this group but can be set in other ways.
- REQUIRED FLAGS
-
--source-file
=SOURCE_FILE
- The path to the Google Cloud Storage file from which the image should be imported.
- OPTIONAL FLAGS
-
--additional-licenses
=[ADDITIONAL_LICENSES
,…]- Comma-separated list of the additional licenses to assign to the machine image.
--description
=DESCRIPTION
- A description of the machine image.
--labels
=[KEY
=VALUE
,…]- A map of labels to associate with the machine image.
--machine-image-name
=MACHINE_IMAGE_NAME
- The name of the machine image that will be imported to Google Compute Engine. Default is the Image Import name.
--machine-type
=MACHINE_TYPE
- The machine type to create the machine image with. If not provided, the service will choose a relevant machine type series based on the information from the source image.
--network-interface
=[network
=NETWORK
],[networkTier
=NETWORKTIER
],[subnetwork
=SUBNETWORK
]-
The network interface to use for the instance created by the machine image. This
is a dicionary with the following keys:
- network: The network to use for this network interface.
- subnetwork: The subnetwork to use for this network interface.
- network-tier: The network tier to use for this network interface. This argument can be specified multiple times in case of multiple nics.
--single-region-storage
- If true, the location of the imported machine image will be the region of the import job. Otherwise the closest multi-region is selected. Default is false.
- The tags to apply to the instance created by the machine image.
--target-project
=TARGET_PROJECT
- The target project resource path to which the machine image will be imported. Default is the host project. To get a list of the target projects run the gcloud alpha migration vms target-projects list command.
-
Shielded instance configuration.
--enable-integrity-monitoring
- Defines whether the instance created by the machine image has integrity monitoring enabled. This can be set to true only if the image boot option is EFI, and vTPM is enabled.
--enable-vtpm
- Defines whether the instance created by the machine image has vTPM enabled. This can be set to true only if the image boot option is EFI.
--secure-boot
=SECURE_BOOT
-
Defines whether the instance created by the machine image has Secure Boot
enabled. This can be set to true only if the image boot option is EFI. If not
specified we will use the configuration of the source.
SECURE_BOOT
must be one of:false
,secure-boot-unspecified
,true
.
-
The service account to assign to the instance created by the machine image.
--scopes
=[SCOPES
,…]- The list of scopes to be made available for the service account.
--service-account
=SERVICE_ACCOUNT
- The email address of the service account.
-
OS adaptation parameters.
At most one of these can be specified:
--skip-os-adaptation
- If true, skip OS adaptation. Default false.
--generalize
- If true, generalize the imported machine image. Default false. The generalization process enables co-existence of multiple VMs created from the same machine image. For Windows, generalizing the machine image removes computer-specific information such as installed drivers and the computer security identifier (SID).
--license-type
=LICENSE_TYPE
-
The license to use post migration.
LICENSE_TYPE
must be one of:compute-engine-license-type-byol
,compute-engine-license-type-default
,compute-engine-license-type-payg
.
- GCLOUD WIDE FLAGS
-
These flags are available to all commands:
--access-token-file
,--account
,--billing-project
,--configuration
,--flags-file
,--flatten
,--format
,--help
,--impersonate-service-account
,--log-http
,--project
,--quiet
,--trace-token
,--user-output-enabled
,--verbosity
.Run
$ gcloud help
for details. - API REFERENCE
-
This command uses the
vmmigration/v1
API. The full documentation for this API can be found at: https://cloud.google.com/migrate/virtual-machines - NOTES
- This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early access allowlist.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-07-30 UTC.