As of January 1, 2020 this library no longer supports Python 2 on the latest released version. Library versions released prior to that date will continue to be available. For more information please visit Python 2 support on Google Cloud.

Types for Google Cloud Vmmigration v1 API

class google.cloud.vmmigration_v1.types.AdaptingOSStep(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

AdaptingOSStep contains specific step details.

class google.cloud.vmmigration_v1.types.AddGroupMigrationRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘AddGroupMigration’ request.

group

Required. The full path name of the Group to add to.

Type

str

migrating_vm

The full path name of the MigratingVm to add.

Type

str

class google.cloud.vmmigration_v1.types.AddGroupMigrationResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Response message for ‘AddGroupMigration’ request.

class google.cloud.vmmigration_v1.types.ApplianceVersion(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Describes an appliance version.

version

The appliance version.

Type

str

uri

A link for downloading the version.

Type

str

critical

Determine whether it’s critical to upgrade the appliance to this version.

Type

bool

release_notes_uri

Link to a page that contains the version release notes.

Type

str

class google.cloud.vmmigration_v1.types.AppliedLicense(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

AppliedLicense holds the license data returned by adaptation module report.

type_

The license type that was used in OS adaptation.

Type

google.cloud.vmmigration_v1.types.AppliedLicense.Type

os_license

The OS license returned from the adaptation module’s report.

Type

str

class Type(value)[source]

Bases: proto.enums.Enum

License types used in OS adaptation.

Values:
TYPE_UNSPECIFIED (0):

Unspecified license for the OS.

NONE (1):

No license available for the OS.

PAYG (2):

The license type is Pay As You Go license type.

BYOL (3):

The license type is Bring Your Own License type.

class google.cloud.vmmigration_v1.types.AvailableUpdates(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Holds informatiom about the available versions for upgrade.

new_deployable_appliance

The newest deployable version of the appliance. The current appliance can’t be updated into this version, and the owner must manually deploy this OVA to a new appliance.

Type

google.cloud.vmmigration_v1.types.ApplianceVersion

in_place_update

The latest version for in place update. The current appliance can be updated to this version using the API or m4c CLI.

Type

google.cloud.vmmigration_v1.types.ApplianceVersion

class google.cloud.vmmigration_v1.types.AwsSecurityGroup(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

AwsSecurityGroup describes a security group of an AWS VM.

id

The AWS security group id.

Type

str

name

The AWS security group name.

Type

str

class google.cloud.vmmigration_v1.types.AwsSourceDetails(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

AwsSourceDetails message describes a specific source details for the AWS source type.

access_key_creds

AWS Credentials using access key id and secret.

This field is a member of oneof credentials_type.

Type

google.cloud.vmmigration_v1.types.AwsSourceDetails.AccessKeyCredentials

aws_region

Immutable. The AWS region that the source VMs will be migrated from.

Type

str

state

Output only. State of the source as determined by the health check.

Type

google.cloud.vmmigration_v1.types.AwsSourceDetails.State

error

Output only. Provides details on the state of the Source in case of an error.

Type

google.rpc.status_pb2.Status

inventory_tag_list

AWS resource tags to limit the scope of the source inventory.

Type

MutableSequence[google.cloud.vmmigration_v1.types.AwsSourceDetails.Tag]

inventory_security_group_names

AWS security group names to limit the scope of the source inventory.

Type

MutableSequence[str]

migration_resources_user_tags

User specified tags to add to every M2VM generated resource in AWS. These tags will be set in addition to the default tags that are set as part of the migration process. The tags must not begin with the reserved prefix m2vm.

Type

MutableMapping[str, str]

public_ip

Output only. The source’s public IP. All communication initiated by this source will originate from this IP.

Type

str

class AccessKeyCredentials(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Message describing AWS Credentials using access key id and secret.

access_key_id

AWS access key ID.

Type

str

secret_access_key

Input only. AWS secret access key.

Type

str

class MigrationResourcesUserTagsEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

class State(value)[source]

Bases: proto.enums.Enum

The possible values of the state.

Values:
STATE_UNSPECIFIED (0):

The state is unknown. This is used for API compatibility only and is not used by the system.

PENDING (1):

The state was not sampled by the health checks yet.

FAILED (2):

The source is available but might not be usable yet due to invalid credentials or another reason. The error message will contain further details.

ACTIVE (3):

The source exists and its credentials were verified.

class Tag(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Tag is an AWS tag representation.

key

Key of tag.

Type

str

value

Value of tag.

Type

str

class google.cloud.vmmigration_v1.types.AwsSourceVmDetails(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Represent the source AWS VM details.

firmware

The firmware type of the source VM.

Type

google.cloud.vmmigration_v1.types.AwsSourceVmDetails.Firmware

committed_storage_bytes

The total size of the disks being migrated in bytes.

Type

int

class Firmware(value)[source]

Bases: proto.enums.Enum

Possible values for AWS VM firmware.

Values:
FIRMWARE_UNSPECIFIED (0):

The firmware is unknown.

EFI (1):

The firmware is EFI.

BIOS (2):

The firmware is BIOS.

class google.cloud.vmmigration_v1.types.AwsVmDetails(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

AwsVmDetails describes a VM in AWS.

vm_id

The VM ID in AWS.

Type

str

display_name

The display name of the VM. Note that this value is not necessarily unique.

Type

str

source_id

The id of the AWS’s source this VM is connected to.

Type

str

source_description

The descriptive name of the AWS’s source this VM is connected to.

Type

str

power_state

Output only. The power state of the VM at the moment list was taken.

Type

google.cloud.vmmigration_v1.types.AwsVmDetails.PowerState

cpu_count

The number of cpus the VM has.

Type

int

memory_mb

The memory size of the VM in MB.

Type

int

disk_count

The number of disks the VM has.

Type

int

committed_storage_mb

The total size of the storage allocated to the VM in MB.

Type

int

os_description

The VM’s OS.

Type

str

boot_option

The VM Boot Option.

Type

google.cloud.vmmigration_v1.types.AwsVmDetails.BootOption

instance_type

The instance type of the VM.

Type

str

vpc_id

The VPC ID the VM belongs to.

Type

str

security_groups

The security groups the VM belongs to.

Type

MutableSequence[google.cloud.vmmigration_v1.types.AwsSecurityGroup]

tags

The tags of the VM.

Type

MutableMapping[str, str]

zone

The AWS zone of the VM.

Type

str

virtualization_type

The virtualization type.

Type

google.cloud.vmmigration_v1.types.AwsVmDetails.VmVirtualizationType

architecture

The CPU architecture.

Type

google.cloud.vmmigration_v1.types.AwsVmDetails.VmArchitecture

class BootOption(value)[source]

Bases: proto.enums.Enum

The possible values for the vm boot option.

Values:
BOOT_OPTION_UNSPECIFIED (0):

The boot option is unknown.

EFI (1):

The boot option is UEFI.

BIOS (2):

The boot option is LEGACY-BIOS.

class PowerState(value)[source]

Bases: proto.enums.Enum

Possible values for the power state of the VM.

Values:
POWER_STATE_UNSPECIFIED (0):

Power state is not specified.

ON (1):

The VM is turned on.

OFF (2):

The VM is turned off.

SUSPENDED (3):

The VM is suspended. This is similar to hibernation or sleep mode.

PENDING (4):

The VM is starting.

class TagsEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

class VmArchitecture(value)[source]

Bases: proto.enums.Enum

Possible values for the architectures of the VM.

Values:
VM_ARCHITECTURE_UNSPECIFIED (0):

The architecture is unknown.

I386 (1):

The architecture is I386.

X86_64 (2):

The architecture is X86_64.

ARM64 (3):

The architecture is ARM64.

X86_64_MAC (4):

The architecture is X86_64_MAC.

class VmVirtualizationType(value)[source]

Bases: proto.enums.Enum

Possible values for the virtualization types of the VM.

Values:
VM_VIRTUALIZATION_TYPE_UNSPECIFIED (0):

The virtualization type is unknown.

HVM (1):

The virtualziation type is HVM.

PARAVIRTUAL (2):

The virtualziation type is PARAVIRTUAL.

class google.cloud.vmmigration_v1.types.AwsVmsDetails(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

AWSVmsDetails describes VMs in AWS.

details

The details of the AWS VMs.

Type

MutableSequence[google.cloud.vmmigration_v1.types.AwsVmDetails]

class google.cloud.vmmigration_v1.types.CancelCloneJobRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘CancelCloneJob’ request.

name

Required. The clone job id

Type

str

class google.cloud.vmmigration_v1.types.CancelCloneJobResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Response message for ‘CancelCloneJob’ request.

class google.cloud.vmmigration_v1.types.CancelCutoverJobRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘CancelCutoverJob’ request.

name

Required. The cutover job id

Type

str

class google.cloud.vmmigration_v1.types.CancelCutoverJobResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Response message for ‘CancelCutoverJob’ request.

class google.cloud.vmmigration_v1.types.CloneJob(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

CloneJob describes the process of creating a clone of a [MigratingVM][google.cloud.vmmigration.v1.MigratingVm] to the requested target based on the latest successful uploaded snapshots. While the migration cycles of a MigratingVm take place, it is possible to verify the uploaded VM can be started in the cloud, by creating a clone. The clone can be created without any downtime, and it is created using the latest snapshots which are already in the cloud. The cloneJob is only responsible for its work, not its products, which means once it is finished, it will never touch the instance it created. It will only delete it in case of the CloneJob being cancelled or upon failure to clone.

compute_engine_target_details

Output only. Details of the target VM in Compute Engine.

This field is a member of oneof target_vm_details.

Type

google.cloud.vmmigration_v1.types.ComputeEngineTargetDetails

create_time

Output only. The time the clone job was created (as an API call, not when it was actually created in the target).

Type

google.protobuf.timestamp_pb2.Timestamp

end_time

Output only. The time the clone job was ended.

Type

google.protobuf.timestamp_pb2.Timestamp

name

Output only. The name of the clone.

Type

str

state

Output only. State of the clone job.

Type

google.cloud.vmmigration_v1.types.CloneJob.State

state_time

Output only. The time the state was last updated.

Type

google.protobuf.timestamp_pb2.Timestamp

error

Output only. Provides details for the errors that led to the Clone Job’s state.

Type

google.rpc.status_pb2.Status

steps

Output only. The clone steps list representing its progress.

Type

MutableSequence[google.cloud.vmmigration_v1.types.CloneStep]

class State(value)[source]

Bases: proto.enums.Enum

Possible states of the clone job.

Values:
STATE_UNSPECIFIED (0):

The state is unknown. This is used for API compatibility only and is not used by the system.

PENDING (1):

The clone job has not yet started.

ACTIVE (2):

The clone job is active and running.

FAILED (3):

The clone job finished with errors.

SUCCEEDED (4):

The clone job finished successfully.

CANCELLED (5):

The clone job was cancelled.

CANCELLING (6):

The clone job is being cancelled.

ADAPTING_OS (7):

OS adaptation is running as part of the clone job to generate license.

class google.cloud.vmmigration_v1.types.CloneStep(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

CloneStep holds information about the clone step progress.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

adapting_os

Adapting OS step.

This field is a member of oneof step.

Type

google.cloud.vmmigration_v1.types.AdaptingOSStep

preparing_vm_disks

Preparing VM disks step.

This field is a member of oneof step.

Type

google.cloud.vmmigration_v1.types.PreparingVMDisksStep

instantiating_migrated_vm

Instantiating migrated VM step.

This field is a member of oneof step.

Type

google.cloud.vmmigration_v1.types.InstantiatingMigratedVMStep

start_time

The time the step has started.

Type

google.protobuf.timestamp_pb2.Timestamp

end_time

The time the step has ended.

Type

google.protobuf.timestamp_pb2.Timestamp

class google.cloud.vmmigration_v1.types.ComputeEngineBootOption(value)[source]

Bases: proto.enums.Enum

Possible values for vm boot option.

Values:
COMPUTE_ENGINE_BOOT_OPTION_UNSPECIFIED (0):

The boot option is unknown.

COMPUTE_ENGINE_BOOT_OPTION_EFI (1):

The boot option is EFI.

COMPUTE_ENGINE_BOOT_OPTION_BIOS (2):

The boot option is BIOS.

class google.cloud.vmmigration_v1.types.ComputeEngineDiskType(value)[source]

Bases: proto.enums.Enum

Types of disks supported for Compute Engine VM.

Values:
COMPUTE_ENGINE_DISK_TYPE_UNSPECIFIED (0):

An unspecified disk type. Will be used as STANDARD.

COMPUTE_ENGINE_DISK_TYPE_STANDARD (1):

A Standard disk type.

COMPUTE_ENGINE_DISK_TYPE_SSD (2):

SSD hard disk type.

COMPUTE_ENGINE_DISK_TYPE_BALANCED (3):

An alternative to SSD persistent disks that balance performance and cost.

class google.cloud.vmmigration_v1.types.ComputeEngineLicenseType(value)[source]

Bases: proto.enums.Enum

Types of licenses used in OS adaptation.

Values:
COMPUTE_ENGINE_LICENSE_TYPE_DEFAULT (0):

The license type is the default for the OS.

COMPUTE_ENGINE_LICENSE_TYPE_PAYG (1):

The license type is Pay As You Go license type.

COMPUTE_ENGINE_LICENSE_TYPE_BYOL (2):

The license type is Bring Your Own License type.

class google.cloud.vmmigration_v1.types.ComputeEngineTargetDefaults(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

ComputeEngineTargetDefaults is a collection of details for creating a VM in a target Compute Engine project.

vm_name

The name of the VM to create.

Type

str

target_project

The full path of the resource of type TargetProject which represents the Compute Engine project in which to create this VM.

Type

str

zone

The zone in which to create the VM.

Type

str

machine_type_series

The machine type series to create the VM with.

Type

str

machine_type

The machine type to create the VM with.

Type

str

network_tags

A map of network tags to associate with the VM.

Type

MutableSequence[str]

network_interfaces

List of NICs connected to this VM.

Type

MutableSequence[google.cloud.vmmigration_v1.types.NetworkInterface]

service_account

The service account to associate the VM with.

Type

str

disk_type

The disk type to use in the VM.

Type

google.cloud.vmmigration_v1.types.ComputeEngineDiskType

labels

A map of labels to associate with the VM.

Type

MutableMapping[str, str]

license_type

The license type to use in OS adaptation.

Type

google.cloud.vmmigration_v1.types.ComputeEngineLicenseType

applied_license

Output only. The OS license returned from the adaptation module report.

Type

google.cloud.vmmigration_v1.types.AppliedLicense

compute_scheduling

Compute instance scheduling information (if empty default is used).

Type

google.cloud.vmmigration_v1.types.ComputeScheduling

secure_boot

Defines whether the instance has Secure Boot enabled. This can be set to true only if the vm boot option is EFI.

Type

bool

boot_option

Output only. The VM Boot Option, as set in the source vm.

Type

google.cloud.vmmigration_v1.types.ComputeEngineBootOption

metadata

The metadata key/value pairs to assign to the VM.

Type

MutableMapping[str, str]

additional_licenses

Additional licenses to assign to the VM.

Type

MutableSequence[str]

hostname

The hostname to assign to the VM.

Type

str

class LabelsEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

class MetadataEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

class google.cloud.vmmigration_v1.types.ComputeEngineTargetDetails(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

ComputeEngineTargetDetails is a collection of details for creating a VM in a target Compute Engine project.

vm_name

The name of the VM to create.

Type

str

project

The Google Cloud target project ID or project name.

Type

str

zone

The zone in which to create the VM.

Type

str

machine_type_series

The machine type series to create the VM with.

Type

str

machine_type

The machine type to create the VM with.

Type

str

network_tags

A map of network tags to associate with the VM.

Type

MutableSequence[str]

network_interfaces

List of NICs connected to this VM.

Type

MutableSequence[google.cloud.vmmigration_v1.types.NetworkInterface]

service_account

The service account to associate the VM with.

Type

str

disk_type

The disk type to use in the VM.

Type

google.cloud.vmmigration_v1.types.ComputeEngineDiskType

labels

A map of labels to associate with the VM.

Type

MutableMapping[str, str]

license_type

The license type to use in OS adaptation.

Type

google.cloud.vmmigration_v1.types.ComputeEngineLicenseType

applied_license

The OS license returned from the adaptation module report.

Type

google.cloud.vmmigration_v1.types.AppliedLicense

compute_scheduling

Compute instance scheduling information (if empty default is used).

Type

google.cloud.vmmigration_v1.types.ComputeScheduling

secure_boot

Defines whether the instance has Secure Boot enabled. This can be set to true only if the vm boot option is EFI.

Type

bool

boot_option

The VM Boot Option, as set in the source vm.

Type

google.cloud.vmmigration_v1.types.ComputeEngineBootOption

metadata

The metadata key/value pairs to assign to the VM.

Type

MutableMapping[str, str]

additional_licenses

Additional licenses to assign to the VM.

Type

MutableSequence[str]

hostname

The hostname to assign to the VM.

Type

str

class LabelsEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

class MetadataEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

class google.cloud.vmmigration_v1.types.ComputeScheduling(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Scheduling information for VM on maintenance/restart behaviour and node allocation in sole tenant nodes.

on_host_maintenance

How the instance should behave when the host machine undergoes maintenance that may temporarily impact instance performance.

Type

google.cloud.vmmigration_v1.types.ComputeScheduling.OnHostMaintenance

restart_type

Whether the Instance should be automatically restarted whenever it is terminated by Compute Engine (not terminated by user). This configuration is identical to automaticRestart field in Compute Engine create instance under scheduling. It was changed to an enum (instead of a boolean) to match the default value in Compute Engine which is automatic restart.

Type

google.cloud.vmmigration_v1.types.ComputeScheduling.RestartType

node_affinities

A set of node affinity and anti-affinity configurations for sole tenant nodes.

Type

MutableSequence[google.cloud.vmmigration_v1.types.SchedulingNodeAffinity]

min_node_cpus

The minimum number of virtual CPUs this instance will consume when running on a sole-tenant node. Ignored if no node_affinites are configured.

Type

int

class OnHostMaintenance(value)[source]

Bases: proto.enums.Enum

Values:
ON_HOST_MAINTENANCE_UNSPECIFIED (0):

An unknown, unexpected behavior.

TERMINATE (1):

Terminate the instance when the host machine undergoes maintenance.

MIGRATE (2):

Migrate the instance when the host machine undergoes maintenance.

class RestartType(value)[source]

Bases: proto.enums.Enum

Defines whether the Instance should be automatically restarted whenever it is terminated by Compute Engine (not terminated by user).

Values:
RESTART_TYPE_UNSPECIFIED (0):

Unspecified behavior. This will use the default.

AUTOMATIC_RESTART (1):

The Instance should be automatically restarted whenever it is terminated by Compute Engine.

NO_AUTOMATIC_RESTART (2):

The Instance isn’t automatically restarted whenever it is terminated by Compute Engine.

class google.cloud.vmmigration_v1.types.CreateCloneJobRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘CreateCloneJob’ request.

parent

Required. The Clone’s parent.

Type

str

clone_job_id

Required. The clone job identifier.

Type

str

clone_job

Required. The clone request body.

Type

google.cloud.vmmigration_v1.types.CloneJob

request_id

A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request.

For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

Type

str

class google.cloud.vmmigration_v1.types.CreateCutoverJobRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘CreateCutoverJob’ request.

parent

Required. The Cutover’s parent.

Type

str

cutover_job_id

Required. The cutover job identifier.

Type

str

cutover_job

Required. The cutover request body.

Type

google.cloud.vmmigration_v1.types.CutoverJob

request_id

A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request.

For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

Type

str

class google.cloud.vmmigration_v1.types.CreateDatacenterConnectorRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘CreateDatacenterConnector’ request.

parent

Required. The DatacenterConnector’s parent. Required. The Source in where the new DatacenterConnector will be created. For example: projects/my-project/locations/us-central1/sources/my-source

Type

str

datacenter_connector_id

Required. The datacenterConnector identifier.

Type

str

datacenter_connector

Required. The create request body.

Type

google.cloud.vmmigration_v1.types.DatacenterConnector

request_id

A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request.

For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

Type

str

class google.cloud.vmmigration_v1.types.CreateGroupRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘CreateGroup’ request.

parent

Required. The Group’s parent.

Type

str

group_id

Required. The group identifier.

Type

str

group

Required. The create request body.

Type

google.cloud.vmmigration_v1.types.Group

request_id

A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request.

For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

Type

str

class google.cloud.vmmigration_v1.types.CreateMigratingVmRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘CreateMigratingVm’ request.

parent

Required. The MigratingVm’s parent.

Type

str

migrating_vm_id

Required. The migratingVm identifier.

Type

str

migrating_vm

Required. The create request body.

Type

google.cloud.vmmigration_v1.types.MigratingVm

request_id

A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request.

For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

Type

str

class google.cloud.vmmigration_v1.types.CreateSourceRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘CreateSource’ request.

parent

Required. The Source’s parent.

Type

str

source_id

Required. The source identifier.

Type

str

source

Required. The create request body.

Type

google.cloud.vmmigration_v1.types.Source

request_id

A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request.

For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

Type

str

class google.cloud.vmmigration_v1.types.CreateTargetProjectRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘CreateTargetProject’ request.

parent

Required. The TargetProject’s parent.

Type

str

target_project_id

Required. The target_project identifier.

Type

str

target_project

Required. The create request body.

Type

google.cloud.vmmigration_v1.types.TargetProject

request_id

A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request.

For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

Type

str

class google.cloud.vmmigration_v1.types.CreateUtilizationReportRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘CreateUtilizationReport’ request.

parent

Required. The Utilization Report’s parent.

Type

str

utilization_report

Required. The report to create.

Type

google.cloud.vmmigration_v1.types.UtilizationReport

utilization_report_id

Required. The ID to use for the report, which will become the final component of the reports’s resource name.

This value maximum length is 63 characters, and valid characters are /[a-z][0-9]-/. It must start with an english letter and must not end with a hyphen.

Type

str

request_id

A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request.

For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

Type

str

class google.cloud.vmmigration_v1.types.CutoverJob(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

CutoverJob message describes a cutover of a migrating VM. The CutoverJob is the operation of shutting down the VM, creating a snapshot and clonning the VM using the replicated snapshot.

compute_engine_target_details

Output only. Details of the target VM in Compute Engine.

This field is a member of oneof target_vm_details.

Type

google.cloud.vmmigration_v1.types.ComputeEngineTargetDetails

create_time

Output only. The time the cutover job was created (as an API call, not when it was actually created in the target).

Type

google.protobuf.timestamp_pb2.Timestamp

end_time

Output only. The time the cutover job had finished.

Type

google.protobuf.timestamp_pb2.Timestamp

name

Output only. The name of the cutover job.

Type

str

state

Output only. State of the cutover job.

Type

google.cloud.vmmigration_v1.types.CutoverJob.State

state_time

Output only. The time the state was last updated.

Type

google.protobuf.timestamp_pb2.Timestamp

progress_percent

Output only. The current progress in percentage of the cutover job.

Type

int

error

Output only. Provides details for the errors that led to the Cutover Job’s state.

Type

google.rpc.status_pb2.Status

state_message

Output only. A message providing possible extra details about the current state.

Type

str

steps

Output only. The cutover steps list representing its progress.

Type

MutableSequence[google.cloud.vmmigration_v1.types.CutoverStep]

class State(value)[source]

Bases: proto.enums.Enum

Possible states of the cutover job.

Values:
STATE_UNSPECIFIED (0):

The state is unknown. This is used for API compatibility only and is not used by the system.

PENDING (1):

The cutover job has not yet started.

FAILED (2):

The cutover job finished with errors.

SUCCEEDED (3):

The cutover job finished successfully.

CANCELLED (4):

The cutover job was cancelled.

CANCELLING (5):

The cutover job is being cancelled.

ACTIVE (6):

The cutover job is active and running.

ADAPTING_OS (7):

OS adaptation is running as part of the cutover job to generate license.

class google.cloud.vmmigration_v1.types.CutoverStep(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

CutoverStep holds information about the cutover step progress.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

previous_replication_cycle

A replication cycle prior cutover step.

This field is a member of oneof step.

Type

google.cloud.vmmigration_v1.types.ReplicationCycle

shutting_down_source_vm

Shutting down VM step.

This field is a member of oneof step.

Type

google.cloud.vmmigration_v1.types.ShuttingDownSourceVMStep

final_sync

Final sync step.

This field is a member of oneof step.

Type

google.cloud.vmmigration_v1.types.ReplicationCycle

preparing_vm_disks

Preparing VM disks step.

This field is a member of oneof step.

Type

google.cloud.vmmigration_v1.types.PreparingVMDisksStep

instantiating_migrated_vm

Instantiating migrated VM step.

This field is a member of oneof step.

Type

google.cloud.vmmigration_v1.types.InstantiatingMigratedVMStep

start_time

The time the step has started.

Type

google.protobuf.timestamp_pb2.Timestamp

end_time

The time the step has ended.

Type

google.protobuf.timestamp_pb2.Timestamp

class google.cloud.vmmigration_v1.types.CycleStep(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

CycleStep holds information about a step progress.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

initializing_replication

Initializing replication step.

This field is a member of oneof step.

Type

google.cloud.vmmigration_v1.types.InitializingReplicationStep

replicating

Replicating step.

This field is a member of oneof step.

Type

google.cloud.vmmigration_v1.types.ReplicatingStep

post_processing

Post processing step.

This field is a member of oneof step.

Type

google.cloud.vmmigration_v1.types.PostProcessingStep

start_time

The time the cycle step has started.

Type

google.protobuf.timestamp_pb2.Timestamp

end_time

The time the cycle step has ended.

Type

google.protobuf.timestamp_pb2.Timestamp

class google.cloud.vmmigration_v1.types.DatacenterConnector(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

DatacenterConnector message describes a connector between the Source and Google Cloud, which is installed on a vmware datacenter (an OVA vm installed by the user) to connect the Datacenter to Google Cloud and support vm migration data transfer.

create_time

Output only. The time the connector was created (as an API call, not when it was actually installed).

Type

google.protobuf.timestamp_pb2.Timestamp

update_time

Output only. The last time the connector was updated with an API call.

Type

google.protobuf.timestamp_pb2.Timestamp

name

Output only. The connector’s name.

Type

str

registration_id

Immutable. A unique key for this connector. This key is internal to the OVA connector and is supplied with its creation during the registration process and can not be modified.

Type

str

service_account

The service account to use in the connector when communicating with the cloud.

Type

str

version

The version running in the DatacenterConnector. This is supplied by the OVA connector during the registration process and can not be modified.

Type

str

bucket

Output only. The communication channel between the datacenter connector and Google Cloud.

Type

str

state

Output only. State of the DatacenterConnector, as determined by the health checks.

Type

google.cloud.vmmigration_v1.types.DatacenterConnector.State

state_time

Output only. The time the state was last set.

Type

google.protobuf.timestamp_pb2.Timestamp

error

Output only. Provides details on the state of the Datacenter Connector in case of an error.

Type

google.rpc.status_pb2.Status

appliance_infrastructure_version

Output only. Appliance OVA version. This is the OVA which is manually installed by the user and contains the infrastructure for the automatically updatable components on the appliance.

Type

str

appliance_software_version

Output only. Appliance last installed update bundle version. This is the version of the automatically updatable components on the appliance.

Type

str

available_versions

Output only. The available versions for updating this appliance.

Type

google.cloud.vmmigration_v1.types.AvailableUpdates

upgrade_status

Output only. The status of the current / last upgradeAppliance operation.

Type

google.cloud.vmmigration_v1.types.UpgradeStatus

class State(value)[source]

Bases: proto.enums.Enum

The possible values of the state.

Values:
STATE_UNSPECIFIED (0):

The state is unknown. This is used for API compatibility only and is not used by the system.

PENDING (1):

The state was not sampled by the health checks yet.

OFFLINE (2):

The source was sampled by health checks and is not available.

FAILED (3):

The source is available but might not be usable yet due to unvalidated credentials or another reason. The credentials referred to are the ones to the Source. The error message will contain further details.

ACTIVE (4):

The source exists and its credentials were verified.

class google.cloud.vmmigration_v1.types.DeleteDatacenterConnectorRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘DeleteDatacenterConnector’ request.

name

Required. The DatacenterConnector name.

Type

str

request_id

A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request.

For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

Type

str

class google.cloud.vmmigration_v1.types.DeleteGroupRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘DeleteGroup’ request.

name

Required. The Group name.

Type

str

request_id

Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request.

For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

Type

str

class google.cloud.vmmigration_v1.types.DeleteMigratingVmRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘DeleteMigratingVm’ request.

name

Required. The name of the MigratingVm.

Type

str

class google.cloud.vmmigration_v1.types.DeleteSourceRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘DeleteSource’ request.

name

Required. The Source name.

Type

str

request_id

Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request.

For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

Type

str

class google.cloud.vmmigration_v1.types.DeleteTargetProjectRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘DeleteTargetProject’ request.

name

Required. The TargetProject name.

Type

str

request_id

Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request.

For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

Type

str

class google.cloud.vmmigration_v1.types.DeleteUtilizationReportRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘DeleteUtilizationReport’ request.

name

Required. The Utilization Report name.

Type

str

request_id

Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request.

For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

Type

str

class google.cloud.vmmigration_v1.types.FetchInventoryRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for [fetchInventory][google.cloud.vmmigration.v1.VmMigration.FetchInventory].

source

Required. The name of the Source.

Type

str

force_refresh

If this flag is set to true, the source will be queried instead of using cached results. Using this flag will make the call slower.

Type

bool

class google.cloud.vmmigration_v1.types.FetchInventoryResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Response message for [fetchInventory][google.cloud.vmmigration.v1.VmMigration.FetchInventory].

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

vmware_vms

The description of the VMs in a Source of type Vmware.

This field is a member of oneof SourceVms.

Type

google.cloud.vmmigration_v1.types.VmwareVmsDetails

aws_vms

The description of the VMs in a Source of type AWS.

This field is a member of oneof SourceVms.

Type

google.cloud.vmmigration_v1.types.AwsVmsDetails

update_time

Output only. The timestamp when the source was last queried (if the result is from the cache).

Type

google.protobuf.timestamp_pb2.Timestamp

class google.cloud.vmmigration_v1.types.FinalizeMigrationRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘FinalizeMigration’ request.

migrating_vm

Required. The name of the MigratingVm.

Type

str

class google.cloud.vmmigration_v1.types.FinalizeMigrationResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Response message for ‘FinalizeMigration’ request.

class google.cloud.vmmigration_v1.types.GetCloneJobRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘GetCloneJob’ request.

name

Required. The name of the CloneJob.

Type

str

class google.cloud.vmmigration_v1.types.GetCutoverJobRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘GetCutoverJob’ request.

name

Required. The name of the CutoverJob.

Type

str

class google.cloud.vmmigration_v1.types.GetDatacenterConnectorRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘GetDatacenterConnector’ request.

name

Required. The name of the DatacenterConnector.

Type

str

class google.cloud.vmmigration_v1.types.GetGroupRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘GetGroup’ request.

name

Required. The group name.

Type

str

class google.cloud.vmmigration_v1.types.GetMigratingVmRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘GetMigratingVm’ request.

name

Required. The name of the MigratingVm.

Type

str

view

Optional. The level of details of the migrating VM.

Type

google.cloud.vmmigration_v1.types.MigratingVmView

class google.cloud.vmmigration_v1.types.GetReplicationCycleRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘GetReplicationCycle’ request.

name

Required. The name of the ReplicationCycle.

Type

str

class google.cloud.vmmigration_v1.types.GetSourceRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘GetSource’ request.

name

Required. The Source name.

Type

str

class google.cloud.vmmigration_v1.types.GetTargetProjectRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘GetTargetProject’ call.

name

Required. The TargetProject name.

Type

str

class google.cloud.vmmigration_v1.types.GetUtilizationReportRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘GetUtilizationReport’ request.

name

Required. The Utilization Report name.

Type

str

view

Optional. The level of details of the report. Defaults to FULL

Type

google.cloud.vmmigration_v1.types.UtilizationReportView

class google.cloud.vmmigration_v1.types.Group(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Describes message for ‘Group’ resource. The Group is a collections of several MigratingVms.

name

Output only. The Group name.

Type

str

create_time

Output only. The create time timestamp.

Type

google.protobuf.timestamp_pb2.Timestamp

update_time

Output only. The update time timestamp.

Type

google.protobuf.timestamp_pb2.Timestamp

description

User-provided description of the group.

Type

str

display_name

Display name is a user defined name for this group which can be updated.

Type

str

class google.cloud.vmmigration_v1.types.InitializingReplicationStep(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

InitializingReplicationStep contains specific step details.

class google.cloud.vmmigration_v1.types.InstantiatingMigratedVMStep(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

InstantiatingMigratedVMStep contains specific step details.

class google.cloud.vmmigration_v1.types.ListCloneJobsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘ListCloneJobsRequest’ request.

parent

Required. The parent, which owns this collection of source VMs.

Type

str

page_size

Optional. The maximum number of clone jobs to return. The service may return fewer than this value. If unspecified, at most 500 clone jobs will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

Type

int

page_token

Required. A page token, received from a previous ListCloneJobs call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListCloneJobs must match the call that provided the page token.

Type

str

filter

Optional. The filter request.

Type

str

order_by

Optional. the order by fields for the result.

Type

str

class google.cloud.vmmigration_v1.types.ListCloneJobsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Response message for ‘ListCloneJobs’ request.

clone_jobs

Output only. The list of clone jobs response.

Type

MutableSequence[google.cloud.vmmigration_v1.types.CloneJob]

next_page_token

Output only. A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

unreachable

Output only. Locations that could not be reached.

Type

MutableSequence[str]

class google.cloud.vmmigration_v1.types.ListCutoverJobsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘ListCutoverJobsRequest’ request.

parent

Required. The parent, which owns this collection of migrating VMs.

Type

str

page_size

Optional. The maximum number of cutover jobs to return. The service may return fewer than this value. If unspecified, at most 500 cutover jobs will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

Type

int

page_token

Required. A page token, received from a previous ListCutoverJobs call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListCutoverJobs must match the call that provided the page token.

Type

str

filter

Optional. The filter request.

Type

str

order_by

Optional. the order by fields for the result.

Type

str

class google.cloud.vmmigration_v1.types.ListCutoverJobsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Response message for ‘ListCutoverJobs’ request.

cutover_jobs

Output only. The list of cutover jobs response.

Type

MutableSequence[google.cloud.vmmigration_v1.types.CutoverJob]

next_page_token

Output only. A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

unreachable

Output only. Locations that could not be reached.

Type

MutableSequence[str]

class google.cloud.vmmigration_v1.types.ListDatacenterConnectorsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘ListDatacenterConnectors’ request.

parent

Required. The parent, which owns this collection of connectors.

Type

str

page_size

Optional. The maximum number of connectors to return. The service may return fewer than this value. If unspecified, at most 500 sources will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

Type

int

page_token

Required. A page token, received from a previous ListDatacenterConnectors call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListDatacenterConnectors must match the call that provided the page token.

Type

str

filter

Optional. The filter request.

Type

str

order_by

Optional. the order by fields for the result.

Type

str

class google.cloud.vmmigration_v1.types.ListDatacenterConnectorsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Response message for ‘ListDatacenterConnectors’ request.

datacenter_connectors

Output only. The list of sources response.

Type

MutableSequence[google.cloud.vmmigration_v1.types.DatacenterConnector]

next_page_token

Output only. A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

unreachable

Output only. Locations that could not be reached.

Type

MutableSequence[str]

class google.cloud.vmmigration_v1.types.ListGroupsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘ListGroups’ request.

parent

Required. The parent, which owns this collection of groups.

Type

str

page_size

Optional. The maximum number of groups to return. The service may return fewer than this value. If unspecified, at most 500 groups will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

Type

int

page_token

Required. A page token, received from a previous ListGroups call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListGroups must match the call that provided the page token.

Type

str

filter

Optional. The filter request.

Type

str

order_by

Optional. the order by fields for the result.

Type

str

class google.cloud.vmmigration_v1.types.ListGroupsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Response message for ‘ListGroups’ request.

groups

Output only. The list of groups response.

Type

MutableSequence[google.cloud.vmmigration_v1.types.Group]

next_page_token

Output only. A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

unreachable

Output only. Locations that could not be reached.

Type

MutableSequence[str]

class google.cloud.vmmigration_v1.types.ListMigratingVmsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘LisMigratingVmsRequest’ request.

parent

Required. The parent, which owns this collection of MigratingVms.

Type

str

page_size

Optional. The maximum number of migrating VMs to return. The service may return fewer than this value. If unspecified, at most 500 migrating VMs will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

Type

int

page_token

Required. A page token, received from a previous ListMigratingVms call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListMigratingVms must match the call that provided the page token.

Type

str

filter

Optional. The filter request.

Type

str

order_by

Optional. the order by fields for the result.

Type

str

view

Optional. The level of details of each migrating VM.

Type

google.cloud.vmmigration_v1.types.MigratingVmView

class google.cloud.vmmigration_v1.types.ListMigratingVmsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Response message for ‘ListMigratingVms’ request.

migrating_vms

Output only. The list of Migrating VMs response.

Type

MutableSequence[google.cloud.vmmigration_v1.types.MigratingVm]

next_page_token

Output only. A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

unreachable

Output only. Locations that could not be reached.

Type

MutableSequence[str]

class google.cloud.vmmigration_v1.types.ListReplicationCyclesRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘LisReplicationCyclesRequest’ request.

parent

Required. The parent, which owns this collection of ReplicationCycles.

Type

str

page_size

Optional. The maximum number of replication cycles to return. The service may return fewer than this value. If unspecified, at most 100 migrating VMs will be returned. The maximum value is 100; values above 100 will be coerced to 100.

Type

int

page_token

Required. A page token, received from a previous ListReplicationCycles call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListReplicationCycles must match the call that provided the page token.

Type

str

filter

Optional. The filter request.

Type

str

order_by

Optional. the order by fields for the result.

Type

str

class google.cloud.vmmigration_v1.types.ListReplicationCyclesResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Response message for ‘ListReplicationCycles’ request.

replication_cycles

Output only. The list of replication cycles response.

Type

MutableSequence[google.cloud.vmmigration_v1.types.ReplicationCycle]

next_page_token

Output only. A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

unreachable

Output only. Locations that could not be reached.

Type

MutableSequence[str]

class google.cloud.vmmigration_v1.types.ListSourcesRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘ListSources’ request.

parent

Required. The parent, which owns this collection of sources.

Type

str

page_size

Optional. The maximum number of sources to return. The service may return fewer than this value. If unspecified, at most 500 sources will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

Type

int

page_token

Required. A page token, received from a previous ListSources call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListSources must match the call that provided the page token.

Type

str

filter

Optional. The filter request.

Type

str

order_by

Optional. the order by fields for the result.

Type

str

class google.cloud.vmmigration_v1.types.ListSourcesResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Response message for ‘ListSources’ request.

sources

Output only. The list of sources response.

Type

MutableSequence[google.cloud.vmmigration_v1.types.Source]

next_page_token

Output only. A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

unreachable

Output only. Locations that could not be reached.

Type

MutableSequence[str]

class google.cloud.vmmigration_v1.types.ListTargetProjectsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘ListTargetProjects’ call.

parent

Required. The parent, which owns this collection of targets.

Type

str

page_size

Optional. The maximum number of targets to return. The service may return fewer than this value. If unspecified, at most 500 targets will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

Type

int

page_token

Required. A page token, received from a previous ListTargets call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListTargets must match the call that provided the page token.

Type

str

filter

Optional. The filter request.

Type

str

order_by

Optional. the order by fields for the result.

Type

str

class google.cloud.vmmigration_v1.types.ListTargetProjectsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Response message for ‘ListTargetProjects’ call.

target_projects

Output only. The list of target response.

Type

MutableSequence[google.cloud.vmmigration_v1.types.TargetProject]

next_page_token

Output only. A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

unreachable

Output only. Locations that could not be reached.

Type

MutableSequence[str]

class google.cloud.vmmigration_v1.types.ListUtilizationReportsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘ListUtilizationReports’ request.

parent

Required. The Utilization Reports parent.

Type

str

view

Optional. The level of details of each report. Defaults to BASIC.

Type

google.cloud.vmmigration_v1.types.UtilizationReportView

page_size

Optional. The maximum number of reports to return. The service may return fewer than this value. If unspecified, at most 500 reports will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

Type

int

page_token

Required. A page token, received from a previous ListUtilizationReports call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListUtilizationReports must match the call that provided the page token.

Type

str

filter

Optional. The filter request.

Type

str

order_by

Optional. the order by fields for the result.

Type

str

class google.cloud.vmmigration_v1.types.ListUtilizationReportsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Response message for ‘ListUtilizationReports’ request.

utilization_reports

Output only. The list of reports.

Type

MutableSequence[google.cloud.vmmigration_v1.types.UtilizationReport]

next_page_token

Output only. A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

unreachable

Output only. Locations that could not be reached.

Type

MutableSequence[str]

class google.cloud.vmmigration_v1.types.MigratingVm(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

MigratingVm describes the VM that will be migrated from a Source environment and its replication state.

compute_engine_target_defaults

Details of the target VM in Compute Engine.

This field is a member of oneof target_vm_defaults.

Type

google.cloud.vmmigration_v1.types.ComputeEngineTargetDefaults

aws_source_vm_details

Output only. Details of the VM from an AWS source.

This field is a member of oneof source_vm_details.

Type

google.cloud.vmmigration_v1.types.AwsSourceVmDetails

name

Output only. The identifier of the MigratingVm.

Type

str

source_vm_id

The unique ID of the VM in the source. The VM’s name in vSphere can be changed, so this is not the VM’s name but rather its moRef id. This id is of the form vm-<num>.

Type

str

display_name

The display name attached to the MigratingVm by the user.

Type

str

description

The description attached to the migrating VM by the user.

Type

str

policy

The replication schedule policy.

Type

google.cloud.vmmigration_v1.types.SchedulePolicy

create_time

Output only. The time the migrating VM was created (this refers to this resource and not to the time it was installed in the source).

Type

google.protobuf.timestamp_pb2.Timestamp

update_time

Output only. The last time the migrating VM resource was updated.

Type

google.protobuf.timestamp_pb2.Timestamp

last_sync

Output only. The most updated snapshot created time in the source that finished replication.

Type

google.cloud.vmmigration_v1.types.ReplicationSync

state

Output only. State of the MigratingVm.

Type

google.cloud.vmmigration_v1.types.MigratingVm.State

state_time

Output only. The last time the migrating VM state was updated.

Type

google.protobuf.timestamp_pb2.Timestamp

current_sync_info

Output only. The percentage progress of the current running replication cycle.

Type

google.cloud.vmmigration_v1.types.ReplicationCycle

group

Output only. The group this migrating vm is included in, if any. The group is represented by the full path of the appropriate [Group][google.cloud.vmmigration.v1.Group] resource.

Type

str

labels

The labels of the migrating VM.

Type

MutableMapping[str, str]

recent_clone_jobs

Output only. The recent [clone jobs][google.cloud.vmmigration.v1.CloneJob] performed on the migrating VM. This field holds the vm’s last completed clone job and the vm’s running clone job, if one exists. Note: To have this field populated you need to explicitly request it via the “view” parameter of the Get/List request.

Type

MutableSequence[google.cloud.vmmigration_v1.types.CloneJob]

error

Output only. Provides details on the state of the Migrating VM in case of an error in replication.

Type

google.rpc.status_pb2.Status

recent_cutover_jobs

Output only. The recent cutover jobs performed on the migrating VM. This field holds the vm’s last completed cutover job and the vm’s running cutover job, if one exists. Note: To have this field populated you need to explicitly request it via the “view” parameter of the Get/List request.

Type

MutableSequence[google.cloud.vmmigration_v1.types.CutoverJob]

class LabelsEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

class State(value)[source]

Bases: proto.enums.Enum

The possible values of the state/health of source VM.

Values:
STATE_UNSPECIFIED (0):

The state was not sampled by the health checks yet.

PENDING (1):

The VM in the source is being verified.

READY (2):

The source VM was verified, and it’s ready to start replication.

FIRST_SYNC (3):

Migration is going through the first sync cycle.

ACTIVE (4):

The replication is active, and it’s running or scheduled to run.

CUTTING_OVER (7):

The source VM is being turned off, and a final replication is currently running.

CUTOVER (8):

The source VM was stopped and replicated. The replication is currently paused.

FINAL_SYNC (9):

A cutover job is active and replication cycle is running the final sync.

PAUSED (10):

The replication was paused by the user and no cycles are scheduled to run.

FINALIZING (11):

The migrating VM is being finalized and migration resources are being removed.

FINALIZED (12):

The replication process is done. The migrating VM is finalized and no longer consumes billable resources.

ERROR (13):

The replication process encountered an unrecoverable error and was aborted.

class google.cloud.vmmigration_v1.types.MigratingVmView(value)[source]

Bases: proto.enums.Enum

Controls the level of details of a Migrating VM.

Values:
MIGRATING_VM_VIEW_UNSPECIFIED (0):

View is unspecified. The API will fallback to the default value.

MIGRATING_VM_VIEW_BASIC (1):

Get the migrating VM basic details. The basic details do not include the recent clone jobs and recent cutover jobs lists.

MIGRATING_VM_VIEW_FULL (2):

Include everything.

class google.cloud.vmmigration_v1.types.MigrationError(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Represents migration resource error information that can be used with google.rpc.Status message. MigrationError is used to present the user with error information in migration operations.

code

Output only. The error code.

Type

google.cloud.vmmigration_v1.types.MigrationError.ErrorCode

error_message

Output only. The localized error message.

Type

google.rpc.error_details_pb2.LocalizedMessage

action_item

Output only. Suggested action for solving the error.

Type

google.rpc.error_details_pb2.LocalizedMessage

Output only. URL(s) pointing to additional information on handling the current error.

Type

MutableSequence[google.rpc.error_details_pb2.Link]

error_time

Output only. The time the error occurred.

Type

google.protobuf.timestamp_pb2.Timestamp

class ErrorCode(value)[source]

Bases: proto.enums.Enum

Represents resource error codes.

Values:
ERROR_CODE_UNSPECIFIED (0):

Default value. This value is not used.

UNKNOWN_ERROR (1):

Migrate for Compute encountered an unknown error.

SOURCE_VALIDATION_ERROR (2):

Migrate for Compute encountered an error while validating replication source health.

SOURCE_REPLICATION_ERROR (3):

Migrate for Compute encountered an error during source data operation.

TARGET_REPLICATION_ERROR (4):

Migrate for Compute encountered an error during target data operation.

OS_ADAPTATION_ERROR (5):

Migrate for Compute encountered an error during OS adaptation.

CLONE_ERROR (6):

Migrate for Compute encountered an error in clone operation.

CUTOVER_ERROR (7):

Migrate for Compute encountered an error in cutover operation.

UTILIZATION_REPORT_ERROR (8):

Migrate for Compute encountered an error during utilization report creation.

APPLIANCE_UPGRADE_ERROR (9):

Migrate for Compute encountered an error during appliance upgrade.

class google.cloud.vmmigration_v1.types.NetworkInterface(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

NetworkInterface represents a NIC of a VM.

network

The network to connect the NIC to.

Type

str

subnetwork

The subnetwork to connect the NIC to.

Type

str

internal_ip

The internal IP to define in the NIC. The formats accepted are: ephemeral \ ipv4 address \ a named address resource full path.

Type

str

external_ip

The external IP to define in the NIC.

Type

str

class google.cloud.vmmigration_v1.types.OperationMetadata(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Represents the metadata of the long-running operation.

create_time

Output only. The time the operation was created.

Type

google.protobuf.timestamp_pb2.Timestamp

end_time

Output only. The time the operation finished running.

Type

google.protobuf.timestamp_pb2.Timestamp

target

Output only. Server-defined resource path for the target of the operation.

Type

str

verb

Output only. Name of the verb executed by the operation.

Type

str

status_message

Output only. Human-readable status of the operation, if any.

Type

str

requested_cancellation

Output only. Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have [Operation.error][] value with a [google.rpc.Status.code][google.rpc.Status.code] of 1, corresponding to Code.CANCELLED.

Type

bool

api_version

Output only. API version used to start the operation.

Type

str

class google.cloud.vmmigration_v1.types.PauseMigrationRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘PauseMigration’ request.

migrating_vm

Required. The name of the MigratingVm.

Type

str

class google.cloud.vmmigration_v1.types.PauseMigrationResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Response message for ‘PauseMigration’ request.

class google.cloud.vmmigration_v1.types.PostProcessingStep(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

PostProcessingStep contains specific step details.

class google.cloud.vmmigration_v1.types.PreparingVMDisksStep(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

PreparingVMDisksStep contains specific step details.

class google.cloud.vmmigration_v1.types.RemoveGroupMigrationRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘RemoveMigration’ request.

group

Required. The name of the Group.

Type

str

migrating_vm

The MigratingVm to remove.

Type

str

class google.cloud.vmmigration_v1.types.RemoveGroupMigrationResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Response message for ‘RemoveMigration’ request.

class google.cloud.vmmigration_v1.types.ReplicatingStep(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

ReplicatingStep contains specific step details.

total_bytes

Total bytes to be handled in the step.

Type

int

replicated_bytes

Replicated bytes in the step.

Type

int

last_two_minutes_average_bytes_per_second

The source disks replication rate for the last 2 minutes in bytes per second.

Type

int

last_thirty_minutes_average_bytes_per_second

The source disks replication rate for the last 30 minutes in bytes per second.

Type

int

class google.cloud.vmmigration_v1.types.ReplicationCycle(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

ReplicationCycle contains information about the current replication cycle status.

name

The identifier of the ReplicationCycle.

Type

str

cycle_number

The cycle’s ordinal number.

Type

int

start_time

The time the replication cycle has started.

Type

google.protobuf.timestamp_pb2.Timestamp

end_time

The time the replication cycle has ended.

Type

google.protobuf.timestamp_pb2.Timestamp

total_pause_duration

The accumulated duration the replication cycle was paused.

Type

google.protobuf.duration_pb2.Duration

progress_percent

The current progress in percentage of this cycle. Was replaced by ‘steps’ field, which breaks down the cycle progression more accurately.

Type

int

steps

The cycle’s steps list representing its progress.

Type

MutableSequence[google.cloud.vmmigration_v1.types.CycleStep]

state

State of the ReplicationCycle.

Type

google.cloud.vmmigration_v1.types.ReplicationCycle.State

error

Provides details on the state of the cycle in case of an error.

Type

google.rpc.status_pb2.Status

class State(value)[source]

Bases: proto.enums.Enum

Possible states of a replication cycle.

Values:
STATE_UNSPECIFIED (0):

The state is unknown. This is used for API compatibility only and is not used by the system.

RUNNING (1):

The replication cycle is running.

PAUSED (2):

The replication cycle is paused.

FAILED (3):

The replication cycle finished with errors.

SUCCEEDED (4):

The replication cycle finished successfully.

class google.cloud.vmmigration_v1.types.ReplicationSync(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

ReplicationSync contain information about the last replica sync to the cloud.

last_sync_time

The most updated snapshot created time in the source that finished replication.

Type

google.protobuf.timestamp_pb2.Timestamp

class google.cloud.vmmigration_v1.types.ResumeMigrationRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘ResumeMigration’ request.

migrating_vm

Required. The name of the MigratingVm.

Type

str

class google.cloud.vmmigration_v1.types.ResumeMigrationResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Response message for ‘ResumeMigration’ request.

class google.cloud.vmmigration_v1.types.SchedulePolicy(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

A policy for scheduling replications.

idle_duration

The idle duration between replication stages.

Type

google.protobuf.duration_pb2.Duration

skip_os_adaptation

A flag to indicate whether to skip OS adaptation during the replication sync. OS adaptation is a process where the VM’s operating system undergoes changes and adaptations to fully function on Compute Engine.

Type

bool

class google.cloud.vmmigration_v1.types.SchedulingNodeAffinity(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Node Affinity: the configuration of desired nodes onto which this Instance could be scheduled. Based on https://cloud.google.com/compute/docs/reference/rest/v1/instances/setScheduling

key

The label key of Node resource to reference.

Type

str

operator

The operator to use for the node resources specified in the values parameter.

Type

google.cloud.vmmigration_v1.types.SchedulingNodeAffinity.Operator

values

Corresponds to the label values of Node resource.

Type

MutableSequence[str]

class Operator(value)[source]

Bases: proto.enums.Enum

Possible types of node selection operators. Valid operators are IN for affinity and NOT_IN for anti-affinity.

Values:
OPERATOR_UNSPECIFIED (0):

An unknown, unexpected behavior.

IN (1):

The node resource group should be in these resources affinity.

NOT_IN (2):

The node resource group should not be in these resources affinity.

class google.cloud.vmmigration_v1.types.ShuttingDownSourceVMStep(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

ShuttingDownSourceVMStep contains specific step details.

class google.cloud.vmmigration_v1.types.Source(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Source message describes a specific vm migration Source resource. It contains the source environment information.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

vmware

Vmware type source details.

This field is a member of oneof source_details.

Type

google.cloud.vmmigration_v1.types.VmwareSourceDetails

aws

AWS type source details.

This field is a member of oneof source_details.

Type

google.cloud.vmmigration_v1.types.AwsSourceDetails

name

Output only. The Source name.

Type

str

create_time

Output only. The create time timestamp.

Type

google.protobuf.timestamp_pb2.Timestamp

update_time

Output only. The update time timestamp.

Type

google.protobuf.timestamp_pb2.Timestamp

labels

The labels of the source.

Type

MutableMapping[str, str]

description

User-provided description of the source.

Type

str

class LabelsEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

class google.cloud.vmmigration_v1.types.StartMigrationRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘StartMigrationRequest’ request.

migrating_vm

Required. The name of the MigratingVm.

Type

str

class google.cloud.vmmigration_v1.types.StartMigrationResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Response message for ‘StartMigration’ request.

class google.cloud.vmmigration_v1.types.TargetProject(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

TargetProject message represents a target Compute Engine project for a migration or a clone.

name

Output only. The name of the target project.

Type

str

project

The target project ID (number) or project name.

Type

str

description

The target project’s description.

Type

str

create_time

Output only. The time this target project resource was created (not related to when the Compute Engine project it points to was created).

Type

google.protobuf.timestamp_pb2.Timestamp

update_time

Output only. The last time the target project resource was updated.

Type

google.protobuf.timestamp_pb2.Timestamp

class google.cloud.vmmigration_v1.types.UpdateGroupRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Update message for ‘UpdateGroups’ request.

update_mask

Field mask is used to specify the fields to be overwritten in the Group resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.

Type

google.protobuf.field_mask_pb2.FieldMask

group

Required. The update request body.

Type

google.cloud.vmmigration_v1.types.Group

request_id

A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request.

For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

Type

str

class google.cloud.vmmigration_v1.types.UpdateMigratingVmRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘UpdateMigratingVm’ request.

update_mask

Field mask is used to specify the fields to be overwritten in the MigratingVm resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.

Type

google.protobuf.field_mask_pb2.FieldMask

migrating_vm

Required. The update request body.

Type

google.cloud.vmmigration_v1.types.MigratingVm

request_id

A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request.

For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

Type

str

class google.cloud.vmmigration_v1.types.UpdateSourceRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Update message for ‘UpdateSources’ request.

update_mask

Field mask is used to specify the fields to be overwritten in the Source resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.

Type

google.protobuf.field_mask_pb2.FieldMask

source

Required. The update request body.

Type

google.cloud.vmmigration_v1.types.Source

request_id

A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request.

For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

Type

str

class google.cloud.vmmigration_v1.types.UpdateTargetProjectRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Update message for ‘UpdateTargetProject’ request.

update_mask

Field mask is used to specify the fields to be overwritten in the TargetProject resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.

Type

google.protobuf.field_mask_pb2.FieldMask

target_project

Required. The update request body.

Type

google.cloud.vmmigration_v1.types.TargetProject

request_id

A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request.

For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

Type

str

class google.cloud.vmmigration_v1.types.UpgradeApplianceRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Request message for ‘UpgradeAppliance’ request.

datacenter_connector

Required. The DatacenterConnector name.

Type

str

request_id

A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request.

For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

Type

str

class google.cloud.vmmigration_v1.types.UpgradeApplianceResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Response message for ‘UpgradeAppliance’ request.

class google.cloud.vmmigration_v1.types.UpgradeStatus(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

UpgradeStatus contains information about upgradeAppliance operation.

version

The version to upgrade to.

Type

str

state

The state of the upgradeAppliance operation.

Type

google.cloud.vmmigration_v1.types.UpgradeStatus.State

error

Provides details on the state of the upgrade operation in case of an error.

Type

google.rpc.status_pb2.Status

start_time

The time the operation was started.

Type

google.protobuf.timestamp_pb2.Timestamp

previous_version

The version from which we upgraded.

Type

str

class State(value)[source]

Bases: proto.enums.Enum

The possible values of the state.

Values:
STATE_UNSPECIFIED (0):

The state was not sampled by the health checks yet.

RUNNING (1):

The upgrade has started.

FAILED (2):

The upgrade failed.

SUCCEEDED (3):

The upgrade finished successfully.

class google.cloud.vmmigration_v1.types.UtilizationReport(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Utilization report details the utilization (CPU, memory, etc.) of selected source VMs.

name

Output only. The report unique name.

Type

str

display_name

The report display name, as assigned by the user.

Type

str

state

Output only. Current state of the report.

Type

google.cloud.vmmigration_v1.types.UtilizationReport.State

state_time

Output only. The time the state was last set.

Type

google.protobuf.timestamp_pb2.Timestamp

error

Output only. Provides details on the state of the report in case of an error.

Type

google.rpc.status_pb2.Status

create_time

Output only. The time the report was created (this refers to the time of the request, not the time the report creation completed).

Type

google.protobuf.timestamp_pb2.Timestamp

time_frame

Time frame of the report.

Type

google.cloud.vmmigration_v1.types.UtilizationReport.TimeFrame

frame_end_time

Output only. The point in time when the time frame ends. Notice that the time frame is counted backwards. For instance if the “frame_end_time” value is 2021/01/20 and the time frame is WEEK then the report covers the week between 2021/01/20 and 2021/01/14.

Type

google.protobuf.timestamp_pb2.Timestamp

vm_count

Output only. Total number of VMs included in the report.

Type

int

vms

List of utilization information per VM. When sent as part of the request, the “vm_id” field is used in order to specify which VMs to include in the report. In that case all other fields are ignored.

Type

MutableSequence[google.cloud.vmmigration_v1.types.VmUtilizationInfo]

class State(value)[source]

Bases: proto.enums.Enum

Utilization report state.

Values:
STATE_UNSPECIFIED (0):

The state is unknown. This value is not in use.

CREATING (1):

The report is in the making.

SUCCEEDED (2):

Report creation completed successfully.

FAILED (3):

Report creation failed.

class TimeFrame(value)[source]

Bases: proto.enums.Enum

Report time frame options.

Values:
TIME_FRAME_UNSPECIFIED (0):

The time frame was not specified and will default to WEEK.

WEEK (1):

One week.

MONTH (2):

One month.

YEAR (3):

One year.

class google.cloud.vmmigration_v1.types.UtilizationReportView(value)[source]

Bases: proto.enums.Enum

Controls the level of details of a Utilization Report.

Values:
UTILIZATION_REPORT_VIEW_UNSPECIFIED (0):

The default / unset value. The API will default to FULL on single report request and BASIC for multiple reports request.

BASIC (1):

Get the report metadata, without the list of VMs and their utilization info.

FULL (2):

Include everything.

class google.cloud.vmmigration_v1.types.VmUtilizationInfo(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Utilization information of a single VM.

vmware_vm_details

The description of the VM in a Source of type Vmware.

This field is a member of oneof VmDetails.

Type

google.cloud.vmmigration_v1.types.VmwareVmDetails

vm_id

The VM’s ID in the source.

Type

str

utilization

Utilization metrics for this VM.

Type

google.cloud.vmmigration_v1.types.VmUtilizationMetrics

class google.cloud.vmmigration_v1.types.VmUtilizationMetrics(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

Utilization metrics values for a single VM.

cpu_max_percent

Max CPU usage, percent.

Type

int

cpu_average_percent

Average CPU usage, percent.

Type

int

memory_max_percent

Max memory usage, percent.

Type

int

memory_average_percent

Average memory usage, percent.

Type

int

disk_io_rate_max_kbps

Max disk IO rate, in kilobytes per second.

Type

int

disk_io_rate_average_kbps

Average disk IO rate, in kilobytes per second.

Type

int

network_throughput_max_kbps

Max network throughput (combined transmit-rates and receive-rates), in kilobytes per second.

Type

int

network_throughput_average_kbps

Average network throughput (combined transmit-rates and receive-rates), in kilobytes per second.

Type

int

class google.cloud.vmmigration_v1.types.VmwareSourceDetails(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

VmwareSourceDetails message describes a specific source details for the vmware source type.

username

The credentials username.

Type

str

password

Input only. The credentials password. This is write only and can not be read in a GET operation.

Type

str

vcenter_ip

The ip address of the vcenter this Source represents.

Type

str

thumbprint

The thumbprint representing the certificate for the vcenter.

Type

str

class google.cloud.vmmigration_v1.types.VmwareVmDetails(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

VmwareVmDetails describes a VM in vCenter.

vm_id

The VM’s id in the source (note that this is not the MigratingVm’s id). This is the moref id of the VM.

Type

str

datacenter_id

The id of the vCenter’s datacenter this VM is contained in.

Type

str

datacenter_description

The descriptive name of the vCenter’s datacenter this VM is contained in.

Type

str

uuid

The unique identifier of the VM in vCenter.

Type

str

display_name

The display name of the VM. Note that this is not necessarily unique.

Type

str

power_state

The power state of the VM at the moment list was taken.

Type

google.cloud.vmmigration_v1.types.VmwareVmDetails.PowerState

cpu_count

The number of cpus in the VM.

Type

int

memory_mb

The size of the memory of the VM in MB.

Type

int

disk_count

The number of disks the VM has.

Type

int

committed_storage_mb

The total size of the storage allocated to the VM in MB.

Type

int

guest_description

The VM’s OS. See for example https://vdc-repo.vmware.com/vmwb-repository/dcr-public/da47f910-60ac-438b-8b9b-6122f4d14524/16b7274a-bf8b-4b4c-a05e-746f2aa93c8c/doc/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html for types of strings this might hold.

Type

str

boot_option

Output only. The VM Boot Option.

Type

google.cloud.vmmigration_v1.types.VmwareVmDetails.BootOption

class BootOption(value)[source]

Bases: proto.enums.Enum

Possible values for vm boot option.

Values:
BOOT_OPTION_UNSPECIFIED (0):

The boot option is unknown.

EFI (1):

The boot option is EFI.

BIOS (2):

The boot option is BIOS.

class PowerState(value)[source]

Bases: proto.enums.Enum

Possible values for the power state of the VM.

Values:
POWER_STATE_UNSPECIFIED (0):

Power state is not specified.

ON (1):

The VM is turned ON.

OFF (2):

The VM is turned OFF.

SUSPENDED (3):

The VM is suspended. This is similar to hibernation or sleep mode.

class google.cloud.vmmigration_v1.types.VmwareVmsDetails(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

Bases: proto.message.Message

VmwareVmsDetails describes VMs in vCenter.

details

The details of the vmware VMs.

Type

MutableSequence[google.cloud.vmmigration_v1.types.VmwareVmDetails]