---
title: "POST /v1/{+parent}/datacenterConnectors"
method: POST
path: "/v1/{+parent}/datacenterConnectors"
tags: ["projects"]
---

# POST /v1/{+parent}/datacenterConnectors

`POST /v1/{+parent}/datacenterConnectors`

Creates a new DatacenterConnector in a given Source.

## Path parameters

- `parent` string, required

## Query parameters

- `datacenterConnectorId` string
- `requestId` string

## Request body

- 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.
  - `serviceAccount` string — The service account to use in the connector when communicating with the cloud.
  - `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.
  - `error` Status — 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).
    - `details` object[] — A list of messages that carry the error details. There is a common set of message types for APIs to use.
    - `message` string — 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.
    - `code` integer — The status code, which should be an enum value of google.rpc.Code.
  - `updateTime` string, google-datetime — Output only. The last time the connector was updated with an API call.
  - `bucket` string — Output only. The communication channel between the datacenter connector and Google Cloud.
  - `state` 'STATE_UNSPECIFIED' | 'PENDING' | 'OFFLINE' | 'FAILED' | 'ACTIVE' — Output only. State of the DatacenterConnector, as determined by the health checks.
  - `createTime` string, google-datetime — Output only. The time the connector was created (as an API call, not when it was actually installed).
  - `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.
  - `name` string — Output only. The connector's name.
  - `applianceSoftwareVersion` string — Output only. Appliance last installed update bundle version. This is the version of the automatically updatable components on the appliance.
  - `stateTime` string, google-datetime — Output only. The time the state was last set.
  - `availableVersions` AvailableUpdates — Holds information about the available versions for upgrade.
    - `newDeployableAppliance` ApplianceVersion — Describes an appliance version.
      - `version` string — The appliance version.
      - `releaseNotesUri` string — Link to a page that contains the version release notes.
      - `uri` string — A link for downloading the version.
      - `critical` boolean — Determine whether it's critical to upgrade the appliance to this version.
    - `inPlaceUpdate` ApplianceVersion — Describes an appliance version.
      - `version` string — The appliance version.
      - `releaseNotesUri` string — Link to a page that contains the version release notes.
      - `uri` string — A link for downloading the version.
      - `critical` boolean — Determine whether it's critical to upgrade the appliance to this version.
  - `upgradeStatus` UpgradeStatus — UpgradeStatus contains information about upgradeAppliance operation.
    - `version` string — The version to upgrade to.
    - `previousVersion` string — The version from which we upgraded.
    - `error` Status — 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).
      - `details` object[] — A list of messages that carry the error details. There is a common set of message types for APIs to use.
      - `message` string — 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.
      - `code` integer — The status code, which should be an enum value of google.rpc.Code.
    - `state` 'STATE_UNSPECIFIED' | 'RUNNING' | 'FAILED' | 'SUCCEEDED' — The state of the upgradeAppliance operation.
    - `startTime` string, google-datetime — The time the operation was started.
  - `version` string — The version running in the DatacenterConnector. This is supplied by the OVA connector during the registration process and can not be modified.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/vmmigration.md) · [All operations](https://skmtc.net/google/apis/vmmigration/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/vmmigration/versions/c812c34615f3/schema)