v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB

DigitalOcean-public.v2-new_VPCs

Create a Peering with a VPC

To create a new VPC peering for a given VPC, send a POST request to /v2/vpcs/$VPC_ID/peerings.

post/v2/vpcs/{vpc_id}/peerings

Path parameters

vpc_idstring uuid required

A unique identifier for a VPC.

Request body

namestring required

The name of the VPC peering. Must be unique and may only contain alphanumeric characters, dashes, and periods.

vpc_idstring uuid required

The ID of the VPC to peer with.

Example request

{
  "name": "nyc1-blr1-peering",
  "vpc_id": "c140286f-e6ce-4131-8b7b-df4590ce8d6a"
}

Response

The response will be a JSON object with a key called peering, containing the standard attributes associated with a VPC peering.

Example response

{
  "peering": {
    "id": "6b5c619c-359c-44ca-87e2-47e98170c01d",
    "name": "example-vpc-peering",
    "vpc_ids": [
      "997615ce-132d-4bae-9270-9ee21b395e5d",
      "e51aed59-3bb1-4a6a-8de0-9d1329e9c997"
    ],
    "created_at": "2024-01-09T20:44:32Z",
    "status": "PROVISIONING"
  }
}