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

# POST /v1/{+parent}/privateConnections

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

Creates a new private connection in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `privateConnectionId` string
- `requestId` string
- `skipValidation` boolean
- `validateOnly` boolean

## Request body

- PrivateConnection — The PrivateConnection resource is used to establish private connectivity with the customer's network.
  - `satisfiesPzi` boolean — Output only. Reserved for future use.
  - `createTime` string, google-datetime — Output only. The create time of the resource.
  - `pscInterfaceConfig` PscInterfaceConfig — The PSC Interface configuration is used to create PSC Interface between DMS's internal VPC and the consumer's PSC.
    - `networkAttachment` string — Required. Fully qualified name of the Network Attachment that DMS will connect to. Format: `projects/{{project}}/regions/{{region}}/networkAttachments/{{name}}`
  - `vpcPeeringConfig` VpcPeeringConfig — The VPC peering configuration is used to create VPC peering with the consumer's VPC.
    - `vpcName` string — Required. Fully qualified name of the VPC that Database Migration Service will peer to.
    - `subnet` string — Required. A free subnet for peering. (CIDR of /29)
  - `labels` object — The resource labels for private connections to use to annotate any related underlying resources such as Compute Engine VMs. An object containing a list of "key": "value" pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
  - `displayName` string — The private connection display name.
  - `name` string — The name of the resource.
  - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'CREATED' | 'FAILED' | 'DELETING' | 'FAILED_TO_DELETE' | 'DELETED' — Output only. The state of the private connection.
  - `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).
    - `code` integer — The status code, which should be an enum value of google.rpc.Code.
    - `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.
    - `details` object[] — A list of messages that carry the error details. There is a common set of message types for APIs to use.
  - `updateTime` string, google-datetime — Output only. The last update time of the resource.
  - `satisfiesPzs` boolean — Output only. Reserved for future use.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/datamigration.md) · [All operations](https://skmtc.dev/google/apis/datamigration/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/datamigration/revisions/d77bd66e25e6/schema)