kubernetes: k8s.io/kubernetes/pkg/apis/flowcontrol Index | Files | Directories

package flowcontrol

import "k8s.io/kubernetes/pkg/apis/flowcontrol"

Package flowcontrol provides api definitions for the "flowcontrol.apiserver.k8s.io" api group.

Index

Package Files

doc.go register.go types.go zz_generated.deepcopy.go

Constants

const (
    APIGroupAll    = "*"
    ResourceAll    = "*"
    VerbAll        = "*"
    NonResourceAll = "*"
    NameAll        = "*"

    NamespaceEvery = "*" // matches every particular namespace
)

These are valid wildcards.

const (
    PriorityLevelConfigurationNameExempt   = "exempt"
    PriorityLevelConfigurationNameCatchAll = "catch-all"
    FlowSchemaNameExempt                   = "exempt"
    FlowSchemaNameCatchAll                 = "catch-all"
)

System preset priority level names

const (
    FlowSchemaConditionDangling = "Dangling"

    PriorityLevelConfigurationConditionConcurrencyShared = "ConcurrencyShared"
)

Conditions

const (
    FlowSchemaMaxMatchingPrecedence int32 = 10000
)

Constants used by api validation.

const GroupName = "flowcontrol.apiserver.k8s.io"

GroupName is the name of api group

Variables

var (
    // SchemeBuilder installs the api group to a scheme
    SchemeBuilder = runtime.NewSchemeBuilder(addKnownTypes)
    // AddToScheme adds api to a scheme
    AddToScheme = SchemeBuilder.AddToScheme
)
var SchemeGroupVersion = schema.GroupVersion{Group: GroupName, Version: runtime.APIVersionInternal}

SchemeGroupVersion is group version used to register these objects

func Kind Uses

func Kind(kind string) schema.GroupKind

Kind takes an unqualified kind and returns a Group qualified GroupKind

func Resource Uses

func Resource(resource string) schema.GroupResource

Resource takes an unqualified resource and returns a Group qualified GroupResource

type ConditionStatus Uses

type ConditionStatus string

ConditionStatus is the status of the condition.

const (
    ConditionTrue    ConditionStatus = "True"
    ConditionFalse   ConditionStatus = "False"
    ConditionUnknown ConditionStatus = "Unknown"
)

These are valid condition statuses. "ConditionTrue" means a resource is in the condition. "ConditionFalse" means a resource is not in the condition. "ConditionUnknown" means kubernetes can't decide if a resource is in the condition or not. In the future, we could add other intermediate conditions, e.g. ConditionDegraded.

type FlowDistinguisherMethod Uses

type FlowDistinguisherMethod struct {
    // `type` is the type of flow distinguisher method
    // The supported types are "ByUser" and "ByNamespace".
    // Required.
    Type FlowDistinguisherMethodType
}

FlowDistinguisherMethod specifies the method of a flow distinguisher.

func (*FlowDistinguisherMethod) DeepCopy Uses

func (in *FlowDistinguisherMethod) DeepCopy() *FlowDistinguisherMethod

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FlowDistinguisherMethod.

func (*FlowDistinguisherMethod) DeepCopyInto Uses

func (in *FlowDistinguisherMethod) DeepCopyInto(out *FlowDistinguisherMethod)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type FlowDistinguisherMethodType Uses

type FlowDistinguisherMethodType string

FlowDistinguisherMethodType is the type of flow distinguisher method

const (
    // FlowDistinguisherMethodByUserType specifies that the flow distinguisher is the username in the request.
    // This type is used to provide some insulation between users.
    FlowDistinguisherMethodByUserType FlowDistinguisherMethodType = "ByUser"

    // FlowDistinguisherMethodByNamespaceType specifies that the flow distinguisher is the namespace of the
    // object that the request acts upon. If the object is not namespaced, or if the request is a non-resource
    // request, then the distinguisher will be the empty string. An example usage of this type is to provide
    // some insulation between tenants in a situation where there are multiple tenants and each namespace
    // is dedicated to a tenant.
    FlowDistinguisherMethodByNamespaceType FlowDistinguisherMethodType = "ByNamespace"
)

These are valid flow-distinguisher methods.

type FlowSchema Uses

type FlowSchema struct {
    metav1.TypeMeta
    // `metadata` is the standard object's metadata.
    // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata
    // +optional
    metav1.ObjectMeta
    // `spec` is the specification of the desired behavior of a FlowSchema.
    // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status
    // +optional
    Spec FlowSchemaSpec
    // `status` is the current status of a FlowSchema.
    // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status
    // +optional
    Status FlowSchemaStatus
}

FlowSchema defines the schema of a group of flows. Note that a flow is made up of a set of inbound API requests with similar attributes and is identified by a pair of strings: the name of the FlowSchema and a "flow distinguisher".

func (*FlowSchema) DeepCopy Uses

func (in *FlowSchema) DeepCopy() *FlowSchema

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FlowSchema.

func (*FlowSchema) DeepCopyInto Uses

func (in *FlowSchema) DeepCopyInto(out *FlowSchema)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*FlowSchema) DeepCopyObject Uses

func (in *FlowSchema) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

type FlowSchemaCondition Uses

type FlowSchemaCondition struct {
    // `type` is the type of the condition.
    // Required.
    Type FlowSchemaConditionType
    // `status` is the status of the condition.
    // Can be True, False, Unknown.
    // Required.
    Status ConditionStatus
    // `lastTransitionTime` is the last time the condition transitioned from one status to another.
    LastTransitionTime metav1.Time
    // `reason` is a unique, one-word, CamelCase reason for the condition's last transition.
    Reason string
    // `message` is a human-readable message indicating details about last transition.
    Message string
}

FlowSchemaCondition describes conditions for a FlowSchema.

func (*FlowSchemaCondition) DeepCopy Uses

func (in *FlowSchemaCondition) DeepCopy() *FlowSchemaCondition

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FlowSchemaCondition.

func (*FlowSchemaCondition) DeepCopyInto Uses

func (in *FlowSchemaCondition) DeepCopyInto(out *FlowSchemaCondition)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type FlowSchemaConditionType Uses

type FlowSchemaConditionType string

FlowSchemaConditionType is a valid value for FlowSchemaStatusCondition.Type

type FlowSchemaList Uses

type FlowSchemaList struct {
    metav1.TypeMeta
    // `metadata` is the standard list metadata.
    // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata
    // +optional
    metav1.ListMeta

    // `items` is a list of FlowSchemas.
    Items []FlowSchema
}

FlowSchemaList is a list of FlowSchema objects.

func (*FlowSchemaList) DeepCopy Uses

func (in *FlowSchemaList) DeepCopy() *FlowSchemaList

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FlowSchemaList.

func (*FlowSchemaList) DeepCopyInto Uses

func (in *FlowSchemaList) DeepCopyInto(out *FlowSchemaList)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*FlowSchemaList) DeepCopyObject Uses

func (in *FlowSchemaList) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

type FlowSchemaSpec Uses

type FlowSchemaSpec struct {
    // `priorityLevelConfiguration` should reference a PriorityLevelConfiguration in the cluster. If the reference cannot
    // be resolved, the FlowSchema will be ignored and marked as invalid in its status.
    // Required.
    PriorityLevelConfiguration PriorityLevelConfigurationReference
    // `matchingPrecedence` is used to choose among the FlowSchemas that match a given request. The chosen
    // FlowSchema is among those with the numerically lowest (which we take to be logically highest)
    // MatchingPrecedence.  Each MatchingPrecedence value must be ranged in [1,10000].
    // Note that if the precedence is not specified, it will be set to 1000 as default.
    // +optional
    MatchingPrecedence int32
    // `distinguisherMethod` defines how to compute the flow distinguisher for requests that match this schema.
    // `nil` specifies that the distinguisher is disabled and thus will always be the empty string.
    // +optional
    DistinguisherMethod *FlowDistinguisherMethod
    // `rules` describes which requests will match this flow schema. This FlowSchema matches a request if and only if
    // at least one member of rules matches the request.
    // if it is an empty slice, there will be no requests matching the FlowSchema.
    // +listType=set
    // +optional
    Rules []PolicyRulesWithSubjects
}

FlowSchemaSpec describes how the FlowSchema's specification looks like.

func (*FlowSchemaSpec) DeepCopy Uses

func (in *FlowSchemaSpec) DeepCopy() *FlowSchemaSpec

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FlowSchemaSpec.

func (*FlowSchemaSpec) DeepCopyInto Uses

func (in *FlowSchemaSpec) DeepCopyInto(out *FlowSchemaSpec)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type FlowSchemaStatus Uses

type FlowSchemaStatus struct {
    // `conditions` is a list of the current states of FlowSchema.
    // +listType=map
    // +listMapKey=type
    // +optional
    Conditions []FlowSchemaCondition
}

FlowSchemaStatus represents the current state of a FlowSchema.

func (*FlowSchemaStatus) DeepCopy Uses

func (in *FlowSchemaStatus) DeepCopy() *FlowSchemaStatus

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FlowSchemaStatus.

func (*FlowSchemaStatus) DeepCopyInto Uses

func (in *FlowSchemaStatus) DeepCopyInto(out *FlowSchemaStatus)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type GroupSubject Uses

type GroupSubject struct {
    // name is the user group that matches, or "*" to match all user groups.
    // See https://github.com/kubernetes/apiserver/blob/master/pkg/authentication/user/user.go for some
    // well-known group names.
    // Required.
    Name string
}

GroupSubject holds detailed information for group-kind subject.

func (*GroupSubject) DeepCopy Uses

func (in *GroupSubject) DeepCopy() *GroupSubject

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new GroupSubject.

func (*GroupSubject) DeepCopyInto Uses

func (in *GroupSubject) DeepCopyInto(out *GroupSubject)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type LimitResponse Uses

type LimitResponse struct {
    // `type` is "Queue" or "Reject".
    // "Queue" means that requests that can not be executed upon arrival
    // are held in a queue until they can be executed or a queuing limit
    // is reached.
    // "Reject" means that requests that can not be executed upon arrival
    // are rejected.
    // Required.
    // +unionDiscriminator
    Type LimitResponseType

    // `queuing` holds the configuration parameters for queuing.
    // This field may be non-empty only if `type` is `"Queue"`.
    // +optional
    Queuing *QueuingConfiguration
}

LimitResponse defines how to handle requests that can not be executed right now. +union

func (*LimitResponse) DeepCopy Uses

func (in *LimitResponse) DeepCopy() *LimitResponse

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new LimitResponse.

func (*LimitResponse) DeepCopyInto Uses

func (in *LimitResponse) DeepCopyInto(out *LimitResponse)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type LimitResponseType Uses

type LimitResponseType string

LimitResponseType identifies how a Limited priority level handles a request that can not be executed right now

const (
    // LimitResponseTypeQueue means that requests that can not be executed right now are queued until they can be executed or a queuing limit is hit
    LimitResponseTypeQueue LimitResponseType = "Queue"

    // LimitResponseTypeReject means that requests that can not be executed right now are rejected
    LimitResponseTypeReject LimitResponseType = "Reject"
)

Supported limit responses.

type LimitedPriorityLevelConfiguration Uses

type LimitedPriorityLevelConfiguration struct {
    // `assuredConcurrencyShares` (ACS) configures the execution
    // limit, which is a limit on the number of requests of this
    // priority level that may be exeucting at a given time.  ACS must
    // be a positive number. The server's concurrency limit (SCL) is
    // divided among the concurrency-controlled priority levels in
    // proportion to their assured concurrency shares. This produces
    // the assured concurrency value (ACV) --- the number of requests
    // that may be executing at a time --- for each such priority
    // level:
    //
    //             ACV(l) = ceil( SCL * ACS(l) / ( sum[priority levels k] ACS(k) ) )
    //
    // bigger numbers of ACS mean more reserved concurrent requests (at the
    // expense of every other PL).
    // This field has a default value of 30.
    // +optional
    AssuredConcurrencyShares int32

    // `limitResponse` indicates what to do with requests that can not be executed right now
    LimitResponse LimitResponse
}

LimitedPriorityLevelConfiguration specifies how to handle requests that are subject to limits. It addresses two issues:

* How are requests for this priority level limited?
* What should be done with requests that exceed the limit?

func (*LimitedPriorityLevelConfiguration) DeepCopy Uses

func (in *LimitedPriorityLevelConfiguration) DeepCopy() *LimitedPriorityLevelConfiguration

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new LimitedPriorityLevelConfiguration.

func (*LimitedPriorityLevelConfiguration) DeepCopyInto Uses

func (in *LimitedPriorityLevelConfiguration) DeepCopyInto(out *LimitedPriorityLevelConfiguration)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type NonResourcePolicyRule Uses

type NonResourcePolicyRule struct {
    // `verbs` is a list of matching verbs and may not be empty.
    // "*" matches all verbs. If it is present, it must be the only entry.
    // +listType=set
    // Required.
    Verbs []string
    // `nonResourceURLs` is a set of url prefixes that a user should have access to and may not be empty.
    // For example:
    //   - "/healthz" is legal
    //   - "/hea*" is illegal
    //   - "/hea" is legal but matches nothing
    //   - "/hea/*" also matches nothing
    //   - "/healthz/*" matches all per-component health checks.
    // "*" matches all non-resource urls. if it is present, it must be the only entry.
    // +listType=set
    // Required.
    NonResourceURLs []string
}

NonResourcePolicyRule is a predicate that matches non-resource requests according to their verb and the target non-resource URL. A NonResourcePolicyRule matches a request if and only if both (a) at least one member of verbs matches the request and (b) at least one member of nonResourceURLs matches the request.

func (*NonResourcePolicyRule) DeepCopy Uses

func (in *NonResourcePolicyRule) DeepCopy() *NonResourcePolicyRule

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new NonResourcePolicyRule.

func (*NonResourcePolicyRule) DeepCopyInto Uses

func (in *NonResourcePolicyRule) DeepCopyInto(out *NonResourcePolicyRule)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type PolicyRulesWithSubjects Uses

type PolicyRulesWithSubjects struct {
    // subjects is the list of normal user, serviceaccount, or group that this rule cares about.
    // There must be at least one member in this slice.
    // A slice that includes both the system:authenticated and system:unauthenticated user groups matches every request.
    // +listType=set
    // Required.
    Subjects []Subject
    // `resourceRules` is a slice of ResourcePolicyRules that identify matching requests according to their verb and the
    // target resource.
    // At least one of `resourceRules` and `nonResourceRules` has to be non-empty.
    // +listType=set
    // +optional
    ResourceRules []ResourcePolicyRule
    // `nonResourceRules` is a list of NonResourcePolicyRules that identify matching requests according to their verb
    // and the target non-resource URL.
    // +listType=set
    // +optional
    NonResourceRules []NonResourcePolicyRule
}

PolicyRulesWithSubjects prescribes a test that applies to a request to an apiserver. The test considers the subject making the request, the verb being requested, and the resource to be acted upon. This PolicyRulesWithSubjects matches a request if and only if both (a) at least one member of subjects matches the request and (b) at least one member of resourceRules or nonResourceRules matches the request.

func (*PolicyRulesWithSubjects) DeepCopy Uses

func (in *PolicyRulesWithSubjects) DeepCopy() *PolicyRulesWithSubjects

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new PolicyRulesWithSubjects.

func (*PolicyRulesWithSubjects) DeepCopyInto Uses

func (in *PolicyRulesWithSubjects) DeepCopyInto(out *PolicyRulesWithSubjects)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type PriorityLevelConfiguration Uses

type PriorityLevelConfiguration struct {
    metav1.TypeMeta
    // `metadata` is the standard object's metadata.
    // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata
    // +optional
    metav1.ObjectMeta
    // `spec` is the specification of the desired behavior of a "request-priority".
    // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status
    // +optional
    Spec PriorityLevelConfigurationSpec
    // `status` is the current status of a "request-priority".
    // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status
    // +optional
    Status PriorityLevelConfigurationStatus
}

PriorityLevelConfiguration represents the configuration of a priority level.

func (*PriorityLevelConfiguration) DeepCopy Uses

func (in *PriorityLevelConfiguration) DeepCopy() *PriorityLevelConfiguration

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new PriorityLevelConfiguration.

func (*PriorityLevelConfiguration) DeepCopyInto Uses

func (in *PriorityLevelConfiguration) DeepCopyInto(out *PriorityLevelConfiguration)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*PriorityLevelConfiguration) DeepCopyObject Uses

func (in *PriorityLevelConfiguration) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

type PriorityLevelConfigurationCondition Uses

type PriorityLevelConfigurationCondition struct {
    // `type` is the type of the condition.
    // Required.
    Type PriorityLevelConfigurationConditionType
    // `status` is the status of the condition.
    // Can be True, False, Unknown.
    // Required.
    Status ConditionStatus
    // `lastTransitionTime` is the last time the condition transitioned from one status to another.
    LastTransitionTime metav1.Time
    // `reason` is a unique, one-word, CamelCase reason for the condition's last transition.
    Reason string
    // `message` is a human-readable message indicating details about last transition.
    Message string
}

PriorityLevelConfigurationCondition defines the condition of priority level.

func (*PriorityLevelConfigurationCondition) DeepCopy Uses

func (in *PriorityLevelConfigurationCondition) DeepCopy() *PriorityLevelConfigurationCondition

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new PriorityLevelConfigurationCondition.

func (*PriorityLevelConfigurationCondition) DeepCopyInto Uses

func (in *PriorityLevelConfigurationCondition) DeepCopyInto(out *PriorityLevelConfigurationCondition)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type PriorityLevelConfigurationConditionType Uses

type PriorityLevelConfigurationConditionType string

PriorityLevelConfigurationConditionType is a valid value for PriorityLevelConfigurationStatusCondition.Type

type PriorityLevelConfigurationList Uses

type PriorityLevelConfigurationList struct {
    metav1.TypeMeta
    // `metadata` is the standard object's metadata.
    // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata
    // +optional
    metav1.ListMeta
    // `items` is a list of request-priorities.
    Items []PriorityLevelConfiguration
}

PriorityLevelConfigurationList is a list of PriorityLevelConfiguration objects.

func (*PriorityLevelConfigurationList) DeepCopy Uses

func (in *PriorityLevelConfigurationList) DeepCopy() *PriorityLevelConfigurationList

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new PriorityLevelConfigurationList.

func (*PriorityLevelConfigurationList) DeepCopyInto Uses

func (in *PriorityLevelConfigurationList) DeepCopyInto(out *PriorityLevelConfigurationList)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*PriorityLevelConfigurationList) DeepCopyObject Uses

func (in *PriorityLevelConfigurationList) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

type PriorityLevelConfigurationReference Uses

type PriorityLevelConfigurationReference struct {
    // `name` is the name of the priority level configuration being referenced
    // Required.
    Name string
}

PriorityLevelConfigurationReference contains information that points to the "request-priority" being used.

func (*PriorityLevelConfigurationReference) DeepCopy Uses

func (in *PriorityLevelConfigurationReference) DeepCopy() *PriorityLevelConfigurationReference

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new PriorityLevelConfigurationReference.

func (*PriorityLevelConfigurationReference) DeepCopyInto Uses

func (in *PriorityLevelConfigurationReference) DeepCopyInto(out *PriorityLevelConfigurationReference)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type PriorityLevelConfigurationSpec Uses

type PriorityLevelConfigurationSpec struct {
    // `type` indicates whether this priority level is subject to
    // limitation on request execution.  A value of `"Exempt"` means
    // that requests of this priority level are not subject to a limit
    // (and thus are never queued) and do not detract from the
    // capacity made available to other priority levels.  A value of
    // `"Limited"` means that (a) requests of this priority level
    // _are_ subject to limits and (b) some of the server's limited
    // capacity is made available exclusively to this priority level.
    // Required.
    // +unionDiscriminator
    Type PriorityLevelEnablement

    // `limited` specifies how requests are handled for a Limited priority level.
    // This field must be non-empty if and only if `type` is `"Limited"`.
    // +optional
    Limited *LimitedPriorityLevelConfiguration
}

PriorityLevelConfigurationSpec specifies the configuration of a priority level. +union

func (*PriorityLevelConfigurationSpec) DeepCopy Uses

func (in *PriorityLevelConfigurationSpec) DeepCopy() *PriorityLevelConfigurationSpec

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new PriorityLevelConfigurationSpec.

func (*PriorityLevelConfigurationSpec) DeepCopyInto Uses

func (in *PriorityLevelConfigurationSpec) DeepCopyInto(out *PriorityLevelConfigurationSpec)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type PriorityLevelConfigurationStatus Uses

type PriorityLevelConfigurationStatus struct {
    // `conditions` is the current state of "request-priority".
    // +listType=map
    // +listMapKey=type
    // +optional
    Conditions []PriorityLevelConfigurationCondition
}

PriorityLevelConfigurationStatus represents the current state of a "request-priority".

func (*PriorityLevelConfigurationStatus) DeepCopy Uses

func (in *PriorityLevelConfigurationStatus) DeepCopy() *PriorityLevelConfigurationStatus

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new PriorityLevelConfigurationStatus.

func (*PriorityLevelConfigurationStatus) DeepCopyInto Uses

func (in *PriorityLevelConfigurationStatus) DeepCopyInto(out *PriorityLevelConfigurationStatus)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type PriorityLevelEnablement Uses

type PriorityLevelEnablement string

PriorityLevelEnablement indicates whether limits on execution are enabled for the priority level

const (
    // PriorityLevelEnablementExempt means that requests are not subject to limits
    PriorityLevelEnablementExempt PriorityLevelEnablement = "Exempt"

    // PriorityLevelEnablementLimited means that requests are subject to limits
    PriorityLevelEnablementLimited PriorityLevelEnablement = "Limited"
)

Supported priority level enablement values.

type QueuingConfiguration Uses

type QueuingConfiguration struct {
    // `queues` is the number of queues for this priority level. The
    // queues exist independently at each apiserver. The value must be
    // positive.  Setting it to 1 effectively precludes
    // shufflesharding and thus makes the distinguisher method of
    // associated flow schemas irrelevant.  This field has a default
    // value of 64.
    // +optional
    Queues int32

    // `handSize` is a small positive number that configures the
    // shuffle sharding of requests into queues.  When enqueuing a request
    // at this priority level the request's flow identifier (a string
    // pair) is hashed and the hash value is used to shuffle the list
    // of queues and deal a hand of the size specified here.  The
    // request is put into one of the shortest queues in that hand.
    // `handSize` must be no larger than `queues`, and should be
    // significantly smaller (so that a few heavy flows do not
    // saturate most of the queues).  See the user-facing
    // documentation for more extensive guidance on setting this
    // field.  This field has a default value of 8.
    // +optional
    HandSize int32

    // `queueLengthLimit` is the maximum number of requests allowed to
    // be waiting in a given queue of this priority level at a time;
    // excess requests are rejected.  This value must be positive.  If
    // not specified, it will be defaulted to 50.
    // +optional
    QueueLengthLimit int32
}

QueuingConfiguration holds the configuration parameters for queuing

func (*QueuingConfiguration) DeepCopy Uses

func (in *QueuingConfiguration) DeepCopy() *QueuingConfiguration

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new QueuingConfiguration.

func (*QueuingConfiguration) DeepCopyInto Uses

func (in *QueuingConfiguration) DeepCopyInto(out *QueuingConfiguration)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type ResourcePolicyRule Uses

type ResourcePolicyRule struct {
    // `verbs` is a list of matching verbs and may not be empty.
    // "*" matches all verbs and, if present, must be the only entry.
    // +listType=set
    // Required.
    Verbs []string

    // `apiGroups` is a list of matching API groups and may not be empty.
    // "*" matches all API groups and, if present, must be the only entry.
    // +listType=set
    // Required.
    APIGroups []string

    // `resources` is a list of matching resources (i.e., lowercase
    // and plural) with, if desired, subresource.  For example, [
    // "services", "nodes/status" ].  This list may not be empty.
    // "*" matches all resources and, if present, must be the only entry.
    // Required.
    // +listType=set
    Resources []string

    // `clusterScope` indicates whether to match requests that do not
    // specify a namespace (which happens either because the resource
    // is not namespaced or the request targets all namespaces).
    // If this field is omitted or false then the `namespaces` field
    // must contain a non-empty list.
    // +optional
    ClusterScope bool

    // `namespaces` is a list of target namespaces that restricts
    // matches.  A request that specifies a target namespace matches
    // only if either (a) this list contains that target namespace or
    // (b) this list contains "*".  Note that "*" matches any
    // specified namespace but does not match a request that _does
    // not specify_ a namespace (see the `clusterScope` field for
    // that).
    // This list may be empty, but only if `clusterScope` is true.
    // +optional
    // +listType=set
    Namespaces []string
}

ResourcePolicyRule is a predicate that matches some resource requests, testing the request's verb and the target resource. A ResourcePolicyRule matches a resource request if and only if: (a) at least one member of verbs matches the request, (b) at least one member of apiGroups matches the request, (c) at least one member of resources matches the request, and (d) least one member of namespaces matches the request.

func (*ResourcePolicyRule) DeepCopy Uses

func (in *ResourcePolicyRule) DeepCopy() *ResourcePolicyRule

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ResourcePolicyRule.

func (*ResourcePolicyRule) DeepCopyInto Uses

func (in *ResourcePolicyRule) DeepCopyInto(out *ResourcePolicyRule)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type ServiceAccountSubject Uses

type ServiceAccountSubject struct {
    // `namespace` is the namespace of matching ServiceAccount objects.
    // Required.
    Namespace string
    // `name` is the name of matching ServiceAccount objects, or "*" to match regardless of name.
    // Required.
    Name string
}

ServiceAccountSubject holds detailed information for service-account-kind subject.

func (*ServiceAccountSubject) DeepCopy Uses

func (in *ServiceAccountSubject) DeepCopy() *ServiceAccountSubject

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ServiceAccountSubject.

func (*ServiceAccountSubject) DeepCopyInto Uses

func (in *ServiceAccountSubject) DeepCopyInto(out *ServiceAccountSubject)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type Subject Uses

type Subject struct {
    // Required
    // +unionDiscriminator
    Kind SubjectKind
    // +optional
    User *UserSubject
    // +optional
    Group *GroupSubject
    // +optional
    ServiceAccount *ServiceAccountSubject
}

Subject matches the originator of a request, as identified by the request authentication system. There are three ways of matching an originator; by user, group, or service account. +union

func (*Subject) DeepCopy Uses

func (in *Subject) DeepCopy() *Subject

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Subject.

func (*Subject) DeepCopyInto Uses

func (in *Subject) DeepCopyInto(out *Subject)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type SubjectKind Uses

type SubjectKind string

SubjectKind is the kind of subject.

const (
    SubjectKindUser           SubjectKind = "User"
    SubjectKindGroup          SubjectKind = "Group"
    SubjectKindServiceAccount SubjectKind = "ServiceAccount"
)

Supported subject's kinds.

type UserSubject Uses

type UserSubject struct {
    // `name` is the username that matches, or "*" to match all usernames.
    // Required.
    Name string
}

UserSubject holds detailed information for user-kind subject.

func (*UserSubject) DeepCopy Uses

func (in *UserSubject) DeepCopy() *UserSubject

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new UserSubject.

func (*UserSubject) DeepCopyInto Uses

func (in *UserSubject) DeepCopyInto(out *UserSubject)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

Directories

PathSynopsis
installPackage install installs the experimental API group, making it available as an option to all of the API encoding/decoding machinery.
internalbootstrap
util
v1alpha1
validation

Package flowcontrol imports 3 packages (graph) and is imported by 29 packages. Updated 2020-09-06. Refresh now. Tools for package owners.