第4章 FlowSchema [flowcontrol.apiserver.k8s.io/v1beta3]

distinguisherMethod

object

FlowDistinguisherMethod は、フロー識別子のメソッドを指定します。

matchingPrecedence

integer

matchingPrecedence は、特定のリクエストに一致する FlowSchemas から選択するために使用されます。選択された FlowSchema は、MatchingPrecedence が数値的に最も低い (論理的に最も高いと見なされる) ものの 1 つです。各 MatchingPrecedence 値は、[1,10000] の範囲である必要があります。優先順位が指定されていない場合、デフォルトで 1000 に設定されることに注意してください。

priorityLevelConfiguration

object

PriorityLevelConfigurationReference には、使用されている "request-priority" を指す情報が含まれています。

rules

array

ルール は、どのリクエストがこのフロースキーマに一致するかを記述します。この FlowSchema は、ルールの少なくとも 1 つのメンバーが要求に一致する場合にのみ、要求に一致します。空のスライスの場合、FlowSchema に一致するリクエストはありません。

rules[]

object

PolicyRulesWithSubjects は、apiserver へのリクエストに適用されるテストを規定します。テストでは、要求を行っているサブジェクト、要求されている動詞、および実行対象のリソースが考慮されます。この PolicyRulesWithSubjects は、(a) サブジェクトの少なくとも 1 つのメンバーが要求に一致し、(b)resourceRules または nonResourceRules の少なくとも 1 つのメンバーが要求に一致する場合にのみ、要求に一致します。

type

string

type は、フロー識別子メソッドのタイプです。サポートされているタイプは、"ByUser" と "ByNamespace" です。必須。

name

string

name は、参照されている優先度レベルの設定の名前です必須。

nonResourceRules

array

nonResourceRules は、動詞とターゲットの非リソース URL に従って一致するリクエストを識別する NonResourcePolicyRules のリストです。

nonResourceRules[]

object

NonResourcePolicyRule は、動詞とターゲットの非リソース URL に従って非リソース要求に一致する述語です。NonResourcePolicyRule は、(a) 動詞の少なくとも 1 つのメンバーが要求に一致し、(b)nonResourceURLs の少なくとも 1 つのメンバーが要求に一致する場合にのみ、要求に一致します。

resourceRules

array

resourceRules は、動詞とターゲットリソースに従って一致するリクエストを識別する ResourcePolicyRules のスライスです。resourceRules と nonResourceRules の少なくとも 1 つは空でない必要があります。

resourceRules[]

object

ResourcePolicyRule は、一部のリソースリクエストに一致する述語であり、リクエストの動詞とターゲットリソースをテストします。ResourcePolicyRule は、(a) 動詞の少なくとも 1 つのメンバーがリクエストと一致する、(b) apiGroups の少なくとも 1 つのメンバーがリクエストと一致する、(c) リソースの少なくとも 1 つのメンバーがリクエストと一致する場合、または (d) (d1) リクエストで namespace が指定されておらず (つまり、Namespace=="")、clusterScope が true であるか、または (d2) リクエストで namespace が指定されており、namespace の少なくとも 1 つのメンバーがリクエストの namespace と一致する場合にリソースリクエストと一致します。

subjects

array

サブジェクトは、このルールが関係する通常のユーザー、サービスアカウント、またはグループのリストです。このスライスには少なくとも 1 つのメンバーが必要です。system:authenticated ユーザーグループと system:unauthenticated ユーザーグループの両方を含むスライスは、すべてのリクエストに一致します。必須。

subjects[]

object

サブジェクトは、リクエスト認証システムによって識別されるように、リクエストの発信者と一致します。発信者を照合する方法は 3 つあります。ユーザー、グループ、またはサービスアカウントごと。

nonResourceURLs

array (string)

nonResourceURLs は、ユーザーがアクセスできる必要があり、空であってはならない URL 接頭辞のセットです。例: - "/healthz" は合法です "/hea*" は違法です - "/hea" は合法ですが何にも一致しません - "/hea/" も何にも一致しません - "/healthz/" はすべてのコンポーネントごとのヘルスチェックに一致します。"*" はすべての非リソース URL に一致します。存在する場合は、それが唯一のエントリーである必要があります。必須。

verbs

array (string)

verbs は一致する動詞のリストであり、空にすることはできません。"*" はすべての動詞に一致します。存在する場合は、それが唯一のエントリーである必要があります。必須。

apiGroups

array (string)

apiGroups は、一致する API グループのリストであり、空ではない場合があります。"*" はすべての API グループに一致し、存在する場合は唯一のエントリーである必要があります。必須。

clusterScope

boolean

clusterScope は、namespace を指定しない要求に一致するかどうかを示します (これは、リソースが namespace 化されていないか、要求がすべての namespace を対象としているために発生します)。このフィールドが省略されているか false の場合、namespaces フィールドには空でないリストが含まれている必要があります。

namespaces

array (string)

namespaces は、一致を制限するターゲット namespace のリストです。ターゲット namespace を指定するリクエストは、(a) このリストにそのターゲット namespace が含まれているか、(b) このリストに "" が含まれます。"" は、指定の namespace と一致しますが、namespace を 指定していない 要求とは一致しません (これは clusterScope フィールドを参照してください)。このリストは空の場合がありますが、clusterScope が true の場合に限ります。

resources

array (string)

resources は、必要に応じてサブリソースと一致するリソース (小文字と複数形) のリストです。たとえば、[ "services", "nodes/status" ] です。このリストは空ではない可能性があります。"*" はすべてのリソースに一致し、存在する場合は唯一のエントリーである必要があります。必須。

verbs

array (string)

動詞 は一致する動詞のリストであり、空にすることはできません。"*" はすべての動詞に一致し、存在する場合は唯一のエントリーである必要があります。必須。

group

object

GroupSubject は、グループの種類のサブジェクトの詳細情報を保持します。

kind

string

kind は、他のフィールドのどれが空でないかを示します。必須

serviceAccount

object

ServiceAccountSubject は、service-account-kind サブジェクトの詳細情報を保持します。

user

object

UserSubject は、ユーザーの種類のサブジェクトに関する詳細情報を保持します。

name

string

name は一致するユーザーグループ、"*" はすべてのユーザーグループに一致します。よく知られているグループ名は、https://github.com/kubernetes/apiserver/blob/master/pkg/authentication/user/user.go を参照してください。必須。

name

string

name は一致する ServiceAccount オブジェクトの名前、または名前に関係なく一致する場合は "*" です。必須。

namespace

string

namespace は、一致する ServiceAccount オブジェクトの namespace です。必須。

name

string

name は一致するユーザー名、すべてのユーザー名に一致する場合は "*" です。必須。

conditions

array

条件 は、FlowSchema の現在の状態のリストです。

conditions[]

object

FlowSchemaCondition は、FlowSchema の条件を記述します。

lastTransitionTime

Time

lastTransitionTime は、ある状態から別の状態に最後に遷移した時間です。

message

string

message は、最後の遷移に関する詳細を示す人間が判読できるメッセージです。

reason

string

理由 は、条件の最後の遷移の一意の 1 単語の CamelCase 理由です。

status

string

status は、状態のステータスです。True、False、Unknown の場合があります。必須。

type

string

type は、条件のタイプです。必須。