Sign in
DigitalOcean-public.v2-new_VPCs

Update a VPC

To update information about a VPC, send a PUT request to /v2/vpcs/$VPC_ID.

put/v2/vpcs/{vpc_id}

Path parameters

vpc_idstring uuid required

A unique identifier for a VPC.

Request body

namestring required

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

descriptionstring

A free-form text field for describing the VPC's purpose. It may be a maximum of 255 characters.

defaultboolean

A boolean value indicating whether or not the VPC is the default network for the region. All applicable resources are placed into the default VPC network unless otherwise specified during their creation. The default field cannot be unset from true. If you want to set a new default VPC network, update the default field of another VPC network in the same region. The previous network's default field will be set to false when a new default VPC has been defined.

Example request

{
  "name": "env.prod-vpc",
  "description": "VPC for production environment",
  "default": true
}

Response

The response will be a JSON object with a key called vpc. The value of this will be an object that contains the standard attributes associated with a VPC.

Example response

{
  "vpc": {
    "name": "env.prod-vpc",
    "description": "VPC for production environment",
    "region": "nyc1",
    "ip_range": "10.10.10.0/24",
    "default": true,
    "id": "5a4981aa-9653-4bd1-bef5-d6bff52042e4",
    "urn": "do:droplet:13457723",
    "created_at": "2020-03-13T19:20:47.442049222Z"
  }
}

Changes

Changed in 4 of the 8 revisions of this API.14