​
Select Service
ves-io-schema-views-aws_vpc_site-API-Create
Published April 5, 2023 | Last modified May 28, 2026
Examples of creating aws_vpc_site
Usecase:
Create vpc-site1
Request using vesctl:
vesctl configuration create aws_vpc_site -i aws_vpc_site.yaml
where file aws_vpc_site.yaml has following contents (aws_vpc_site.CreateRequest):
RequestJSON:
{ "metadata": { "name": "vpc-site1", "namespace": "system" }, "spec": { "vpc": { "new_vpc": { "name_tag": "aws-vpc-unit-test", "primary_ipv4": "192.168.0.0/16" } }, "voltstack_cluster": { "aws_certified_hw": "aws-byol-voltstack-combo", "az_nodes": [ { "aws_az_name": "eu-west-3a", "local_subnet": { "subnet_param": { "ipv4": "192.168.1.0/24" } } }, { "aws_az_name": "eu-west-3b", "local_subnet": { "subnet_param": { "ipv4": "192.168.2.0/24" } } }, { "aws_az_name": "eu-west-3c", "local_subnet": { "subnet_param": { "ipv4": "192.168.3.0/24" } } } ], "no_network_policy": null, "no_forward_proxy": null, "no_outside_static_routes": null, "no_global_network": null, "storage_class_list": { "storage_classes": [] }, "no_k8s_cluster": {} }, "aws_cred": { "namespace": "system", "name": "unit-creds-views-aws-test" }, "aws_region": "eu-west-3", "ssh_key": "ssh-rsa AAAAB..", "logs_streaming_disabled": {}, "sw": { "default_sw_version": {} }, "os": { "default_os_version": {} }, "nodes_per_az": 0 }}vesctl yaml response:
ResponseJSON:
{ "metadata": { "name": "vpc-site1", "namespace": "system", "labels": {}, "annotations": {}, "description": "", "disable": false }, "system_metadata": { "uid": "70f7546b-d28f-4d3b-b8d8-7f5ec55cffad", "creation_timestamp": "2026-04-13T02:01:51.036403Z", "deletion_timestamp": null, "modification_timestamp": null, "initializers": null, "finalizers": [], "tenant": "acmecorp", "creator_class": "examplesvc", "creator_id": "examplesvc", "object_index": 0, "owner_view": null, "labels": {} }, "spec": { "vpc": { "new_vpc": { "name_tag": "aws-vpc-unit-test", "primary_ipv4": "192.168.0.0/16", "allocate_ipv6": false } }, "voltstack_cluster": { "aws_certified_hw": "aws-byol-voltstack-combo", "az_nodes": [ { "aws_az_name": "eu-west-3a", "local_subnet": { "subnet_param": { "ipv4": "192.168.1.0/24", "ipv6": "" } }, "disk_size": 0 }, { "aws_az_name": "eu-west-3b", "local_subnet": { "subnet_param": { "ipv4": "192.168.2.0/24", "ipv6": "" } }, "disk_size": 0 }, { "aws_az_name": "eu-west-3c", "local_subnet": { "subnet_param": { "ipv4": "192.168.3.0/24", "ipv6": "" } }, "disk_size": 0 } ], "no_dc_cluster_group": {}, "sm_connection_public_ip": {}, "storage_class_list": { "storage_classes": [] }, "allowed_vip_port": null, "no_k8s_cluster": {} }, "aws_cred": { "tenant": "acmecorp", "namespace": "system", "name": "unit-creds-views-aws-test" }, "instance_type": "", "disk_size": 0, "volterra_software_version": "", "operating_system_version": "", "aws_region": "eu-west-3", "ssh_key": "ssh-rsa AAAAB..", "admin_password": null, "address": "", "coordinates": null, "logs_streaming_disabled": {}, "site_state": "ONLINE", "vip_params_per_az": [], "user_modification_timestamp": null, "tags": {}, "nodes_per_az": 0, "block_all_services": {}, "direct_connect_disabled": {}, "offline_survivability_mode": null, "disable_internet_vip": {}, "egress_gateway_default": {}, "suggested_action": "", "error_description": "", "f5xc_security_group": {}, "f5_orchestrated_routing": {}, "site_errors": [], "validation_state": "VALIDATION_STATE_NONE", "custom_dns": null, "kubernetes_upgrade_drain": null, "cloud_site_info": null, "direct_connect_info": null }}Request using curl:
curl -X 'POST' -d '{"metadata":{"name":"vpc-site1","namespace":"system"},"spec":{"vpc":{"new_vpc":{"name_tag":"aws-vpc-unit-test","primary_ipv4":"192.168.0.0/16"}},"voltstack_cluster":{"aws_certified_hw":"aws-byol-voltstack-combo","az_nodes":[{"aws_az_name":"eu-west-3a","local_subnet":{"subnet_param":{"ipv4":"192.168.1.0/24"}}},{"aws_az_name":"eu-west-3b","local_subnet":{"subnet_param":{"ipv4":"192.168.2.0/24"}}},{"aws_az_name":"eu-west-3c","local_subnet":{"subnet_param":{"ipv4":"192.168.3.0/24"}}}],"no_network_policy":null,"no_forward_proxy":null,"no_outside_static_routes":null,"no_global_network":null,"storage_class_list":{"storage_classes":[]},"no_k8s_cluster":{}},"aws_cred":{"namespace":"system","name":"unit-creds-views-aws-test"},"aws_region":"eu-west-3","ssh_key":"ssh-rsa AAAAB..","logs_streaming_disabled":{},"sw":{"default_sw_version":{}},"os":{"default_os_version":{}},"nodes_per_az":0}}' -H 'Content-Type: application/json' -H 'X-Volterra-Useragent: v1/pgm=_var_folders_q2_3kp8z3zs0x5_m7pk1bgb0_ph0000gp_T_go-build1414723615_b001_apidocs.test/host=MTY6VVHQPH/svc=S:examplesvc/site=mytestce01' 'https://acmecorp.console.ves.volterra.io/api/config/namespaces/system/aws_vpc_sites'curl response:
HTTP/1.1 200 OKContent-Type: application/jsonDate: Mon, 13 Apr 2026 02:01:51 GMTVary: Accept-Encoding
{ "metadata": { "name": "vpc-site1", "namespace": "system", "labels": { }, "annotations": { }, "description": "", "disable": false }, "system_metadata": { "uid": "70f7546b-d28f-4d3b-b8d8-7f5ec55cffad", "creation_timestamp": "2026-04-13T02:01:51.036403Z", "deletion_timestamp": null, "modification_timestamp": null, "initializers": null, "finalizers": [ ], "tenant": "acmecorp", "creator_class": "examplesvc", "creator_id": "examplesvc", "object_index": 0, "owner_view": null, "labels": { } }, "spec": { "vpc": { "new_vpc": { "name_tag": "aws-vpc-unit-test", "primary_ipv4": "192.168.0.0/16", "allocate_ipv6": false } }, "voltstack_cluster": { "aws_certified_hw": "aws-byol-voltstack-combo", "az_nodes": [ { "aws_az_name": "eu-west-3a", "local_subnet": { "subnet_param": { "ipv4": "192.168.1.0/24", "ipv6": "" } }, "disk_size": 0 }, { "aws_az_name": "eu-west-3b", "local_subnet": { "subnet_param": { "ipv4": "192.168.2.0/24", "ipv6": "" } }, "disk_size": 0 }, { "aws_az_name": "eu-west-3c", "local_subnet": { "subnet_param": { "ipv4": "192.168.3.0/24", "ipv6": "" } }, "disk_size": 0 } ], "no_dc_cluster_group": {
}, "sm_connection_public_ip": {
}, "storage_class_list": { "storage_classes": [ ] }, "allowed_vip_port": null, "no_k8s_cluster": {
} }, "aws_cred": { "tenant": "acmecorp", "namespace": "system", "name": "unit-creds-views-aws-test" }, "instance_type": "", "disk_size": 0, "volterra_software_version": "", "operating_system_version": "", "aws_region": "eu-west-3", "ssh_key": "ssh-rsa AAAAB..", "admin_password": null, "address": "", "coordinates": null, "logs_streaming_disabled": {
}, "site_state": "ONLINE", "vip_params_per_az": [ ], "user_modification_timestamp": null, "tags": { }, "nodes_per_az": 0, "block_all_services": {
}, "direct_connect_disabled": {
}, "offline_survivability_mode": null, "disable_internet_vip": {
}, "egress_gateway_default": {
}, "suggested_action": "", "error_description": "", "f5xc_security_group": {
}, "f5_orchestrated_routing": {
}, "site_errors": [ ], "validation_state": "VALIDATION_STATE_NONE", "custom_dns": null, "kubernetes_upgrade_drain": null, "cloud_site_info": null, "direct_connect_info": null }}