avn vpc
The list of commands for avn vpc.
Manage project's VPC
Commands for managing project's VPC (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, see 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 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 VPC.
| 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 VPC.
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