REST Resource: projects.locations.sources.migratingVms.cloneJobs

Resource: CloneJob

CloneJob describes the process of creating a clone of a 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.

JSON representation
{
  "createTime": string,
  "endTime": string,
  "name": string,
  "state": enum (State),
  "stateTime": string,
  "error": {
    object (Status)
  },
  "steps": [
    {
      object (CloneStep)
    }
  ],

  // Union field target_vm_details can be only one of the following:
  "computeEngineTargetDetails": {
    object (ComputeEngineTargetDetails)
  },
  "computeEngineDisksTargetDetails": {
    object (ComputeEngineDisksTargetDetails)
  }
  // End of list of possible types for union field target_vm_details.
}
Fields
createTime

string (Timestamp format)

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

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

Output only. The time the clone job was ended.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

name

string

Output only. The name of the clone.

state

enum (State)

Output only. State of the clone job.

stateTime

string (Timestamp format)

Output only. The time the state was last updated.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

error

object (Status)

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

steps[]

object (CloneStep)

Output only. The clone steps list representing its progress.

Union field target_vm_details. Details of the VM to create as the target of this clone job. target_vm_details can be only one of the following:
computeEngineTargetDetails

object (ComputeEngineTargetDetails)

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

computeEngineDisksTargetDetails

object (ComputeEngineDisksTargetDetails)

Output only. Details of the target Persistent Disks in Compute Engine.

State

Possible states of the clone job.

Enums
STATE_UNSPECIFIED The state is unknown. This is used for API compatibility only and is not used by the system.
PENDING The clone job has not yet started.
ACTIVE The clone job is active and running.
FAILED The clone job finished with errors.
SUCCEEDED The clone job finished successfully.
CANCELLED The clone job was cancelled.
CANCELLING The clone job is being cancelled.
ADAPTING_OS OS adaptation is running as part of the clone job to generate license.

CloneStep

CloneStep holds information about the clone step progress.

JSON representation
{
  "startTime": string,
  "endTime": string,

  // Union field step can be only one of the following:
  "adaptingOs": {
    object (AdaptingOSStep)
  },
  "preparingVmDisks": {
    object (PreparingVMDisksStep)
  },
  "instantiatingMigratedVm": {
    object (InstantiatingMigratedVMStep)
  }
  // End of list of possible types for union field step.
}
Fields
startTime

string (Timestamp format)

The time the step has started.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

The time the step has ended.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

Union field step.

step can be only one of the following:

adaptingOs

object (AdaptingOSStep)

Adapting OS step.

preparingVmDisks

object (PreparingVMDisksStep)

Preparing VM disks step.

instantiatingMigratedVm

object (InstantiatingMigratedVMStep)

Instantiating migrated VM step.

Methods

cancel

Initiates the cancellation of a running clone job.

create

Initiates a Clone of a specific migrating VM.

get

Gets details of a single CloneJob.

list

Lists the CloneJobs of a migrating VM.