Partager via


Spécification de l’API Passerelle d’application pour conteneurs pour Kubernetes

.

Le package v1 est la version v1 de l’API.

alb.networking.azure.io/v1

Ce document définit chacun des types de ressources pour alb.networking.azure.io/v1.

Types de ressources :

AffinityType (alias string)

(Apparaît sur :SessionAffinity)

AffinityType définit le type d’affinité pour le service

Valeur Description

"application-cookie"

AffinityTypeApplicationCookie est un type d’affinité de session pour un cookie d’application

"managed-cookie"

AffinityTypeManagedCookie est un type d’affinité de session pour un cookie managé

AlbConditionReason (alias string)

AlbConditionReason définit l’ensemble des raisons qui expliquent pourquoi un type de condition particulier est déclenché par la ressource Passerelle d’application pour conteneurs.

Valeur Description

"Accepted"

AlbReasonAccepted indique que la ressource Passerelle d’application pour conteneurs est acceptée par le contrôleur.

« Prêt »

AlbReasonDeploymentReady indique l’état du déploiement des ressources Passerelle d’application pour conteneurs.

"InProgress"

AlbReasonInProgress indique si la ressource Passerelle d’application pour conteneurs est en cours de création, de mise à jour ou de suppression.

AlbConditionType (alias string)

AlbConditionType est un type de condition associé à une ressource Passerelle d’application pour conteneurs. Ce type doit être utilisé avec le champ AlbStatus.Conditions.

Valeur Description

"Accepted"

AlbConditionTypeAccepted indique si la ressource Passerelle d’application pour conteneurs est acceptée par le contrôleur.

"Deployment"

AlbConditionTypeDeployment indique l’état de déploiement de la ressource Passerelle d’application pour conteneurs.

AlbSpec

(Apparaît sur :ApplicationLoadBalancer)

AlbSpec définit les spécifications de la ressource Passerelle d’application pour conteneurs.

Champ Description
associations
[]chaîne

Les associations sont des ID de ressource de sous-réseau auxquels la ressource Passerelle d’application pour conteneurs est associée.

AlbStatus

(Apparaît sur :ApplicationLoadBalancer)

AlbStatus définit l’état observé de la ressource Passerelle d’application pour conteneurs.

Champ Description
conditions
Kubernetes meta/v1.Condition
(Facultatif)

Les types de conditions connues sont les suivants :

  • “Acceptée”
  • “Prête”

ApplicationLoadBalancer

ApplicationLoadBalancer est le schéma de la ressource Passerelle d’application pour conteneurs.

Champ Description
metadata
Kubernetes meta/v1.ObjectMeta
(Facultatif)

Métadonnées de l’objet ’.

Reportez-vous à la documentation de l’API Kubernetes pour connaître les champs du champ metadata.
spec
AlbSpec

Spec correspond aux spécifications de la ressource Passerelle d’application pour conteneurs.



associations
[]chaîne

Les associations sont des ID de ressource de sous-réseau auxquels la ressource Passerelle d’application pour conteneurs est associée.

status
AlbStatus

Status définit l’état actuel de la ressource Passerelle d’application pour conteneurs.

Politique d'équilibrage de charge du backend

BackendLoadBalancingPolicy représente la configuration de l’équilibrage de charge back-end.

Champ Description
metadata
Kubernetes meta/v1.ObjectMeta
(Facultatif)

Métadonnées de l’objet ’.

Reportez-vous à la documentation de l’API Kubernetes pour connaître les champs du champ metadata.
spec
BackendLoadBalancingPolicySpec

Spec est la spécification BackendLoadBalancingPolicy.



targetRefs
[]TargetRefSpec

TargetRefs identifie une liste d’objets API auxquels appliquer la stratégie.

loadBalancing
LoadBalancingConfig
(Facultatif)

LoadBalancing définit le schéma pour la configuration des options d’équilibrage de charge

status
Statut de la politique d'équilibrage de charge du backend

L’état définit l’état actuel de BackendLoadBalancingPolicy.

BackendLoadBalancingPolicyConditionReason (string alias)

BackendLoadBalancingPolicyConditionReason définit l’ensemble des raisons qui expliquent pourquoi un type de condition BackendLoadBalancingPolicy particulier est déclenché.

Valeur Description

"Accepted"

BackendLoadBalancingPolicyReasonAccepted est utilisé pour définir BackendLoadBalancingPolicyConditionReason sur Accepté lorsque le BackendLoadBalancingPolicy fourni est correctement configuré

« En conflit »

BackendLoadBalancingPolicyReasonConflicted est utilisé lorsque la référence cible entre en conflit avec une cible de politique existante.

« InvalidBackendLoadBalancingPolicy »

BackendLoadBalancingPolicyReasonInvalid est la raison pour laquelle BackendLoadBalancingPolicy n’est’pas accepté

"InvalidGroup"

BackendLoadBalancingPolicyReasonInvalidGroup est utilisé lorsque le groupe est invalide

"InvalidKind"

BackendLoadBalancingPolicyReasonInvalidKind est utilisé lorsque le type/le groupe n’est pas valide

"InvalidName"

BackendLoadBalancingPolicyReasonInvalidName est utilisé lorsque le nom n’est pas valide

"InvalidService"

BackendLoadBalancingPolicyReasonInvalidService est utilisé lorsque le Service n’est pas valide

"NoTargetReference"

BackendLoadBalancingPolicyReasonNoTargetReference est utilisé lorsqu’il n’existe’aucune référence cible

"RefNotPermitted"

BackendLoadBalancingPolicyReasonRefNotPermitted est utilisé lorsque la référence n’est’pas autorisée

"ResolvedRefs"

BackendLoadBalancingPolicyReasonResolvedRefs est utilisé pour définir le BackendLoadBalancingPolicyConditionReason sur ResolvedRefs lorsque le BackendLoadBalancingPolicy a des références correctes

BackendLoadBalancingPolicyConditionType (string alias)

BackendLoadBalancingPolicyConditionType est un type de condition associé à un BackendLoadBalancingPolicy. Ce type doit être utilisé avec le champ BackendLoadBalancingPolicyStatus.Conditions.

Valeur Description

"Accepted"

BackendLoadBalancingPolicyConditionAccepted est utilisé pour définir BackendLoadBalancingPolicyConditionType sur Accept

"ResolvedRefs"

BackendLoadBalancingPolicyConditionResolvedRefs est utilisé pour définir BackendLoadBalancingPolicyCondition sur ResolvedRefs

BackendLoadBalancingPolicyPort

(Apparaît sur :TargetRefSpec)

BackendLoadBalancingPolicyPort définit la configuration de port pour la stratégie d’équilibrage de charge back-end.

Champ Description
port
int32

Le port est le port à utiliser pour la connexion au back-end

BackendLoadBalancingPolicySpec

(S’affiche sur :BackendLoadBalancingPolicy, IngressBackendSettings)

BackendLoadBalancingPolicySpec définit la spécification de BackendLoadBalancingPolicy.

Champ Description
targetRefs
[]TargetRefSpec

TargetRefs identifie une liste d’objets API auxquels appliquer la stratégie.

loadBalancing
LoadBalancingConfig
(Facultatif)

LoadBalancing définit le schéma pour la configuration des options d’équilibrage de charge

BackendLoadBalancingPolicyStatus

(S’affiche sur :BackendLoadBalancingPolicy)

BackendLoadBalancingPolicyStatus définit l’état observé de BackendLoadBalancingPolicy.

Champ Description
targets
[]BackendLoadBalancingPolicyTargetStatus

BackendLoadBalancingPolicyTargetStatus

(Apparaît sur :BackendLoadBalancingPolicyStatus)

BackendLoadBalancingPolicyTargetStatus définit l’état observé pour une référence cible

Champ Description
targetRef
CustomTargetRef
conditions
Kubernetes meta/v1.Condition

BackendTLSPolicy

BackendTLSPolicy est le schéma de l’API BackendTLSPolicies.

Champ Description
metadata
Kubernetes meta/v1.ObjectMeta
(Facultatif)

Métadonnées de l’objet ’.

Reportez-vous à la documentation de l’API Kubernetes pour connaître les champs du champ metadata.
spec
BackendTLSPolicySpec

Spec est la spécification BackendTLSPolicy.



targetRef
CustomTargetRef

TargetRef identifie un objet API auquel appliquer la stratégie.

override
BackendTLSPolicyConfig
(Facultatif)

Override définit la configuration de stratégie qui doit remplacer la configuration de stratégie attachée sous la ressource ciblée dans la hiérarchie.

Remarque : le remplacement n’est actuellement pas pris en charge et génère une erreur de validation. La prise en charge du remplacement sera ajoutée dans une version ultérieure.

default
BackendTLSPolicyConfig
(Facultatif)

Default définit la configuration de stratégie par défaut pour la ressource ciblée.

status
BackendTLSPolicyStatus

Status définit l’état actuel de BackendTLSPolicy.

BackendTLSPolicyConfig

(Apparaît sur :BackendTLSPolicySpec)

BackendTLSPolicyConfig définit la spécification de stratégie pour la stratégie TLS de back-end.

Champ Description
CommonTLSPolicy
CommonTLSPolicy

(Les membres de CommonTLSPolicy sont incorporés dans ce type.)

sni
chaîne
(Facultatif)

Sni est le nom du serveur à utiliser pour la connexion TLS au back-end.

ports
[]BackendTLSPolicyPort

Ports spécifie la liste des ports où la stratégie est appliquée.

clientCertificateRef
API de passerelle . SecretObjectReference
(Facultatif)

ClientCertificateRef est la référence au certificat client à utiliser pour la connexion TLS au back-end.

BackendTLSPolicyPort

(Apparaît sur :BackendTLSPolicyConfig)

BackendTLSPolicyPort définit le port à utiliser pour la connexion TLS au back-end

Champ Description
port
Int

Port est le port à utiliser pour la connexion TLS au back-end

BackendTLSPolicySpec

(Apparaît sur :BackendTLSPolicy)

BackendTLSPolicySpec définit l’état souhaité de BackendTLSPolicy.

Champ Description
targetRef
CustomTargetRef

TargetRef identifie un objet API auquel appliquer la stratégie.

override
BackendTLSPolicyConfig
(Facultatif)

Override définit la configuration de stratégie qui doit remplacer la configuration de stratégie attachée sous la ressource ciblée dans la hiérarchie.

Remarque : le remplacement n’est actuellement pas pris en charge et génère une erreur de validation. La prise en charge du remplacement sera ajoutée dans une version ultérieure.

default
BackendTLSPolicyConfig
(Facultatif)

Default définit la configuration de stratégie par défaut pour la ressource ciblée.

BackendTLSPolicyStatus

(Apparaît sur :BackendTLSPolicy)

BackendTLSPolicyStatus définit l’état observé de BackendTLSPolicy.

Champ Description
conditions
Kubernetes meta/v1.Condition
(Facultatif)

conditions décrit les conditions actuelles de BackendTLSPolicy.

Les implémentations doivent préférer exprimer des conditions BackendTLSPolicy à l’aide des constantes BackendTLSPolicyConditionType et BackendTLSPolicyConditionReason, afin que les opérateurs et les outils puissent converger sur un vocabulaire commun pour décrire l’état BackendTLSPolicy.

Les types de conditions connues sont les suivants :

  • “Acceptée”
  • “ResolvedRefs”

CommonTLSPolicy

(Apparaît sur :BackendTLSPolicyConfig)

CommonTLSPolicy est le schéma pour l’API CommonTLSPolicy.

Champ Description
verify
CommonTLSPolicyVerify
(Facultatif)

Verify fournit les options permettant de vérifier le certificat du pair.

CommonTLSPolicyVerify

(Apparaît sur :CommonTLSPolicy)

CommonTLSPolicyVerify définit le schéma pour l’API CommonTLSPolicyVerify.

Champ Description
caCertificateRef
API de passerelle . SecretObjectReference

CaCertificateRef est le certificat d’autorité de certification utilisé pour vérifier le certificat du pair.

subjectAltName
chaîne
(Facultatif)

SubjectAltName est l’autre nom de l’objet utilisé pour vérifier le certificat du pair.

CustomTargetRef

(S’affiche sur :BackendLoadBalancingPolicyTargetStatus, BackendTLSPolicySpec, FrontendTLSPolicySpec, HealthCheckPolicySpec, PolicyRefStatus, RoutePolicySpec, TargetRefSpec, WebApplicationFirewallPolicySpec)

CustomTargetRef est une référence à une ressource personnalisée qui ne fait pas partie de l’API principale Kubernetes.

Champ Description
NamespacedPolicyTargetReference
alpha2.NamespacedPolicyTargetReference de l’API Gateway

(Les membres de NamespacedPolicyTargetReference sont incorporés dans ce type.)

sectionNames
[]chaîne
(Facultatif)

SectionNames est le nom de la section dans la ressource cible. Lorsqu’il n’est pas spécifié, ce targetRef cible l’ensemble de la ressource. Dans les ressources suivantes, SectionNames est interprété de la manière suivante :

  • Passerelle : nom de l’écouteur
  • Service : nom du port

Si SectionNames est spécifié, mais qu’il n’existe pas sur l’objet ciblé, l’attachement de la stratégie échoue et l’implémentation de la stratégie enregistre une ResolvedRefs ou une condition similaire dans l’état de la stratégie.

FrontendTLSPolicy

FrontendTLSPolicy est le schéma de l’API FrontendTLSPolicy

Champ Description
metadata
Kubernetes meta/v1.ObjectMeta
(Facultatif)

Métadonnées de l’objet ’.

Reportez-vous à la documentation de l’API Kubernetes pour connaître les champs du champ metadata.
spec
FrontendTLSPolicySpec

Spec est la spécification FrontendTLSPolicy.



targetRef
CustomTargetRef

TargetRef identifie un objet API auquel appliquer la stratégie.

default
FrontendTLSPolicyConfig
(Facultatif)

Default définit la configuration de stratégie par défaut pour la ressource ciblée.

override
FrontendTLSPolicyConfig
(Facultatif)

Override définit la configuration de stratégie qui doit remplacer la configuration de stratégie attachée sous la ressource ciblée dans la hiérarchie.

Remarque : le remplacement n’est actuellement pas pris en charge et génère une erreur de validation. La prise en charge du remplacement sera ajoutée dans une version ultérieure.

status
FrontendTLSPolicyStatus

Status définit l’état actuel de FrontendTLSPolicy.

FrontendTLSPolicyConfig

(Apparaît sur :FrontendTLSPolicySpec)

FrontendTLSPolicyConfig définit la spécification de stratégie pour la stratégie TLS de front-end.

Champ Description
verify
MTLSPolicyVerify
(Facultatif)

Verify fournit les options permettant de vérifier le certificat du pair.

policyType
PolicyType
(Facultatif)

Type est le type de la stratégie.

FrontendTLSPolicySpec

(Apparaît sur :FrontendTLSPolicy)

FrontendTLSPolicySpec définit l’état souhaité de FrontendTLSPolicy

Champ Description
targetRef
CustomTargetRef

TargetRef identifie un objet API auquel appliquer la stratégie.

default
FrontendTLSPolicyConfig
(Facultatif)

Default définit la configuration de stratégie par défaut pour la ressource ciblée.

override
FrontendTLSPolicyConfig
(Facultatif)

Override définit la configuration de stratégie qui doit remplacer la configuration de stratégie attachée sous la ressource ciblée dans la hiérarchie.

Remarque : le remplacement n’est actuellement pas pris en charge et génère une erreur de validation. La prise en charge du remplacement sera ajoutée dans une version ultérieure.

FrontendTLSPolicyStatus

(Apparaît sur :FrontendTLSPolicy)

FrontendTLSPolicyStatus définit l’état observé de FrontendTLSPolicy.

Champ Description
conditions
Kubernetes meta/v1.Condition
(Facultatif)

conditions décrit les conditions actuelles de FrontendTLSPolicy.

Les implémentations doivent préférer exprimer des conditions FrontendTLSPolicy à l’aide des constantes FrontendTLSPolicyConditionType et FrontendTLSPolicyConditionReason, afin que les opérateurs et les outils puissent converger sur un vocabulaire commun pour décrire l’état FrontendTLSPolicy.

Les types de conditions connues sont les suivants :

  • “Acceptée”

FrontendTLSPolicyType (alias string)

(Apparaît sur :PolicyType)

FrontendTLSPolicyType est le type de la stratégie TLS front-end.

Valeur Description

"predefined"

PredefinedFrontendTLSPolicyType est le type de la stratégie TLS front-end prédéfinie.

FrontendTLSPolicyTypeName (string alias)

(Apparaît sur :PolicyType)

FrontendTLSPolicyTypeName est le nom de la stratégie TLS front-end.

Valeur Description

"2023-06"

PredefinedPolicy202306 est le nom de la stratégie TLS front-end prédéfinie pour la stratégie “2023-06”.

"2023-06-S"

PredefinedPolicy202306Strict est le nom de la stratégie TLS front-end prédéfinie pour la stratégie “2023-06-S”. Il s’agit d’une version stricte de la stratégie “2023-06”.

GRPCSpecifiers

(Apparaît sur :HealthCheckPolicyConfig)

GRPCSpecifiers définit le schéma pour GRPC HealthCheck.

Champ Description
authority
chaîne
(Facultatif)

Si elle est présente, l’autorité est utilisée comme valeur de l’en-tête Authority dans le contrôle d’intégrité.

service
chaîne
(Facultatif)

Le service autorise la configuration d’un contrôle d’intégrité inscrit sous un autre nom de service.

HTTPHeader

(Apparaît sur :HeaderFilter)

HTTPHeader représente un nom et une valeur d’en-tête HTTP définis par RFC 7230.

Champ Description
name
HTTPHeaderName

Name est le nom de l’en-tête HTTP à mettre en correspondance. La mise en correspondance de noms NE DOIT PAS respecter la casse. (Voir https://tools.ietf.org/html/rfc7230#section-3.2.)

Si plusieurs entrées spécifient des noms d’en-tête équivalents, la première entrée avec un nom équivalent DOIT être prise en compte pour une correspondance. Les entrées suivantes avec un nom d’en-tête équivalent DOIVENT être ignorées. En raison du non-respect de la casse des noms d’en-tête, “foo” et “Foo” sont considérés comme équivalents.

value
chaîne

Value est la valeur de l’en-tête HTTP à mettre en correspondance.

HTTPHeaderName (alias string)

(Apparaît sur :HTTPHeader)

HTTPHeaderName est le nom d’un en-tête HTTP.

Les valeurs valides sont les suivantes :

  • “Autorisation”
  • “Set-Cookie”

Les valeurs non valides comprennent :

  • ”:method” - “ :” est un caractère non valide Cela signifie que les pseudo-en-têtes HTTP/2 ne sont actuellement pas pris en charge par ce type.
  • ”/invalid” - “/ ” est un caractère non valide

HTTPMatch

(Apparaît sur :HTTPSpecifiers)

HTTPMatch définit les correspondances HTTP à utiliser pour les vérifications HealthCheck.

Champ Description
body
chaîne
(Facultatif)

Body définit les correspondances de corps HTTP à utiliser pour les vérifications HealthCheck.

statusCodes
[]StatusCodes
(Facultatif)

StatusCodes définit les correspondances de code d’état HTTP à utiliser pour les vérifications HealthCheck.

HTTPPathModifier

(Apparaît sur :Redirect, URLRewriteFilter)

HTTPPathModifier définit la configuration des modificateurs de chemin d’accès.

Champ Description
type
HTTPPathModifierType

Type définit le type de modificateur de chemin d’accès. Davantage de types pourront être ajoutés dans une prochaine version de l’API.

Des valeurs peuvent être ajoutées à cette énumération ; les implémentations doivent s’assurer que les valeurs inconnues ne provoqueront pas d’incident.

Les valeurs inconnues ici doivent entraîner la définition, par l’implémentation, de la condition Accepted pour que la règle soit false

replaceFullPath
chaîne
(Facultatif)

ReplaceFullPath spécifie la valeur par laquelle remplacer le chemin d’accès complet d’une requête lors d’une réécriture ou d’une redirection.

replacePrefixMatch
chaîne
(Facultatif)

ReplacePrefixMatch spécifie la valeur par laquelle remplacer la correspondance de préfixe d’une requête lors d’une réécriture ou d’une redirection. Par exemple, une requête à “/foo/bar” avec une correspondance de préfixe “/foo” et un ReplacePrefixMatch de “/xyz” sera remplacée par “/xyz/bar”.

Cela correspond au comportement du type de correspondance PathPrefix. Cela correspond aux éléments de chemin d’accès complets. Un élément de chemin d’accès fait référence à la liste des étiquettes dans le chemin d’accès divisé par le séparateur /. S’il est spécifié, un / de fin est ignoré. Par exemple, les chemins d’accès /abc, /abc/ et /abc/def correspondent tous au préfixe /abc, contrairement au chemin d’accès /abcd.

ReplacePrefixMatch n’est compatible qu’avec un httpRouteMatch PathPrefix. Si vous utilisez un autre type de HTTPRouteMatch sur le même HTTPRouteRule, l’implémentation définit la condition Accepté pour la route sur status: False.

Chemin d’accès de la requête Correspondance de préfixe Préfixe de remplacement Chemin d’accès modifié
/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)

(S’affiche sur :HTTPPathModifier)

HTTPPathModifierType définit le type de redirection ou de réécriture du chemin d’accès.

Valeur Description

"ReplaceFullPath"

FullPathHTTPPathModifier remplace le chemin d’accès complet par la valeur spécifiée.

« ReplacePrefixMatch »

PrefixMatchHTTPPathModifier remplace tout chemin de préfixe par la valeur de substitution. Par exemple, un chemin d’accès avec une correspondance de préfixe de “/foo” et une substitution ReplacePrefixMatch de “/bar” remplace “/foo” par “/bar” dans les requêtes correspondantes.

Cela correspond au comportement du type de correspondance PathPrefix. Cela correspond aux éléments de chemin d’accès complets. Un élément de chemin d’accès fait référence à la liste des étiquettes dans le chemin d’accès divisé par le séparateur /. S’il est spécifié, un / de fin est ignoré. Par exemple, les chemins d’accès /abc, /abc/ et /abc/def correspondent tous au préfixe /abc, contrairement au chemin d’accès /abcd.

HTTPSpecifiers

(Apparaît sur :HealthCheckPolicyConfig)

HTTPSpecifiers définit le schéma pour la spécification de vérification http HealthCheck.

Champ Description
host
chaîne
(Facultatif)

Host est la valeur d’en-tête de l’hôte à utiliser pour les vérifications HealthCheck.

path
chaîne
(Facultatif)

Path est le chemin d’accès à utiliser pour les vérifications HealthCheck.

match
HTTPMatch
(Facultatif)

Match définit les correspondances HTTP à utiliser pour les vérifications HealthCheck.

HeaderFilter

(Apparaît on :IngressRewrites)

HeaderFilter définit un filtre qui modifie les en-têtes d’une requête ou d’une réponse HTTP. Une seule action pour un nom d’en-tête donné est autorisée. Les filtres spécifiant plusieurs actions du même type ou différent pour n’importe quel nom d’en-tête ne sont pas valides et rejetés. La configuration permettant de définir ou d’ajouter plusieurs valeurs pour un en-tête doit utiliser la mise en forme de valeur d’en-tête RFC 7230, en séparant chaque valeur par une virgule.

Champ Description
set
[]HTTPHeader
(Facultatif)

Set remplace la requête par l’en-tête donné (nom, valeur) avant l’action.

Entrée : GET /foo HTTP/1.1 my-header : foo

Config : set: - name: “my-header” value: “bar”

Sortie : GET /foo HTTP/1.1 my-header : bar

add
[]HTTPHeader
(Facultatif)

Add ajoute le ou les en-têtes donnés (nom, valeur) à la requête avant l’action. Il ajoute à toutes les valeurs existantes associées au nom d’en-tête.

Entrée : GET /foo HTTP/1.1 my-header : foo

Configuration : ajouter : - nom : “my-header” valeur : “bar,baz”

Sortie : GET /foo HTTP/1.1 my-header: foo,bar,baz

remove
[]chaîne
(Facultatif)

Supprimez le ou les en-têtes donnés de la requête HTTP avant l’action. La valeur de Remove est une liste de noms d’en-tête HTTP. Les noms d’en-tête ne respectent pas la casse (consultez https://datatracker.ietf.org/doc/html/rfc2616#section-4.2).

Entrée : GET /foo HTTP/1.1 my-header1: foo my-header2: bar my-header3: baz

Configuration : supprimer : [“my-header1”, “my-header3”]

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

HeaderName (string alias)

HeaderName est le nom d’un paramètre d’en-tête ou de requête.

Politique de vérification de santé

HealthCheckPolicy est le schéma de l’API HealthCheckPolicy.

Champ Description
metadata
Kubernetes meta/v1.ObjectMeta
(Facultatif)

Métadonnées de l’objet ’.

Reportez-vous à la documentation de l’API Kubernetes pour connaître les champs du champ metadata.
spec
HealthCheckPolicySpec

Spec est la spécification HealthCheckPolicy.



targetRef
CustomTargetRef

TargetRef identifie un objet API auquel appliquer la stratégie.

override
HealthCheckPolicyConfig
(Facultatif)

Override définit la configuration de stratégie qui doit remplacer la configuration de stratégie attachée sous la ressource ciblée dans la hiérarchie.

Remarque : Le remplacement n’est actuellement pas pris en charge et génère une erreur de validation. La prise en charge du remplacement sera ajoutée dans une version ultérieure.

default
HealthCheckPolicyConfig
(Facultatif)

Default définit la configuration de stratégie par défaut pour la ressource ciblée.

status
StatutDeLaPolitiqueDeVérificationDeSanté

L’état définit l’état actuel de HealthCheckPolicy.

HealthCheckPolicyConditionReason (string alias)

HealthCheckPolicyConditionReason définit l’ensemble des raisons qui expliquent pourquoi un type de condition HealthCheckPolicy particulier est déclenché.

Valeur Description

« BackendTLSPolicyNotFound »

BackendTLSPolicyConditionNotFound est utilisé lorsque backendTLSPolicy est introuvable pour le service.

"Accepted"

HealthCheckPolicyReasonAccepted est utilisé pour définir HealthCheckPolicyConditionReason sur Accepté. Lorsque la HealthCheckPolicy donnée est correctement configurée.

"InvalidHealthCheckPolicy"

HealthCheckPolicyReasonInvalid est la raison pour laquelle la HealthCheckPolicy n’est’pas acceptée.

"InvalidGroup"

HealthCheckPolicyReasonInvalidGroup est utilisé lorsque le groupe n’est pas valide.

"InvalidKind"

HealthCheckPolicyReasonInvalidKind est utilisé lorsque le type/le groupe n’est pas valide.

"InvalidName"

HealthCheckPolicyReasonInvalidName est utilisé lorsque le nom n’est pas valide.

« InvalidPort »

HealthCheckPolicyReasonInvalidPort est utilisé lorsque le port n’est pas valide.

"InvalidService"

HealthCheckPolicyReasonInvalidService est utilisé lorsque le service n’est pas valide.

"NoTargetReference"

HealthCheckPolicyReasonNoTargetReference est utilisé lorsqu’il n’existe’aucune référence cible.

« OverrideNotSupported »

HealthCheckPolicyReasonOverrideNotSupported est utilisé quand le remplacement n’est pas pris en charge.

"RefNotPermitted"

HealthCheckPolicyReasonRefNotPermitted est utilisé lorsque la référence n’est’pas autorisée.

"ResolvedRefs"

HealthCheckPolicyReasonResolvedRefs est utilisé lorsque le targetRef a été résolu avec succès.

"SectionNamesNotPermitted"

HealthCheckPolicyReasonSectionNamesNotPermitted est utilisé lorsque les noms de section ne sont’pas autorisés.

« UnsupportedStatusCodes »

HealthCheckPolicyReasonUnsupportedStatusCodes est utilisé lorsque HealthCheckPolicy correspondant à StatusCodes ne sont pas pris en charge.

HealthCheckPolicyConditionType (alias string)

HealthCheckPolicyConditionType est un type de condition associé à HealthCheckPolicy. Ce type doit être utilisé avec le champ HealthCheckPolicyStatus.Conditions.

Valeur Description

"Accepted"

HealthCheckPolicyConditionAccepted est utilisé pour définir HealthCheckPolicyConditionType sur Accept.

"ResolvedRefs"

HealthCheckPolicyConditionResolvedRefs est utilisé pour définir HealthCheckPolicyCondition sur ResolvedRefs.

Configuration de la politique de vérification de santé

(S’affiche sur :HealthCheckPolicySpec)

HealthCheckPolicyConfig définit le schéma pour la spécification de vérification HealthCheck.

Champ Description
interval
Kubernetes /v1 meta Durée
(Facultatif)

L’intervalle est le nombre de secondes entre les vérifications HealthCheck.

timeout
Kubernetes meta/v1.Duration
(Facultatif)

Le délai d’expiration est le nombre de secondes après lesquelles la vérification HealthCheck est considérée comme ayant échoué.

port
int32
(Facultatif)

Port est le port à utiliser pour les vérifications HealthCheck.

unhealthyThreshold
int32
(Facultatif)

UnhealthyThreshold est le nombre de contrôles HealthCheck consécutifs ayant échoué.

healthyThreshold
int32
(Facultatif)

HealthyThreshold est le nombre de contrôles "HealthCheck" réussis consécutifs.

useTLS
Bool
(Facultatif)

UseTLS indique si la vérification d’intégrité doit appliquer TLS. Par défaut, la vérification d’intégrité utilise le même protocole que le service si le même port est utilisé pour le contrôle d’intégrité. Si le port est différent, la vérification de l'état sera en texte clair.

http
HTTPSpecifiers
(Facultatif)

HTTP définit la spécification de contrainte HTTP pour HealthCheck d’une ressource cible.

grpc
GRPCSpecifiers

GRPC configure un contrôle d’intégrité gRPC v1 (https://github.com/grpc/grpc-proto/blob/master/grpc/health/v1/health.proto) sur la ressource cible.

HealthCheckPolicySpec

(Apparaît sur :HealthCheckPolicy)

HealthCheckPolicySpec définit l’état souhaité de HealthCheckPolicy.

Champ Description
targetRef
CustomTargetRef

TargetRef identifie un objet API auquel appliquer la stratégie.

override
HealthCheckPolicyConfig
(Facultatif)

Override définit la configuration de stratégie qui doit remplacer la configuration de stratégie attachée sous la ressource ciblée dans la hiérarchie.

Remarque : Le remplacement n’est actuellement pas pris en charge et génère une erreur de validation. La prise en charge du remplacement sera ajoutée dans une version ultérieure.

default
HealthCheckPolicyConfig
(Facultatif)

Default définit la configuration de stratégie par défaut pour la ressource ciblée.

StatutDeLaPolitiqueDeVérificationDeSanté

(Apparaît sur :HealthCheckPolicy)

HealthCheckPolicyStatus définit l’état observé de HealthCheckPolicy.

Champ Description
conditions
Kubernetes meta/v1.Condition
(Facultatif)

Les conditions décrivent les conditions actuelles de HealthCheckPolicy.

Les implémentations doivent préférer exprimer des conditions HealthCheckPolicy à l’aide des constantes HealthCheckPolicyConditionType et HealthCheckPolicyConditionReason afin que les opérateurs et les outils puissent converger sur un vocabulaire commun pour décrire l’état HealthCheckPolicy.

Les types de conditions connues sont les suivants :

  • “Acceptée”

IngressBackendPort

(Apparaît dans :IngressBackendSettings)

IngressBackendPort décrit un port sur un serveur principal. Un seul nom/numéro doit être défini.

Champ Description
port
int32
(Facultatif)

Le port désigne celui utilisé par le service back-end.

name
chaîne
(Facultatif)

Le nom doit faire référence à un nom sur un port sur le service principal

protocol
Protocole

Le protocole doit être l’un des “protocoles HTTP”, “HTTPS”

IngressBackendSettingStatus

(Apparaît on :IngressExtensionStatus)

IngressBackendSettingStatus décrit l’état d’un BackendSetting

Champ Description
service
chaîne

Le service identifie le BackendSetting auquel cet état correspond.

validationErrors
[]chaîne
(Facultatif)

Les erreurs sont une liste d’erreurs relatives à ce paramètre

valid
Bool

Valide indique qu’aucune erreur de validation n’est présente sur ce BackendSetting

IngressBackendSettings

(Apparaît on :IngressExtensionSpec)

IngressBackendSettings fournit des options de configuration étendues pour un service principal

Champ Description
service
chaîne

Le service est le nom d’un service principal auquel cette configuration s’applique

ports
[]IngressBackendPort
(Facultatif)

Les ports peuvent être utilisés pour indiquer si le service principal écoute sur HTTP ou HTTPS

trustedRootCertificate
chaîne
(Facultatif)

TrustedRootCertificate peut être utilisé pour fournir un certificat de confiance pour la passerelle lors de la communication avec le back-end sur le port spécifié en HTTPS.

sessionAffinity
SessionAffinity
(Facultatif)

SessionAffinity permet aux requêtes clientes d’être données de manière cohérente au même back-end

timeouts
IngressTimeouts
(Facultatif)

Les délais d’expiration définissent un ensemble de paramètres d'expiration à appliquer à une Ingress.

loadBalancingPolicySpec
BackendLoadBalancingPolicySpec
(Facultatif)

LoadBalancing définit la stratégie d’équilibrage de charge pour le service principal

IngressExtension

IngressExtension est le schéma de l’API IngressExtension

Champ Description
metadata
Kubernetes meta/v1.ObjectMeta
(Facultatif)

Métadonnées de l’objet ’.

Reportez-vous à la documentation de l’API Kubernetes pour connaître les champs du champ metadata.
spec
IngressExtensionSpec

Spec est la spécification IngressExtension.



rules
[]IngressRuleSetting
(Facultatif)

Les règles définissent les règles par hôte

backendSettings
[]IngressBackendSettings
(Facultatif)

BackendSettings définit un ensemble d’options de configuration pour les back-ends du service Ingress

status
IngressExtensionStatus

IngressExtensionConditionReason (string alias)

IngressExtensionConditionReason définit l’ensemble des raisons qui expliquent pourquoi un type de condition IngressExtension particulier est déclenché.

Valeur Description

"Accepted"

IngressExtensionReasonAccepted est utilisé pour définir IngressExtensionConditionAccepted sur Accept

"HasValidationErrors"

IngressExtensionReasonHasErrors indique qu’il existe des erreurs de validation

AucuneErreurDeValidation

IngressExtensionReasonNoErrors indique qu’il n’existe aucune erreur de validation

« Accepté partiellement avec erreurs »

IngressExtensionReasonPartiallyAccepted est utilisé pour définir IngressExtensionConditionAccepted sur Accepté, mais avec des erreurs de validation non-fatales.

IngressExtensionConditionType (string alias)

IngressExtensionConditionType est un type de condition associé à une ingressExtension. Ce type doit être utilisé avec le champ IngressExtensionStatus.Conditions.

Valeur Description

"Accepted"

IngressExtensionConditionAccepted indique si l’ingressExtension est accepté (réconcilié) par le contrôleur

« Erreurs »

IngressExtensionConditionErrors indique s’il existe des erreurs de validation ou de build sur l’extension

IngressExtensionSpec

(Apparaît on :IngressExtension)

IngressExtensionSpec définit la configuration souhaitée d’IngressExtension

Champ Description
rules
[]IngressRuleSetting
(Facultatif)

Les règles définissent les règles par hôte

backendSettings
[]IngressBackendSettings
(Facultatif)

BackendSettings définit un ensemble d’options de configuration pour les back-ends du service Ingress

IngressExtensionStatus

(Apparaît on :IngressExtension)

IngressExtensionStatus décrit l’état actuel de l’ingressExtension

Champ Description
rules
[]IngressRuleStatus
(Facultatif)

Les règles ont des informations d’état détaillées sur chaque règle

backendSettings
[]IngressBackendSettingStatus
(Facultatif)

BackendSettings contient des informations d’état détaillées sur chaque backendSettings

conditions
Kubernetes meta/v1.Condition
(Facultatif)

Les conditions décrivent les conditions actuelles de l’IngressExtension. Les types de conditions connues sont les suivants :

  • “Acceptée”
  • “Erreurs”

IngressRewrites

(Apparaît on :IngressRuleSetting)

IngressRewrites fournit les différentes réécritures prises en charge par une règle

Champ Description
type
RewriteType

Type identifie le type de réécriture

requestHeaderModifier
HeaderFilter
(Facultatif)

RequestHeaderModifier définit un schéma qui modifie les en-têtes de requête.

responseHeaderModifier
HeaderFilter
(Facultatif)

RequestHeaderModifier définit un schéma qui modifie les en-têtes de réponse.

urlRewrite
URLRewriteFilter
(Facultatif)

URLRewrite définit un schéma qui modifie une requête pendant le transfert.

IngressRuleSetting

(Apparaît on :IngressExtensionSpec)

IngressRuleSetting fournit des options de configuration pour les règles

Champ Description
host
chaîne

L’hôte est utilisé pour correspondre aux règles Ingress avec le même nom d’hôte afin d’identifier les règles qui influencent ces paramètres.

additionalHostnames
[]chaîne
(Facultatif)

AdditionalHostnames spécifie d’autres noms d’hôte sur lesquels écouter.

rewrites
[]IngressRewrites
(Facultatif)

Rewrites définit les réécritures pour la règle

requestRedirect
Rediriger
(Facultatif)

RequestRedirect définit le comportement de redirection de la règle

IngressRuleStatus

(Apparaît on :IngressExtensionStatus)

IngressRuleStatus décrit l’état d’une règle

Champ Description
host
chaîne

L’hôte identifie la règle que décrit ce statut

validationErrors
[]chaîne
(Facultatif)

Les erreurs sont une liste d’erreurs relatives à ce paramètre

valid
Bool
(Facultatif)

Valide indique qu’aucune erreur de validation n’est présente sur cette règle

IngressTimeouts

(Apparaît dans :IngressBackendSettings)

IngressTimeouts peut être utilisé pour configurer les propriétés de délai d’expiration d’une Ingress

Champ Description
requestTimeout
Kubernetes meta/v1.Duration
(Facultatif)

RequestTimeout définit le délai d’expiration utilisé par l’équilibreur de charge lors du transfert de requêtes vers un service back-end

LoadBalancingConfig

(S’affiche sur :BackendLoadBalancingPolicySpec)

LoadBalancingConfig définit la configuration pour l’équilibrage de charge.

Champ Description
strategy
LoadBalancingStrategy
(Facultatif)

La stratégie définit la stratégie à utiliser lors de l’équilibrage de charge du trafic vers le service principal. La valeur par défaut est le round-robin.

slowStart
SlowStartConfig
(Facultatif)

SlowStart définit le schéma pour la spécification Slow Start

Stratégie d'équilibrage de charge (string alias)

(S’affiche sur :LoadBalancingConfig)

LoadBalancingStrategy définit la stratégie à utiliser lors de l’équilibrage du trafic entre un service

Valeur Description

« moins de requêtes »

LoadBalancingLeastRequest est utilisé pour définir LoadBalancingStrategy sur least-request

« ring-hash »

LoadBalancingRingHash est utilisé pour définir LoadBalancingStrategy sur ring-hash

« round-robin »

LoadBalancingRoundRobin est utilisé pour définir LoadBalancingStrategy sur round-robin

MTLSPolicyVerify

(S’affiche sur :FrontendTLSPolicyConfig)

MTLSPolicyVerify définit le schéma de l’API MTLSPolicyVerify.

Champ Description
caCertificateRef
API de passerelle . SecretObjectReference

CaCertificateRef est le certificat d’autorité de certification utilisé pour vérifier le certificat du pair.

subjectAltNames
[]chaîne
(Facultatif)

SubjectAltNames est la liste des noms alternatifs de l'objet utilisés pour vérifier le certificat homologue.

PolicyConditionReason (alias string)

PolicyConditionReason est le type de raison utilisé pour différents CRD de stratégie liés à l’ALB.

Valeur Description

"Accepted"

« En conflit »

« Déployé »

« ÉchecDuDéploiement »

« Non valide »

"InvalidCertificateRef"

"InvalidGroup"

"InvalidKind"

"InvalidName"

"InvalidService"

« InvalidTargetReference »

« Pas de déploiement »

"NoTargetReference"

« OpérationÉchouée »

« OverrideNotSupported »

« En attente »

« Programmé »

Échec de programmation

"RefNotPermitted"

"ResolvedRefs"

"SectionNamesNotPermitted"

PolicyConditionType (string alias)

PolicyConditionType est le type des conditions utilisées pour différents CRD de stratégie liés à l’ALB.

Valeur Description

"Accepted"

"Deployment"

« Programmé »

"ResolvedRefs"

PolicyRefStatus

PolicyRefStatus définit l’état d’une référence cible unique pour une stratégie qui prend en charge plusieurs références cibles.

Champ Description
targetRef
CustomTargetRef

TargetRef est la référence à l’objet cible auquel cette stratégie est appliquée

conditions
Kubernetes meta/v1.Condition
(Facultatif)

Les conditions décrivent les conditions actuelles des règles d’accès IP d’Application Gateway pour conteneurs, car elles concernent un targetRef particulier.

PolicyType

(S’affiche sur :FrontendTLSPolicyConfig)

PolicyType est le type de la stratégie.

Champ Description
name
FrontendTLSPolicyTypeName

Name est le nom de la stratégie.

type
FrontendTLSPolicyType

FrontendTLSPolicyType spécifie le type de stratégie TLS frontend

PortNumber (int32 pseudonyme)

(S’affiche sur :Redirect)

PortNumber définit un port réseau.

PreciseHostname (string alias)

(Apparaît sur :Redirect, URLRewriteFilter)

PreciseHostname est le nom de domaine complet d’un hôte réseau. Cela correspond à la définition RFC 1123 d’un nom d’hôte avec une exception notable que les adresses IP numériques ne sont pas autorisées’.

Par RFC1035 et RFC1123, une étiquette doit se composer de caractères alphanumériques minuscules ou ‘-’, et doit commencer et se terminer par un caractère alphanumérique. Aucune autre ponctuation n’est autorisée.

Protocole (string alias)

(Apparaît on :IngressBackendPort)

Le protocole définit le protocole utilisé pour certaines propriétés. Les valeurs de protocole valides sont les suivantes :

  • HTTP
  • HTTPS
  • TCP
Valeur Description

« HTTP »

ProtocolHTTP implique que le service utilise HTTP.

« HTTPS »

ProtocolHTTPS implique que le service utilise HTTPS.

« TCP »

ProtocolTCP implique que le service utilise le protocole TCP brut.

Rediriger

(Apparaît on :IngressRuleSetting)

La redirection définit un filtre qui redirige une requête. Cela NE DOIT PAS être utilisé sur la même règle qui a également une URLRewriteFilter.

Champ Description
scheme
chaîne
(Facultatif)

Scheme est le schéma à utiliser dans la valeur de l’en-tête Location dans la réponse. En cas de vide, le schéma de la requête est utilisé.

hostname
PreciseHostname
(Facultatif)

Le nom d’hôte est le nom d’hôte à utiliser dans la valeur de l’en-tête Location dans la réponse. En cas de vide, le nom d’hôte dans l’en-tête Host de la requête est utilisé.

path
HTTPPathModifier
(Facultatif)

Le chemin définit les paramètres utilisés pour modifier le chemin d’accès de la requête entrante. Le chemin modifié est ensuite utilisé pour construire l’en-tête Location . Lorsqu’il est vide, le chemin de la requête est utilisé as-is.

port
PortNumber
(Facultatif)

Le port à utiliser est celui indiqué dans la valeur de l'en-tête Location dans la réponse.

Si aucun port n’est spécifié, le port de redirection doit être dérivé à l’aide des règles suivantes :

  • Si le schéma de redirection n’est pas vide, le port de redirection doit être le port connu associé au schéma de redirection. Plus précisément “http” vers le port 80 et “https” vers le port 443. Si le schéma de redirection n’a’pas de port connu, le port d’écouteur de la passerelle DOIT être utilisé.
  • Si le schéma de redirection est vide, le port de redirection doit obligatoirement être le port de l'écouteur de passerelle.

Les implémentations NE DOIVENT PAS ajouter le numéro de port dans l’en-tête ‘Location’ dans les cas suivants :

  • Un en-tête d’emplacement qui utilise HTTP (que ce soit déterminé via le protocole d’écouteur ou le champ de schéma) et qui utilise le port 80.
  • En-tête de localisation qui utilise HTTPS (que cela soit déterminé via le protocole Listener ou le champ Schéma) et utilise le port 443.
statusCode
Int
(Facultatif)

StatusCode est le code d’état HTTP à utiliser en réponse.

Les valeurs peuvent être ajoutées à cette énumération, les implémentations doivent s’assurer que les valeurs inconnues ne provoquent’pas de blocage.

RewriteType (string alias)

(Apparaît on :IngressRewrites)

RewriteType identifie le type de réécriture

Valeur Description

« RequestHeaderModifier »

RequestHeaderModifier peut être utilisé pour ajouter ou supprimer un en-tête HTTP d’une requête HTTP avant d’être’envoyé à la cible en amont.

"ResponseHeaderModifier"

ResponseHeaderModifier peut être utilisé pour ajouter ou supprimer un en-tête HTTP d’une réponse HTTP avant son’envoi au client.

« URLRewrite »

L’URLRewrite peut être utilisée pour modifier une requête pendant le transfert.

RoutePolicy

RoutePolicy est le schéma de l’API RoutePolicy.

Champ Description
metadata
Kubernetes meta/v1.ObjectMeta
(Facultatif)

Métadonnées de l’objet ’.

Reportez-vous à la documentation de l’API Kubernetes pour connaître les champs du champ metadata.
spec
RoutePolicySpec

La spécification Spec est celle de RoutePolicy.



targetRef
CustomTargetRef

TargetRef identifie un objet API auquel appliquer la stratégie.

override
RoutePolicyConfig
(Facultatif)

Override définit la configuration de stratégie qui doit remplacer la configuration de stratégie attachée sous la ressource ciblée dans la hiérarchie.

Remarque : le remplacement n’est actuellement pas pris en charge et génère une erreur de validation. La prise en charge du remplacement sera ajoutée dans une version ultérieure.

default
RoutePolicyConfig
(Facultatif)

Default définit la configuration de stratégie par défaut pour la ressource ciblée.

status
RoutePolicyStatus

L’état définit l’état actuel de RoutePolicy.

RoutePolicyConditionReason (string alias)

RoutePolicyConditionReason définit l’ensemble des raisons qui expliquent pourquoi un type de condition RoutePolicy particulier est déclenché.

Valeur Description

"Accepted"

RoutePolicyReasonAccepted est utilisé pour définir RoutePolicyConditionReason sur Accepté lorsque la RoutePolicy donnée est correctement configurée.

« AcceptedWithTimeoutConflict »

RoutePolicyReasonAcceptedWithTimeoutConflict est utilisé pour définir RoutePolicyConditionReason sur AcceptedWithTimeoutConflict lorsque la RoutePolicy donnée est correctement configurée, mais a un conflit de délai d’expiration avec l’itinéraire cible

"InvalidRoutePolicy"

RoutePolicyReasonInvalid est la raison pour laquelle RoutePolicy n’est pas Accepted

« InvalidGRPCRoute »

RoutePolicyReasonInvalidGRPCRoute est utilisé quand GRPCRoute est non valide

"InvalidGroup"

RoutePolicyReasonInvalidGroup est utilisé lorsque le groupe n’est pas valide

"InvalidHTTPRoute"

RoutePolicyReasonInvalidHTTPRoute est utilisé lorsque HTTPRoute n’est pas valide

"InvalidKind"

RoutePolicyReasonInvalidKind Est utilisé lorsque le type/le groupe n’est pas valide

"InvalidName"

RoutePolicyReasonInvalidName est utilisé lorsque le nom n’est pas valide

"NoTargetReference"

RoutePolicyReasonNoTargetReference est utilisé lorsqu’il n’existe’aucune référence cible

« OverrideNotSupported »

RoutePolicyReasonOverrideNotSupported est utilisé lorsque le remplacement n’est pas pris en charge

"RefNotPermitted"

RoutePolicyReasonRefNotPermitted est utilisé lorsque la référence n’est’pas autorisée

"SectionNamesNotPermitted"

RoutePolicyReasonSectionNamesNotPermitted est utilisé lorsque les noms de section ne sont’pas autorisés

RoutePolicyConditionType (string alias)

RoutePolicyConditionType est un type de condition associé à une routePolicy. Ce type doit être utilisé avec le champ RoutePolicyStatus.Conditions.

Valeur Description

"Accepted"

RoutePolicyConditionAccepted est utilisé pour définir RoutePolicyConditionType sur Accept

"ResolvedRefs"

RoutePolicyConditionResolvedRefs est utilisé pour définir RoutePolicyCondition sur ResolvedRefs

Configuration de la politique de routage

(S’affiche sur :RoutePolicySpec)

RoutePolicyConfig définit le schéma pour la spécification RoutePolicy. Cela permet la spécification des attributs suivants : * Timeouts * Affinité de session

Champ Description
timeouts
RouteTimeouts
(Facultatif)

Délais d’expiration personnalisés pour la ressource cible.

sessionAffinity
SessionAffinity
(Facultatif)

SessionAffinity définit le schéma pour la spécification d’affinité de session

RoutePolicySpec

(Apparaît sur :RoutePolicy)

RoutePolicySpec définit l’état souhaité de RoutePolicy.

Champ Description
targetRef
CustomTargetRef

TargetRef identifie un objet API auquel appliquer la stratégie.

override
RoutePolicyConfig
(Facultatif)

Override définit la configuration de stratégie qui doit remplacer la configuration de stratégie attachée sous la ressource ciblée dans la hiérarchie.

Remarque : le remplacement n’est actuellement pas pris en charge et génère une erreur de validation. La prise en charge du remplacement sera ajoutée dans une version ultérieure.

default
RoutePolicyConfig
(Facultatif)

Default définit la configuration de stratégie par défaut pour la ressource ciblée.

État de la politique de routage

(Apparaît sur :RoutePolicy)

RoutePolicyStatus définit l’état observé de RoutePolicy.

Champ Description
conditions
Kubernetes meta/v1.Condition
(Facultatif)

Les conditions décrivent les conditions actuelles de RoutePolicy.

Les implémentations doivent préférer exprimer des conditions de RoutePolicy en utilisant les constantes RoutePolicyConditionType et RoutePolicyConditionReason afin que les opérateurs et les outils puissent converger sur un langage commun pour décrire l'état de RoutePolicy.

Les types de conditions connues sont les suivants :

  • “Acceptée”

RouteTimeouts

(S’affiche sur :RoutePolicyConfig)

RouteTimeouts définit le schéma pour la spécification des délais d'expiration.

Champ Description
routeTimeout
Kubernetes meta/v1.Duration
(Facultatif)

RouteTimeout est le délai d’expiration de l’itinéraire.

Affinité de session

(S’affiche sur :IngressBackendSettings, RoutePolicyConfig)

SessionAffinity définit le schéma pour la spécification d’affinité de session.

Champ Description
affinityType
AffinityType
cookieName
chaîne
(Facultatif)
cookieDuration
Kubernetes meta/v1.Duration
(Facultatif)

SlowStartConfig

(S’affiche sur :LoadBalancingConfig)

SlowStartConfig définit la configuration pour le démarrage lent.

Champ Description
window
Kubernetes meta/v1.Duration

Durée de la fenêtre de démarrage lente.

aggression
chaîne
(Facultatif)

La vitesse d'augmentation du trafic pendant la fenêtre de démarrage lente doit être supérieure à 0,0. La valeur par défaut est 1.0 si elle n’est pas spécifiée.

startWeightPercent
uint32
(Facultatif)

Pourcentage minimal ou de départ du trafic à envoyer vers de nouveaux points d'accès. La valeur par défaut est 10% si elle n’est pas spécifiée.

StatusCodes

(S’affiche sur :HTTPMatch)

StatusCodes définit les correspondances de code d’état HTTP à utiliser pour les vérifications HealthCheck.

Champ Description
start
int32
(Facultatif)

Start définit le début de la plage de codes d’état à utiliser pour les vérifications HealthCheck. Ceci est inclusif.

end
int32
(Facultatif)

Fin définit la fin de la plage de codes d’état à utiliser pour les vérifications de HealthCheck. Ceci est inclusif.

TargetRefSpec

(S’affiche sur :BackendLoadBalancingPolicySpec)

TargetRefSpec définit la référence cible et les ports de la stratégie d’équilibrage de charge back-end.

Champ Description
targetRef
CustomTargetRef

TargetRef identifie un objet API auquel appliquer la stratégie.

ports
[]BackendLoadBalancingPolicyPort
(Facultatif)

Les ports spécifient la liste des ports où la stratégie est appliquée.

URLRewriteFilter

(Apparaît on :IngressRewrites)

URLRewriteFilter définit un filtre qui modifie une requête pendant le transfert. Au plus un de ces filtres peut être utilisé sur une règle. Il NE FAUT PAS l'utiliser sur la même règle comportant un sslRedirect.

Champ Description
hostname
PreciseHostname
(Facultatif)

Le nom d’hôte est la valeur à utiliser pour remplacer la valeur d’en-tête de l’hôte pendant le transfert.

path
HTTPPathModifier
(Facultatif)

Path définit une réécriture de chemin d’accès.

WebApplicationFirewallConfig

(S’affiche sur :WebApplicationFirewallPolicySpec)

WebApplicationFirewallConfig définit la configuration de la stratégie de pare-feu d’applications web pour la Politique de sécurité du sous-ressource Application Gateway pour les conteneurs.

Champ Description
id
chaîne

Politique de Pare-feu d'Application Web

WebApplicationFirewallPolicy est le schéma de la ressource enfant Application Gateway for Containers Security Policy.

Champ Description
metadata
Kubernetes meta/v1.ObjectMeta
(Facultatif)

Métadonnées de l’objet ’.

Reportez-vous à la documentation de l’API Kubernetes pour connaître les champs du champ metadata.
spec
WebApplicationFirewallPolicySpec

La spécification correspond aux spécifications pour la ressource enfant de stratégie de sécurité de Passerelle d’application pour conteneurs.



targetRef
CustomTargetRef

TargetRef identifie un objet API auquel appliquer la stratégie.

webApplicationFirewall
WebApplicationFirewallConfig

WebApplicationFirewallPolicy est utilisé pour spécifier une ressource WebApplicationPolicy

status
WebApplicationFirewallPolicyStatus

L’état définit l’état actuel de la ressource enfant de stratégie de sécurité de Passerelle d’application pour conteneurs.

WebApplicationFirewallPolicySpec

(S’affiche sur :WebApplicationFirewallPolicy)

WebApplicationFirewallPolicySpec définit l’état souhaité de WebApplicationFirewallPolicy.

Champ Description
targetRef
CustomTargetRef

TargetRef identifie un objet API auquel appliquer la stratégie.

webApplicationFirewall
WebApplicationFirewallConfig

WebApplicationFirewallPolicy est utilisé pour spécifier une ressource WebApplicationPolicy

WebApplicationFirewallPolicyStatus

(S’affiche sur :WebApplicationFirewallPolicy)

WebApplicationFirewallPolicyStatus définit l’état observé de la ressource enfant de stratégie de sécurité de Passerelle d’application pour conteneurs.

Champ Description
conditions
Kubernetes meta/v1.Condition
(Facultatif)

Les types de conditions connues sont les suivants :

  • “Acceptée”
  • “Déploiement”
  • “ResolvedRefs”
  • “Programmé”