Skip to content

xcsh_aws_tgw_site (Data Source)

Retrieves information about a AWS TGW Site resource in F5 Distributed Cloud for deploying F5 sites connected via AWS Transit Gateway. This is a read-only data source.

~> Note: For more information, see the F5 Distributed Cloud API documentation.

# AWSTGWSite Data Source Example
terraform {
required_version = ">= 1.0"
required_providers {
xcsh = {
source = "f5-sales-demo/xcsh"
version = ">= 0.1.0"
}
}
}
# Look up an existing AWSTGWSite by name
data "xcsh_aws_tgw_site" "example" {
name = "example-aws-tgw-site"
namespace = "staging"
}
output "aws_tgw_site_id" {
value = data.xcsh_aws_tgw_site.example.id
}

-> Syntax Rule: This provider uses OneOf groups for mutually exclusive options. Fields documented as “Optional Block” use block syntax field_name { ... }. Empty OneOf object attributes use field_name = {}; conditional selection uses condition ? {} : null. Boolean attributes (such as add_hsts and http_redirect) use = true or = false.

🔶 High Risk Operations — Some operations on this resource have high danger level. Destructive operations may require confirmation.

• name - Required String
Name of the AWSTGWSite

• namespace - Required String
Namespace where the AWSTGWSite exists

In addition to all arguments above, the following attributes are exported:

• annotations - Optional Map
Annotations applied to this resource

• aws_parameters - Optional String
Setup AWS services VPC, transit gateway and site

• block_all_services - Optional Object
Enable this option

• blocked_services - Optional String
Disable node local services on this site

• coordinates - Optional String
Coordinates of the site which provides the site physical location

• custom_dns - Optional String
Custom DNS is the configured for specify CE site

• default_blocked_services - Optional Object
Enable this option

• description - Optional String
Description of the AWSTGWSite

• direct_connect_disabled - Optional Object
Enable this option

• direct_connect_enabled - Optional String
Direct Connect Configuration. Direct Connect Configuration

• id - Optional String
Unique identifier for the resource

• kubernetes_upgrade_drain - Optional String
Specify how worker nodes within a site will be upgraded

• labels - Optional Map
Labels applied to this resource

• log_receiver - Optional String
Type establishes a direct reference from one object(the referrer) to another(the referred). Such a reference is in form of tenant/namespace/name

• logs_streaming_disabled - Optional Object
Enable this option

• offline_survivability_mode - Optional String
Offline Survivability allows the Site to continue functioning normally without traffic loss during periods of connectivity loss to the Regional Edge (RE) or the Global Controller (GC). When this feature is enabled, a site can continue to function as is with existing configuration for upto 7

• os - Optional String
Select the F5XC Operating System Version for the site. By default, latest available OS Version will be used. Refer to release notes to find required released OS versions

• performance_enhancement_mode - Optional String
Optimize the site for L3 or L7 traffic processing. L7 optimized is the default

• private_connectivity - Optional String
Configuration parameter for private connectivity

• sw - Optional String
Select the F5XC Software Version for the site. By default, latest available F5XC Software Version will be used. Refer to release notes to find required released SW versions

• tags - Optional Map
AWS Tags is a label consisting of a user-defined key and value. It helps to manage, identify, organize, search for, and filter resources in AWS console

• tgw_security - Optional String
Security Configuration for transit gateway

• vn_config - Optional String
Virtual Network Configuration. Virtual Network Configuration

• vpc_attachments - Optional String
Spoke VPCs to be attached to the AWS TGW Site

• admin_password - Optional String
SecretType is used in an object to indicate a sensitive/confidential field

• aws_cred - Optional String
Type establishes a direct reference from one object(the referrer) to another(the referred). Such a reference is in form of tenant/namespace/name

• aws_region - Optional String
AWS Region of your services VPC, where F5XC site will be deployed

• az_nodes - Optional List
Only Single AZ or Three AZ(s) nodes are supported currently

• custom_security_group - Optional String
Enter pre created security groups for slo(Site Local Outside) and SLI(Site Local Inside) interface. Supported only for sites deployed on existing VPC

• disable_encryption - Optional Object
Configuration parameter for disable encryption

• disable_internet_vip - Optional Object
Enable this option

• disk_size - Optional Number
Node disk size for all node in the F5XC site. Unit is GiB

• enable_encryption - Optional String
Configuration parameter for enable encryption

• enable_internet_vip - Optional Object
Enable this option

• existing_tgw - Optional String
Configuration parameter for existing TGW

• f5xc_security_group - Optional Object
Enable this option

• instance_type - Optional String
AWS Instance Type for Node. Instance size based on the performance

• new_tgw - Optional String
TGWParamsType

• new_vpc - Optional String
AWS VPC Parameters. Parameters to create new AWS VPC

• no_worker_nodes - Optional Object
Configuration parameter for no worker nodes

• nodes_per_az - Optional Number
Desired Worker Nodes Per AZ. Max limit is up to 21

• reserved_tgw_cidr - Optional Object
Configuration parameter for reserved TGW CIDR

• ssh_key - Optional String
Public SSH key for accessing nodes of the site

• tgw_cidr - Optional String
Parameters for creating a new cloud subnet

• total_nodes - Optional Number
Total number of worker nodes to be deployed across all AZ’s used in the Site

• vpc_id - Optional String
Existing VPC ID

• blindfold_secret_info - Optional String
BlindfoldSecretInfoType specifies information about the Secret managed by F5XC Secret Management

• clear_secret_info - Optional String
ClearSecretInfoType specifies information about the Secret that is not encrypted

• decryption_provider - Optional String
Name of the Secret Management Access object that contains information about the backend Secret Management service

• location - Optional String
Location is the uri_ref. It could be in URL format for string:/// Or it could be a path if the store provider is an HTTP/HTTPS location

• store_provider - Optional String
Name of the Secret Management Access object that contains information about the store to GET encrypted bytes This field needs to be provided only if the URL scheme is not string:///

• provider_ref - Optional String
Name of the Secret Management Access object that contains information about the store to GET encrypted bytes This field needs to be provided only if the URL scheme is not string:///

• url - Optional String
URL of the secret. Currently supported URL schemes is string:///. For string:/// scheme, Secret needs to be encoded Base64 format. When asked for this secret, caller will GET Secret bytes after Base64 decoding

• name - Optional String
When a configuration object(e.g. Virtual_host) refers to another(e.g route) then name will hold the referred object’s(e.g. Route’s) name

• namespace - Optional String
When a configuration object(e.g. Virtual_host) refers to another(e.g route) then namespace will hold the referred object’s(e.g. Route’s) namespace

• tenant - Optional String
When a configuration object(e.g. Virtual_host) refers to another(e.g route) then tenant will hold the referred object’s(e.g. Route’s) tenant

• aws_az_name - Optional String
AWS availability zone, must be consistent with the selected AWS region

• inside_subnet - Optional String
Configuration parameter for inside subnet

• outside_subnet - Optional String
Configuration parameter for outside subnet

• reserved_inside_subnet - Optional Object
Configuration parameter for reserved inside subnet

• workload_subnet - Optional String
Configuration parameter for workload subnet

• existing_subnet_id - Optional String
Information about existing subnet ID

• subnet_param - Optional String
Parameters for creating a new cloud subnet

• ipv4 - Optional String
IPv4 Subnet. IPv4 subnet prefix for this subnet

• existing_subnet_id - Optional String
Information about existing subnet ID

• subnet_param - Optional String
Parameters for creating a new cloud subnet

• ipv4 - Optional String
IPv4 Subnet. IPv4 subnet prefix for this subnet

• existing_subnet_id - Optional String
Information about existing subnet ID

• subnet_param - Optional String
Parameters for creating a new cloud subnet

• ipv4 - Optional String
IPv4 Subnet. IPv4 subnet prefix for this subnet

• inside_security_group_id - Optional String
Security Group ID to be attached to SLI(Site Local Inside) Interface

• outside_security_group_id - Optional String
Security Group ID to be attached to SLO(Site Local Outside) Interface

• kms_key_id - Optional String
AWS KMS Key to be used to encrypt the disk attached to the VM

• tgw_asn - Optional Number
Enter TGW ASN. TGW ASN

• tgw_id - Optional String
Existing TGW ID. Existing TGW ID

• volterra_site_asn - Optional Number
Enter F5XC Site ASN. F5XC Site ASN

• system_generated - Optional Object
Configuration parameter for system generated

• user_assigned - Optional String
Information needed when ASNs are assigned by the user

• tgw_asn - Optional Number
TGW ASN. Allowed range for 16-bit private ASNs include 64512 to 65534

• volterra_site_asn - Optional Number
Enter F5XC Site ASN. F5XC Site ASN

• autogenerate - Optional Object
Configuration parameter for autogenerate

• name_tag - Optional String
Specify the VPC Name

• primary_ipv4 - Optional String
IPv4 CIDR block for this VPC. It has to be private address space. The Primary IPv4 block cannot be modified. All subnets prefixes in this VPC must be part of this CIDR block

• ipv4 - Optional String
IPv4 Subnet. IPv4 subnet prefix for this subnet

• blocked_service - Optional List
Disable Node Local Services. Blocking or denial configuration

• dns - Optional Object
Enable this option

• network_type - Optional String Defaults to VIRTUAL_NETWORK_SITE_LOCAL
Possible values are VIRTUAL_NETWORK_SITE_LOCAL, VIRTUAL_NETWORK_SITE_LOCAL_INSIDE, VIRTUAL_NETWORK_PER_SITE, VIRTUAL_NETWORK_PUBLIC, VIRTUAL_NETWORK_GLOBAL, VIRTUAL_NETWORK_SITE_SERVICE, VIRTUAL_NETWORK_VER_INTERNAL, VIRTUAL_NETWORK_SITE_LOCAL_INSIDE_OUTSIDE, VIRTUAL_NETWORK_IP_AUTO, VIRTUAL_NETWORK_VOLTADN_PRIVATE_NETWORK, VIRTUAL_NETWORK_SRV6_NETWORK, VIRTUAL_NETWORK_IP_FABRIC, VIRTUAL_NETWORK_SEGMENT, VIRTUAL_NETWORK_MANAGEMENT
[Enum: VIRTUAL_NETWORK_SITE_LOCAL|VIRTUAL_NETWORK_SITE_LOCAL_INSIDE|VIRTUAL_NETWORK_PER_SITE|VIRTUAL_NETWORK_PUBLIC|VIRTUAL_NETWORK_GLOBAL|VIRTUAL_NETWORK_SITE_SERVICE|VIRTUAL_NETWORK_VER_INTERNAL|VIRTUAL_NETWORK_SITE_LOCAL_INSIDE_OUTSIDE|VIRTUAL_NETWORK_IP_AUTO|VIRTUAL_NETWORK_VOLTADN_PRIVATE_NETWORK|VIRTUAL_NETWORK_SRV6_NETWORK|VIRTUAL_NETWORK_IP_FABRIC|VIRTUAL_NETWORK_SEGMENT|VIRTUAL_NETWORK_MANAGEMENT] Different types of virtual networks understood by the system Virtual-network of type VIRTUAL_NETWORK_SITE_LOCAL provides connectivity to public (outside) network. This is an insecure network and is connected to public internet via NAT Gateways/firwalls Virtual-network of this type is local to

• ssh - Optional Object
Enable this option

• web_user_interface - Optional Object
Enable this option


A coordinates block supports the following:

• latitude - Optional Number
Latitude. Latitude of the site location

• longitude - Optional Number
Longitude. Longitude of site location

A custom_dns block supports the following:

• inside_nameserver - Optional String
Optional DNS server IP to be used for name resolution in inside network

• outside_nameserver - Optional String
Optional DNS server IP to be used for name resolution in outside network

A default_blocked_services block supports the following:

A direct_connect_disabled block supports the following:

A direct_connect_enabled block supports the following:

• auto_asn - Optional Object
Enable this option

• custom_asn - Optional Number
Custom Autonomous System Number

• hosted_vifs - Optional String
AWS Direct Connect Hosted VIF Configuration

• standard_vifs - Optional Object
Configuration parameter for standard vifs

An auto_asn block (within direct_connect_enabled) supports the following:

A hosted_vifs block (within direct_connect_enabled) supports the following:

• site_registration_over_direct_connect - Optional String
CloudLink ADN Network Config

• site_registration_over_internet - Optional Object
Enable this option

• vif_list - Optional List
List of Hosted VIF Config. List of Hosted VIF Config

Direct Connect Enabled Hosted Vifs Site Registration Over Direct Connect

Section titled “Direct Connect Enabled Hosted Vifs Site Registration Over Direct Connect”

Deeply nested Connect block collapsed for readability.

Direct Connect Enabled Hosted Vifs Site Registration Over internet

Section titled “Direct Connect Enabled Hosted Vifs Site Registration Over internet”

Deeply nested internet block collapsed for readability.

Direct Connect Enabled Hosted Vifs Vif List

Section titled “Direct Connect Enabled Hosted Vifs Vif List”

A vif_list block (within direct_connect_enabled.hosted_vifs) supports the following:

• other_region - Optional String
Possible values are af-south-1, ap-east-1, ap-northeast-1, ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2, ap-southeast-3, CA-central-1, eu-central-1, eu-north-1, eu-south-1, eu-west-1, eu-west-2, eu-west-3, me-south-1, sa-east-1, us-east-1, us-east-2, us-west-1, us-west-2
[Enum: af-south-1|ap-east-1|ap-northeast-1|ap-northeast-2|ap-south-1|ap-southeast-1|ap-southeast-2|ap-southeast-3|CA-central-1|eu-central-1|eu-north-1|eu-south-1|eu-west-1|eu-west-2|eu-west-3|me-south-1|sa-east-1|us-east-1|us-east-2|us-west-1|us-west-2] Other Region

• same_as_site_region - Optional Object
Enable this option

• vif_id - Optional String
AWS Direct Connect VIF ID that needs to be connected to the site

Direct Connect Enabled Hosted Vifs Vif List Same As Site Region

Section titled “Direct Connect Enabled Hosted Vifs Vif List Same As Site Region”

Deeply nested Region block collapsed for readability.

A standard_vifs block (within direct_connect_enabled) supports the following:

A kubernetes_upgrade_drain block supports the following:

• disable_upgrade_drain - Optional Object
Configuration parameter for disable upgrade drain

• enable_upgrade_drain - Optional String
Specify batch upgrade settings for worker nodes within a site

Kubernetes Upgrade Drain Disable Upgrade Drain

Section titled “Kubernetes Upgrade Drain Disable Upgrade Drain”

A disable_upgrade_drain block (within kubernetes_upgrade_drain) supports the following:

Kubernetes Upgrade Drain Enable Upgrade Drain

Section titled “Kubernetes Upgrade Drain Enable Upgrade Drain”

An enable_upgrade_drain block (within kubernetes_upgrade_drain) supports the following:

• disable_vega_upgrade_mode - Optional Object
Configuration parameter for disable vega upgrade mode

• drain_max_unavailable_node_count - Optional Number
Node Batch Size Count

• drain_max_unavailable_node_percentage - Optional Number
Maximum percentage of nodes unavailable during upgrade draining

• drain_node_timeout - Optional Number
Seconds to wait before initiating upgrade on the next set of nodes. Setting it to 0 will wait indefinitely for all services on nodes to be upgraded gracefully before proceeding to the next set of nodes. (Warning: It may block upgrade if services on a node cannot be gracefully upgraded. It is

• enable_vega_upgrade_mode - Optional Object
Configuration parameter for enable vega upgrade mode

Kubernetes Upgrade Drain Enable Upgrade Drain Disable Vega Upgrade Mode

Section titled “Kubernetes Upgrade Drain Enable Upgrade Drain Disable Vega Upgrade Mode”

Deeply nested Mode block collapsed for readability.

Kubernetes Upgrade Drain Enable Upgrade Drain Enable Vega Upgrade Mode

Section titled “Kubernetes Upgrade Drain Enable Upgrade Drain Enable Vega Upgrade Mode”

Deeply nested Mode block collapsed for readability.

A log_receiver block supports the following:

• name - Optional String
When a configuration object(e.g. Virtual_host) refers to another(e.g route) then name will hold the referred object’s(e.g. Route’s) name

• namespace - Optional String
When a configuration object(e.g. Virtual_host) refers to another(e.g route) then namespace will hold the referred object’s(e.g. Route’s) namespace

• tenant - Optional String
When a configuration object(e.g. Virtual_host) refers to another(e.g route) then tenant will hold the referred object’s(e.g. Route’s) tenant

A logs_streaming_disabled block supports the following:

An offline_survivability_mode block supports the following:

• enable_offline_survivability_mode - Optional Object
Configuration parameter for enable offline survivability mode

• no_offline_survivability_mode - Optional Object
Configuration parameter for no offline survivability mode

Offline Survivability Mode Enable Offline Survivability Mode

Section titled “Offline Survivability Mode Enable Offline Survivability Mode”

An enable_offline_survivability_mode block (within offline_survivability_mode) supports the following:

Offline Survivability Mode No Offline Survivability Mode

Section titled “Offline Survivability Mode No Offline Survivability Mode”

A no_offline_survivability_mode block (within offline_survivability_mode) supports the following:

An os block supports the following:

• default_os_version - Optional Object
Enable this option

• operating_system_version - Optional String
Specify a OS version to be used e.g. 9.2024.6

A default_os_version block (within os) supports the following:

A performance_enhancement_mode block supports the following:

• perf_mode_l3_enhanced - Optional String
Configuration parameter for perf mode l3 enhanced

• perf_mode_l7_enhanced - Optional String
Configuration parameter for perf mode l7 enhanced

Performance Enhancement Mode Perf Mode L3 Enhanced

Section titled “Performance Enhancement Mode Perf Mode L3 Enhanced”

A perf_mode_l3_enhanced block (within performance_enhancement_mode) supports the following:

• jumbo - Optional Object
Enable this option

• no_jumbo - Optional Object
Enable this option

Performance Enhancement Mode Perf Mode L3 Enhanced Jumbo

Section titled “Performance Enhancement Mode Perf Mode L3 Enhanced Jumbo”

Deeply nested Jumbo block collapsed for readability.

Performance Enhancement Mode Perf Mode L3 Enhanced No Jumbo

Section titled “Performance Enhancement Mode Perf Mode L3 Enhanced No Jumbo”

Deeply nested Jumbo block collapsed for readability.

Performance Enhancement Mode Perf Mode L7 Enhanced

Section titled “Performance Enhancement Mode Perf Mode L7 Enhanced”

A perf_mode_l7_enhanced block (within performance_enhancement_mode) supports the following:

• jumbo_disabled - Optional Object
Enable this option

• jumbo_enabled - Optional Object
Enable this option

Performance Enhancement Mode Perf Mode L7 Enhanced Jumbo Disabled

Section titled “Performance Enhancement Mode Perf Mode L7 Enhanced Jumbo Disabled”

Deeply nested Disabled block collapsed for readability.

Performance Enhancement Mode Perf Mode L7 Enhanced Jumbo Enabled

Section titled “Performance Enhancement Mode Perf Mode L7 Enhanced Jumbo Enabled”

Deeply nested Enabled block collapsed for readability.

A private_connectivity block supports the following:

• cloud_link - Optional String
Type establishes a direct reference from one object(the referrer) to another(the referred). Such a reference is in form of tenant/namespace/name

• inside - Optional Object
Enable this option

• outside - Optional Object
Enable this option

A cloud_link block (within private_connectivity) supports the following:

• name - Optional String
When a configuration object(e.g. Virtual_host) refers to another(e.g route) then name will hold the referred object’s(e.g. Route’s) name

• namespace - Optional String
When a configuration object(e.g. Virtual_host) refers to another(e.g route) then namespace will hold the referred object’s(e.g. Route’s) namespace

• tenant - Optional String
When a configuration object(e.g. Virtual_host) refers to another(e.g route) then tenant will hold the referred object’s(e.g. Route’s) tenant

An inside block (within private_connectivity) supports the following:

An outside block (within private_connectivity) supports the following:

A sw block supports the following:

• default_sw_version - Optional Object
Enable this option

• volterra_software_version - Optional String
Specify a F5XC Software Version to be used e.g. Crt-20210329-1002

A default_sw_version block (within sw) supports the following:

A tgw_security block supports the following:

• active_east_west_service_policies - Optional String
Active service policies for the east-west proxy

• active_enhanced_firewall_policies - Optional String
List of Enhanced Firewall Policies These policies use session-based rules and provide all OPTIONS available under firewall policies with an additional option for service insertion

• active_forward_proxy_policies - Optional String
Ordered List of Forward Proxy Policies active

• active_network_policies - Optional String
Configuration parameter for active network policies

• east_west_service_policy_allow_all - Optional Object
Configuration parameter for east west service policy allow all

• forward_proxy_allow_all - Optional Object
Configuration parameter for forward proxy allow all

• no_east_west_policy - Optional Object
Policy configuration for this feature

• no_forward_proxy - Optional Object
Configuration parameter for no forward proxy

• no_network_policy - Optional Object
Policy configuration for this feature

TGW Security Active East West Service Policies

Section titled “TGW Security Active East West Service Policies”

An active_east_west_service_policies block (within tgw_security) supports the following:

• service_policies - Optional List
List of references to service_policy objects

TGW Security Active East West Service Policies Service Policies

Section titled “TGW Security Active East West Service Policies Service Policies”

Deeply nested Policies block collapsed for readability.

TGW Security Active Enhanced Firewall Policies

Section titled “TGW Security Active Enhanced Firewall Policies”

An active_enhanced_firewall_policies block (within tgw_security) supports the following:

• enhanced_firewall_policies - Optional List
Ordered List of Enhanced Firewall Policies active

TGW Security Active Enhanced Firewall Policies Enhanced Firewall Policies

Section titled “TGW Security Active Enhanced Firewall Policies Enhanced Firewall Policies”

Deeply nested Policies block collapsed for readability.

TGW Security Active Forward Proxy Policies

Section titled “TGW Security Active Forward Proxy Policies”

An active_forward_proxy_policies block (within tgw_security) supports the following:

• forward_proxy_policies - Optional List
Ordered List of Forward Proxy Policies active

TGW Security Active Forward Proxy Policies Forward Proxy Policies

Section titled “TGW Security Active Forward Proxy Policies Forward Proxy Policies”

Deeply nested Policies block collapsed for readability.

An active_network_policies block (within tgw_security) supports the following:

• network_policies - Optional List
Ordered List of Firewall Policies active for this network firewall

TGW Security Active Network Policies Network Policies

Section titled “TGW Security Active Network Policies Network Policies”

A network_policies block (within tgw_security.active_network_policies) supports the following:

• name - Optional String
When a configuration object(e.g. Virtual_host) refers to another(e.g route) then name will hold the referred object’s(e.g. Route’s) name

• namespace - Optional String
When a configuration object(e.g. Virtual_host) refers to another(e.g route) then namespace will hold the referred object’s(e.g. Route’s) namespace

• tenant - Optional String
When a configuration object(e.g. Virtual_host) refers to another(e.g route) then tenant will hold the referred object’s(e.g. Route’s) tenant

TGW Security East West Service Policy Allow All

Section titled “TGW Security East West Service Policy Allow All”

Deeply nested All block collapsed for readability.

A forward_proxy_allow_all block (within tgw_security) supports the following:

A no_east_west_policy block (within tgw_security) supports the following:

A no_forward_proxy block (within tgw_security) supports the following:

A no_network_policy block (within tgw_security) supports the following:

A vn_config block supports the following:

• allowed_vip_port - Optional String
Defines the TCP port(s) which will be opened on the cloud loadbalancer. Such that the client can use the cloud VIP IP and port combination to reach TCP/HTTP LB configured on the F5XC Site

• allowed_vip_port_sli - Optional String
Defines the TCP port(s) which will be opened on the cloud loadbalancer. Such that the client can use the cloud VIP IP and port combination to reach TCP/HTTP LB configured on the F5XC Site

• dc_cluster_group_inside_vn - Optional String
Type establishes a direct reference from one object(the referrer) to another(the referred). Such a reference is in form of tenant/namespace/name

• dc_cluster_group_outside_vn - Optional String
Type establishes a direct reference from one object(the referrer) to another(the referred). Such a reference is in form of tenant/namespace/name

• global_network_list - Optional String
Global Network Connection List. List of global network connections

• inside_static_routes - Optional String
Configuration parameter for inside static routes

• no_dc_cluster_group - Optional Object
Enable this option

• no_global_network - Optional Object
Configuration parameter for no global network

• no_inside_static_routes - Optional Object
Configuration parameter for no inside static routes

• no_outside_static_routes - Optional Object
Configuration parameter for no outside static routes

• outside_static_routes - Optional String
Configuration parameter for outside static routes

• sm_connection_public_ip - Optional Object
Enable this option

• sm_connection_pvt_ip - Optional Object
Enable this option

An allowed_vip_port block (within vn_config) supports the following:

• custom_ports - Optional String
Custom Ports. List of Custom port

• disable_allowed_vip_port - Optional Object
Enable this option

• use_http_https_port - Optional Object
Enable this option

• use_http_port - Optional Object
Enable this option

• use_https_port - Optional Object
Enable this option

A custom_ports block (within vn_config.allowed_vip_port) supports the following:

• port_ranges - Optional String
Port Ranges. Port Ranges

Vn Config Allowed VIP Port Disable Allowed VIP Port

Section titled “Vn Config Allowed VIP Port Disable Allowed VIP Port”

Deeply nested Port block collapsed for readability.

Vn Config Allowed VIP Port Use HTTP HTTPS Port

Section titled “Vn Config Allowed VIP Port Use HTTP HTTPS Port”

Deeply nested Port block collapsed for readability.

Deeply nested Port block collapsed for readability.

Deeply nested Port block collapsed for readability.

An allowed_vip_port_sli block (within vn_config) supports the following:

• custom_ports - Optional String
Custom Ports. List of Custom port

• disable_allowed_vip_port - Optional Object
Enable this option

• use_http_https_port - Optional Object
Enable this option

• use_http_port - Optional Object
Enable this option

• use_https_port - Optional Object
Enable this option

Vn Config Allowed VIP Port SLI Custom Ports

Section titled “Vn Config Allowed VIP Port SLI Custom Ports”

Deeply nested Ports block collapsed for readability.

Vn Config Allowed VIP Port SLI Disable Allowed VIP Port

Section titled “Vn Config Allowed VIP Port SLI Disable Allowed VIP Port”

Deeply nested Port block collapsed for readability.

Vn Config Allowed VIP Port SLI Use HTTP HTTPS Port

Section titled “Vn Config Allowed VIP Port SLI Use HTTP HTTPS Port”

Deeply nested Port block collapsed for readability.

Vn Config Allowed VIP Port SLI Use HTTP Port

Section titled “Vn Config Allowed VIP Port SLI Use HTTP Port”

Deeply nested Port block collapsed for readability.

Vn Config Allowed VIP Port SLI Use HTTPS Port

Section titled “Vn Config Allowed VIP Port SLI Use HTTPS Port”

Deeply nested Port block collapsed for readability.

A dc_cluster_group_inside_vn block (within vn_config) supports the following:

• name - Optional String
When a configuration object(e.g. Virtual_host) refers to another(e.g route) then name will hold the referred object’s(e.g. Route’s) name

• namespace - Optional String
When a configuration object(e.g. Virtual_host) refers to another(e.g route) then namespace will hold the referred object’s(e.g. Route’s) namespace

• tenant - Optional String
When a configuration object(e.g. Virtual_host) refers to another(e.g route) then tenant will hold the referred object’s(e.g. Route’s) tenant

A dc_cluster_group_outside_vn block (within vn_config) supports the following:

• name - Optional String
When a configuration object(e.g. Virtual_host) refers to another(e.g route) then name will hold the referred object’s(e.g. Route’s) name

• namespace - Optional String
When a configuration object(e.g. Virtual_host) refers to another(e.g route) then namespace will hold the referred object’s(e.g. Route’s) namespace

• tenant - Optional String
When a configuration object(e.g. Virtual_host) refers to another(e.g route) then tenant will hold the referred object’s(e.g. Route’s) tenant

A global_network_list block (within vn_config) supports the following:

• global_network_connections - Optional List
Global Network Connections. Global network connections

Vn Config Global Network List Global Network Connections

Section titled “Vn Config Global Network List Global Network Connections”

Deeply nested Connections block collapsed for readability.

Vn Config Global Network List Global Network Connections SLI To Global DR

Section titled “Vn Config Global Network List Global Network Connections SLI To Global DR”

Deeply nested DR block collapsed for readability.

Vn Config Global Network List Global Network Connections SLI To Global DR Global Vn

Section titled “Vn Config Global Network List Global Network Connections SLI To Global DR Global Vn”

Deeply nested Vn block collapsed for readability.

Vn Config Global Network List Global Network Connections Slo To Global DR

Section titled “Vn Config Global Network List Global Network Connections Slo To Global DR”

Deeply nested DR block collapsed for readability.

Vn Config Global Network List Global Network Connections Slo To Global DR Global Vn

Section titled “Vn Config Global Network List Global Network Connections Slo To Global DR Global Vn”

Deeply nested Vn block collapsed for readability.

An inside_static_routes block (within vn_config) supports the following:

• static_route_list - Optional List
List of Static Routes. List of Static routes

Vn Config Inside Static Routes Static Route List

Section titled “Vn Config Inside Static Routes Static Route List”

Deeply nested List block collapsed for readability.

Vn Config Inside Static Routes Static Route List Custom Static Route

Section titled “Vn Config Inside Static Routes Static Route List Custom Static Route”

Deeply nested Route block collapsed for readability.

Vn Config Inside Static Routes Static Route List Custom Static Route Labels

Section titled “Vn Config Inside Static Routes Static Route List Custom Static Route Labels”

Deeply nested Labels block collapsed for readability.

Vn Config Inside Static Routes Static Route List Custom Static Route Nexthop

Section titled “Vn Config Inside Static Routes Static Route List Custom Static Route Nexthop”

Deeply nested Nexthop block collapsed for readability.

Vn Config Inside Static Routes Static Route List Custom Static Route Nexthop Interface

Section titled “Vn Config Inside Static Routes Static Route List Custom Static Route Nexthop Interface”

Deeply nested Interface block collapsed for readability.

Vn Config Inside Static Routes Static Route List Custom Static Route Nexthop Nexthop Address

Section titled “Vn Config Inside Static Routes Static Route List Custom Static Route Nexthop Nexthop Address”

Deeply nested Address block collapsed for readability.

Vn Config Inside Static Routes Static Route List Custom Static Route Nexthop Nexthop Address IPv4

Section titled “Vn Config Inside Static Routes Static Route List Custom Static Route Nexthop Nexthop Address IPv4”

Deeply nested IPv4 block collapsed for readability.

Vn Config Inside Static Routes Static Route List Custom Static Route Nexthop Nexthop Address IPv6

Section titled “Vn Config Inside Static Routes Static Route List Custom Static Route Nexthop Nexthop Address IPv6”

Deeply nested IPv6 block collapsed for readability.

Vn Config Inside Static Routes Static Route List Custom Static Route Subnets

Section titled “Vn Config Inside Static Routes Static Route List Custom Static Route Subnets”

Deeply nested Subnets block collapsed for readability.

Vn Config Inside Static Routes Static Route List Custom Static Route Subnets IPv4

Section titled “Vn Config Inside Static Routes Static Route List Custom Static Route Subnets IPv4”

Deeply nested IPv4 block collapsed for readability.

Vn Config Inside Static Routes Static Route List Custom Static Route Subnets IPv6

Section titled “Vn Config Inside Static Routes Static Route List Custom Static Route Subnets IPv6”

Deeply nested IPv6 block collapsed for readability.

A no_dc_cluster_group block (within vn_config) supports the following:

A no_global_network block (within vn_config) supports the following:

A no_inside_static_routes block (within vn_config) supports the following:

A no_outside_static_routes block (within vn_config) supports the following:

An outside_static_routes block (within vn_config) supports the following:

• static_route_list - Optional List
List of Static Routes. List of Static routes

Vn Config Outside Static Routes Static Route List

Section titled “Vn Config Outside Static Routes Static Route List”

Deeply nested List block collapsed for readability.

Vn Config Outside Static Routes Static Route List Custom Static Route

Section titled “Vn Config Outside Static Routes Static Route List Custom Static Route”

Deeply nested Route block collapsed for readability.

Vn Config Outside Static Routes Static Route List Custom Static Route Labels

Section titled “Vn Config Outside Static Routes Static Route List Custom Static Route Labels”

Deeply nested Labels block collapsed for readability.

Vn Config Outside Static Routes Static Route List Custom Static Route Nexthop

Section titled “Vn Config Outside Static Routes Static Route List Custom Static Route Nexthop”

Deeply nested Nexthop block collapsed for readability.

Vn Config Outside Static Routes Static Route List Custom Static Route Nexthop Interface

Section titled “Vn Config Outside Static Routes Static Route List Custom Static Route Nexthop Interface”

Deeply nested Interface block collapsed for readability.

Vn Config Outside Static Routes Static Route List Custom Static Route Nexthop Nexthop Address

Section titled “Vn Config Outside Static Routes Static Route List Custom Static Route Nexthop Nexthop Address”

Deeply nested Address block collapsed for readability.

Vn Config Outside Static Routes Static Route List Custom Static Route Nexthop Nexthop Address IPv4

Section titled “Vn Config Outside Static Routes Static Route List Custom Static Route Nexthop Nexthop Address IPv4”

Deeply nested IPv4 block collapsed for readability.

Vn Config Outside Static Routes Static Route List Custom Static Route Nexthop Nexthop Address IPv6

Section titled “Vn Config Outside Static Routes Static Route List Custom Static Route Nexthop Nexthop Address IPv6”

Deeply nested IPv6 block collapsed for readability.

Vn Config Outside Static Routes Static Route List Custom Static Route Subnets

Section titled “Vn Config Outside Static Routes Static Route List Custom Static Route Subnets”

Deeply nested Subnets block collapsed for readability.

Vn Config Outside Static Routes Static Route List Custom Static Route Subnets IPv4

Section titled “Vn Config Outside Static Routes Static Route List Custom Static Route Subnets IPv4”

Deeply nested IPv4 block collapsed for readability.

Vn Config Outside Static Routes Static Route List Custom Static Route Subnets IPv6

Section titled “Vn Config Outside Static Routes Static Route List Custom Static Route Subnets IPv6”

Deeply nested IPv6 block collapsed for readability.

A sm_connection_public_ip block (within vn_config) supports the following:

A sm_connection_pvt_ip block (within vn_config) supports the following:

A vpc_attachments block supports the following:

• vpc_list - Optional List
List of VPC attachments to transit gateway

A vpc_list block (within vpc_attachments) supports the following:

• labels - Optional String
Add labels for the VPC attachment. These labels can then be used in policies such as enhanced firewall

• vpc_id - Optional String
VPC ID. Information about existing VPC

A labels block (within vpc_attachments.vpc_list) supports the following:


The following type definitions are used throughout this resource. See the full definition here rather than repeated inline.

Object Reference {#common-object-reference}

Section titled “Object Reference {#common-object-reference}”

Object references establish a direct reference from one configuration object to another in F5 Distributed Cloud. References use the format tenant/namespace/name.

FieldTypeDescription
nameStringName of the referenced object
namespaceStringNamespace containing the referenced object
tenantStringTenant of the referenced object (system-managed)

Transformers apply transformations to input values before matching. Multiple transformers can be applied in order.

ValueDescription
LOWER_CASEConvert to lowercase
UPPER_CASEConvert to uppercase
BASE64_DECODEDecodebase64 content
NORMALIZE_PATHNormalize URL path
REMOVE_WHITESPACERemove whitespace characters
URL_DECODEDecode URL-encoded characters
TRIM_LEFTTrim leading whitespace
TRIM_RIGHTTrim trailing whitespace
TRIMTrim both leading and trailing whitespace

HTTP methods used for request matching.

ValueDescription
ANYMatch any HTTP method
GETHTTP GET request
HEADHTTP HEAD request
POSTHTTP POST request
PUTHTTP PUT request
DELETEHTTP DELETE request
CONNECTHTTP CONNECT request
OPTIONSHTTP OPTIONS request
TRACEHTTP TRACE request
PATCHHTTP PATCH request
COPYHTTP COPY request (WebDAV)

TLS Fingerprints {#common-tls-fingerprints}

Section titled “TLS Fingerprints {#common-tls-fingerprints}”

TLS fingerprint categories for malicious client detection.

ValueDescription
TLS_FINGERPRINT_NONENo fingerprint matching
ANY_MALICIOUS_FINGERPRINTMatch any known malicious fingerprint
ADWAREAdware-associated fingerprints
DRIDEXDridex malware fingerprints
GOOTKITGootkit malware fingerprints
RANSOMWARERansomware-associated fingerprints
TRICKBOTTrickbot malware fingerprints

IP Threat Categories {#common-ip-threat-categories}

Section titled “IP Threat Categories {#common-ip-threat-categories}”

IP address threat categories for security filtering.

ValueDescription
SPAM_SOURCESKnown spam sources
WINDOWS_EXPLOITSWindows exploit sources
WEB_ATTACKSWeb attack sources
BOTNETSKnown botnet IPs
SCANNERSNetwork scanner IPs
REPUTATIONPoor reputation IPs
PHISHINGPhishing-related IPs
PROXYAnonymous proxy IPs
MOBILE_THREATSMobile threat sources
TOR_PROXYTor exit nodes
DENIAL_OF_SERVICEDoS attack sources
NETWORKKnown bad network ranges