API Reference

Networking

VPCs

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get VPC Details

client.Networking.VPCs.Get(ctx, vpcID) (*VPC, error)

GET/v1/networking/vpcs/{vpc_id}

Get details about a VPC

ParametersExpand Collapse

vpcID string

ReturnsExpand Collapse

type VPC struct{…}

VPC details.

ID string

Unique identifier for the VPC.

CreatedAt Time

When the VPC was created.

formatdate-time

FirewallRuleIDs []string

IDs of the Firewall Rules associated with the VPC.

Name string

Name of the VPC.

ProjectID string

Project ID the VPC belongs to.

Region RegionName

Region the resource is in.

Status ResourceStatus

Status of the resource.

One of the following:

const ResourceStatusPending ResourceStatus = "pending"

const ResourceStatusCreating ResourceStatus = "creating"

const ResourceStatusUpdating ResourceStatus = "updating"

const ResourceStatusReady ResourceStatus = "ready"

const ResourceStatusDeleting ResourceStatus = "deleting"

const ResourceStatusDeleted ResourceStatus = "deleted"

const ResourceStatusError ResourceStatus = "error"

Subnet Subnet

Subnet of the VPC.

ID string

Unique identifier for the Subnet.

CIDR string

CIDR block for the Subnet.

CreatedAt Time

When the Subnet was created.

formatdate-time

Name string

Name of the Subnet.

UpdatedAt Time

When the Subnet was updated.

formatdate-time

Tags []string

Tags to attach to the VPC.

UpdatedAt Time

When the VPC was updated.

formatdate-time

Get VPC Details

Go

HTTP

TypeScript

Go

Terraform

CLI Tool

package main

import (
  "context"
  "fmt"

  "github.com/nirvana-labs/nirvana-go"
  "github.com/nirvana-labs/nirvana-go/option"
)

func main() {
  client := nirvana.NewClient(
    option.WithAPIKey("My API Key"),
  )
  vpc, err := client.Networking.VPCs.Get(context.TODO(), "vpc_id")
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", vpc.ID)
}

200 example

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2025-01-01T00:00:00Z",
  "firewall_rule_ids": [
    "123e4567-e89b-12d3-a456-426614174001",
    "123e4567-e89b-12d3-a456-426614174002"
  ],
  "name": "my-vpc",
  "project_id": "123e4567-e89b-12d3-a456-426614174000",
  "region": "us-sva-2",
  "status": "ready",
  "subnet": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "cidr": "10.128.35.128/25",
    "created_at": "2025-01-01T00:00:00Z",
    "name": "my-subnet",
    "updated_at": "2025-01-01T00:00:00Z"
  },
  "tags": [
    "production",
    "ethereum"
  ],
  "updated_at": "2025-01-01T00:00:00Z"
}

Returns Examples

200 example

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2025-01-01T00:00:00Z",
  "firewall_rule_ids": [
    "123e4567-e89b-12d3-a456-426614174001",
    "123e4567-e89b-12d3-a456-426614174002"
  ],
  "name": "my-vpc",
  "project_id": "123e4567-e89b-12d3-a456-426614174000",
  "region": "us-sva-2",
  "status": "ready",
  "subnet": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "cidr": "10.128.35.128/25",
    "created_at": "2025-01-01T00:00:00Z",
    "name": "my-subnet",
    "updated_at": "2025-01-01T00:00:00Z"
  },
  "tags": [
    "production",
    "ethereum"
  ],
  "updated_at": "2025-01-01T00:00:00Z"
}