Version 5.0

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,
  "name": string,
  "targetDetails": {
    object (TargetVMDetails)
  },
  "state": enum (State),
  "stateTime": string,
  "error": {
    object (Status)
  },
  "computeEngineVmDetails": {
    object (TargetVMDetails)
  }
}
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".

name

string

The name of the clone.

targetDetails
(deprecated)

object (TargetVMDetails)

Output only. Details of the VM to create as the target of this clone job.

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.

computeEngineVmDetails

object (TargetVMDetails)

Output only. Details of the VM 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.

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 CloneJobs of a given migrating VM.