Give Feedback

pydo.vpc_peerings.create()

Generated on 3 Aug 2026 from pydo version v0.40.0

Copy page as Markdown View page as Markdown

Usage

client.vpc_peerings.create(
    body={
        "name": "nyc1-blr1-peering",
        "vpc_ids": [...],
    },
)

Returns JSONRaises HttpResponseError

Description

To create a new VPC Peering, send a POST request to /v2/vpc_peerings specifying a name and a list of two VPC IDs to peer. The response code, 202 Accepted, does not indicate the success or failure of the operation, just that the request has been accepted for processing.

Parameters

name string required

Example: nyc1-blr1-peering

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

vpc_ids array of strings required

Example: ['c140286f-e6ce-4131-8b7b-df4590ce8d6a', '994a2735-dc84-11e8-80bc-3cfdfea9fba1']

An array of the two peered VPCs IDs.

Request Sample

Show Request Sample

import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

req = {
  "name": "nyc1-blr1-peering",
  "vpc_ids": [
    "c140286f-e6ce-4131-8b7b-df4590ce8d6a",
    "994a2735-dc84-11e8-80bc-3cfdfea9fba1"
  ]
}

resp = client.vpc_peerings.create(body=req)

Response Example

Show Response Example

{
  "vpc_peering": {
    "id": "5a4981aa-9653-4bd1-bef5-d6bff52042e4",
    "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"
  }
}

More Information

See /v2/vpc_peerings in the API reference for additional detail on responses, headers, parameters, and more.