avn vpc

Here you’ll find the full list of commands for avn vpc.

Manage project’s VPC

Commands for managing project’s VPCs (Virtual Private Cloud) and using them with avn commands.

avn vpc create

Creates a new VPC.

Parameter

Information

--project

The project to fetch details for

--cloud

The cloud to use by default, to review the list of available cloud regions, check the avn cloud list command

--network-cidr

The network range in the Aiven project VPC in CIDR format (a.b.c.d/e) (required)

Example: Create a new VPC in aws-us-west-1 cloud region with network range 10.1.2.0/24

avn vpc create              \
  --cloud aws-us-west-1     \
  --network-cidr 10.1.2.0/24

The command output is:

PROJECT_VPC_ID                        STATE     CLOUD_NAME     NETWORK_CIDR
====================================  ========  =============  ============
1548c3f6-6240-45ab-892f-2dfacc62ed0d  APPROVED  aws-us-west-1  10.1.2.0/24

avn vpc delete

Deletes an existing VPC.

Parameter

Information

--project

The project to use when a project isn’t specified for an avn command

--project-vpc-id

The project VPC ID. To get the list of VPC IDs execute avn vpc list (required)

Example: Delete the VPC with id 1548c3f6-6240-45ab-892f-2dfacc62ed0d.

avn vpc delete \
--project-vpc-id 1548c3f6-6240-45ab-892f-2dfacc62ed0d

The command output is:

PROJECT_VPC_ID                        STATE     CLOUD_NAME     NETWORK_CIDR
====================================  ========  =============  ============
1548c3f6-6240-45ab-892f-2dfacc62ed0d  DELETING  aws-us-west-1  10.1.2.0/24

avn vpc list

Lists all the project’s VPCs.

Parameter

Information

--project

The project to use when a project isn’t specified for an avn command

--json

Retrieve the output in JSON format

--verbose

Retrieve the verbose output

Example: List all project’s VPCs.

avn vpc list

The command output is:

PROJECT_VPC_ID                        CLOUD_NAME          NETWORK_CIDR   STATE
====================================  ==================  =============  ======
b132dfbf-b035-4cf5-8b15-b7cd6a68aqqd  aws-us-east-1       10.2.1.0/24    ACTIVE
c36a0a6a-6cfb-4718-93ce-ec043ae94qq5  aws-us-west-2       10.13.4.0/24   ACTIVE
d7a984bf-6ebf-4503-bbbd-e7950c49bqqb  azure-eastus        10.213.2.0/24  ACTIVE
f99601f3-4b00-44d6-b4d9-6f16e9f55qq8  google-us-central1  10.1.13.0/24   ACTIVE
8af49368-3125-48a8-b94e-3d1a3d601qqf  google-us-east1     10.50.8.0/24   ACTIVE
6ba650ce-cc08-4e0a-a386-5a354c327qq6  google-us-east4     10.1.17.0/24   ACTIVE
c4bc3a59-87da-4dce-9243-c197edb43qq2  google-us-west3     10.1.13.0/24   ACTIVE

Manage VPC peering connections

avn vpc peering-connection create

Creates a peering connection for a project VPC to AWS, GCP or Azure.

Parameter

Information

--project

The project to use when a project isn’t specified for an avn command

--project-vpc-id

Aiven project VPC ID. To get the list of VPC IDs execute avn vpc list (required)

--peer-cloud-account

AWS account ID, Google project ID, or Azure subscription ID (required)

--peer-vpc

AWS VPC ID, Google VPC network name, or Azure VNet name (required)

--peer-region

AWS region of peer VPC, if different than the region defined in the Aiven project VPC

--peer-resource-group

Azure resource group name (required for Azure)

--peer-azure-app-id

Azure app object ID (required for Azure)

--peer-azure-tenant-id

Azure AD tenant ID (required for Azure)

--user-peer-network-cidr

User-defined peer network IP range for routing/firewall

Example: Create a peering connection for AWS.

avn vpc peering-connection create \
  --project-vpc-id b032dfbf-b035-4cf5-8b15-b7cd6a68aqqd \
  --peer-cloud-account 012345678901 \
  --peer-vpc vpc-abcdef01234567890

The command output is:

CREATE_TIME           PEER_AZURE_APP_ID  PEER_AZURE_TENANT_ID  PEER_CLOUD_ACCOUNT  PEER_RESOURCE_GROUP  PEER_VPC               STATE     STATE_INFO  UPDATE_TIME           USER_PEER_NETWORK_CIDRS  VPC_PEERING_CONNECTION_TYPE
====================  =================  ====================  ==================  ===================  =====================  ========  ==========  ====================  =======================  ===========================
2022-06-15T14:50:54Z  null               null                  012345678901        null                 vpc-abcdef01234567890  APPROVED  null        2022-06-15T14:50:54Z

avn vpc peering-connection delete

Deletes a VPC peering connection.

Parameter

Information

--project

The project to use when a project isn’t specified for an avn command

--project-vpc-id

Aiven project VPC ID. To get the list of VPC IDs execute avn vpc list (required)

--peer-cloud-account

AWS account ID, Google project ID, or Azure subscription ID (required)

--peer-vpc

AWS VPC ID, Google VPC network name, or Azure VNet name (required)

--peer-region

AWS region of peer VPC, if different than the region defined in the Aiven project VPC

--peer-resource-group

Azure resource group name (required for Azure)

Example: Delete the VPC peering connection between the b032dfbf-b035-4cf5-8b15-b7cd6a68aqqd Aiven VPC and the vpc-abcdef01234567890 AWS VPC.

avn vpc peering-connection delete \
  --project-vpc-id b032dfbf-b035-4cf5-8b15-b7cd6a68aqqd \
  --peer-cloud-account 012345678901 \
  --peer-vpc vpc-abcdef01234567890

The command output is:

CREATE_TIME           PEER_AZURE_APP_ID  PEER_AZURE_TENANT_ID  PEER_CLOUD_ACCOUNT  PEER_REGION  PEER_RESOURCE_GROUP  PEER_VPC               STATE     STATE_INFO  UPDATE_TIME           USER_PEER_NETWORK_CIDRS  VPC_PEERING_CONNECTION_TYPE
====================  =================  ====================  ==================  ===========  ===================  =====================  ========  ==========  ====================  =======================  ===========================
2022-06-15T14:50:54Z  null               null                  012345678901        us-east-1    null                 vpc-abcdef01234567890  DELETING  null        2022-06-15T15:02:12Z

avn vpc peering-connection get

Fetches a VPC peering connection details.

Parameter

Information

--project

The project to use when a project isn’t specified for an avn command

--project-vpc-id

Aiven project VPC ID. To get the list of VPC IDs execute avn vpc list (required)

--peer-cloud-account

AWS account ID, Google project ID, or Azure subscription ID (required)

--peer-vpc

AWS VPC ID, Google VPC network name, or Azure VNet name (required)

--json

Retrieve the output in JSON format

--verbose

Retrieve the verbose output

Example: Fetch VPC peering connection details.

avn vpc peering-connection get \
  --project-vpc-id b032dfbf-b035-4cf5-8b15-b7cd6a68aabd \
  --peer-cloud-account 012345678901 \
  --peer-vpc vpc-abcdef01234567890

The command output is:

State: ACTIVE
Message: Peering connection active

AWS_VPC_PEERING_CONNECTION_ID  TYPE
=============================  =================================
pcx-abcdef01234567890          aws-vpc-peering-connection-active

avn vpc peering-connection list

Lists VPC peering connections.

Parameter

Information

--project

The project to use when a project isn’t specified for an avn command

--project-vpc-id

Aiven project VPC ID. To get the list of VPC IDs execute avn vpc list (required)

Example: List VPC peering connections for the VPC with id b032dfbf-b035-4cf5-8b15-b7cd6a68aabd.

avn vpc peering-connection list --project-vpc-id b032dfbf-b035-4cf5-8b15-b7cd6a68aabd

The command output is:

PEER_CLOUD_ACCOUNT  PEER_RESOURCE_GROUP  PEER_VPC               PEER_REGION  STATE
==================  ===================  =====================  ===========  ======
012345678901        null                 vpc-abcdef01234567890  us-east-1    ACTIVE