ResourceInterpreterWebhookConfiguration v1alpha1
apiVersion: config.karmada.io/v1alpha1
import "github.com/karmada-io/karmada/pkg/apis/config/v1alpha1"
ResourceInterpreterWebhookConfiguration
ResourceInterpreterWebhookConfiguration 描述 webhook 的配置，这些配置负责传递 Karmada 资源对象的详情，特别是自定义资源的详情。
apiVersion: config.karmada.io/v1alpha1
kind: ResourceInterpreterWebhookConfiguration
metadata (ObjectMeta)
webhooks ([]ResourceInterpreterWebhook)，必选
Webhooks 罗列 webhook 及其所影响的资源和操作。
ResourceInterpreterWebhook 描述 webhook 及其适用的资源和操作。
webhooks.clientConfig (WebhookClientConfig)，必选
ClientConfig 定义与钩子通信的方式。
WebhookClientConfig 包含与 webhook 建立 TLS 连接的信息。
webhooks.clientConfig.caBundle ([]byte)
caBundle是一个 PEM 编码的 CA 包，用于验证 webhook 的服务器证书。如果未指定，则使用API服务器上的系统信任根。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无法解析集群内的域名，因为这会违反分层原理）。host也可以是 IP 地址。注意：使用
localhost或127.0.0.1作为host是有风险的，在运行 API 服务器的所有主机上运行此 webhook 时必须非常小心， 这些 API 服务器可能需要调用此 webhook。此类部署可能是不可移植的，即不易在新集群中重复安装。该方案必须是 “https”；URL 必须以 “https://” 开头。
路径是可选的，如果有路径，可以是 URL 中允许的任何字符串。可以使用路径将任意字符串传递给 webhook，例如集群标识符。
不允许使用用户或基本身份验证，例如，不允许使用 “user:password@”。不允许使用片段（“#...”）和查询参数（“?...”）。
webhooks.interpreterContextVersions ([]string)，必选
InterpreterContextVersions 是 Webhook 期望的优选的
ResourceInterpreterContext版本的有序列表。Karmada 将尝试使用列表中的第一个版本。如果 Karmada 不支持此列表中的版本，则此对象的验证将失败。如果持久化的 webhook 配置指定了支持的版本，且不包括 Karmada 已知的任何版本，则对 webhook 的调用将失败，并受失败策略的约束。webhooks.name（string），必选
Name 是 webhook 的全限定名。
webhooks.rules ([]RuleWithOperations)
Rules 描述了 webhook 涉及的资源上的操作。webhook 关心操作是否匹配任何 Rule。
RuleWithOperations 是操作和资源的元组。建议确保所有元组组合都是有效的。
webhooks.rules.apiGroups ([]string)，必选
APIGroups 是资源所属的 API 组。'' 表示所有组。如果存在 ''，则列表的长度必须为 1。例如： ["apps", "batch", "example.io"]：匹配3个组。 ["*"]：匹配所有组。
注意：组可留空，例如，对于 Kubernetes 的 core 组，使用 [""]。
webhooks.rules.apiVersions ([]string)，必选
APIVersions 是资源所属的API版本。'' 表示所有版本。如果存在 ''，则列表的长度必须为 1。例如： ["v1alpha1", "v1beta1"]：匹配2个版本。 ["*"]：匹配所有版本。
webhooks.rules.kinds ([]string)，必选
Kinds 是规则适用的资源列表。如果存在 ''，则列表的长度必须为 1。例如： ["Deployment", "Pod"]：匹配 Deployment 和 Pod。 [""]：应用于所有资源。
webhooks.rules.operations ([]string)，必选
Operations 是钩子所关心的操作。如果存在 '*'，则列表的长度必须为 1。
webhooks.timeoutSeconds (int32)
TimeoutSeconds 指定此 webhook 的超时时间。超时后，webhook 的调用将被忽略或 API 调用将根据失败策略失败。取值必须在 1 到 30 秒之间，默认为 10 秒。
ResourceInterpreterWebhookConfigurationList
ResourceInterpreterWebhookConfigurationList 包含 ResourceInterpreterWebhookConfiguration 的列表。
apiVersion: config.karmada.io/v1alpha1
kind: ResourceInterpreterWebhookConfigurationList
metadata (ListMeta)
items ([][ResourceInterpreterWebhookConfiguration](../config-resources/resource-interpreter-webhook-configuration-v1alpha1#resourceinterpreterwebhookconfiguration))，必选
Items holds a list of ResourceInterpreterWebhookConfiguration.
操作
get：查询指定的 ResourceInterpreterWebhookConfiguration
HTTP 请求
GET /apis/config.karmada.io/v1alpha1/resourceinterpreterwebhookconfigurations/{name}
参数
name（路径参数）：string，必选
ResourceInterpreterWebhookConfiguration 名称
pretty（查询参数）：string
响应
200 (ResourceInterpreterWebhookConfiguration): OK
get：查询指定 ResourceInterpreterWebhookConfiguration 的状态
HTTP 请求
GET /apis/config.karmada.io/v1alpha1/resourceinterpreterwebhookconfigurations/{name}/status
参数
name（路径参数）：string，必选
ResourceInterpreterWebhookConfiguration 的名称
pretty（查询参数）：string
响应
200 (ResourceInterpreterWebhookConfiguration): OK
list：查询所有 ResourceInterpreterWebhookConfiguration
HTTP 请求
GET /apis/config.karmada.io/v1alpha1/resourceinterpreterwebhookconfigurations
参数
allowWatchBookmarks（查询参数）：boolean
continue（查询参数）：string
fieldSelector（查询参数）：string
labelSelector（查询参数）：string
limit（查询参数）：integer
pretty（查询参数）：string
resourceVersion（查询参数）：string
resourceVersionMatch（查询参数）：string
sendInitialEvents（查询参数）：boolean
timeoutSeconds（查询参数）：integer
watch（查询参数）：boolean
响应
200 (ResourceInterpreterWebhookConfigurationList): OK
create：创建一个 ResourceInterpreterWebhookConfiguration
HTTP 请求
POST /apis/config.karmada.io/v1alpha1/resourceinterpreterwebhookconfigurations
参数
- body: ResourceInterpreterWebhookConfiguration, required
dryRun（查询参数）：string
fieldManager（查询参数）：string
fieldValidation（查询参数）：string
pretty（查询参数）：string
响应
200 (ResourceInterpreterWebhookConfiguration): OK
201 (ResourceInterpreterWebhookConfiguration): Created
202 (ResourceInterpreterWebhookConfiguration): Accepted
update：更新指定的 ResourceInterpreterWebhookConfiguration
HTTP 请求
PUT /apis/config.karmada.io/v1alpha1/resourceinterpreterwebhookconfigurations/{name}
参数
name（路径参数）：string，必选
ResourceInterpreterWebhookConfiguration 的名称
dryRun（查询参数）：string
fieldManager（查询参数）：string
fieldValidation（查询参数）：string
pretty（查询参数）：string
响应
200 (ResourceInterpreterWebhookConfiguration): OK
201 (ResourceInterpreterWebhookConfiguration): Created
update：更新指定 ResourceInterpreterWebhookConfiguration 的状态
HTTP 请求
PUT /apis/config.karmada.io/v1alpha1/resourceinterpreterwebhookconfigurations/{name}/status
参数
name（路径参数）：string，必选
ResourceInterpreterWebhookConfiguration 的名称
dryRun（查询参数）：string
fieldManager（查询参数）：string
fieldValidation（查询参数）：string
pretty（查询参数）：string
响应
200 (ResourceInterpreterWebhookConfiguration): OK
201 (ResourceInterpreterWebhookConfiguration): Created
patch：更新指定 ResourceInterpreterWebhookConfiguration 的部分信息
HTTP 请求
PATCH /apis/config.karmada.io/v1alpha1/resourceinterpreterwebhookconfigurations/{name}
参数
name（路径参数）：string，必选
ResourceInterpreterWebhookConfiguration 的名称
body: Patch，必选
dryRun（查询参数）：string
fieldManager（查询参数）：string
fieldValidation（查询参数）：string
force（查询参数）：boolean
pretty（查询参数）：string
响应
200 (ResourceInterpreterWebhookConfiguration): OK
201 (ResourceInterpreterWebhookConfiguration): Created
patch：更新指定 ResourceInterpreterWebhookConfiguration 状态的部分信息
HTTP 请求
PATCH /apis/config.karmada.io/v1alpha1/resourceinterpreterwebhookconfigurations/{name}/status
参数
name（路径参数）：string，必选
ResourceInterpreterWebhookConfiguration 的名称
body: Patch，必选
dryRun（查询参数）：string
fieldManager（查询参数）：string
fieldValidation（查询参数）：string
force（查询参数）：boolean
pretty（查询参数）：string
响应
200 (ResourceInterpreterWebhookConfiguration): OK
201 (ResourceInterpreterWebhookConfiguration): Created
delete：删除一个 ResourceInterpreterWebhookConfiguration
HTTP 请求
DELETE /apis/config.karmada.io/v1alpha1/resourceinterpreterwebhookconfigurations/{name}
参数
name（路径参数）：string，必选
ResourceInterpreterWebhookConfiguration 名称
body: DeleteOptions
dryRun（查询参数）：string
gracePeriodSeconds（查询参数）：integer
pretty（查询参数）：string
propagationPolicy（查询参数）：string
响应
200 (Status): OK
202 (Status): Accepted
deletecollection：删除所有 ResourceInterpreterWebhookConfiguration
HTTP 请求
DELETE /apis/config.karmada.io/v1alpha1/resourceinterpreterwebhookconfigurations
参数
- body: DeleteOptions
continue（查询参数）：string
dryRun（查询参数）：string
fieldSelector（查询参数）：string
gracePeriodSeconds（查询参数）：integer
labelSelector（查询参数）：string
limit（查询参数）：integer
pretty（查询参数）：string
propagationPolicy（查询参数）：string
resourceVersion（查询参数）：string
resourceVersionMatch（查询参数）：string
sendInitialEvents（查询参数）：boolean
timeoutSeconds（查询参数）：integer
响应
200 (Status): OK