扩展资源

401: Unauthorized

`get` 读取指定 CustomResourceDefinition 的状态

HTTP 请求

GET /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}/status

参数

name （路径参数）：string，必需

CustomResourceDefinition 的名称。
pretty （查询参数）：string

pretty

响应

401: Unauthorized

`list` 列出或观察 CustomResourceDefinition 类型的对象

HTTP 请求

GET /apis/apiextensions.k8s.io/v1/customresourcedefinitions

参数

allowWatchBookmarks （查询参数）：boolean

allowWatchBookmarks
continue （查询参数）：string

continue
fieldSelector （查询参数）：string

fieldSelector
labelSelector （查询参数）：string

labelSelector
limit （查询参数）：integer

limit
pretty （查询参数）：string

pretty
resourceVersion （查询参数）：string

resourceVersion
resourceVersionMatch （查询参数）：string

resourceVersionMatch
sendInitialEvents （查询参数）: boolean

sendInitialEvents
timeoutSeconds （查询参数）：integer

timeoutSeconds
watch （查询参数）：boolean

watch

响应

200 (CustomResourceDefinitionList): OK

401: Unauthorized

`create` 创建一个 CustomResourceDefinition

HTTP 请求

POST /apis/apiextensions.k8s.io/v1/customresourcedefinitions

参数

body：CustomResourceDefinition，必需
dryRun （查询参数）：string

dryRun
fieldManager （查询参数）：string

fieldManager
fieldValidation （查询参数）：string

fieldValidation
pretty （查询参数）：string

pretty

响应

201 (CustomResourceDefinition): Created

202 (CustomResourceDefinition): Accepted

401: Unauthorized

`update` 替换指定的 CustomResourceDefinition

HTTP 请求

PUT /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}

参数

name （路径参数）：string，必需

CustomResourceDefinition 的名称。
body：CustomResourceDefinition，必需
dryRun （查询参数）：string

dryRun
fieldManager （查询参数）：string

fieldManager
fieldValidation （查询参数）：string

fieldValidation
pretty （查询参数）：string

pretty

响应

201 (CustomResourceDefinition): Created

401: Unauthorized

`update` 替换指定 CustomResourceDefinition 的状态

HTTP 请求

PUT /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}/status

参数

name （路径参数）：string，必需

CustomResourceDefinition 的名称。
body：CustomResourceDefinition，必需
dryRun （查询参数）：string

dryRun
fieldManager （查询参数）：string

fieldManager
fieldValidation （查询参数）：string

fieldValidation
pretty （查询参数）：string

pretty

响应

201 (CustomResourceDefinition): Created

401: Unauthorized

`patch` 部分更新指定的 CustomResourceDefinition

HTTP 请求

PATCH /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}

参数

name （路径参数）：string，必需

CustomResourceDefinition 的名称。
body：Patch，必需
dryRun （查询参数）：string

dryRun
fieldManager （查询参数）：string

fieldManager
fieldValidation （查询参数）：string

fieldValidation
force （查询参数）：boolean

force
pretty（查询参数）：string

pretty

响应

201 (CustomResourceDefinition): Created

401: Unauthorized

`patch` 部分更新指定 CustomResourceDefinition 的状态

HTTP 请求

PATCH /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}/status

参数

name （路径参数）：string，必需

CustomResourceDefinition 的名称。
body：Patch，必需
dryRun （查询参数）：string

dryRun
fieldManager （查询参数）：string

fieldManager
fieldValidation （查询参数）：string

fieldValidation
force （查询参数）：boolean

force
pretty （查询参数）：string

pretty

响应

201 (CustomResourceDefinition): Created

401: Unauthorized

`delete` 删除一个 CustomResourceDefinition

HTTP 请求

DELETE /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}

参数

name （路径参数）：string，必需

CustomResourceDefinition 的名称。
body：DeleteOptions
dryRun （查询参数）：string

dryRun
gracePeriodSeconds （查询参数）：integer

gracePeriodSeconds
pretty （查询参数）：string

pretty
propagationPolicy （查询参数）：string

propagationPolicy

响应

200 (Status): OK

202 (Status): Accepted

401: Unauthorized

`deletecollection` 删除 CustomResourceDefinition 的集合

HTTP 请求

DELETE /apis/apiextensions.k8s.io/v1/customresourcedefinitions

参数

body：DeleteOptions
continue （查询参数）：string

continue
dryRun （查询参数）：string

dryRun
fieldSelector （查询参数）：string

fieldSelector
gracePeriodSeconds （查询参数）：integer

gracePeriodSeconds
labelSelector （查询参数）：string

labelSelector
limit （查询参数）：integer

limit
pretty （查询参数）：string

pretty
propagationPolicy （查询参数）：string

propagationPolicy
resourceVersion （查询参数）：string

resourceVersion
resourceVersionMatch （查询参数）：string

resourceVersionMatch
sendInitialEvents （查询参数）: boolean

sendInitialEvents
timeoutSeconds （查询参数）：integer

timeoutSeconds

响应

200 (Status): OK

401: Unauthorized

2 - DeviceClass v1alpha3

DeviceClass 是由供应商或管理员提供的资源，包含设备配置和选择算符。

apiVersion: resource.k8s.io/v1alpha3

import "k8s.io/api/resource/v1alpha3"

DeviceClass

DeviceClass 是由供应商或管理员提供的资源，包含设备配置和选择算符。它可以在申领的设备请求中被引用，以应用预设值。作用域为集群范围。

这是一个 Alpha 阶段的资源类别，需要启用 DynamicResourceAllocation 特性门控。

apiVersion: resource.k8s.io/v1alpha3
kind: DeviceClass

metadata (ObjectMeta)

标准的对象元数据。

spec (DeviceClassSpec)，必需

spec 定义什么可以被分配以及如何进行配置。

此字段是可变更的。消费者必须准备好应对随时会变更的类，变更的原因可能是被更新或被替换。申领分配是基于分配之时类中所设置的内容而确定的。

变更 spec 会让 metadata.generation 编号自动递增。

DeviceClassSpec

DeviceClassSpec 在 DeviceClass 中用于定义可以分配的资源及其配置方式。

config ([]DeviceClassConfiguration)

原子：将在合并期间被替换

config 定义通过此类申领的、适用于每台设备的配置参数。某些类可能会由多个驱动所满足，因此每个供应商配置的实例仅适用于一个驱动。

这些配置参数被传递给驱动，但在分配申领时不考虑这些配置参数。

DeviceClassConfiguration 在 DeviceClass 中使用。
- config.opaque (OpaqueDeviceConfiguration)
  
  opaque 提供特定于驱动的配置参数。
  
  OpaqueDeviceConfiguration 以驱动供应商所定义的格式提供驱动的配置参数。
  - config.opaque.driver (string)，必需
    
    driver 用于确定需要将这些配置参数传递给哪个 kubelet 插件。
    
    驱动开发者所提供的准入策略可以使用此字段来决定是否需要校验这些参数。
    
    必须是一个 DNS 子域，并且应以驱动供应商拥有的 DNS 域结尾。
  - config.opaque.parameters (RawExtension)，必需
    
    parameters 可以包含任意数据。处理校验和版本控制是驱动开发者的责任。通常这包括自我识别和版本化管理（对 Kubernetes 而言即 "kind" + "apiVersion"），并在不同版本之间进行转换。
    
    RawExtension 用于以外部版本来保存扩展数据。
    
    要使用它，请生成一个字段，在外部、版本化结构中以 RawExtension 作为其类型，在内部结构中以 Object 作为其类型。你还需要注册你的各个插件类型。
    
    // 内部包：
```
type MyAPIObject struct {
  runtime.TypeMeta `json:",inline"`
  MyPlugin runtime.Object `json:"myPlugin"`
}

type PluginA struct {
  AOption string `json:"aOption"`
}
```
    // 外部包：
```
type MyAPIObject struct {
  runtime.TypeMeta `json:",inline"`
  MyPlugin runtime.RawExtension `json:"myPlugin"`
}

type PluginA struct {
  AOption string `json:"aOption"`
}
```
    // 在网络上，JSON 看起来像这样：
```
{
  "kind":"MyAPIObject",
  "apiVersion":"v1",
  "myPlugin": {
    "kind":"PluginA",
    "aOption":"foo",
  },
}
```
    那么会发生什么？解码首先使用 JSON 或 YAML 将序列化数据解组到你的外部 MyAPIObject 中。这会导致原始 JSON 被存储下来，但不会被解包。下一步是复制（使用 pkg/conversion）到内部结构中。 runtime 包的 DefaultScheme 安装了转换函数，它将解析存储在 RawExtension 中的 JSON，将其转换为正确的对象类型，并将其存储在 Object 中。（TODO：如果对象是未知类型，将创建并存储一个 runtime.Unknown 对象。）

selectors ([]DeviceSelector)

原子：将在合并期间被替换

每个选择算符必须由通过此类申领的设备所满足。

DeviceSelector 必须设置一个字段。
- selectors.cel (CELDeviceSelector)
  
  cel 包含用于选择设备的 CEL 表达式。
  
  CELDeviceSelector 包含用于选择设备的 CEL 表达式。
  - selectors.cel.expression (string)，必需
    
    expression 是一个 CEL 表达式，用于评估单个设备。当被考虑的设备满足所需条件时，表达式的求值结果必须为 true；当不满足时，结果应为 false。任何其他结果都是错误，会导致设备分配中止。
    
    表达式的输入是一个名为 "device" 的对象，具有以下属性：
    - driver (string)：定义此设备的驱动的名称。
    - attributes (map[string]object)：设备的属性，按前缀分组（例如，device.attributes["dra.example.com"] 评估为一个对象，包含所有以 "dra.example.com" 为前缀的属性。）
    - capacity (map[string]object)：设备的容量，按前缀分组。
    示例：考虑一个驱动为 "dra.example.com" 的设备，它暴露两个名为 "model" 和 "ext.example.com/family" 的属性，并且暴露一个名为 "modules" 的容量。此表达式的输入将具有以下字段：
```
device.driver
device.attributes["dra.example.com"].model
device.attributes["ext.example.com"].family
device.capacity["dra.example.com"].modules
```
    device.driver 字段可用于检查特定驱动，既可以作为高层次的前提条件（即你只想考虑来自此驱动的设备），也可以作为考虑来自不同驱动的设备的多子句表达式的一部分。
    
    attribute 中每个元素的值类型由设备定义，编写这些表达式的用户必须查阅其特定驱动的文档。 capacity 中元素的值类型为 Quantity。
    
    如果在 device.attributes 或 device.capacity 中使用未知前缀进行查找，将返回一个空映射。对未知字段的任何引用将导致评估错误和分配中止。
    
    一个健壮的表达式应在引用属性之前检查其是否存在。
    
    为了方便使用，cel.bind() 函数被启用，此函数可用于简化访问同一域的多个属性的表达式。例如：
```
cel.bind(dra, device.attributes["dra.example.com"], dra.someBool && dra.anotherBool)
```

suitableNodes (NodeSelector)

当 Pod 使用还未分配的申领且该申领通过控制平面控制器分配时，如果调度器在尝试查找适合 Pod 的节点，将仅考虑与选择算符匹配的节点。当申领不使用控制平面控制器进行分配时，此字段将被忽略。

设置此字段是可选的，如果不设置，则所有节点都是候选者。

这是一个 Alpha 字段，需要启用 DRAControlPlaneController 特性门控。

节点选择算符表示针对一组节点执行一个或多个标签查询的结果的并集；也就是说，它表示由节点选择算符条件表示的选择算符的逻辑或计算结果。
- suitableNodes.nodeSelectorTerms ([]NodeSelectorTerm)，必需
  
  原子：将在合并期间被替换
  
  必需。节点选择算符条件的列表。这些条件会按逻辑或的关系来计算。
  
  Null 或空的节点选择算符条件不会与任何对象匹配。这些条件会按逻辑与的关系来计算。 TopologySelectorTerm 类别实现了 NodeSelectorTerm 的子集。
  - suitableNodes.nodeSelectorTerms.matchExpressions ([]NodeSelectorRequirement)
    
    原子：将在合并期间被替换
    
    基于节点标签所设置的节点选择算符要求的列表。
  - suitableNodes.nodeSelectorTerms.matchFields ([]NodeSelectorRequirement)
    
    原子：将在合并期间被替换
    
    基于节点字段所设置的节点选择算符要求的列表。

DeviceClassList

DeviceClassList 是类的集合。

apiVersion: resource.k8s.io/v1alpha3
kind: DeviceClassList

metadata (ListMeta)

标准的列表元数据。
items ([]DeviceClass)，必需

items 是资源类的列表。

操作

`get` 读取指定的 DeviceClass

HTTP 请求

GET /apis/resource.k8s.io/v1alpha3/deviceclasses/{name}

参数

name（路径参数）：string，必需

DeviceClass 的名称。
pretty（查询参数）：string

pretty

响应

200 (DeviceClass): OK

401: Unauthorized

`list` 列举或监视 DeviceClass 类别的对象

HTTP 请求

GET /apis/resource.k8s.io/v1alpha3/deviceclasses

参数

allowWatchBookmarks (查询参数): boolean

allowWatchBookmarks
continue (查询参数): string

continue
fieldSelector (查询参数): string

fieldSelector
labelSelector (查询参数): string

labelSelector
limit (查询参数): integer

limit
pretty (查询参数): string

pretty
resourceVersion (查询参数): string

resourceVersion
resourceVersionMatch (查询参数): string

resourceVersionMatch
sendInitialEvents (查询参数): boolean

sendInitialEvents
timeoutSeconds (查询参数): integer

timeoutSeconds
watch (查询参数): boolean

watch

响应

200 (DeviceClassList): OK

401: Unauthorized

`create` 创建 DeviceClass

HTTP 请求

POST /apis/resource.k8s.io/v1alpha3/deviceclasses

参数

body: DeviceClass，必需
dryRun (查询参数): string

dryRun
fieldManager (查询参数): string

fieldManager
fieldValidation (查询参数): string

fieldValidation
pretty (查询参数): string

pretty

响应

200 (DeviceClass): OK

201 (DeviceClass): Created

202 (DeviceClass): Accepted

401: Unauthorized

`update` 替换指定的 DeviceClass

HTTP 请求

PUT /apis/resource.k8s.io/v1alpha3/deviceclasses/{name}

参数

name (路径参数): string，必需

DeviceClass 的名称。
body: DeviceClass，必需
dryRun (查询参数): string

dryRun
fieldManager (查询参数): string

fieldManager
fieldValidation (查询参数): string

fieldValidation
pretty (查询参数): string

pretty

响应

200 (DeviceClass): OK

201 (DeviceClass): Created

401: Unauthorized

`patch` 部分更新指定的 DeviceClass

HTTP 请求

PATCH /apis/resource.k8s.io/v1alpha3/deviceclasses/{name}

参数

name (路径参数): string，必需

DeviceClass 的名称。
body: Patch，必需
dryRun (查询参数): string

dryRun
fieldManager (查询参数): string

fieldManager
fieldValidation (查询参数): string

fieldValidation
force (查询参数): boolean

force
pretty (查询参数): string

pretty

响应

200 (DeviceClass): OK

201 (DeviceClass): Created

401: Unauthorized

`delete` 删除 DeviceClass

HTTP 请求

DELETE /apis/resource.k8s.io/v1alpha3/deviceclasses/{name}

参数

name (路径参数): string，必需

DeviceClass 的名称。
body: DeleteOptions
dryRun (查询参数): string

dryRun
gracePeriodSeconds (查询参数): integer

gracePeriodSeconds
pretty (查询参数): string

pretty
propagationPolicy (查询参数): string

propagationPolicy

响应

200 (DeviceClass): OK

202 (DeviceClass): Accepted

401: Unauthorized

`deletecollection` 删除 DeviceClass 的集合

HTTP 请求

DELETE /apis/resource.k8s.io/v1alpha3/deviceclasses

参数

body: DeleteOptions
continue (查询参数): string

continue
dryRun (查询参数): string

dryRun
fieldSelector (查询参数): string

fieldSelector
gracePeriodSeconds (查询参数): integer

gracePeriodSeconds
labelSelector (查询参数): string

labelSelector
limit (查询参数): integer

limit
pretty (查询参数): string

pretty
propagationPolicy (查询参数): string

propagationPolicy
resourceVersion (查询参数): string

resourceVersion
resourceVersionMatch (查询参数): string

resourceVersionMatch
sendInitialEvents (查询参数): boolean

sendInitialEvents
timeoutSeconds (查询参数): integer

timeoutSeconds

响应

200 (Status): OK

401: Unauthorized

3 - MutatingWebhookConfiguration

MutatingWebhookConfiguration 描述准入 Webhook 的配置，该 Webhook 可在更改对象的情况下接受或拒绝对象请求

apiVersion: admissionregistration.k8s.io/v1

import "k8s.io/api/admissionregistration/v1"

MutatingWebhookConfiguration

MutatingWebhookConfiguration 描述准入 Webhook 的配置，该 Webhook 可接受或拒绝对象请求，并且可能变更对象。

apiVersion：admissionregistration.k8s.io/v1
kind：MutatingWebhookConfiguration

metadata (ObjectMeta)

标准的对象元数据，更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata。

webhooks ([]MutatingWebhook)

补丁策略：根据 name 键执行合并操作

映射：基于 name 键的唯一值将在合并期间被保留

webhooks 是 Webhook 及其所影响的资源和操作的列表。

MutatingWebhook 描述了一个准入 Webhook 及其适用的资源和操作。
- webhooks.admissionReviewVersions ([]string), 必需
  
  原子性：将在合并期间被替换
  
  admissionReviewVersions 是 Webhook 期望的 AdmissionReview 版本的优选顺序列表。 API 服务器将尝试使用它所支持的版本列表中的第一个版本。如果 API 服务器不支持此列表中设置的任何版本，则此对象将验证失败。如果持久化的 Webhook 配置指定了所允许的版本，但其中不包括 API 服务器所知道的任何版本，则对 Webhook 的调用将失败并根据失败策略进行处理。
- webhooks.clientConfig (WebhookClientConfig), 必需
  
  clientConfig 定义了如何与 Webhook 通信。必需。
  
  WebhookClientConfig 包含与 Webhook 建立 TLS 连接的信息
  - webhooks.clientConfig.caBundle ([]byte)
    
    caBundle 是一个 PEM 编码的 CA 包，将用于验证 Webhook 的服务证书。如果未指定，则使用 apiserver 上的系统信任根。
  - webhooks.clientConfig.service (ServiceReference)
    
    service 是对此 Webhook 的服务的引用。必须指定 service 或 url 之一。
    
    如果 Webhook 在集群中运行，那么你应该使用 service。
    
    ServiceReference 包含对 Service.legacy.k8s.io 的引用
    - webhooks.clientConfig.service.name (string), 必需
      
      name 是服务的名称。必需。
    - webhooks.clientConfig.service.namespace (string), 必需
      
      namespace 是服务的命名空间。必需。
    - webhooks.clientConfig.service.path (string)
      
      path 是一个可选的 URL 路径，在针对此服务的所有请求中都会发送此路径。
    - webhooks.clientConfig.service.port (int32)
      
      如果指定了，则为托管 Webhook 的服务上的端口。默认为 443 以实现向后兼容。 port 应该是一个有效的端口号（包括 1-65535）。
  - webhooks.clientConfig.url (string)
    
    url 以标准 URL 形式（scheme://host:port/path）给出了 Webhook 的位置。必须指定 url 或 service 中的一个。
    
    host 不能用来引用集群中运行的服务；这种情况应改用 service 字段。在某些 API 服务器上，可能会通过外部 DNS 解析 host 值。（例如，kube-apiserver 无法解析集群内 DNS，因为这会违反分层原理）。host 也可以是 IP 地址。
    
    请注意，使用 localhost 或 127.0.0.1 作为 host 是有风险的，除非你非常小心地在运行 apiserver 的所有主机上运行此 Webhook，而这些 API 服务器可能需要调用此 Webhook。此类部署可能是不可移植的，即不容易在新集群中重复安装。
    
    该方案必须是 “https”；URL 必须以 “https://” 开头。
    
    路径是可选的，如果存在，可以是 URL 中允许的任何字符串。你可以使用路径将任意字符串传递给 Webhook，例如集群标识符。
    
    不允许使用用户或基本身份验证，例如不允许使用 “user:password@”。不允许使用片段（“#...”）和查询参数（“?...”）。
- webhooks.name (string), 必需
  
  准入 Webhook 的名称。应该是完全限定的名称，例如 imagepolicy.kubernetes.io，其中 “imagepolicy” 是 Webhook 的名称， kubernetes.io 是组织的名称。必需。
- webhooks.sideEffects (string), 必需
  
  sideEffects 说明此 Webhook 是否有副作用。可接受的值为：None、NoneOnDryRun （通过 v1beta1 创建的 Webhook 也可以指定 Some 或 Unknown）。具有副作用的 Webhook 必须实现协调系统，因为请求可能会被准入链中的未来步骤拒绝，因此需要能够撤消副作用。如果请求与带有 sideEffects == Unknown 或 Some 的 Webhook 匹配，则带有 dryRun 属性的请求将被自动拒绝。
- webhooks.failurePolicy (string)
  
  failurePolicy 定义如何处理来自准入端点的无法识别的错误 - 允许的值是 Ignore 或 Fail。默认为 Fail。
- webhooks.matchConditions ([]MatchCondition)
  
  补丁策略：根据 name 键执行合并操作
  
  映射：键 name 的唯一值将在合并过程中保留
  
  matchConditions 是将请求发送到此 webhook 之前必须满足的条件列表。匹配条件过滤已经被 rules、namespaceSelector、objectSelector 匹配的请求。 matchConditions 取值为空列表时匹配所有请求。最多允许 64 个匹配条件。
  
  精确匹配逻辑是（按顺序）：
  1. 如果任一 matchCondition 的计算结果为 FALSE，则跳过该 webhook。
  2. 如果所有 matchConditions 的计算结果为 TRUE，则调用该 webhook。
  3. 如果任一 matchCondition 的计算结果为错误（但都不是 FALSE）：
    - 如果 failurePolicy=Fail，拒绝该请求；
    - 如果 failurePolicy=Ignore，忽略错误并跳过该 webhook。
  MatchCondition 表示将请求发送到 Webhook 之前必须满足的条件。
  - webhooks.matchConditions.expression (string), 必需
    
    expression 表示将由 CEL 求值的表达式。求值结果必须是 bool 值。CEL 表达式可以访问以 CEL 变量的形式给出的 AdmissionRequest 和 Authorizer 的内容：
    - 'object' - 来自传入请求的对象。对于 DELETE 请求，该值为 null。
    - 'oldObject' - 现有对象。对于 CREATE 请求，该值为 null。
    - 'request' - 准入请求的属性(/pkg/apis/admission/types.go#AdmissionRequest)。
    - 'authorizer' - CEL 授权者。可用于对请求的主体（用户或服务账号）执行授权检查。
      
      参阅： https://pkg.go.dev/k8s.io/apiserver/pkg/cel/library#Authz
    - 'authorizer.requestResource' - CEL ResourceCheck 从"授权方"构建并配置请求资源。
    CEL 文档： https://kubernetes.io/zh-cn/docs/reference/using-api/cel/
    
    此字段为必需字段。
    - webhooks.matchConditions.name (string), 必需
      
      name 是此匹配条件的标识符，用于 MatchConditions 的策略性合并，以及提供用于日志目的的标识符。一个好的 name 应该是对相关表达式的描述。 name 必须是由字母数字字符 -、_ 或 . 组成的限定名称，并且必须以字母、数字字符开头和结尾（例如 MyName、my.name 或 123-abc，用于验证 name 的正则表达式是 ([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9]）。带有可选的 DNS 子域前缀和 /（例如 example.com/MyName）
      
      此字段为必需字段。
- webhooks.matchPolicy (string)
  
  matchPolicy 定义了如何使用 “rules” 列表来匹配传入的请求。允许的值为 “Exact” 或 “Equivalent”。
  - Exact: 仅当请求与指定规则完全匹配时才匹配请求。例如，如果可以通过 apps/v1、apps/v1beta1 和 extensions/v1beta1 修改 deployments 资源，但 “rules” 仅包含 apiGroups:["apps"]、apiVersions:["v1"]、resources:["deployments"]，对 apps/v1beta1 或 extensions/v1beta1 的请求不会被发送到 Webhook。
  - Equivalent: 如果针对的资源包含在 “rules” 中，即使请求是通过另一个 API 组或版本提交，也会匹配。例如，如果可以通过 apps/v1、apps/v1beta1 和 extensions/v1beta1 修改 deployments 资源，并且 “rules” 仅包含 apiGroups:["apps"]、apiVersions:["v1"]、resources:["deployments "]，对 apps/v1beta1 或 extensions/v1beta1 的请求将被转换为 apps/v1 并发送到 Webhook。
  默认为 “Equivalent”。
- webhooks.namespaceSelector (LabelSelector)
  
  namespaceSelector 根据对象的命名空间是否与 selector 匹配来决定是否在该对象上运行 Webhook。如果对象本身是 Namespace，则针对 object.metadata.labels 执行匹配。如果对象是其他集群作用域资源，则永远不会跳过 Webhook 的匹配动作。
  
  例如，为了针对 “runlevel” 不为 “0” 或 “1” 的名字空间中的所有对象运行 Webhook；你可以按如下方式设置 selector：
```
"namespaceSelector": {
  "matchExpressions": [
    {
      "key": "runlevel",
      "operator": "NotIn",
      "values": [
        "0",
        "1"
      ]
    }
  ]
}
```
  相反，如果你只想针对 “environment” 为 “prod” 或 “staging” 的名字空间中的对象运行 Webhook；你可以按如下方式设置 selector：
```
"namespaceSelector": {
  "matchExpressions": [
    {
      "key": "environment",
      "operator": "In",
      "values": [
        "prod",
        "staging"
      ]
    }
  ]
}
```
  有关标签选择算符的更多示例，请参阅 https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/labels。
  
  默认为空的 LabelSelector，匹配所有对象。
- webhooks.objectSelector (LabelSelector)
  
  objectSelector 根据对象是否具有匹配的标签来决定是否运行 Webhook。 objectSelector 针对将被发送到 Webhook 的 oldObject 和 newObject 进行评估，如果任一对象与选择器匹配，则视为匹配。空对象（create 时为 oldObject，delete 时为 newObject）或不能有标签的对象（如 DeploymentRollback 或 PodProxyOptions 对象）认为是不匹配的。仅当 Webhook 支持时才能使用对象选择器，因为最终用户可以通过设置标签来跳过准入 Webhook。默认为空的 LabelSelector，匹配所有内容。
- webhooks.reinvocationPolicy (string)
  
  reinvocationPolicy 表示这个 Webhook 是否可以被多次调用，作为一次准入评估的一部分。可取值有 “Never” 和 “IfNeeded”。
  - Never: 在一次录取评估中，Webhook 被调用的次数不会超过一次。
  - IfNeeded：如果被录取的对象在被最初的 Webhook 调用后又被其他录取插件修改，那么该 Webhook 将至少被额外调用一次作为录取评估的一部分。指定此选项的 Webhook 必须是幂等的，能够处理它们之前承认的对象。注意：不保证额外调用的次数正好为1。 如果额外的调用导致对对象的进一步修改，Webhook 不保证会再次被调用。 使用该选项的 Webhook 可能会被重新排序，以最小化额外调用的数量。 在保证所有的变更都完成后验证一个对象，使用验证性质的准入 Webhook 代替。
  默认值为 “Never”。
- webhooks.rules ([]RuleWithOperations)
  
  原子性：将在合并期间被替换
  
  rules 描述了 Webhook 关心的资源/子资源上有哪些操作。Webhook 关心操作是否匹配任何 rules。但是，为了防止 ValidatingAdmissionWebhooks 和 MutatingAdmissionWebhooks 将集群置于只能完全禁用插件才能恢复的状态， ValidatingAdmissionWebhooks 和 MutatingAdmissionWebhooks 永远不会在处理 ValidatingWebhookConfiguration 和 MutatingWebhookConfiguration 对象的准入请求时被调用。
  
  RuleWithOperations 是操作和资源的元组。建议确保所有元组组合都是有效的。
  - webhooks.rules.apiGroups ([]string)
    
    Atomic：将在合并期间被替换
    
    apiGroups 是资源所属的 API 组列表。* 是所有组。如果存在 *，则列表的长度必须为 1。必需。
  - webhooks.rules.apiVersions ([]string)
    
    Atomic: 将在合并期间被替换
    
    apiVersions 是资源所属的 API 版本列表。* 是所有版本。如果存在 *，则列表的长度必须为 1。必需。
  - webhooks.rules.operations ([]string)
    
    Atomic: 将在合并期间被替换
    
    operations 是准入 Webhook 所关心的操作 —— CREATE、UPDATE、DELETE、CONNECT 或用来指代所有已知操作以及将来可能添加的准入操作的 *。如果存在 *，则列表的长度必须为 1。必需。
  - webhooks.rules.resources ([]string)
    
    Atomic: 将在合并期间被替换
    
    resources 是此规则适用的资源列表。
    - pods 表示 pods，'pods/log' 表示 pods 的日志子资源。* 表示所有资源，但不是子资源。
    - pods/* 表示 pods 的所有子资源,
    - */scale 表示所有 scale 子资源,
    - */* 表示所有资源及其子资源。
    如果存在通配符，则验证规则将确保资源不会相互重叠。
    
    根据所指定的对象，可能不允许使用子资源。必需。
  - webhooks.rules.scope (string)
    
    scope 指定此规则的范围。有效值为 “Cluster”, “Namespaced” 和 “”。 “Cluster” 表示只有集群范围的资源才会匹配此规则。 Namespace API 对象是集群范围的。 “Namespaced” 意味着只有命名空间作用域的资源会匹配此规则。 “” 表示没有范围限制。子资源与其父资源的作用域相同。默认为 “*”。
- webhooks.timeoutSeconds (int32)
  
  timeoutSeconds 指定此 Webhook 的超时时间。超时后，Webhook 的调用将被忽略或 API 调用将根据失败策略失败。超时值必须在 1 到 30 秒之间。默认为 10 秒。

MutatingWebhookConfigurationList

MutatingWebhookConfigurationList 是 MutatingWebhookConfiguration 的列表。

apiVersion: admissionregistration.k8s.io/v1
kind: MutatingWebhookConfigurationList

metadata (ListMeta)

标准的对象元数据，更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

items ([]MutatingWebhookConfiguration), 必需

MutatingWebhookConfiguration 列表。

操作

`get` 读取指定的 MutatingWebhookConfiguration

HTTP 请求

GET /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name}

参数

name（路径参数）：string, 必需

MutatingWebhookConfiguration 的名称。

pretty（查询参数）：string

pretty

响应

401: Unauthorized

`list` 列出或观察 MutatingWebhookConfiguration 类型的对象

HTTP 请求

GET /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations

参数

allowWatchBookmarks（查询参数）：boolean

allowWatchBookmarks

continue（查询参数）：string

continue

fieldSelector（查询参数）：string

fieldSelector

fieldSelector（查询参数）：string

fieldSelector

limit（查询参数）：integer

limit

pretty（查询参数）：string

pretty

resourceVersion（查询参数）：string

resourceVersion

resourceVersionMatch（查询参数）：string

resourceVersionMatch

sendInitialEvents（查询参数）：boolean

sendInitialEvents

timeoutSeconds（查询参数）：integer

timeoutSeconds

watch（查询参数）：boolean

watch

响应

200 (MutatingWebhookConfigurationList): OK

401: Unauthorized

`create` 创建一个 MutatingWebhookConfiguration

HTTP 请求

POST /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations

参数

body: MutatingWebhookConfiguration, 必需

dryRun（查询参数）：string

dryRun

fieldManager（查询参数）：string

fieldManager

fieldValidation（查询参数）：string

fieldValidation

pretty（查询参数）：string

pretty

响应

201 (MutatingWebhookConfiguration): Created

202 (MutatingWebhookConfiguration): Accepted

401: Unauthorized

`update` 替换指定的 MutatingWebhookConfiguration

HTTP 请求

PUT /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name}

参数

name（路径参数）：string, 必需

MutatingWebhookConfiguration 的名称。

body: MutatingWebhookConfiguration, 必需

dryRun（查询参数）：string

dryRun

fieldManager（查询参数）：string

fieldManager

fieldValidation（查询参数）：string

fieldValidation

pretty（查询参数）：string

pretty

响应

201 (MutatingWebhookConfiguration): Created

401: Unauthorized

`patch` 部分更新指定的 MutatingWebhookConfiguration

HTTP 请求

PATCH /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name}

参数

name（路径参数）：string, 必需

MutatingWebhookConfiguration 的名称。

body: Patch, 必需

dryRun（查询参数）：string

dryRun

fieldManager（查询参数）：string

fieldManager

fieldValidation（查询参数）：string

fieldValidation

force（查询参数）：boolean

force

pretty（查询参数）：string

pretty

响应

201 (MutatingWebhookConfiguration): Created

401: Unauthorized

`delete` 删除 MutatingWebhookConfiguration

HTTP 请求

DELETE /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name}

参数

name（路径参数）：string, 必需

MutatingWebhookConfiguration 的名称。
body: DeleteOptions

dryRun（查询参数）：string

dryRun

gracePeriodSeconds（查询参数）：integer

gracePeriodSeconds

pretty（查询参数）：string

pretty

propagationPolicy（查询参数）：string

propagationPolicy

响应

200 (Status): OK

202 (Status): Accepted

401: Unauthorized

`deletecollection` 删除 MutatingWebhookConfiguration 的集合

HTTP 请求

DELETE /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations

参数

body: DeleteOptions

continue（查询参数）：string

continue

dryRun（查询参数）：string

dryRun

fieldSelector（查询参数）：string

fieldSelector

gracePeriodSeconds（查询参数）：integer

gracePeriodSeconds

labelSelector（查询参数）：string

labelSelector

limit（查询参数）：integer

limit

pretty（查询参数）：string

pretty

propagationPolicy（查询参数）：string

propagationPolicy

resourceVersion（查询参数）：string

resourceVersion

resourceVersionMatch（查询参数）：string

resourceVersionMatch

sendInitialEvents（查询参数）：boolean

sendInitialEvents

timeoutSeconds（查询参数）：integer

timeoutSeconds

响应

200 (Status): OK

401: Unauthorized

4 - ValidatingWebhookConfiguration

ValidatingWebhookConfiguration 描述准入 Webhook 的配置，该 Webhook 可在不更改对象的情况下接受或拒绝对象请求

apiVersion: admissionregistration.k8s.io/v1

import "k8s.io/api/admissionregistration/v1"

ValidatingWebhookConfiguration

ValidatingWebhookConfiguration 描述准入 Webhook 的配置，该 Webhook 可在不更改对象的情况下接受或拒绝对象请求。

apiVersion: admissionregistration.k8s.io/v1
kind: ValidatingWebhookConfiguration

metadata (ObjectMeta)

标准的对象元数据，更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata。

webhooks ([]ValidatingWebhook)

补丁策略：根据 name 键执行合并操作

Map：name 键的唯一值将在合并期间保留

webhooks 是 Webhook 以及受影响的资源和操作的列表。

ValidatingWebhook 描述了一个准入 Webhook 及其适用的资源和操作。
- webhooks.admissionReviewVersions ([]string), 必需
  
  Atomic：将在合并期间被替换
  
  admissionReviewVersions 是 Webhook 期望的首选 AdmissionReview 版本的有序列表。 API 服务器将尝试使用它支持的列表中的第一个版本。如果 API 服务器不支持此列表中指定的版本，则此对象将验证失败。如果持久化的 Webhook 配置指定了允许的版本，并且不包括 API 服务器已知的任何版本，则对 Webhook 的调用将失败并受失败策略的约束。
- webhooks.clientConfig (WebhookClientConfig), 必需
  
  clientConfig 定义了如何与 Webhook 通信。必需。
  
  WebhookClientConfig 包含与 Webhook 建立 TLS 连接的信息
  - webhooks.clientConfig.caBundle ([]byte)
    
    caBundle 是一个 PEM 编码的 CA 包，将用于验证 Webhook 的服务证书。如果未指定，则使用 apiserver 上的系统信任根。
  - webhooks.clientConfig.service (ServiceReference)
    
    service 是对此 Webhook 服务的引用。必须指定 service 或 url。
    
    如果 Webhook 在集群中运行，那么你应该使用 service。
    
    ServiceReference 持有对 Service.legacy.k8s.io 的引用
    - webhooks.clientConfig.service.name (string), 必需
      
      name 是服务的名称。必需。
    - webhooks.clientConfig.service.namespace (string), 必需
      
      namespace 是服务的命名空间。必需。
    - webhooks.clientConfig.service.path (string)
      
      path 是一个可选的 URL 路径，它将发送任何请求到此服务。
    - webhooks.clientConfig.service.port (int32)
      
      如果指定，则为托管 Webhook 的服务上的端口。默认为 443 以实现向后兼容性。port 应该是一个有效的端口号（包括 1-65535）。
  - webhooks.clientConfig.url (string)
    
    url 以标准 URL 形式（scheme://host:port/path）给出了 Webhook 的位置。必须指定 url 或 service 中的一个。
    
    host 不应指代在集群中运行的服务；请改用 service 字段。在某些 apiserver 中，可能会通过外部 DNS 解析 host。（例如，kube-apiserver 无法解析集群内 DNS，因为这会违反分层原理）。host 也可以是 IP 地址。
    
    请注意，使用 localhost 或 127.0.0.1 作为 host 是有风险的，除非你非常小心地在运行 apiserver 的所有主机上运行此 Webhook，而这些 API 服务器可能需要调用此 Webhook。此类部署可能是不可移植的，即不容易在新集群中重复安装。
    
    该方案必须是 “https”；URL 必须以 “https://” 开头。
    
    路径是可选的，如果存在，可以是 URL 中允许的任何字符串。你可以使用路径将任意字符串传递给 Webhook，例如集群标识符。
    
    不允许使用用户或基本身份验证，例如不允许使用 “user:password@”。不允许使用片段（“#...”）和查询参数（“?...”）。
- webhooks.name (string), 必需
  
  准入 Webhook 的名称。应该是完全限定的名称，例如 imagepolicy.kubernetes.io，其中 “imagepolicy” 是 Webhook 的名称， kubernetes.io 是组织的名称。必需。
- webhooks.sideEffects (string), 必需
sideEffects 说明此 Webhook 是否有副作用。可接受的值为：None、NoneOnDryRun（通过 v1beta1 创建的 Webhook 也可以指定 Some 或 Unknown）。具有副作用的 Webhook 必须实现协调系统，因为请求可能会被准入链中的未来步骤拒绝，因此需要能够撤消副作用。如果请求与带有 sideEffects == Unknown 或 Some 的 Webhook 匹配，则带有 dryRun 属性的请求将被自动拒绝。
- webhooks.failurePolicy (string)
failurePolicy 定义了如何处理来自准入端点的无法识别的错误 - 允许的值是 Ignore 或 Fail。默认为 Fail。
- webhooks.matchConditions ([]MatchCondition)
补丁策略：根据 name 键的取值合并

Map：name 键的唯一值将在合并期间保留

matchConditions 是将请求发送到此 webhook 之前必须满足的条件列表。匹配条件过滤已经被 rules、namespaceSelector、objectSelector 匹配的请求。 matchConditions 取值为空列表时匹配所有请求。最多允许 64 个匹配条件。

精确匹配逻辑是（按顺序）:
1. 如果任一 matchCondition 的计算结果为 FALSE，则跳过该 webhook。
2. 如果所有 matchConditions 的计算结果为 TRUE，则调用该 webhook。
3. 如果任一 matchCondition 的计算结果为错误（但都不是 FALSE）：
  - 如果 failurePolicy=Fail，拒绝该请求；
  - 如果 failurePolicy=Ignore，忽略错误并跳过该 webhook。
MatchCondition 表示将请求发送到 Webhook 之前必须满足的条件。
- webhooks.matchConditions.expression (string), 必需
expression 表示将由 CEL 求值的表达式。求值结果必须是 bool 值。CEL 表达式可以访问以 CEL 变量的形式给出的 AdmissionRequest 和 Authorizer 的内容：
- 'object' - 来自传入请求的对象。对于 DELETE 请求，该值为 null。
- 'oldObject' - 现有对象。对于 CREATE 请求，该值为 null。
- 'request' - 准入请求的属性(/pkg/apis/admission/types.go#AdmissionRequest)。
- 'authorizer' - CEL 授权者。可用于对请求的主体（用户或服务帐户）执行授权检查。
  
  参阅：https://pkg.go.dev/k8s.io/apiserver/pkg/cel/library#Authz
- 'authorizer.requestResource' - CEL ResourceCheck 从"授权方"构建并配置请求资源。
CEL 文档：https://kubernetes.io/zh-cn/docs/reference/using-api/cel/

此字段为必需字段。
- webhooks.matchConditions.name (string), 必需
name 是此匹配条件的标识符，用于 MatchConditions 的策略性合并，以及提供用于日志目的的标识符。一个好的 name 应该是对相关表达式的描述。 name 必须是由字母数字字符 -、_ 或 . 组成的限定名称，并且必须以字母、数字字符开头和结尾（例如 MyName、my.name 或 123-abc，用于验证 name 的正则表达式是 ([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9]）。带有可选的 DNS 子域前缀和 /（例如 example.com/MyName）

此字段为必需字段。
- webhooks.matchPolicy (string)
  
  matchPolicy 定义了如何使用 "rules" 列表来匹配传入的请求。允许的值为 "Exact" 或 "Equivalent"。
  - Exact: 仅当请求与指定规则完全匹配时才匹配请求。例如，如果可以通过 apps/v1、apps/v1beta1 和 extensions/v1beta1 修改 deployments 资源，但 “rules” 仅包含 apiGroups:["apps"]、apiVersions:["v1"]、resources:["deployments "]，对 apps/v1beta1 或 extensions/v1beta1 的请求不会被发送到 Webhook。
  - Equivalent: 如果针对的资源包含在 “rules” 中，即使是通过另一个 API 组或版本，也视作匹配请求。例如，如果可以通过 apps/v1、apps/v1beta1 和 extensions/v1beta1 修改 deployments 资源，并且 “rules” 仅包含 apiGroups:["apps"]、apiVersions:["v1"]、resources:["deployments "]，对 apps/v1beta1 或 extensions/v1beta1 的请求将被转换为 apps/v1 并发送到 Webhook。
  默认为 “Equivalent”。
- webhooks.namespaceSelector (LabelSelector)
```
namespaceSelector 根据对象的命名空间是否与 selector 匹配来决定是否在该对象上运行 Webhook。 
```
  如果对象本身是命名空间，则在 object.metadata.labels 上执行匹配。如果对象是另一个集群范围的资源，则永远不会跳过 Webhook 执行匹配。
  
  例如，在命名空间与 “0” 或 “1” 的 “runlevel” 不关联的任何对象上运行 Webhook；你可以按如下方式设置 selector :
```
"namespaceSelector": {
"matchExpressions": [
  {
    "key": "runlevel",
    "operator": "NotIn",
    "values": [
      "0",
      "1"
    ]
  }
]
}
```
```
相反，如果你只想在命名空间与 “prod” 或 “staging” 的 “environment” 相关联的对象上运行 Webhook；
```
  你可以按如下方式设置 selector:
```
"namespaceSelector": {
"matchExpressions": [
  {
    "key": "environment",
    "operator": "In",
    "values": [
      "prod",
      "staging"
    ]
  }
]
}
```
```
有关标签选择算符的更多示例，请参阅 
```
  https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/labels。
  
  默认为空的 LabelSelector，匹配所有对象。
- webhooks.objectSelector (LabelSelector)
  
  objectSelector 根据对象是否具有匹配的标签来决定是否运行 Webhook。 objectSelector 针对将被发送到 Webhook 的 oldObject 和 newObject 进行评估，如果任一对象与选择器匹配，则视为匹配。空对象（create 时为 oldObject，delete 时为 newObject）或不能有标签的对象（如 DeploymentRollback 或 PodProxyOptions 对象）认为是不匹配的。仅当 Webhook 支持时才能使用对象选择器，因为最终用户可以通过设置标签来跳过准入 webhook。默认为空的 LabelSelector，匹配所有内容。
- webhooks.rules ([]RuleWithOperations)
  
  Atomic：将在合并期间被替换
  
  rules 描述了 Webhook 关心的资源/子资源上有哪些操作。Webhook 关心操作是否匹配任何rules。但是，为了防止 ValidatingAdmissionWebhooks 和 MutatingAdmissionWebhooks 将集群置于只能完全禁用插件才能恢复的状态， ValidatingAdmissionWebhooks 和 MutatingAdmissionWebhooks 永远不会在处理 ValidatingWebhookConfiguration 和 MutatingWebhookConfiguration 对象的准入请求被调用。
  
  RuleWithOperations 是操作和资源的元组。建议确保所有元组组合都是有效的。
  - webhooks.rules.apiGroups ([]string)
    
    原子性: 合并期间会被替换
    
    apiGroups 是资源所属的 API 组列表。'' 是所有组。如果存在 ''，则列表的长度必须为 1。必需。
  - webhooks.rules.apiVersions ([]string)
    
    原子性: 合并期间会被替换
    
    apiVersions 是资源所属的 API 版本列表。'' 是所有版本。如果存在 ''，则列表的长度必须为 1。必需。
  - webhooks.rules.operations ([]string)
    
    原子性: 合并期间会被替换
    
    operations 是准入 Webhook 所关心的操作 —— CREATE、UPDATE、DELETE、CONNECT 或用来指代所有已知操作以及将来可能添加的准入操作的 *。如果存在 '*'，则列表的长度必须为 1。必需。
  - webhooks.rules.resources ([]string)
    
    原子性: 合并期间会被替换
    
    resources 是此规则适用的资源列表。
    - 'pods' 表示 pods，'pods/log' 表示 pods 的日志子资源。'*' 表示所有资源，但不是子资源。
    - 'pods/*' 表示 pods 的所有子资源,
    - '*/scale' 表示所有 scale 子资源,
    - '/' 表示所有资源及其子资源。
    如果存在通配符，则验证规则将确保资源不会相互重叠。
    
    根据所指定的对象，可能不允许使用子资源。必需。
  - webhooks.rules.scope (string)
    
    scope 指定此规则的范围。有效值为 "Cluster", "Namespaced" 和 ""。 "Cluster" 表示只有集群范围的资源才会匹配此规则。 Namespace API 对象是集群范围的。 "Namespaced" 意味着只有命名空间作用域的资源会匹配此规则。 "" 表示没有范围限制。子资源与其父资源的作用域相同。默认为 "*"。
- webhooks.timeoutSeconds (int32)
  
  timeoutSeconds 指定此 Webhook 的超时时间。超时后，Webhook 的调用将被忽略或 API 调用将根据失败策略失败。超时值必须在 1 到 30 秒之间。默认为 10 秒。

ValidatingWebhookConfigurationList

ValidatingWebhookConfigurationList 是 ValidatingWebhookConfiguration 的列表。

items ([]ValidatingWebhookConfiguration), 必需

ValidatingWebhookConfiguration 列表。

apiVersion 定义对象表示的版本化模式。服务器应将已识别的模式转换为最新的内部值，并可能拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind（string）

kind 是一个字符串值，表示此对象表示的 REST 资源。服务器可以从客户端提交请求的端点推断出资源类别。无法更新。采用驼峰式命名。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata (ListMeta)

标准的列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

操作

`get` 读取指定的 ValidatingWebhookConfiguration

HTTP 请求

GET /apis/admissionregistration.k8s.io/v1/validatingwebhookconfigurations/{name}

参数

name (路径参数): string, 必需

ValidatingWebhookConfiguration 的名称。

pretty (查询参数): string

pretty

响应

401: Unauthorized

`list` 列出或观察 ValidatingWebhookConfiguration 类型的对象

HTTP 请求

GET /apis/admissionregistration.k8s.io/v1/validatingwebhookconfigurations

参数

allowWatchBookmarks (查询参数): boolean

allowWatchBookmarks

continue (查询参数): string

continue

fieldSelector (查询参数): string

fieldSelector

fieldSelector (查询参数): string

fieldSelector

limit (查询参数): integer

limit

pretty (查询参数): string

pretty

resourceVersion (查询参数): string

resourceVersion

resourceVersionMatch (查询参数): string

resourceVersionMatch

sendInitialEvents (查询参数): boolean

sendInitialEvents

timeoutSeconds (查询参数): integer

timeoutSeconds

watch (查询参数): boolean

watch

响应

200 (ValidatingWebhookConfigurationList): OK

401: Unauthorized

`create` 创建一个 ValidatingWebhookConfiguration

HTTP 请求

POST /apis/admissionregistration.k8s.io/v1/validatingwebhookconfigurations

参数

body: ValidatingWebhookConfiguration, 必需

dryRun (查询参数): string

dryRun

fieldManager (查询参数): string

fieldManager

fieldValidation (查询参数): string

fieldValidation

pretty (查询参数): string

pretty

响应

201 (ValidatingWebhookConfiguration): Created

202 (ValidatingWebhookConfiguration): Accepted

401: Unauthorized

`update` 替换指定的 ValidatingWebhookConfiguration

HTTP 请求

PUT /apis/admissionregistration.k8s.io/v1/validatingwebhookconfigurations/{name}

参数

name (路径参数): string, 必需

ValidatingWebhookConfiguration 的名称。

body: ValidatingWebhookConfiguration, 必需

dryRun (查询参数): string

dryRun

fieldManager (查询参数): string

fieldManager

fieldValidation (查询参数): string

fieldValidation

pretty (查询参数): string

pretty

响应

201 (ValidatingWebhookConfiguration): Created

401: Unauthorized

`patch` 部分更新指定的 ValidatingWebhookConfiguration

HTTP 请求

PATCH /apis/admissionregistration.k8s.io/v1/validatingwebhookconfigurations/{name}

参数

name (路径参数): string, 必需

ValidatingWebhookConfiguration 的名称。

body: Patch, 必需

dryRun (查询参数): string

dryRun

fieldManager (查询参数): string

fieldManager

fieldValidation (查询参数): string

fieldValidation

force (查询参数): boolean

force

pretty (查询参数): string

pretty

响应