{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-cloud-migration-center/json-schema/google-cloud-migration-center-datacenter-connector-schema.json",
  "title": "DatacenterConnector",
  "description": "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.",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-cloud-migration-center-vmmigration-projects-api-openapi.yml#/components/schemas/DatacenterConnector",
  "type": "object",
  "properties": {
    "upgradeStatus": {
      "$ref": "#/$defs/UpgradeStatus",
      "description": "Output only. The status of the current / last upgradeAppliance operation."
    },
    "bucket": {
      "readOnly": true,
      "type": "string",
      "description": "Output only. The communication channel between the datacenter connector and Google Cloud."
    },
    "availableVersions": {
      "$ref": "#/$defs/AvailableUpdates",
      "description": "Output only. The available versions for updating this appliance."
    },
    "serviceAccount": {
      "type": "string",
      "description": "The service account to use in the connector when communicating with the cloud."
    },
    "error": {
      "$ref": "#/$defs/Status",
      "description": "Output only. Provides details on the state of the Datacenter Connector in case of an error."
    },
    "registrationId": {
      "type": "string",
      "description": "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."
    },
    "updateTime": {
      "description": "Output only. The last time the connector was updated with an API call.",
      "readOnly": true,
      "format": "google-datetime",
      "type": "string"
    },
    "createTime": {
      "description": "Output only. The time the connector was created (as an API call, not when it was actually installed).",
      "readOnly": true,
      "format": "google-datetime",
      "type": "string"
    },
    "name": {
      "description": "Output only. The connector's name.",
      "readOnly": true,
      "type": "string"
    },
    "state": {
      "type": "string",
      "enum": [
        "STATE_UNSPECIFIED",
        "PENDING",
        "OFFLINE",
        "FAILED",
        "ACTIVE"
      ],
      "description": "Output only. State of the DatacenterConnector, as determined by the health checks.",
      "readOnly": true
    },
    "stateTime": {
      "description": "Output only. The time the state was last set.",
      "readOnly": true,
      "format": "google-datetime",
      "type": "string"
    },
    "version": {
      "description": "The version running in the DatacenterConnector. This is supplied by the OVA connector during the registration process and can not be modified.",
      "type": "string"
    },
    "applianceSoftwareVersion": {
      "readOnly": true,
      "description": "Output only. Appliance last installed update bundle version. This is the version of the automatically updatable components on the appliance.",
      "type": "string"
    },
    "applianceInfrastructureVersion": {
      "type": "string",
      "readOnly": true,
      "description": "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."
    }
  },
  "$defs": {
    "ApplianceVersion": {
      "type": "object",
      "description": "Describes an appliance version.",
      "properties": {
        "critical": {
          "type": "boolean",
          "description": "Determine whether it's critical to upgrade the appliance to this version."
        },
        "uri": {
          "type": "string",
          "description": "A link for downloading the version."
        },
        "version": {
          "type": "string",
          "description": "The appliance version."
        },
        "releaseNotesUri": {
          "type": "string",
          "description": "Link to a page that contains the version release notes."
        }
      }
    },
    "AvailableUpdates": {
      "type": "object",
      "properties": {
        "newDeployableAppliance": {
          "$ref": "#/$defs/ApplianceVersion",
          "description": "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": {
          "$ref": "#/$defs/ApplianceVersion",
          "description": "The latest version for in place update. The current appliance can be updated to this version using the API or m4c CLI."
        }
      },
      "description": "Holds information about the available versions for upgrade."
    },
    "Status": {
      "type": "object",
      "properties": {
        "code": {
          "description": "The status code, which should be an enum value of google.rpc.Code.",
          "type": "integer",
          "format": "int32"
        },
        "message": {
          "type": "string",
          "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client."
        },
        "details": {
          "type": "array",
          "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.",
          "items": {
            "additionalProperties": {
              "description": "Properties of the object. Contains field @type with type URL."
            },
            "type": "object"
          }
        }
      },
      "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors)."
    },
    "UpgradeStatus": {
      "type": "object",
      "description": "UpgradeStatus contains information about upgradeAppliance operation.",
      "properties": {
        "version": {
          "description": "The version to upgrade to.",
          "type": "string"
        },
        "startTime": {
          "description": "The time the operation was started.",
          "type": "string",
          "format": "google-datetime"
        },
        "previousVersion": {
          "description": "The version from which we upgraded.",
          "type": "string"
        },
        "state": {
          "type": "string",
          "enum": [
            "STATE_UNSPECIFIED",
            "RUNNING",
            "FAILED",
            "SUCCEEDED"
          ],
          "description": "The state of the upgradeAppliance operation."
        },
        "error": {
          "$ref": "#/$defs/Status",
          "description": "Output only. Provides details on the state of the upgrade operation in case of an error."
        }
      }
    }
  }
}