gcloud alpha migration vms disk-migrations create

NAME
gcloud alpha migration vms disk-migrations create - create a disk migration resource to migrate a disk to Compute Engine
SYNOPSIS
gcloud alpha migration vms disk-migrations create (DISK_MIGRATION : --location=LOCATION --source=SOURCE) --source-volume-id=SOURCE_VOLUME_ID [--disk-id=DISK_ID] [--disk-type=DISK_TYPE] [--kms-key=KMS_KEY] [--labels=[KEY=VALUE,…]] [--target-project=TARGET_PROJECT] [--zone=ZONE] [GCLOUD_WIDE_FLAG …]
DESCRIPTION
(ALPHA) gcloud alpha migration vms disk-migrations create lets you create disk migration resource. You must create a disk migration resource before you can migrate your disk from any migration source to a Compute Engine disk. The disk migration resource tracks the progress of the disk migration. To use this command, you must enable VM Migration API in your project.

Note that this command only creates a disk migration resource. It does not initiate the disk migration process. After creating the disk migration resource, you must initiate the migration process using the run command.

EXAMPLES
To create a disk migration resource to migrate a volume vol-12345 from an AWS source my-aws-source to my-target-project in us-central1, create the my-disk-migration disk migration resource in my-project in us-central1, run: 
gcloud alpha migration vms disk-migrations create my-disk-migration --project=my-project --location=us-central1 --source=my-aws-source --source-volume-id=vol-12345 --disk-id=gcp-disk1 --target-project=projects/my-project/locations/global/targetProjects/my-target-project
POSITIONAL ARGUMENTS
Disk migration resource - The disk migration resource you want to create. This would be the disk ID if --disk-id 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 disk_migration 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.

DISK_MIGRATION
ID of the disk_migration or fully qualified identifier for the disk_migration.

To set the disk_migration attribute:

  • provide the argument disk_migration on the command line.

This positional argument must be specified if any of the other arguments in this group are specified.

--location=LOCATION
Resource location.

To set the location attribute:

  • provide the argument disk_migration on the command line with a fully specified name;
  • provide the argument --location on the command line;
  • set the property compute/region.
--source=SOURCE
The client source environment object.

To set the source attribute:

  • provide the argument disk_migration on the command line with a fully specified name;
  • provide the argument --source on the command line.
REQUIRED FLAGS
--source-volume-id=SOURCE_VOLUME_ID
The ID of the source volume that you want to migrate to Compute Engine.
OPTIONAL FLAGS
--disk-id=DISK_ID
The ID of the disk that will be migrated to Compute Engine. The default value is the disk migration resource name.
--disk-type=DISK_TYPE
The Compute Engine disk type to use for the migrated disk. The default value is COMPUTE_ENGINE_DISK_TYPE_STANDARD. DISK_TYPE must be one of:
compute-engine-disk-type-balanced
Compute Engine Disk Type Balanced.
compute-engine-disk-type-hyperdisk-balanced
Compute Engine Disk Type hyperdisk-balanced.
compute-engine-disk-type-ssd
Compute Engine Disk Type SSD.
compute-engine-disk-type-standard
Compute Engine Disk Type Standard.
--kms-key=KMS_KEY
Fully qualified identifier for the Cloud KMS (Key Management Service) cryptokey that will be used to protect the disk.
--labels=[KEY=VALUE,…]
A map of labels to associate with the disk.
--target-project=TARGET_PROJECT
The target project resource path to which the disk will be migrated. Default is the host project. To get a list of the target projects run the gcloud alpha migration vms target-projects list command.
--zone=ZONE
The zone in which to create the disk. The default value is the first zone of the Google Cloud location parameter given.
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.