gcloud-help/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.