Module auditregistration/v1alpha1

apiVersion: string;

APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#resources

kind: string;

Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

metadata: ObjectMeta;

spec: AuditSinkSpec;

Spec defines the audit configuration spec

apiVersion: string;

APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#resources

items: AuditSink[];

List of audit configurations.

kind: string;

Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

metadata: ListMeta;

policy: Policy;

Policy defines the policy for selecting which events should be sent to the webhook required

webhook: Webhook;

Webhook to send events required

level: string;

The Level that all requests are recorded at. available options: None, Metadata, Request, RequestResponse required

stages: string[];

Stages is a list of stages for which events are created.

name: string;

name is the name of the service. Required

namespace: string;

namespace is the namespace of the service. Required

path: string;

path is an optional URL path which will be sent in any request to this service.

clientConfig: WebhookClientConfig;

ClientConfig holds the connection parameters for the webhook required

throttle: WebhookThrottleConfig;

Throttle holds the options for throttling the webhook

caBundle: string;

caBundle is a PEM encoded CA bundle which will be used to validate the webhook’s server certificate. If unspecified, system trust roots on the apiserver are used.

service: ServiceReference;

service is a reference to the service for this webhook. Either service or url must be specified.

If the webhook is running within the cluster, then you should use service.

Port 443 will be used if it is open, otherwise it is an error.

url: string;

url gives the location of the webhook, in standard URL form (scheme://host:port/path). Exactly one of url or service must be specified.

The host should not refer to a service running in the cluster; use the service field instead. The host might be resolved via external DNS in some apiservers (e.g., kube-apiserver cannot resolve in-cluster DNS as that would be a layering violation). host may also be an IP address.

Please note that using localhost or 127.0.0.1 as a host is risky unless you take great care to run this webhook on all hosts which run an apiserver which might need to make calls to this webhook. Such installs are likely to be non-portable, i.e., not easy to turn up in a new cluster.

The scheme must be “https”; the URL must begin with “https://”.

A path is optional, and if present may be any string permissible in a URL. You may use the path to pass an arbitrary string to the webhook, for example, a cluster identifier.

Attempting to use a user or basic auth e.g. “user:password@” is not allowed. Fragments (“#…”) and query parameters (“?…”) are not allowed, either.

burst: number;

ThrottleBurst is the maximum number of events sent at the same moment default 15 QPS

qps: number;

ThrottleQPS maximum number of batches per second default 10 QPS