Create a new VPC

POST

https://api.americancloud.com/api/v1/networks/vpc

POST

/api/v1/networks/vpc

curl -X POST https://api.americancloud.com/api/v1/networks/vpc \
     -H "X-API-Client-ID: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "production-vpc",
  "region": "sjc0",
  "cidr": "10.0.0.0/16"
}'

{
  "id": "vpc-a1b2c3d4",
  "name": "Production VPC",
  "description": "Production VPC",
  "cidr": "10.0.0.0/16",
  "status": "Active",
  "region": "us-east-1",
  "tiers": [
    {
      "id": "tier-1a2b3c4d",
      "name": "Web Tier",
      "description": "Web Tier",
      "cidr": "10.1.1.0/24",
      "gateway": "10.1.1.1",
      "netmask": "255.255.255.0",
      "status": "Active",
      "aclId": "123e4567-e89b-12d3-a456-426614174000",
      "aclName": "default_allow"
    }
  ],
  "publicIps": [
    "203.0.113.1",
    "203.0.113.2"
  ],
  "createdAt": "2023-05-15T10:30:00Z"
}

Creates a new VPC. To preview pricing without creating anything, use POST /networks/vpc/cost-estimate.

Authentication

X-API-Client-IDstring

API Client ID

X-API-Client-Secretstring

API Client Secret

Request

This endpoint expects an object.

namestringRequired

Human-readable name for the VPC.

regionstringRequired

Region the VPC will be created in. References a region label from /v1/compute/regions.

cidrstringRequired

IPv4 CIDR block the VPC will use.

descriptionstringOptional

Free-form description of the VPC.

Response

The VPC has been created

idstringformat: "uuid"

Unique identifier for the VPC

namestring

Name of the VPC

descriptionstring

Description of the VPC

cidrstring

CIDR of the VPC

statusenum

VPC status

Allowed values:

regionstring

Region where the VPC is located

tierslist of objects

Network tiers in this VPC

publicIpslist of strings

Public IP addresses associated with this VPC

createdAtdatetimeOptional

VPC creation date

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error