Freigeben über

Application Gateway für Container API-Spezifikation für Kubernetes

  • Artikel

Packages

Paket v1 ist die Version v1 der API.

alb.networking.azure.io/v1

In diesem Dokument werden die einzelnen Ressourcentypen für alb.networking.azure.io/v1 definiert.

Ressourcentypen:

AffinityType (string Alias)

(Wird angezeigt auf:SessionAffinity)

AffinityType definiert den Affinitätstyp für den Dienst

Wert Beschreibung

"application-cookie"

AffinityTypeApplicationCookie ist ein Sitzungsaffinitätstyp für ein Anwendungscookie

"managed-cookie"

AffinityTypeManagedCookie ist ein Sitzungsaffinitätstyp für ein verwaltetes Cookie

AlbConditionReason (string Alias)

AlbConditionReason definiert die Gruppe von Gründen, die erklären, warum ein bestimmter Bedingungstyp auf der Ressource Application Gateway für Container ausgelöst wird.

Wert Beschreibung

"Accepted"

AlbReasonAccepted gibt an, dass die Ressource Application Gateway für Container vom Controller akzeptiert wird.

„Ready“

AlbReasonDeploymentReady zeigt den Bereitstellungsstatus der Ressource Application Gateway für Container an.

"InProgress"

AlbReasonInProgress gibt an, ob sich die Application Gateway für Container-Ressource gerade erstellt, aktualisiert oder gelöscht wird.

AlbConditionType (string Alias)

AlbConditionType ist eine Art von Bedingung, die der Ressource Application Gateway für Container zugeordnet ist. Dieser Typ sollte mit dem Feld "AlbStatus.Conditions" verwendet werden.

Wert Beschreibung

"Accepted"

AlbConditionTypeAccepted gibt an, ob die Ressource Application Gateway for Containers vom Controller akzeptiert wird.

„Bereitstellung“

AlbConditionTypeDeployment gibt den Bereitstellungsstatus der Ressource Application Gateway for Containers an.

AlbSpec

(Angezeigt auf:ApplicationLoadBalancer)

AlbSpec definiert die Spezifikationen für die Ressource Application Gateway for Containers.

Feld Beschreibung
associations
/string

Zuordnungen sind Subnetzressourcen-IDs, denen die Ressource Application Gateway for Containers zugeordnet wird.

AlbStatus

(Angezeigt auf:ApplicationLoadBalancer)

AlbStatus definiert den beobachteten Zustand der Ressource Application Gateway für Container.

Feld Beschreibung
conditions
[]Kubernetes meta/v1.Condition 		(Optional)

Bekannte Bedingungstypen sind:

  • “Akzeptiert”
  • “Bereit”

ApplicationLoadBalancer

ApplicationLoadBalancer ist das Schema für die Ressource Application Gateway für Container.

Feld Beschreibung
metadata
Kubernetes meta/v1.ObjectMeta 		(Optional)

Objektmetadaten’.

Informationen zu den Feldern des metadata Felds finden Sie in der Kubernetes-API-Dokumentation.
spec
AlbSpec

„Spec“ sind die Spezifikationen für die Ressource "Application Gateway for Containers".



associations
/string

Zuordnungen sind Subnetzressourcen-IDs, denen die Ressource Application Gateway for Containers zugeordnet wird.
status
AlbStatus

AlbStatus definiert den aktuellen Zustand der Ressource Application Gateway für Container.

BackendTLSPolicy

BackendTLSPolicy ist das Schema für die BackendTLSPolicys-API.

Feld Beschreibung
metadata
Kubernetes meta/v1.ObjectMeta 		(Optional)

Objektmetadaten’.

Informationen zu den Feldern des metadata Felds finden Sie in der Kubernetes-API-Dokumentation.
spec
BackendTLSPolicySpec

Spezifikation ist die Back-EndTLSPolicy-Spezifikation.



targetRef
CustomTargetRef

TargetRef identifiziert ein API-Objekt, auf das die Richtlinie angewendet werden soll.
override
BackendTLSPolicyConfig 		(Optional)

Überschreiben definiert die Richtlinienkonfiguration, die unter der zielbezogenen Ressource in der Hierarchie angefügte Richtlinienkonfiguration außer Kraft setzen soll.

Hinweis: Das Überschreiben wird derzeit nicht unterstützt und führt zu einem Validierungsfehler. Die Unterstützung für Außerkraftsetzung wird in einer zukünftigen Version hinzugefügt.
default
BackendTLSPolicyConfig 		(Optional)

Der Standardwert definiert die Standardrichtlinienkonfiguration für die Zielressource.
status
BackendTLSPolicyStatus

Status definiert den aktuellen Zustand der Back-EndTLSPolicy.

Back-EndTLSPolicyConditionReason (string Alias)

BackTLSPolicyConditionReason definiert die Gruppe von Gründen, die erklären, warum ein bestimmter BackendTLSPolicy-Bedingungstyp ausgelöst wird.

Wert Beschreibung

"Accepted"

Back-EndTLSPolicyReasonAccepted wird verwendet, um das Back-EndTLSPolicyConditionReason auf "Akzeptiert" festzulegen, wenn die angegebene Back-EndTLSPolicy ordnungsgemäß konfiguriert ist.

"InvalidBackendTLSPolicy"

BackTLSPolicyReasonInvalid ist der Grund, warum die Back-EndTLSPolicy nicht ’akzeptiert wird.

"InvalidCertificateRef"

BackendTLSPolicyReasonInvalidCertificateRef wird verwendet, wenn auf ein ungültiges Zertifikat verwiesen wird

"InvalidGroup"

Back-EndTLSPolicyReasonInvalidGroup wird verwendet, wenn die Gruppe ungültig ist.

"InvalidKind"

Back-EndTLSPolicyReasonInvalidKind wird verwendet, wenn die Art/Gruppe ungültig ist.

"InvalidName"

Back-EndTLSPolicyReasonInvalidName wird verwendet, wenn der Name ungültig ist.

"InvalidSecret"

Back-EndTLSPolicyReasonInvalidSecret wird verwendet, wenn der Geheimschlüssel ungültig ist.

"InvalidService"

Back-EndTLSPolicyReasonInvalidService wird verwendet, wenn der Dienst ungültig ist.

"NoTargetReference"

BackendTLSPolicyReasonNoTargetReference wird verwendet, wenn kein’ Zielverweis vorhanden ist

„OverrideNotSupported“

BackendTLSPolicyReasonOverrideNotSupported wird verwendet, wenn die Außerkraftsetzung nicht’ unterstützt wird

"RefNotPermitted"

Back-EndTLSPolicyReasonRefNotPermitted wird verwendet, wenn der Verweis nicht ’zulässig ist.

„SectionNamesNotPermitted“

BackendTLSPolicyReasonSectionNamesNotPermitted wird verwendet, wenn die Abschnittsnamen nicht’ zulässig sind

Back-EndTLSPolicyConditionType (string Alias)

Back-EndTLSPolicyConditionType ist ein Bedingungstyp, der einer Back-EndTLSPolicy zugeordnet ist. Dieser Typ muss mit dem Back-EndTLSPolicyStatus.Conditions-Feld verwendet werden.

Wert Beschreibung

"Accepted"

Back-EndTLSPolicyConditionAccepted wird verwendet, um den Back-EndTLSPolicyConditionType auf "Akzeptiert" festzulegen.

"ResolvedRefs"

Back-EndTLSPolicyConditionResolvedRefs wird verwendet, um das Back-EndTLSPolicyCondition auf ResolvedRefs festzulegen.

BackendTLSPolicyConfig

(Wird angezeigt unter:Back-EndTLSPolicySpec)

Back-EndTLSPolicyConfig definiert die Richtlinienspezifikation für die Back-End-TLS-Richtlinie.

Feld Beschreibung
CommonTLSPolicy
CommonTLSPolicy

(Elemente von CommonTLSPolicy sind in diesen Typ eingebettet.)

sni
string 		(Optional)

Sni ist der Servername, der für die TLS-Verbindung mit dem Back-End verwendet werden soll.
ports
[]BackendTLSPolicyPort

Ports gibt die Liste der Ports an, in denen die Richtlinie angewendet wird.
clientCertificateRef
Gateway API .SecretObjectReference 		(Optional)

ClientCertificateRef ist der Verweis auf das Clientzertifikat, das für die TLS-Verbindung mit dem Back-End verwendet werden soll.

BackendTLSPolicyPort

(Wird angezeigt unter:Back-EndTLSPolicyConfig)

Back-EndTLSPolicyPort definiert den Port, der für die TLS-Verbindung mit dem Back-End verwendet werden soll.

Feld Beschreibung
port
int

Port ist der Port, der für die TLS-Verbindung zum Back-End verwendet werden soll.

BackendTLSPolicySpec

(Wird angezeigt unter:Back-EndTLSPolicy)

BackendTLSPolicySpec definiert den gewünschten Zustand von BackendTLSPolicy.

Feld Beschreibung
targetRef
CustomTargetRef

TargetRef identifiziert ein API-Objekt, auf das die Richtlinie angewendet werden soll.
override
BackendTLSPolicyConfig 		(Optional)

Überschreiben definiert die Richtlinienkonfiguration, die unter der zielbezogenen Ressource in der Hierarchie angefügte Richtlinienkonfiguration außer Kraft setzen soll.

Hinweis: Das Überschreiben wird derzeit nicht unterstützt und führt zu einem Validierungsfehler. Die Unterstützung für Außerkraftsetzung wird in einer zukünftigen Version hinzugefügt.
default
BackendTLSPolicyConfig 		(Optional)

Der Standardwert definiert die Standardrichtlinienkonfiguration für die Zielressource.

BackendTLSPolicyStatus

(Wird angezeigt unter:Back-EndTLSPolicy)

BackTLSPolicyStatus definiert den beobachteten Zustand von Back-EndTLSPolicy.

Feld Beschreibung
conditions
[]Kubernetes meta/v1.Condition 		(Optional)

Bedingungen beschreiben die aktuellen Bedingungen der Back-EndTLSPolicy.

Implementierungen müssen es vorziehen, Back-EndTLSPolicy-Bedingungen mit den BackendTLSPolicyConditionType und BackendTLSPolicyConditionReason Konstanten auszudrücken, damit Operatoren und Tools in einem gemeinsamen Vokabular konvergent laufen können, um den Back-EndTLSPolicy-Zustand zu beschreiben.

Bekannte Bedingungstypen sind:

  • “Akzeptiert”

CommonTLSPolicy

(Wird angezeigt unter:Back-EndTLSPolicyConfig)

CommonTLSPolicy ist das Schema für die CommonTLSPolicy-API.

Feld Beschreibung
verify
CommonTLSPolicyVerify 		(Optional)

„Verify“ stellt die Optionen zum Überprüfen des Peer-Zertifikats bereit.

CommonTLSPolicyVerify

(Wird angezeigt unter:CommonTLSPolicy)

CommonTLSPolicyVerify definiert das Schema für die CommonTLSPolicyVerify-API.

Feld Beschreibung
caCertificateRef
Gateway API .SecretObjectReference

CaCertificateRef ist das Zertifizierungsstellenzertifikat, das zum Überprüfen des Peer-Zertifikats verwendet wird.
subjectAltName
string 		(Optional)

SubjectAltName ist der alternative Antragstellername, der zum Überprüfen des Peer-Zertifikats verwendet wird.

CustomTargetRef

(Wird angezeigt unter:BackendTLSPolicySpec, FrontendTLSPolicySpec, HealthCheckPolicySpec, RoutePolicySpec)

CustomTargetRef ist ein Verweis auf eine benutzerdefinierte Ressource, die nicht Teil der Kubernetes-Kern-API ist’.

Feld Beschreibung
NamespacedPolicyTargetReference
Gateway-API alpha2.NamespacedPolicyTargetReference

(Elemente von NamespacedPolicyTargetReference sind in diesen Typ eingebettet.)

sectionNames
/string 		(Optional)

SectionNames ist der Name des Abschnitts innerhalb der Zielressource. Wenn nicht angegeben, zielt dieses targetRef auf die gesamte Ressource ab. In den folgenden Ressourcen wird SectionNames wie folgt interpretiert:

  • Gateway: Listenername
  • Dienst: Portname

Wenn ein SectionNames angegeben ist, aber für das zielorientierte Objekt nicht vorhanden ist, kann die Richtlinie nicht angefügt werden, und die Richtlinienimplementierung wird eine Bedingung ResolvedRefs oder eine ähnliche Bedingung im Status der Richtlinie aufzeichnen.

FrontendTLSPolicy

FrontendTLSPolicy ist das Schema für die FrontendTLSPolicy-API

Feld Beschreibung
metadata
Kubernetes meta/v1.ObjectMeta 		(Optional)

Objektmetadaten’.

Informationen zu den Feldern des metadata Felds finden Sie in der Kubernetes-API-Dokumentation.
spec
FrontendTLSPolicySpec

Spezifikation ist die FrontendTLSPolicy-Spezifikation.



targetRef
CustomTargetRef

TargetRef identifiziert ein API-Objekt, auf das die Richtlinie angewendet werden soll.
default
FrontendTLSPolicyConfig 		(Optional)

Der Standardwert definiert die Standardrichtlinienkonfiguration für die Zielressource.
override
FrontendTLSPolicyConfig 		(Optional)

Überschreiben definiert die Richtlinienkonfiguration, die unter der zielbezogenen Ressource in der Hierarchie angefügte Richtlinienkonfiguration außer Kraft setzen soll.

Hinweis: Das Überschreiben wird derzeit nicht unterstützt und führt zu einem Validierungsfehler. Die Unterstützung für Außerkraftsetzung wird in einer zukünftigen Version hinzugefügt.
status
FrontendTLSPolicyStatus

Status definiert den aktuellen Status von FrontendTLSPolicy.

FrontendTLSPolicyConditionReason (string Alias)

FrontendTLSPolicyConditionReason definiert die Reihe von Gründen, die erläutern, warum ein bestimmter FrontendTLSPolicy-Bedingungstyp ausgelöst wird.

Wert Beschreibung

"Accepted"

FrontendTLSPolicyReasonAccepted wird verwendet, um das FrontendTLSPolicyConditionReason auf "Akzeptiert" festzulegen, wenn die angegebene FrontendTLSPolicy ordnungsgemäß konfiguriert ist.

"InvalidFrontendTLSPolicy"

FrontendTLSPolicyReasonInvalid ist der Grund, warum die FrontendTLSPolicy nicht’ akzeptiert wird.

"InvalidCertificateRef"

FrontendTLSPolicyReasonInvalidCertificateRef wird verwendet, wenn auf ein ungültiges Zertifikat verwiesen wird

„InvalidDefault“

FrontendTLSPolicyReasonInvalidDefault wird verwendet, wenn der Standardwert ungültig ist

"InvalidGateway"

FrontendTLSPolicyReasonInvalidGateway wird verwendet, wenn das Gateway ungültig ist.

"InvalidGroup"

FrontendTLSPolicyReasonInvalidGroup wird verwendet, wenn die Gruppe ungültig ist.

"InvalidKind"

FrontendTLSPolicyReasonInvalidKind wird verwendet, wenn die Art/Gruppe ungültig ist.

"InvalidName"

FrontendTLSPolicyReasonInvalidName wird verwendet, wenn der Name ungültig ist.

"InvalidPolicyName"

FrontendTLSPolicyReasonInvalidPolicyName wird verwendet, wenn der Richtlinienname ungültig ist.

"InvalidPolicyType"

FrontendTLSPolicyReasonInvalidPolicyType wird verwendet, wenn der Richtlinientyp ungültig ist.

„InvalidTargetReference“

FrontendTLSPolicyReasonInvalidTargetReference wird verwendet, wenn der Zielverweis ungültig ist

"NoTargetReference"

FrontendTLSPolicyReasonNoTargetReference wird verwendet, wenn kein’ Zielverweis vorhanden ist

„OverrideNotSupported“

FrontendTLSPolicyReasonOverrideNotSupported wird verwendet, wenn die Außerkraftsetzung nicht’ unterstützt wird

"RefNotPermitted"

FrontendTLSPolicyReasonRefNotPermitted wird verwendet, wenn die Referenz nicht ’zulässig ist.

„SectionNamesNotPermitted“

FrontendTLSPolicyReasonSectionNamesNotPermitted wird verwendet, wenn die Abschnittsnamen nicht’ zulässig sind

FrontendTLSPolicyConditionType (string Alias)

FrontendTLSPolicyConditionType ist ein Bedingungstyp, der einer FrontendTLSPolicy zugeordnet ist. Dieser Typ sollte mit dem Feld "FrontendTLSPolicyStatus.Conditions" verwendet werden.

Wert Beschreibung

"Accepted"

FrontendTLSPolicyConditionAccepted wird verwendet, um die FrontendTLSPolicyCondition auf Akzeptiert festzulegen.

"ResolvedRefs"

FrontendTLSPolicyConditionResolvedRefs wird verwendet, um die FrontendTLSPolicyCondition auf ResolvedRefs festzulegen.

FrontendTLSPolicyConfig

(Wird auf:FrontendTLSPolicySpecangezeigt)

FrontendTLSPolicyConfig definiert die Richtlinienspezifikation für die Frontend-TLS-Richtlinie.

Feld Beschreibung
verify
MTLSPolicyVerify 		(Optional)

„Verify“ stellt die Optionen zum Überprüfen des Peer-Zertifikats bereit.
policyType
PolicyType 		(Optional)

Typ ist der Typ der Richtlinie.

FrontendTLSPolicySpec

(Wird auf:FrontendTLSPolicyangezeigt)

FrontendTLSPolicySpec definiert den gewünschten Zustand von FrontendTLSPolicy.

Feld Beschreibung
targetRef
CustomTargetRef

TargetRef identifiziert ein API-Objekt, auf das die Richtlinie angewendet werden soll.
default
FrontendTLSPolicyConfig 		(Optional)

Der Standardwert definiert die Standardrichtlinienkonfiguration für die Zielressource.
override
FrontendTLSPolicyConfig 		(Optional)

Überschreiben definiert die Richtlinienkonfiguration, die unter der zielbezogenen Ressource in der Hierarchie angefügte Richtlinienkonfiguration außer Kraft setzen soll.

Hinweis: Das Überschreiben wird derzeit nicht unterstützt und führt zu einem Validierungsfehler. Die Unterstützung für Außerkraftsetzung wird in einer zukünftigen Version hinzugefügt.

FrontendTLSPolicyStatus

(Wird auf:FrontendTLSPolicyangezeigt)

FrontendTLSPolicyStatus definiert den beobachteten Zustand von FrontendTLSPolicy.

Feld Beschreibung
conditions
[]Kubernetes meta/v1.Condition 		(Optional)

Bedingungen beschreiben die aktuellen Bedingungen der FrontendTLSPolicy.

Implementierungen müssen es vorziehen, FrontEndTLSPolicy-Bedingungen mit den FrontendTLSPolicyConditionType und FrontendTLSPolicyConditionReason Konstanten auszudrücken, damit Operatoren und Tools in einem gemeinsamen Vokabular konvergent laufen können, um den Front-EndTLSPolicy-Zustand zu beschreiben.

Bekannte Bedingungstypen sind:

  • “Akzeptiert”

FrontendTLSPolicyType (string Alias)

(Wird auf:PolicyTypeangezeigt)

FrontendTLSPolicyType ist der Typ der Frontend-TLS-Richtlinie.

Wert Beschreibung

"predefined"

PredefinedFrontendTLSPolicyType ist der Typ der vordefinierten Frontend-TLS-Richtlinie.

FrontendTLSPolicyTypeName (string-Alias)

(Wird auf:PolicyTypeangezeigt)

FrontendTLSPolicyTypeName ist der Name der Frontend-TLS-Richtlinie.

Wert Beschreibung

„2023-06“

PredefinedPolicy202306 ist der Name der vordefinierten Frontend-TLS-Richtlinie für die Richtlinie “2023-06”.

„2023-06-S“

PredefinedPolicy202306Strict ist der Name der vordefinierten Frontend-TLS-Richtlinie für die Richtlinie “2023-06-S”. Dies ist eine strenge Version der Richtlinie “2023-06”.

GRPCSpecifiers

(Wird angezeigt unter:HealthCheckPolicyConfig)

GRPCSpecifiers definieren das Schema für GRPC HealthCheck.

Feld Beschreibung
authority
string 		(Optional)

Die autoritative Stelle, wenn vorhanden, wird als Wert des Headers der autoritativen Stelle in der Integritätsprüfung verwendet.
service
string 		(Optional)

Der Dienst ermöglicht die Konfiguration einer Integritätsprüfung, die unter einem anderen Dienstnamen registriert ist.

HTTPHeader

(Wird auf:HeaderFilterangezeigt)

HTTPHeader stellt einen HTTP-Headernamen und -Wert dar, wie durch RFC 7230 definiert.

Feld Beschreibung
name
HTTPHeaderName

Der Name ist der Name des HTTP-Headers, der abgeglichen werden soll. Im Namensabgleich DARF NICHT zwischen Groß- und Kleinbuchstaben unterschieden werden. (See https://tools.ietf.org/html/rfc7230#section-3.2).

Wenn mehrere Einträge gleichwertige Kopfzeilennamen angeben, MUSS der erste Eintrag mit einem gleichen Namen für eine Übereinstimmung berücksichtigt werden. Nachfolgende Einträge mit einem entsprechenden Headernamen MÜSSEN ignoriert werden. Da bei Headernamen zwischen Groß- und Kleinbuchstaben nicht unterschieden wird, gelten “foo” und “Foo” als gleich.
value
string

Der Wert ist der Wert des HTTP-Headers, der abgeglichen werden soll.

HTTPHeaderName (string Alias)

(Wird auf:HTTPHeaderangezeigt)

HTTPHeaderName ist der Name eines HTTP-Headers.

Gültige Werte:

  • “Autorisierung”
  • “Set-Cookie”

Ungültige Werte sind:

  • ”:method” - “:” ist ein ungültiges Zeichen. Dies bedeutet, dass HTTP/2-Pseudoheader derzeit nicht’ von diesem Typ unterstützt werden.
  • ”/invalid” - “/ ” ist ein ungültiges Zeichen

HTTPMatch

(Wird auf:HTTPSpecifiersangezeigt)

HTTPMatch definiert die HTTP-Übereinstimmungen, die für HealthCheck-Überprüfungen verwendet werden sollen.

Feld Beschreibung
body
string 		(Optional)

Body definiert die HTTP-Textkörperübereinstimmungen, die für HealthCheck-Überprüfungen verwendet werden sollen.
statusCodes
[]StatusCodes 		(Optional)

StatusCodes definiert die HTTP-Statuscodeübereinstimmungen, die für HealthCheck-Überprüfungen verwendet werden sollen.

HTTPPathModifier

(Wird angezeigt unter:Redirect, URLRewriteFilter)

HTTPPathModifier definiert die Konfiguration für Pfadmodifizierer.

Feld Beschreibung
type
HTTPPathModifierType

Der Typ definiert den Typ des Pfadmodifizierers. In einer zukünftigen Version der API können weitere Typen hinzugefügt werden.

Dieser Enumeration können Werte hinzugefügt werden, Implementierungen müssen sicherstellen, dass unbekannte Werte keinen’ Absturz verursachen.

Unbekannte Werte müssen hier dazu führen, dass die Implementierung die Akzeptierte Bedingung für die Regel auf "false" setzt.
replaceFullPath
string 		(Optional)

ReplaceFullPath gibt den Wert an, mit dem der vollständige Pfad einer Anforderung während einer Umschreibung oder Umleitung ersetzt werden soll.
replacePrefixMatch
string 		(Optional)

ReplacePrefixMatch gibt den Wert an, mit dem die Präfixübereinstimmung einer Anforderung während einer Umschreibung oder Umleitung ersetzt werden soll. Beispielsweise würde eine Anforderung an “/foo/bar” mit einer Präfixübereinstimmung von “/foo” und eine ReplacePrefixMatch von “/xyz” in “/xyz/bar” geändert.

Dieses Verhalten entspricht dem PathPrefix-Übereinstimmungstyps. Dies entspricht vollständigen Pfadelementen. Ein Pfadelement bezieht sich auf die Liste der Beschriftungen im Pfad, die durch das / Trennzeichen geteilt werden. Wenn angegeben, wird ein Trailing/ ignoriert. Beispielsweise würden die Pfade /abc, /abc/ und /abc/def alle dem Präfix /abc entsprechen, aber der Pfad /abcd nicht’.

ReplacePrefixMatch ist nur mit einem PathPrefix HTTPRouteMatch kompatibel. Die Verwendung eines anderen HTTPRouteMatch-Typs auf demselben HTTPRouteRule führt dazu, dass die Implementierung die Akzeptierte Bedingung für die Route auf status: False setzt.

Anforderungspfad Präfixabgleich Präfix ersetzen Geänderter Pfad
/foo/bar /foo /xyz /xyz/bar
/foo/bar /foo /xyz/ /xyz/bar
/foo/bar /foo/ /xyz /xyz/bar
/foo/bar /foo/ /xyz/ /xyz/bar
/foo /foo /xyz /xyz
/foo/ /foo /xyz /xyz/
/foo/bar /foo /bar
/foo/ /foo /
/foo /foo /
/foo/ /foo / /
/foo /foo / /

HTTPPathModifierType (string Alias)

(Wird auf:HTTPPathModifierangezeigt)

HTTPPathModifierType definiert den Typ der Pfadumleitung oder -überschreibung.

Wert Beschreibung

"ReplaceFullPath"

FullPathHTTPPathModifier ersetzt den vollständigen Pfad durch den angegebenen Wert.

"ReplacePrefixMatch"

PrefixMatchHTTPPathModifier ersetzt jeden Präfixpfad durch den Ersetzungswert. Ein Pfad mit einer Präfixübereinstimmung von “/foo” und eine ReplacePrefixMatch-Ersetzung von “/bar” ersetzt “/foo” durch “/bar” in passenden Anforderungen.

Dieses Verhalten entspricht dem PathPrefix-Übereinstimmungstyps. Dies entspricht vollständigen Pfadelementen. Ein Pfadelement bezieht sich auf die Liste der Beschriftungen im Pfad, die durch das / Trennzeichen geteilt werden. Wenn angegeben, wird ein Trailing/ ignoriert. Beispielsweise würden die Pfade /abc, /abc/ und /abc/def alle dem Präfix /abc entsprechen, aber der Pfad /abcd nicht’.

HTTPSpecifier

(Wird angezeigt unter:HealthCheckPolicyConfig)

HTTPSpecifiers definiert das Schema für die HTTP HealthCheck-Prüfspezifikation.

Feld Beschreibung
host
string 		(Optional)

Host ist der Hostheaderwert, der für Integritätsprüfungsprüfungen verwendet werden soll.
path
string 		(Optional)

Der Pfad ist der Pfad, der für HealthCheck-Überprüfungen verwendet werden soll.
match
HTTPMatch 		(Optional)

Match definiert die HTTP-Übereinstimmungen, die für HealthCheck-Überprüfungen verwendet werden sollen.

HeaderFilter

(Wird auf:IngressRewritesangezeigt)

HeaderFilter definiert einen Filter, der die Header einer HTTP-Anforderung oder -Antwort ändert. Für einen gegebenen Headernamen ist nur eine Aktion zulässig. Filter, die mehrere Aktionen desselben oder eines anderen Typs für einen beliebigen Headernamen angeben, sind ungültig und werden zurückgewiesen. Die Konfiguration zum Festlegen oder Hinzufügen mehrerer Werte für einen Header braucht eine RFC 7230-Headerwertformatierung, wo jeder Wert durch ein Komma getrennt wird.

Feld Beschreibung
set
[]HTTPHeader 		(Optional)

„Set“ überschreibt die Anforderung mit dem gegebenen Header (Name, Wert) im Vorfeld der Aktion.

Eingabe: GET /foo HTTP/1.1 my-header: foo

Config: set: - Name: “my-header” Wert: “bar”

Ausgabe: GET /foo HTTP/1.1 my-header: bar
add
[]HTTPHeader 		(Optional)

„Add“ fügt der Anforderung vor der Aktion die angegebenen Headers (Name, Wert) hinzu. Somit wird es allen vorhandenen Werten angefügt, die dem Headernamen zugeordnet sind.

Eingabe: GET /foo HTTP/1.1 my-header: foo

Config: add: - Name: “my-header” Wert: “bar,baz”

Ausgabe: GET /foo HTTP/1.1 my-header: foo,bar,baz
remove
/string 		(Optional)

Vor der Aktion entfernen Sie die angegebenen Header aus der HTTP-Anforderung. Der Wert von Remove ist eine Liste von HTTP-Headernamen. Die Groß-/Kleinschreibung wird bei Headernamen nicht beachtet (siehe https://datatracker.ietf.org/doc/html/rfc2616#section-4.2).

Eingabe: GET /foo HTTP/1.1 my-header1: foo my-header2: bar my-header3: baz

Config: Entfernen: [“my-header1”, “my-header3”]

Ausgabe: GET /foo HTTP/1.1 my-header2: bar

HeaderName (string Alias)

HeaderName ist der Name eines Header- oder Abfrageparameters.

HealthCheckPolicy

HealthCheckPolicy ist das Schema für die HealthCheckPolicy-API.

Feld Beschreibung
metadata
Kubernetes meta/v1.ObjectMeta 		(Optional)

Objektmetadaten’.

Informationen zu den Feldern des metadata Felds finden Sie in der Kubernetes-API-Dokumentation.
spec
HealthCheckPolicySpec

Spezifikation ist die HealthCheckPolicy-Spezifikation.



targetRef
CustomTargetRef

TargetRef identifiziert ein API-Objekt, auf das die Richtlinie angewendet werden soll.
override
HealthCheckPolicyConfig 		(Optional)

Überschreiben definiert die Richtlinienkonfiguration, die unter der zielbezogenen Ressource in der Hierarchie angefügte Richtlinienkonfiguration außer Kraft setzen soll.

Hinweis: Die Außerkraftsetzung wird derzeit nicht unterstützt und führt zu einem Überprüfungsfehler. Die Unterstützung für Außerkraftsetzung wird in einer zukünftigen Version hinzugefügt.
default
HealthCheckPolicyConfig 		(Optional)

Der Standardwert definiert die Standardrichtlinienkonfiguration für die Zielressource.
status
HealthCheckPolicyStatus

Status definiert den aktuellen Status der HealthCheckPolicy.

HealthCheckPolicyConditionReason (string Alias)

HealthCheckPolicyConditionReason definiert die Gruppe von Gründen, die erläutern, warum ein bestimmter HealthCheckPolicy-Bedingungstyp ausgelöst wird.

Wert Beschreibung

„BackendTLSPolicyNotFound“

BackendTLSPolicyConditionNotFound wird verwendet, wenn die BackendTLSPolicy für den Dienst nicht gefunden wird.

"Accepted"

HealthCheckPolicyReasonAccepted wird verwendet, um HealthCheckPolicyConditionReason auf „Akzeptiert“ festzulegen. Wenn die gegebene HealthCheckPolicy ordnungsgemäß konfiguriert ist.

"InvalidHealthCheckPolicy"

HealthCheckPolicyReasonInvalid ist der Grund, wenn die HealthCheckPolicy nicht akzeptiert wird.

"InvalidGroup"

HealthCheckPolicyReasonInvalidGroup wird verwendet, wenn die Gruppe ungültig ist.

"InvalidKind"

HealthCheckPolicyReasonInvalidKind wird verwendet, wenn die Art/Gruppe ungültig ist.

"InvalidName"

HealthCheckPolicyReasonInvalidName wird verwendet, wenn der Name ungültig ist.

"InvalidPort"

HealthCheckPolicyReasonInvalidPort wird verwendet, wenn der Port ungültig ist.

"InvalidService"

HealthCheckPolicyReasonInvalidService wird verwendet, wenn der Dienst ungültig ist.

"NoTargetReference"

HealthCheckPolicyReasonNoTargetReference wird verwendet, wenn kein Zielverweis vorhanden ist.

„OverrideNotSupported“

HealthCheckPolicyReasonOverrideNotSupported wird verwendet, wenn das Überschreiben nicht unterstützt wird.

"RefNotPermitted"

HealthCheckPolicyReasonRefNotPermitted wird verwendet, wenn der Verweis nicht zulässig ist.

„SectionNamesNotPermitted“

HealthCheckPolicyReasonSectionNamesNotPermitted wird verwendet, wenn die Abschnittsnamen nicht zulässig sind.

HealthCheckPolicyConditionType (string Alias)

HealthCheckPolicyConditionType ist ein Zustandstyp, der einer HealthCheckPolicy zugeordnet ist. Dieser Typ muss mit dem Feld HealthCheckPolicyStatus.Conditions verwendet werden.

Wert Beschreibung

"Accepted"

HealthCheckPolicyConditionAccepted wird verwendet, um HealthCheckPolicyConditionType auf „Akzeptiert“ festzulegen.

"ResolvedRefs"

HealthCheckPolicyConditionResolvedRefs wird verwendet, um HealthCheckPolicyCondition auf „ResolvedRefs“ festzulegen.

HealthCheckPolicyConfig

(Wird angezeigt unter:HealthCheckPolicySpec)

HealthCheckPolicyConfig definiert das Schema für die HealthCheck-Prüfspezifikation.

Feld Beschreibung
interval
Kubernetes meta/v1.Duration 		(Optional)

Intervall ist die Anzahl von Sekunden zwischen HealthCheck-Prüfungen.
timeout
Kubernetes meta/v1.Duration 		(Optional)

Timeout ist die Anzahl von Sekunden, nach denen die Healthcheck-Prüfung fehlgeschlagen betrachtet wird.
port
int32 		(Optional)

Port ist der Port, der für HealthCheck-Überprüfungen verwendet werden soll.
unhealthyThreshold
int32 		(Optional)

UnhealthyThreshold ist die Anzahl der aufeinanderfolgenden fehlgeschlagenen HealthCheck-Überprüfungen.
healthyThreshold
int32 		(Optional)

HealthyThreshold ist die Anzahl der aufeinanderfolgenden erfolgreichen HealthCheck-Überprüfungen.
useTLS
bool 		(Optional)

UseTLS gibt an, ob die Integritätsprüfung TLS erzwingen soll. Standardmäßig verwendet die Integritätsprüfung dasselbe Protokoll wie der Dienst, wenn derselbe Port für die Integritätsprüfung verwendet wird. Wenn der Port unterschiedlich ist, wird die Integritätsprüfung Klartext sein.
http
HTTPSpecifier 		(Optional)

HTTP definiert die HTTP-Einschränkungsspezifikation für die HealthCheck einer Zielressource.
grpc
GRPCSpecifiers

GRPC konfiguriert ein gRPC v1 HealthCheck (https://github.com/grpc/grpc-proto/blob/master/grpc/health/v1/health.proto) gegen die Zielressource.

HealthCheckPolicySpec

(Wird angezeigt unter:HealthCheckPolicy)

HealthCheckPolicySpec definiert den gewünschten Status von HealthCheckPolicy.

Feld Beschreibung
targetRef
CustomTargetRef

TargetRef identifiziert ein API-Objekt, auf das die Richtlinie angewendet werden soll.
override
HealthCheckPolicyConfig 		(Optional)

Überschreiben definiert die Richtlinienkonfiguration, die unter der zielbezogenen Ressource in der Hierarchie angefügte Richtlinienkonfiguration außer Kraft setzen soll.

Hinweis: Die Außerkraftsetzung wird derzeit nicht unterstützt und führt zu einem Überprüfungsfehler. Die Unterstützung für Außerkraftsetzung wird in einer zukünftigen Version hinzugefügt.
default
HealthCheckPolicyConfig 		(Optional)

Der Standardwert definiert die Standardrichtlinienkonfiguration für die Zielressource.

HealthCheckPolicyStatus

(Wird angezeigt unter:HealthCheckPolicy)

HealthCheckPolicyStatus definiert den beobachteten Zustand von HealthCheckPolicy.

Feld Beschreibung
conditions
[]Kubernetes meta/v1.Condition 		(Optional)

Bedingungen beschreiben die aktuellen Bedingungen der HealthCheckPolicy.

Implementierungen müssen es vorziehen, HealthCheckPolicy-Bedingungen mit den HealthCheckPolicyConditionType und HealthCheckPolicyConditionReason Konstanten auszudrücken, damit Operatoren und Tools in einem gemeinsamen Vokabular konvergent laufen können, um den HealthCheckPolicy-Zustand zu beschreiben.

Bekannte Bedingungstypen sind:

  • “Akzeptiert”

IngressBackendPort

(Wird auf:IngressBackendSettingsangezeigt)

IngressBackendPort beschreibt einen Port in einem Back-End. Nur einer von Name/Zahl ist zu definieren.

Feld Beschreibung
port
int32 		(Optional)

Port gibt den Port für den Back-End-Dienst an.
name
string 		(Optional)

Name muss auf einen Namen für einen Port im Back-End-Dienst verweisen.
protocol
Protokoll

Das Protokoll sollte eins von “HTTP”, “HTTPS” sein

IngressBackendSettingStatus

(Wird auf:IngressExtensionStatusangezeigt)

IngressBackendSettingStatus beschreibt den Zustand eines Back-EndSettings

Feld Beschreibung
service
string

Der Dienst identifiziert das Back-EndSetting, das dieser Status beschreibt.
validationErrors
/string 		(Optional)

Fehler sind eine Liste der Fehler, die sich auf diese Einstellung beziehen
valid
bool

„Gültig“ heißt, dass in diesem Back-EndSetting keine Überprüfungsfehler vorhanden sind.

IngressBackendSettings

(Wird auf:IngressExtensionSpecangezeigt)

IngressBackendSettings bietet erweiterte Konfigurationsoptionen für einen Back-End-Dienst.

Feld Beschreibung
service
string

„Service“ ist der Name eines Back-End-Diensts, für den diese Konfiguration gilt
ports
[]IngressBackendPort 		(Optional)

Ports können verwendet werden, um anzugeben, ob der Back-End-Dienst auf HTTP oder HTTPS wartet.
trustedRootCertificate
string 		(Optional)

TrustedRootCertificate kann verwendet werden, um ein Zertifikat für das Gateway bereitzustellen, dem beim Kommunizieren mit dem Back-End auf einem als https angegebenen Port vertraut wird.
sessionAffinity
SessionAffinity 		(Optional)

SessionAffinity ermöglicht es, Clientanforderungen konsistent an dasselbe Back-End zu übergeben.
timeouts
IngressTimeouts 		(Optional)

Timeouts definieren eine Reihe von Timeoutparametern, die auf „Ingress“ (eingehende Daten) angewendet werden sollen

IngressExtension

IngressExtension ist das Schema für die IngressExtension-API

Feld Beschreibung
metadata
Kubernetes meta/v1.ObjectMeta 		(Optional)

Objektmetadaten’.

Informationen zu den Feldern des metadata Felds finden Sie in der Kubernetes-API-Dokumentation.
spec
IngressExtensionSpec

Spec ist die IngressExtension-Spezifikation.



rules
[]IngressRuleSetting 		(Optional)

Regeln definieren die Regeln pro Host
backendSettings
[]IngressBackendSettings 		(Optional)

Back-EndSettings definiert eine Reihe von Konfigurationsoptionen für Ingress-Dienst-Back-Ends
status
IngressExtensionStatus

IngressExtensionConditionReason (string Alias)

IngressExtensionConditionReason definiert die Reihe von Gründen, die erläutern, warum ein bestimmter IngressExtension-Bedingungstyp ausgelöst wird.

Wert Beschreibung

"Accepted"

IngressExtensionReasonAccepted wird verwendet, um "IngressExtensionConditionAccepted" auf "Akzeptiert" festzulegen.

"HasValidationErrors"

IngressExtensionReasonHasErrors gibt an, dass es einige Überprüfungsfehler gibt.

"NoValidationErrors"

IngressExtensionReasonNoErrors gibt an, dass keine Überprüfungsfehler aufgetreten sind.

"PartiallyAcceptedWithErrors"

IngressExtensionReasonPartiallyAccepted wird verwendet, um den IngressExtensionConditionAccepted auf Accepted festzulegen, jedoch mit nicht schwerwiegenden Überprüfungsfehlern

IngressExtensionConditionType (string Alias)

IngressExtensionConditionType ist ein Zustandstyp, der einer IngressExtension zugeordnet ist. Dieser Typ sollte mit dem Feld "IngressExtensionStatus.Conditions" verwendet werden.

Wert Beschreibung

"Accepted"

IngressExtensionConditionAccepted gibt an, ob die IngressExtension vom Controller akzeptiert (abgeglichen) wird

„Fehler“

IngressExtensionConditionErrors gibt an, ob Überprüfungs- oder Buildfehler in der Erweiterung vorhanden sind.

IngressExtensionSpec

(Wird auf:IngressExtensionangezeigt)

IngressExtensionSpec definiert die gewünschte Konfiguration von IngressExtension

Feld Beschreibung
rules
[]IngressRuleSetting 		(Optional)

Regeln definieren die Regeln pro Host
backendSettings
[]IngressBackendSettings 		(Optional)

Back-EndSettings definiert eine Reihe von Konfigurationsoptionen für Ingress-Dienst-Back-Ends

IngressExtensionStatus

(Wird auf:IngressExtensionangezeigt)

IngressExtensionStatus beschreibt den aktuellen Zustand der IngressExtension

Feld Beschreibung
rules
[]IngressRuleStatus 		(Optional)

Regeln enthalten detaillierte Statusinformationen zu den einzelnen Regeln
backendSettings
[]IngressBackendSettingStatus 		(Optional)

Back-EndSettings enthält detaillierte Statusinformationen zu den einzelnen Back-EndSettings
conditions
[]Kubernetes meta/v1.Condition 		(Optional)

Bedingungen beschreiben die aktuellen Bedingungen der IngressExtension. Bekannte Bedingungstypen sind:

  • “Akzeptiert”
  • “Fehler”

IngressRewrites

(Wird auf:IngressRuleSettingangezeigt)

IngressRewrites stellt die verschiedenen in einer Regel unterstützten Überschreibungen bereit.

Feld Beschreibung
type
RewriteType

Type definiert den Typ der Überschreibung
requestHeaderModifier
HeaderFilter 		(Optional)

RequestHeaderModifier definiert ein Schema, das die Anforderungsheader ändert.
responseHeaderModifier
HeaderFilter 		(Optional)

RequestHeaderModifier definiert ein Schema, das die Antwortheader ändert.
urlRewrite
URLRewriteFilter 		(Optional)

URLRewrite definiert ein Schema, das eine Anforderung während der Weiterleitung ändert.

IngressRuleSetting

(Wird auf:IngressExtensionSpecangezeigt)

IngressRuleSetting stellt Konfigurationsoptionen für Regeln bereit.

Feld Beschreibung
host
string

Host wird verwendet, um die Eingangsregeln mit demselben Hostnamen abzugleichen, um zu ermitteln, welche Regeln diese Einstellungen betrifft.
additionalHostnames
/string 		(Optional)

AdditionalHostnames gibt zusätzliche Hostnamen an, auf die gewartet werden soll
rewrites
[]IngressRewrites 		(Optional)

Rewrites definiert die Neuschreibungen für die Regel.
requestRedirect
Redirect 		(Optional)

RequestRedirect definiert das Umleitungsverhalten für die Regel.

IngressRuleStatus

(Wird auf:IngressExtensionStatusangezeigt)

IngressRuleStatus beschreibt den Status einer Regel.

Feld Beschreibung
host
string

Host identifiziert die Regel, die dieser Status beschreibt.
validationErrors
/string 		(Optional)

Fehler sind eine Liste der Fehler, die sich auf diese Einstellung beziehen
valid
bool 		(Optional)

„Gültig“ heißt, dass in dieser Regel keine Überprüfungsfehler vorhanden sind.

IngressTimeouts

(Wird auf:IngressBackendSettingsangezeigt)

IngressTimeouts können zum Konfigurieren von Timeouteigenschaften für einen Ingress verwendet werden.

Feld Beschreibung
requestTimeout
Kubernetes meta/v1.Duration 		(Optional)

RequestTimeout definiert das timeout, das vom Lastenausgleichsmodul beim Weiterleiten von Anforderungen an einen Back-End-Dienst verwendet wird.

MTLSPolicyVerify

(Wird angezeigt unter:FrontendTLSPolicyConfig)

MTLSPolicyVerify definiert das Schema für die MTLSPolicyVerify-API.

Feld Beschreibung
caCertificateRef
Gateway API .SecretObjectReference

CaCertificateRef ist das Zertifizierungsstellenzertifikat, das zum Überprüfen des Peer-Zertifikats verwendet wird.
subjectAltNames
/string 		(Optional)

SubjectAltNames ist die Liste der alternativen Antragstellernamen, die zum Überprüfen des Peer-Zertifikats verwendet werden.

PolicyType

(Wird angezeigt unter:FrontendTLSPolicyConfig)

PolicyType ist der Typ der Richtlinie.

Feld Beschreibung
name
FrontendTLSPolicyTypeName

Name ist der Name der Richtlinie
type
FrontendTLSPolicyType

PredefinedFrontendTLSPolicyType ist der Typ der vordefinierten Frontend-TLS-Richtlinie.

PortNumber (int32 Alias)

(Wird angezeigt am:Redirect)

PortNumber definiert einen Netzwerkport.

PreciseHostname (string Alias)

(Wird angezeigt unter:Redirect, URLRewriteFilter)

PreciseHostname ist der vollqualifizierte Domänenname eines Netzwerkhosts. Dies entspricht der RFC 1123-Definition eines Hostnamens, mit einer wichtigen Ausnahme, dass numerische IP-Adressen nicht’ zulässig sind.

Gemäß RFC1035 und RFC1123 muss eine Beschriftung aus alphanumerischen Zeichen in Kleinbuchstaben oder ‘-’ bestehen und mit einem alphanumerischen Zeichen beginnen und enden. Es ist keine andere Interpunktion zulässig.

Protokoll (string Alias)

(Wird auf IngressBackendPortangezeigt)

Protokoll heißt das protokoll, das für bestimmte Eigenschaften verwendet wird. Gültige Protokollwerte sind:

  • HTTP
  • HTTPS
  • TCP
Wert Beschreibung

„HTTP“

ProtocolHTTP impliziert, dass der Dienst HTTP verwendet.

„HTTPS“

ProtocolHTTPS impliziert, dass der Dienst HTTPS verwendet.

"TCP"

ProtocolTCP impliziert, dass der Dienst einfaches TCP verwendet.

Umleiten

(Wird auf:IngressRuleSettingangezeigt)

Umleiten definiert einen Filter, der eine Anforderung umleitet. Dies DARF NICHT für die gleiche Regel verwendet werden, die auch einen URLRewriteFilter aufweist.

Feld Beschreibung
scheme
string 		(Optional)

Schema ist das Schema, das im Wert des Location Headers in der Antwort verwendet werden soll. Wenn es leer ist, wird das Schema der Anforderung verwendet.
hostname
PreciseHostname 		(Optional)

Hostname ist der Hostname, der im Wert des Location Headers in der Antwort verwendet werden soll. Wenn er leer ist, wird der Hostname im Host Header der Anforderung verwendet.
path
HTTPPathModifier 		(Optional)

Path definiert Parameter, die zum Ändern des Pfads der eingehenden Anforderung verwendet werden. Der geänderte Pfad wird dann zum Erstellen des Location Headers verwendet. Wenn er leer ist, wird der Anforderungspfad unverändert verwendet.
port
PortNumber 		(Optional)

Port ist der Port, der im Wert des Location Headers in der Antwort verwendet werden soll.

Wenn kein Port angegeben ist, MUSS der Umleitungsport mithilfe folgender Regeln abgeleitet werden:

  • Wenn das Umleitungsschema nicht leer ist, muss der Umleitungsport der bekannte Port sein, der dem Umleitungsschema zugeordnet ist. Insbesondere “http” zu Port 80 und “https” zu Port 443. Wenn das Umleitungsschema keinen’ bekannten Port hat, SOLLTE der Listenerport des Gateways verwendet werden.
  • Wenn das Umleitungsschema leer ist, MUSS der Umleitungsport der Gatewaylistener-Port sein.

In folgenden Fällen SOLLEN die Implementierungen die Portnummer im ‘Location-Header’ in folgenden Fällen NICHT hinzufügen:

  • Ein Location-Header, der HTTP (unabhängig davon, ob dies über das Listener-Protokoll oder das Schemafeld bestimmt wird) und Port 80 verwendet.
  • Ein Location Header, der HTTPS (unabhängig davon, ob dies über das Listener-Protokoll oder das Schemafeld bestimmt wird) und Port 443 verwendet.
statusCode
int 		(Optional)

StatusCode ist der HTTP-Statuscode, der als Antwort verwendet werden soll.

Beachten Sie, dass dieser Enumeration möglicherweise noch Werte hinzugefügt werden. Implementierungen müssen sicherstellen, dass unbekannte Werte keinen’ Absturz verursachen.

RewriteType (string Alias)

(Angezeigt auf:IngressRewrites)

RewriteType identifiziert den Umschreibtyp

Wert Beschreibung

"RequestHeaderModifier"

RequestHeaderModifier kann verwendet werden, um einen HTTP-Header aus einer HTTP-Anforderung hinzuzufügen oder zu entfernen, bevor er an das Upstreamziel gesendet wird’.

"ResponseHeaderModifier"

ResponseHeaderModifier kann verwendet werden, um einen HTTP-Header aus einer HTTP-Antwort hinzuzufügen oder zu entfernen, bevor er an den Client gesendet wird’.

"URLRewrite"

URLRewrite kann zum Ändern einer Anforderung während der Weiterleitung verwendet werden.

RoutePolicy

RoutePolicy ist das Schema für die RoutePolicy-API.

Feld Beschreibung
metadata
Kubernetes meta/v1.ObjectMeta 		(Optional)

Objektmetadaten’.

Informationen zu den Feldern des metadata Felds finden Sie in der Kubernetes-API-Dokumentation.
spec
RoutePolicySpec

Spec ist die RoutePolicy-Spezifikation.



targetRef
CustomTargetRef

TargetRef identifiziert ein API-Objekt, auf das die Richtlinie angewendet werden soll.
override
RoutePolicyConfig 		(Optional)

Überschreiben definiert die Richtlinienkonfiguration, die unter der zielbezogenen Ressource in der Hierarchie angefügte Richtlinienkonfiguration außer Kraft setzen soll.

Hinweis: Das Überschreiben wird derzeit nicht unterstützt und führt zu einem Validierungsfehler. Die Unterstützung für Außerkraftsetzung wird in einer zukünftigen Version hinzugefügt.
default
RoutePolicyConfig 		(Optional)

Der Standardwert definiert die Standardrichtlinienkonfiguration für die Zielressource.
status
RoutePolicyStatus

Status definiert den aktuellen Status von RoutePolicy.

RoutePolicyConditionReason (string Alias)

RoutePolicyConditionReason definiert die Gruppe von Gründen, die erläutern, warum ein bestimmter RoutePolicy-Bedingungstyp ausgelöst wird.

Wert Beschreibung

"Accepted"

RoutePolicyReasonAccepted wird verwendet, um "RoutePolicyConditionReason" auf "Akzeptiert" festzulegen, wenn die angegebene RoutePolicy ordnungsgemäß konfiguriert ist.

"InvalidRoutePolicy"

RoutePolicyReasonInvalid ist der Grund, warum die RoutePolicy nicht ’akzeptiert wird.

„InvalidGRPCRoute“

RoutePolicyReasonInvalidGRPCRoute wird verwendet, wenn die GRPCRoute ungültig ist

"InvalidGroup"

RoutePolicyReasonInvalidGroup wird verwendet, wenn die Gruppe ungültig ist.

"InvalidHTTPRoute"

RoutePolicyReasonInvalidHTTPRoute wird verwendet, wenn die HTTPRoute ungültig ist.

"InvalidKind"

RoutePolicyReasonInvalidKind wird verwendet, wenn die Art/Gruppe ungültig ist.

"InvalidName"

RoutePolicyReasonInvalidName wird verwendet, wenn der Name ungültig ist.

"NoTargetReference"

RoutePolicyReasonNoTargetReference wird verwendet, wenn kein’ Zielverweis vorhanden ist

„OverrideNotSupported“

RoutePolicyReasonOverrideNotSupported wird verwendet, wenn die Außerkraftsetzung nicht’ unterstützt wird

"RefNotPermitted"

RoutePolicyReasonRefNotPermitted wird verwendet, wenn der Verweis nicht zulässig ist’.

„SectionNamesNotPermitted“

RoutePolicyReasonSectionNamesNotPermitted wird verwendet, wenn die Abschnittsnamen nicht’ zulässig sind

RoutePolicyConditionType (string Alias)

RoutePolicyConditionType ist ein Zustandstyp, der einer RoutePolicy zugeordnet ist. Dieser Typ sollte mit dem Feld "RoutePolicyStatus.Conditions" verwendet werden.

Wert Beschreibung

"Accepted"

RoutePolicyConditionAccepted wird verwendet, um "RoutePolicyConditionType" auf "Akzeptiert" zu setzen.

"ResolvedRefs"

RoutePolicyConditionResolvedRefs wird verwendet, um "RoutePolicyCondition" auf "ResolvedRefs" zu setzen.

RoutePolicyConfig

(Angezeigt auf:RoutePolicySpec)

RoutePolicyConfig definiert das Schema für die RoutePolicy-Spezifikation. Dies ermöglicht die Spezifikation folgender Attribute: * Timeouts * Session Affinity

Feld Beschreibung
timeouts
RouteTimeouts 		(Optional)

Benutzerdefinierte Timeouts: Timeouts für die Zielressource.
sessionAffinity
SessionAffinity

SessionAffinity definiert das Schema für die Sitzungsaffinitätsspezifikation.

RoutePolicySpec

(Angezeigt auf:RoutePolicy)

RoutePolicySpec definiert den gewünschten Zustand von RoutePolicy.

Feld Beschreibung
targetRef
CustomTargetRef

TargetRef identifiziert ein API-Objekt, auf das die Richtlinie angewendet werden soll.
override
RoutePolicyConfig 		(Optional)

Überschreiben definiert die Richtlinienkonfiguration, die unter der zielbezogenen Ressource in der Hierarchie angefügte Richtlinienkonfiguration außer Kraft setzen soll.

Hinweis: Das Überschreiben wird derzeit nicht unterstützt und führt zu einem Validierungsfehler. Die Unterstützung für Außerkraftsetzung wird in einer zukünftigen Version hinzugefügt.
default
RoutePolicyConfig 		(Optional)

Der Standardwert definiert die Standardrichtlinienkonfiguration für die Zielressource.

RoutePolicyStatus

(Angezeigt auf:RoutePolicy)

RoutePolicyStatus definiert den beobachteten Zustand von RoutePolicy.

Feld Beschreibung
conditions
[]Kubernetes meta/v1.Condition 		(Optional)

Bedingungen beschreiben die aktuellen Bedingungen der RoutePolicy.

Implementierungen müssen es vorziehen, RoutePolicy-Bedingungen mit den RoutePolicyConditionType und RoutePolicyConditionReason Konstanten auszudrücken, damit Operatoren und Tools in einem gemeinsamen Vokabular konvergent laufen können, um den RoutePolicy-Zustand zu beschreiben.

Bekannte Bedingungstypen sind:

  • “Akzeptiert”

RouteTimeouts

(Wird auf:RoutePolicyConfigangezeigt)

RouteTimeouts definiert das Schema für die Timeouts-Spezifikation.

Feld Beschreibung
routeTimeout
Kubernetes meta/v1.Duration 		(Optional)

RouteTimeout ist das Timeout für die Route.

SessionAffinity

(Wird auf:IngressBackendSettings, RoutePolicyConfig) angezeigt.

SessionAffinity definiert das Schema für die Sitzungsaffinitätsspezifikation.

Feld Beschreibung
affinityType
AffinityType
cookieName
string 		(Optional)
cookieDuration
Kubernetes meta/v1.Duration 		(Optional)

StatusCodes

(Wird auf:HTTPMatchangezeigt)

StatusCodes definiert die HTTP-Statuscodeübereinstimmungen, die für HealthCheck-Überprüfungen verwendet werden sollen.

Feld Beschreibung
start
int32 		(Optional)

Start definiert den Anfang des Bereichs der Statuscodes, der für HealthCheck-Überprüfungen verwendet werden soll. Dies ist inklusive.
end
int32 		(Optional)

End definiert das Ende des Bereichs der Statuscodes, die für HealthCheck-Überprüfungen verwendet werden sollen. Dies ist inklusive.

URLRewriteFilter

(Angezeigt auf:IngressRewrites)

URLRewriteFilter definiert einen Filter, der eine Anforderung während der Weiterleitung ändert. Mindestens eines dieser Filter kann für eine Regel verwendet werden. Dies DARF NICHT für dieselbe Regel mit sslRedirect verwendet werden.

Feld Beschreibung
hostname
PreciseHostname 		(Optional)

Hostname ist der Wert, der verwendet werden soll, um den Hostheaderwert während der Weiterleitung zu ersetzen.
path
HTTPPathModifier 		(Optional)

Path definiert eine Pfad-Überschreibung.