​
Select Service
ves-io-schema-views-http_loadbalancer-API-Create
Published April 5, 2023 | Last modified October 2, 2026
Examples of creating http_loadbalancer
Usecase:
Create "productpage" HTTP loadbalancer which supports HTTPS
Request using vesctl:
vesctl configuration create http_loadbalancer -i http_loadbalancer.yaml
where file http_loadbalancer.yaml has following contents (http_loadbalancer.CreateRequest):
RequestJSON:
{ "metadata": { "name": "productpage", "namespace": "documentation", "labels": { "ves.io/app_type": "bookinfo" } }, "spec": { "domains": [ "www.bookinfo.com" ], "https": { "tls_cert_params": { "tls_config": { "default_security": {} }, "certificates": [ { "name": "cert1" } ], "no_mtls": {} }, "enable_path_normalize": {}, "port": 0, "header_transformation_type": {} }, "advertise_on_public_default_vip": {}, "default_route_pools": [ { "pool": { "name": "ppage-route" } } ], "disable_waf": {}, "no_challenge": {}, "user_id_client_ip": {}, "disable_rate_limit": {}, "waf_exclusion_rules": [ { "any_domain": null, "path_regex": "", "methods": [ "ANY" ], "metadata": { "name": "name" }, "app_firewall_detection_control": { "exclude_signature_contexts": [ { "signature_id": 10000000 } ], "exclude_violation_contexts": [ { "exclude_violation": "VIOL_ASM_COOKIE_MODIFIED" } ], "exclude_attack_type_contexts": [ { "exclude_attack_type": "ATTACK_TYPE_ABUSE_OF_FUNCTIONALITY" } ] } } ], "l7_ddos_protection": { "mitigation_block": {}, "rps_threshold": 5000, "clientside_action_none": {}, "ddos_policy_none": {} }, "service_policies_from_namespace": {}, "round_robin": {}, "multi_lb_app": {} }}vesctl yaml response:
ResponseJSON:
{ "metadata": { "name": "productpage", "namespace": "documentation", "labels": { "ves.io/app_type": "bookinfo" }, "annotations": {}, "description": "", "disable": false }, "system_metadata": { "uid": "20473531-188e-4cae-a843-b5f30d957f88", "creation_timestamp": "2026-09-28T04:37:47.667657Z", "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": { "domains": [ "www.bookinfo.com" ], "https": { "http_redirect": false, "add_hsts": false, "tls_cert_params": { "tls_config": { "default_security": {} }, "certificates": [ { "tenant": "acmecorp", "namespace": "documentation", "name": "cert1" } ], "no_mtls": {} }, "enable_path_normalize": {}, "port": 0, "header_transformation_type": { "legacy_header_transformation": {} }, "connection_idle_timeout": 0, "http_protocol_options": null, "coalescing_options": null }, "downstream_tls_certificate_expiration_timestamps": [], "advertise_on_public_default_vip": {}, "default_route_pools": [ { "pool": { "tenant": "acmecorp", "namespace": "documentation", "name": "ppage-route" }, "weight": 0, "priority": 0, "endpoint_subsets": {} } ], "origin_server_subset_rule_list": null, "routes": [], "cors_policy": null, "disable_waf": {}, "add_location": false, "no_challenge": {}, "more_option": null, "user_id_client_ip": {}, "api_rate_limit_legacy": null, "disable_rate_limit": {}, "malicious_user_mitigation": null, "waf_exclusion_rules": [ { "path_regex": "", "methods": [ "ANY" ], "expiration_timestamp": null, "metadata": { "name": "name", "description": "", "disable": false }, "app_firewall_detection_control": { "exclude_signature_contexts": [ { "signature_id": 10000000, "context": "CONTEXT_ANY", "context_name": "" } ], "exclude_violation_contexts": [ { "exclude_violation": "VIOL_ASM_COOKIE_MODIFIED", "context": "CONTEXT_ANY", "context_name": "" } ], "exclude_attack_type_contexts": [ { "exclude_attack_type": "ATTACK_TYPE_ABUSE_OF_FUNCTIONALITY", "context": "CONTEXT_ANY", "context_name": "" } ], "exclude_bot_name_contexts": [] } } ], "waf_exclusion": null, "data_guard_rules": [], "blocked_clients": [], "trusted_clients": [], "api_protection_rules": null, "ddos_mitigation_rules": [], "l7_ddos_protection": { "mitigation_block": {}, "rps_threshold": 5000, "clientside_action_none": {}, "ddos_policy_none": {} }, "service_policies_from_namespace": {}, "round_robin": {}, "disable_trust_client_ip_headers": {}, "multi_lb_app": {}, "disable_malicious_user_detection": {}, "disable_api_discovery": {}, "default_sensitive_data_policy": {}, "disable_api_testing": {}, "disable_api_definition": {}, "csrf_policy": null, "graphql_rules": [], "protected_cookies": [], "host_name": "", "dns_info": [], "state": "VIRTUAL_HOST_READY", "auto_cert_info": null, "internet_vip_info": [], "jwt_validation": null, "disable_threat_mesh": {}, "cert_state": "AutoCertDisabled", "sensitive_data_disclosure_rules": null, "disable_malware_protection": {} }}Request using curl:
curl -X 'POST' -d '{"metadata":{"name":"productpage","namespace":"documentation","labels":{"ves.io/app_type":"bookinfo"}},"spec":{"domains":["www.bookinfo.com"],"https":{"tls_cert_params":{"tls_config":{"default_security":{}},"certificates":[{"name":"cert1"}],"no_mtls":{}},"enable_path_normalize":{},"port":0,"header_transformation_type":{}},"advertise_on_public_default_vip":{},"default_route_pools":[{"pool":{"name":"ppage-route"}}],"disable_waf":{},"no_challenge":{},"user_id_client_ip":{},"disable_rate_limit":{},"waf_exclusion_rules":[{"any_domain":null,"path_regex":"","methods":["ANY"],"metadata":{"name":"name"},"app_firewall_detection_control":{"exclude_signature_contexts":[{"signature_id":10000000}],"exclude_violation_contexts":[{"exclude_violation":"VIOL_ASM_COOKIE_MODIFIED"}],"exclude_attack_type_contexts":[{"exclude_attack_type":"ATTACK_TYPE_ABUSE_OF_FUNCTIONALITY"}]}}],"l7_ddos_protection":{"mitigation_block":{},"rps_threshold":5000,"clientside_action_none":{},"ddos_policy_none":{}},"service_policies_from_namespace":{},"round_robin":{},"multi_lb_app":{}}}' -H 'Content-Type: application/json' -H 'X-Volterra-Useragent: v1/pgm=_var_folders_q2_3kp8z3zs0x5_m7pk1bgb0_ph0000gp_T_go-build3348201650_b001_apidocs.test/host=MTY6VVHQPH/svc=S:examplesvc/site=mytestce01' 'https://acmecorp.console.ves.volterra.io/api/config/namespaces/documentation/http_loadbalancers'curl response:
HTTP/1.1 200 OKContent-Type: application/jsonDate: Mon, 28 Sep 2026 04:37:47 GMTVary: Accept-EncodingX-Volterra-Response-Fields-Deprecated: spec.api_rate_limit_legacy,spec.bot_defense_advanced,spec.caching_policy.default_cache_action.eligible_for_cache,spec.enable_api_discovery.sensitive_data_detection_rules,spec.jwt_validation.jwks,spec.routes.#.direct_response_route.route_direct_response.response_body,spec.single_lb_app.enable_discovery.sensitive_data_detection_rules
{ "metadata": { "name": "productpage", "namespace": "documentation", "labels": { "ves.io/app_type": "bookinfo" }, "annotations": { }, "description": "", "disable": false }, "system_metadata": { "uid": "20473531-188e-4cae-a843-b5f30d957f88", "creation_timestamp": "2026-09-28T04:37:47.667657Z", "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": { "domains": [ "www.bookinfo.com" ], "https": { "http_redirect": false, "add_hsts": false, "tls_cert_params": { "tls_config": { "default_security": {
} }, "certificates": [ { "tenant": "acmecorp", "namespace": "documentation", "name": "cert1" } ], "no_mtls": {
} }, "enable_path_normalize": {
}, "port": 0, "header_transformation_type": { "legacy_header_transformation": {
} }, "connection_idle_timeout": 0, "http_protocol_options": null, "coalescing_options": null }, "downstream_tls_certificate_expiration_timestamps": [ ], "advertise_on_public_default_vip": {
}, "default_route_pools": [ { "pool": { "tenant": "acmecorp", "namespace": "documentation", "name": "ppage-route" }, "weight": 0, "priority": 0, "endpoint_subsets": { } } ], "origin_server_subset_rule_list": null, "routes": [ ], "cors_policy": null, "disable_waf": {
}, "add_location": false, "no_challenge": {
}, "more_option": null, "user_id_client_ip": {
}, "api_rate_limit_legacy": null, "disable_rate_limit": {
}, "malicious_user_mitigation": null, "waf_exclusion_rules": [ { "path_regex": "", "methods": [ "ANY" ], "expiration_timestamp": null, "metadata": { "name": "name", "description": "", "disable": false }, "app_firewall_detection_control": { "exclude_signature_contexts": [ { "signature_id": 10000000, "context": "CONTEXT_ANY", "context_name": "" } ], "exclude_violation_contexts": [ { "exclude_violation": "VIOL_ASM_COOKIE_MODIFIED", "context": "CONTEXT_ANY", "context_name": "" } ], "exclude_attack_type_contexts": [ { "exclude_attack_type": "ATTACK_TYPE_ABUSE_OF_FUNCTIONALITY", "context": "CONTEXT_ANY", "context_name": "" } ], "exclude_bot_name_contexts": [ ] } } ], "waf_exclusion": null, "data_guard_rules": [ ], "blocked_clients": [ ], "trusted_clients": [ ], "api_protection_rules": null, "ddos_mitigation_rules": [ ], "l7_ddos_protection": { "mitigation_block": {
}, "rps_threshold": 5000, "clientside_action_none": {
}, "ddos_policy_none": {
} }, "service_policies_from_namespace": {
}, "round_robin": {
}, "disable_trust_client_ip_headers": {
}, "multi_lb_app": {
}, "disable_malicious_user_detection": {
}, "disable_api_discovery": {
}, "default_sensitive_data_policy": {
}, "disable_api_testing": {
}, "disable_api_definition": {
}, "csrf_policy": null, "graphql_rules": [ ], "protected_cookies": [ ], "host_name": "", "dns_info": [ ], "state": "VIRTUAL_HOST_READY", "auto_cert_info": null, "internet_vip_info": [ ], "jwt_validation": null, "disable_threat_mesh": {
}, "cert_state": "AutoCertDisabled", "sensitive_data_disclosure_rules": null, "disable_malware_protection": {
} }}