For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
GitHub
DocumentationREST API Reference
DocumentationREST API Reference
    • Home
  • Overview
    • What is NICo?
    • Key Capabilities
    • Operational Principles
    • Day 0 / Day 1 / Day 2 Lifecycle
    • Scope and Boundaries
  • Getting Started
    • Building NICo Containers
    • Quick Start Guide
  • Architecture
    • Overview and Components
    • Reliable State Handling
    • Networking Integrations
    • Key Group Synchronization
  • Provisioning (Day 0)
    • Ingesting Hosts
    • Ingesting Hosts (REST API)
    • Machine Validation
    • SKU Validation
    • Measured Boot Attestation
  • Configuration (Day 1)
    • Network Isolation
    • Tenant Management
    • Organization & Permissions
  • Operations (Day 2)
    • Tenant Lifecycle Cleanup
    • Network Isolation
    • Network Security Groups
    • InfiniBand Partitioning
    • NVLink Partitioning
    • Rack-Level Administration (RLA)
      • VPC Routing Profiles
      • VPC Peering
      • VPC Network Virtualization
      • Flat VPCs and Zero-DPU Hosts
      • VNI Resource Pools
    • IP Resource Pools
    • BGP Peering
    • nicocli Reference
  • Reference
    • Hardware Compatibility List
    • Release Notes
    • FAQs
    • Glossary
GitHub
NVIDIANVIDIA
Developer-friendly docs for your API
Privacy Policy | Your Privacy Choices | Terms of Service | Accessibility | Corporate Policies | Product Security | Contact

Copyright © 2026, NVIDIA Corporation.

LogoLogo
On this page
  • VPC Peering Commands
  • Creating VPC Peering Connections
  • Listing VPC Peering Connections
  • Deleting VPC Peering Connections
Operations (Day 2)Managing VPCs

VPC Peering

||View as Markdown|
Previous

VPC Routing Profiles

Next

VPC Network Virtualization

VPC peering allows you to connect two VPCs together, enabling bi-directional network communication between instances in different VPCs. This page explains how to manage VPC peering connections using nico-admin-cli.

VPC Peering Commands

The nico-admin-cli vpc-peering command provides three main operations:

$nico-admin-cli vpc-peering <COMMAND>
$
$Commands:
$ create Create VPC peering connection
$ show Show list of VPC peering connections
$ delete Delete VPC peering connection

Creating VPC Peering Connections

To create a new VPC peering connection between two VPCs:

$nico-admin-cli vpc-peering create <VPC1_ID> <VPC2_ID>

Example:

$nico-admin-cli vpc-peering create e65a9d69-39d2-4872-a53e-e5cb87c84e75 366de82e-1113-40dd-830a-a15711d54ef1

Notes:

  • The operator should confirm with both VPC owners (VPC tenant org) that they approve the peering before creating the connection
  • The VPC IDs can be provided in any order
  • The system will automatically enforce canonical ordering (smaller ID becomes vpc1_id)
  • If a peering connection already exists between the two VPCs, the command will return an error indicating a peering connection already exists
  • Both VPCs must exist before creating the peering connection

Listing VPC Peering Connections

To view VPC peering connections, you can either show all connections or filter by a specific VPC:

Show all peering connections:

$nico-admin-cli vpc-peering show

Show peering connections for a specific VPC:

$nico-admin-cli vpc-peering show --vpc-id <VPC_ID>

Example:

$# Show all peering connections
$nico-admin-cli vpc-peering show
$
$# Show peering connections for a specific VPC
$nico-admin-cli vpc-peering show --vpc-id 550e8400-e29b-41d4-a716-446655440000

The output will display:

  • Peering connection ID
  • VPC1 ID (smaller UUID)
  • VPC2 ID (larger UUID)
  • Connection status
  • Creation timestamp

Deleting VPC Peering Connections

To delete an existing VPC peering connection:

$nico-admin-cli vpc-peering delete <PEERING_CONNECTION_ID>

Example:

$nico-admin-cli vpc-peering delete 123e4567-e89b-12d3-a456-426614174000

Notes:

  • You need the peering connection ID (not the VPC IDs) to delete a connection
  • Use the show command to find the peering connection ID