REST Resource: projects.locations.sources.datacenterConnectors

Resource: DatacenterConnector

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.

JSON representation
{
  "createTime": string,
  "updateTime": string,
  "name": string,
  "registrationId": string,
  "serviceAccount": string,
  "version": string,
  "bucket": string,
  "state": enum (State),
  "stateTime": string,
  "error": {
    object (Status)
  },
  "applianceInfrastructureVersion": string,
  "applianceSoftwareVersion": string,
  "availableVersions": {
    object (AvailableUpdates)
  },
  "upgradeStatus": {
    object (UpgradeStatus)
  }
}
Fields
createTime

string (Timestamp format)

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

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".

updateTime

string (Timestamp format)

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

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 connector's name.

registrationId

string

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.

serviceAccount

string

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

version

string

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

bucket

string

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

state

enum (State)

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

stateTime

string (Timestamp format)

Output only. The time the state was last set.

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 on the state of the Datacenter Connector in case of an error.

applianceInfrastructureVersion

string

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.

applianceSoftwareVersion

string

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

availableVersions

object (AvailableUpdates)

Output only. The available versions for updating this appliance.

upgradeStatus

object (UpgradeStatus)

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

State

The possible values of the state.

Enums
STATE_UNSPECIFIED The state is unknown. This is used for API compatibility only and is not used by the system.
PENDING The state was not sampled by the health checks yet.
OFFLINE The source was sampled by health checks and is not available.
FAILED 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 The source exists and its credentials were verified.

AvailableUpdates

Holds informatiom about the available versions for upgrade.

JSON representation
{
  "newDeployableAppliance": {
    object (ApplianceVersion)
  },
  "inPlaceUpdate": {
    object (ApplianceVersion)
  }
}
Fields
newDeployableAppliance

object (ApplianceVersion)

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.

inPlaceUpdate

object (ApplianceVersion)

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

ApplianceVersion

Describes an appliance version.

JSON representation
{
  "version": string,
  "uri": string,
  "critical": boolean,
  "releaseNotesUri": string
}
Fields
version

string

The appliance version.

uri

string

A link for downloading the version.

critical

boolean

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

releaseNotesUri

string

Link to a page that contains the version release notes.

UpgradeStatus

UpgradeStatus contains information about upgradeAppliance operation.

JSON representation
{
  "version": string,
  "state": enum (State),
  "error": {
    object (Status)
  },
  "startTime": string,
  "previousVersion": string
}
Fields
version

string

The version to upgrade to.

state

enum (State)

The state of the upgradeAppliance operation.

error

object (Status)

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

startTime

string (Timestamp format)

The time the operation was 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".

previousVersion

string

The version from which we upgraded.

State

The possible values of the state.

Enums
STATE_UNSPECIFIED The state was not sampled by the health checks yet.
RUNNING The upgrade has started.
FAILED The upgrade failed.
SUCCEEDED The upgrade finished successfully.

Methods

create

Creates a new DatacenterConnector in a given Source.

delete

Deletes a single DatacenterConnector.

get

Gets details of a single DatacenterConnector.

list

Lists DatacenterConnectors in a given Source.

upgradeAppliance

Upgrades the appliance relate to this DatacenterConnector to the in-place updateable version.