Ursprungsserver-Pool-Erweiterungen

Anreicherungsmetadaten für origin_pool-bezogene Schemas. Siehe OpenAPI-Erweiterungen für Erweiterungsdefinitionen.

Angereicherte Schemas

Muster

Alle Schemas, die origin_pool.*SpecType entsprechen, erhalten Anreicherungen:

origin_poolCreateSpecType
origin_poolReplaceSpecType
origin_poolGetSpecType

Pflichtfelder

Feld	Erforderlich für	Hinweise
`metadata.name`	Alle Operationen	1–63 Zeichen, Kleinbuchstaben alphanumerisch, Muster: `^[a-z0-9]([-a-z0-9]*[a-z0-9])?$`
`metadata.namespace`	Alle Operationen	Namespace-Bezeichner
`spec.origin_servers`	Erstellen	Mindestens 1 Element
`spec.port`	Erstellen	1–65535, kein Server-Standard

Minimale Konfiguration

{
  "metadata": {
    "name": "my-origin-pool",
    "namespace": "default"
  },
  "spec": {
    "origin_servers": [
      {
        "public_name": {
          "dns_name": "backend.example.com"
        }
      }
    ],
    "port": 443
  }
}

Vom Server angewendete Standardwerte

Felder, die mit x-f5xc-server-default: true markiert sind, haben ihren default-Wert, der vom F5 XC API-Server angewendet wird, wenn sie in Anfragen weggelassen werden.

Felder der obersten Ebene

Feld	Standardwert	Typ	Beschreibung
`no_tls`	`{}`	object	TLS zum Ursprungsserver deaktiviert
`healthcheck`	`[]`	array	Keine Health-Checks konfiguriert
`loadbalancer_algorithm`	`ROUND_ROBIN`	enum	Round-Robin-Lastverteilung
`endpoint_selection`	`DISTRIBUTED`	enum	Alle Endpunkte verwenden (lokal + remote)

Standardwerte für advanced_options

Wenn advanced_options nicht angegeben wird, verhält sich der Server so, als ob diese Werte gesetzt wären:

Feld	Standardwert	Typ	Beschreibung
`connection_timeout`	`2000`	integer	Verbindungstimeout in Millisekunden
`http_idle_timeout`	`300000`	integer	HTTP-Leerlauf-Timeout in Millisekunden (5 Min.)
`same_as_endpoint_port`	`{}`	object	Health-Check verwendet Endpunkt-Port
`default_circuit_breaker`	`{}`	object	Standard-Circuit-Breaker-Einstellungen
`disable_outlier_detection`	`{}`	object	Ausreißererkennung deaktiviert
`no_panic_threshold`	`{}`	object	Kein Panic-Schwellenwert
`disable_subsets`	`{}`	object	Subset-Lastverteilung deaktiviert
`auto_http_config`	`{}`	object	Automatische HTTP-Protokollaushandlung
`disable_proxy_protocol`	`{}`	object	Proxy-Protokoll deaktiviert
`disable_lb_source_ip_persistance`	`{}`	object	LB-Quell-IP-Persistenz deaktiviert

Standardwerte für verschachtelte Objekte

Pfad	Standardwert	Beschreibung
`origin_servers[].labels`	`{}`	Leeres Labels-Objekt
`origin_servers[].public_name.refresh_interval`	`0`	System-Standard-DNS-Aktualisierung verwenden

Abweichungen zwischen Benutzeroberfläche und Server-Standardwerten

Die F5 XC-Weboberfläche wählt andere Werte vor als die API anwendet, wenn Felder weggelassen werden.

Feld	Benutzeroberfläche vorausgewählt	Server angewendet	Hinweis
`loadbalancer_algorithm`	`LB_OVERRIDE`	`ROUND_ROBIN`	Über die Benutzeroberfläche und über die API erstellte Ressourcen unterscheiden sich, wenn das Feld weggelassen wird

Enum-Werte

loadbalancer_algorithm

Wert	Beschreibung	Hinweise
`ROUND_ROBIN`	Jeder gesunde Endpunkt wird der Reihe nach im Round-Robin-Verfahren ausgewählt	Server-Standard
`LEAST_REQUEST`	Endpunkt mit den wenigsten aktiven Anfragen wird ausgewählt
`RING_HASH`	Konsistentes Hashing mittels Ring-Hash der Endpunktnamen
`RANDOM`	Zufällige Auswahl eines gesunden Endpunkts
`LB_OVERRIDE`	Hash-Richtlinie vom übergeordneten Load Balancer übernommen	Benutzeroberflächen-Standard

endpoint_selection

Wert	Beschreibung	Hinweise
`DISTRIBUTED`	Sowohl remote als auch lokale Endpunkte berücksichtigen	Server-Standard
`LOCAL_ONLY`	Nur lokale Endpunkte werden verwendet
`LOCAL_PREFERRED`	Lokale Endpunkte bevorzugen, bei Nichtverfügbarkeit auf remote zurückfallen

OneOf-Feldgruppen

Sich gegenseitig ausschließende Feldgruppen. Es kann nur EIN Feld aus jeder Gruppe angegeben werden:

Gruppe	Felder	Server-Standard
Port-Konfiguration	`port`, `automatic_port`, `lb_port`	`port` (explizit)
TLS zum Ursprungsserver	`no_tls`, `use_tls`	`no_tls`
Health-Check-Port	`same_as_endpoint_port`, `health_check_port`	`same_as_endpoint_port`
Circuit Breaker	`default_circuit_breaker`, `disable_circuit_breaker`, `circuit_breaker`	`default_circuit_breaker`
Ausreißererkennung	`disable_outlier_detection`, `outlier_detection`	`disable_outlier_detection`
Panic-Schwellenwert	`no_panic_threshold`, `panic_threshold`	`no_panic_threshold`
Subset-LB	`disable_subsets`, `enable_subsets`	`disable_subsets`
HTTP-Protokoll	`auto_http_config`, `http1_config`, `http2_options`	`auto_http_config`
Proxy-Protokoll	`disable_proxy_protocol`, `proxy_protocol_v1`, `proxy_protocol_v2`	`disable_proxy_protocol`
LB-Quell-IP	`disable_lb_source_ip_persistance`, `enable_lb_source_ip_persistance`	`disable_lb_source_ip_persistance`
Verbindungspool	`enable_conn_pool_reuse`, `disable_conn_pool_reuse`	`enable_conn_pool_reuse`

Feldbeschränkungen

Feld	Typ	Einschränkung
`spec.port`	integer	1–65535
`spec.advanced_options.connection_timeout`	integer	0–1.800.000 ms
`spec.advanced_options.http_idle_timeout`	integer	0–600.000 ms
`spec.advanced_options.panic_threshold`	integer	0–100 (Prozentsatz)
`metadata.name`	string	1–63 Zeichen, Muster: `^[a-z0-9]([-a-z0-9]*[a-z0-9])?$`

Konfigurationsoptionen der Benutzeroberfläche

Die F5 XC-Webkonsole bietet 15 Konfigurationsoptionen für Ursprungsserver-Pools:

#	Benutzeroberflächen-Label	API-Feldpfad	Typ	Server-Standard
1	Ursprungsserver-Port	`spec.[port\|automatic_port\|lb_port]`	OneOf	`port` (explizit)
2	Verbindungspool-Wiederverwendung	`spec.[enable_conn_pool_reuse\|disable_conn_pool_reuse]`	OneOf	`enable_conn_pool_reuse`
3	Health-Check-Port	`spec.advanced_options.[same_as_endpoint_port\|health_check_port]`	OneOf	`same_as_endpoint_port`
4	Load-Balancer-Algorithmus	`spec.loadbalancer_algorithm`	enum	`ROUND_ROBIN`
5	Endpunktauswahl	`spec.endpoint_selection`	enum	`DISTRIBUTED`
6	TLS zum Ursprungsserver	`spec.[no_tls\|use_tls]`	OneOf	`no_tls`
7	Verbindungstimeout	`spec.advanced_options.connection_timeout`	integer	2000 ms
8	HTTP-Leerlauf-Timeout	`spec.advanced_options.http_idle_timeout`	integer	300000 ms
9	Circuit Breaker	`spec.advanced_options.[default_circuit_breaker\|disable_circuit_breaker\|circuit_breaker]`	OneOf	`default_circuit_breaker`
10	Ausreißererkennung	`spec.advanced_options.[disable_outlier_detection\|outlier_detection]`	OneOf	`disable_outlier_detection`
11	Panic-Schwellenwert	`spec.advanced_options.[no_panic_threshold\|panic_threshold]`	OneOf	`no_panic_threshold`
12	Subset-Lastverteilung	`spec.advanced_options.[disable_subsets\|enable_subsets]`	OneOf	`disable_subsets`
13	HTTP-Protokoll	`spec.advanced_options.[auto_http_config\|http1_config\|http2_options]`	OneOf	`auto_http_config`
14	Proxy-Protokoll	`spec.advanced_options.[disable_proxy_protocol\|proxy_protocol_v1\|proxy_protocol_v2]`	OneOf	`disable_proxy_protocol`
15	LB-Quell-IP-Persistenz	`spec.advanced_options.[disable_lb_source_ip_persistance\|enable_lb_source_ip_persistance]`	OneOf	`disable_lb_source_ip_persistance`

Datenzugriff

OpenAPI-Spezifikationen

Datei	Inhalt
`docs/specifications/api/virtual.json`	`origin_poolCreateSpecType`, `origin_poolReplaceSpecType`, `origin_poolGetSpecType`
`docs/specifications/api/openapi.json`	Zusammengeführte Spezifikation mit allen Schemas

validation.json-Struktur

defaults.resources.origin_pool
├── server_applied      # Felder mit x-f5xc-server-default: true
├── recommended         # Felder mit x-f5xc-recommended-value
├── advanced_options    # Verschachtelte advanced_options-Standardwerte
├── oneof_choices       # OneOf-Standardauswahlen
└── ui_vs_server        # Abweichungen zwischen Benutzeroberfläche und Server

Ursprungsserver-Typen

Ursprungsserver können mit verschiedenen Typvarianten angegeben werden. Der Typ bestimmt, welche zusätzlichen Felder erforderlich sind.

Implementierte Typen

Typ	Beschreibung	Pflichtfelder	Status
`public_name`	Ursprungsserver mit öffentlichem DNS-Namen	`dns_name`	✅ Vollständig
`public_ip`	Ursprungsserver mit öffentlicher IP-Adresse	`ip` (IPv4)	✅ Vollständig

Beispiel: public_name

{
  "origin_servers": [
    {
      "public_name": {
        "dns_name": "backend.example.com"
      }
    }
  ]
}

Beispiel: public_ip

{
  "origin_servers": [
    {
      "public_ip": {
        "ip": "8.8.8.8"
      }
    }
  ]
}

TODO: Standortabhängige Ursprungsserver-Typen

Die folgenden Ursprungsserver-Typen erfordern die Entwicklung von Logik für „site”-Ressourcen, bevor sie implementiert werden können:

Typ	Beschreibung	Pflichtfelder	Status
`private_ip`	Ursprungsserver mit privater/öffentlicher IP und Standortinformationen	`ip`, `site_locator`, `network_choice`, `snat_pool`	🔲 Standortlogik ausstehend
`private_name`	Ursprungsserver mit DNS-Namen und Standortinformationen	`dns_name`, `site_locator`, `network_choice`, `snat_pool`	🔲 Standortlogik ausstehend
`k8s_service`	Kubernetes-Dienst mit Standortinformationen	`service_name`, `site_locator`, `network_choice`	🔲 Standortlogik ausstehend
`consul_service`	HashiCorp-Consul-Dienst mit Standortinformationen	`service_name`, `site_locator`, `network_choice`	🔲 Standortlogik ausstehend

Implementierungsanforderungen

Bevor diese Typen vollständig dokumentiert werden können:

Standortressourcen-Erkennung – site-Ressourcenschema und site_locator-Muster dokumentieren
network_choice-Enum – Eingeschränkte Werte von network_choice dokumentieren (site_local_inside, site_local_outside usw.)
SNAT-Pool-Optionen – SNAT-Pool-Konfigurationsmuster dokumentieren
Ressourcenübergreifende Referenzen – Definieren, wie origin_pool auf site-Ressourcen verweist

Nachverfolgung

Konfigurationsplatzhalter: config/discovered_defaults.yaml → origin_pool.origin_server_types.enums
Zugehöriger Sprint: Anreicherungen des site-Ressourcenschemas

Änderungsprotokoll

Version	Datum	Änderungen
2.1.2	2026-01-18	Abschnitt zu Ursprungsserver-Typen mit public_name/public_ip hinzugefügt; TODO-Markierungen für standortabhängige Typen
2.1.1	2026-01-18	Als reine API-Referenz neu geschrieben; nachgelagerte Code-Beispiele entfernt
2.1.0	2026-01-18	Auf einheitliche Standardwerte-Struktur in validation.json aktualisiert
2.0.33	2026-01-17	Erste Dokumentation der Ursprungsserver-Pool-Erweiterungen