资源类型
AdmissionReview {#admission-k8s-io-v1-AdmissionReview}
<p>
<code>AdmissionReview</code> 描述准入评审请求/响应。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>apiVersion</code><br/>string</td><td><code>admission.k8s.io/v1</code></td></tr> <tr><td><code>kind</code><br/>string</td><td><code>AdmissionReview</code></td></tr>
<tr><td><code>request</code><br/> <a href="#admission-k8s-io-v1-AdmissionRequest"><code>AdmissionRequest</code></a> </td> <td> <p>
<code>request</code> 描述准入请求的属性。 </p> </td> </tr> <tr><td><code>response</code><br/> <a href="#admission-k8s-io-v1-AdmissionResponse"><code>AdmissionResponse</code></a> </td> <td> <p>
<code>response</code> 描述准入响应的属性。 </p> </td> </tr> </tbody> </table>
AdmissionRequest {#admission-k8s-io-v1-AdmissionRequest}
出现在:
<p>
<code>AdmissionRequest</code> 描述准入请求的 <code>admission.Attributes</code>。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>uid</code> <br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/types#UID"><code>k8s.io/apimachinery/pkg/types.UID</code></a> </td> <td> <p>
<code>uid</code> 是用于标识单个请求/响应的标识符。它允许我们区分在其他情况下完全相同的请求实例(并行请求、在先前请求未修改时的请求等)。 <code>uid</code> 的目的是跟踪 KAS(Kubernetes Admission Server)和 Webhook 之间的轮询(请求/响应),而不是用户请求。 它适用于在 Webhook 和 API 服务器之间建立日志条目上的关联,从而服务于审计或调试目的。</p>
</td> </tr> <tr><td><code>kind</code> <br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#GroupVersionKind"><code>meta/v1.GroupVersionKind</code></a> </td> <td> <p>
<code>kind</code> 是正被提交的对象的全限定类别名称(例如 <code>v1.Pod</code> 或 <code>autoscaling.v1.Scale</code>)。 </p> </td> </tr> <tr><td><code>resource</code> <br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#GroupVersionResource"><code>meta/v1.GroupVersionResource</code></a> </td> <td> <p>
<code>resource</code> 是正被请求的资源的全限定名称(例如 <code>v1.pods</code>)。 </p> </td> </tr> <tr><td><code>subResource</code><br/> <code>string</code> </td> <td> <p>
<code>subResource</code> 是正被请求的子资源——如果存在的话(例如 "status" 或 "scale")。 </p> </td> </tr> <tr><td><code>requestKind</code><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#GroupVersionKind"><code>meta/v1.GroupVersionKind</code></a> </td> <td>
<p><code>requestKind</code> 是原始 API 请求的完全限定类别名称(例如 v1.Pod 或 autoscaling.v1.Scale)。 如果此字段被指定且不同于 "kind" 中的值,则执行等效的匹配和转换。</p> <p>例如,如果 Deployment 可以通过 apps/v1 和 apps/v1beta1 进行修改,并且 Webhook 注册了 <code>apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]</code> 和 <code>matchPolicy: Equivalent</code> 的规则,那么指向 apps/v1beta1 Deployment 的 API 请求将被转换并发送到 Webhook, 其中 <code>kind: {group:"apps", version:"v1", kind:"Deployment"}</code> (与 Webhook 注册的规则匹配)并且 <code>requestKind: {group:"apps", version:"v1beta1", kind:"Deployment"}</code>(指示原始 API 请求的类别)。</p> <p>参阅文档了解 Webhook 配置类型中 "matchPolicy" 字段的更多细节。</p>
</td> </tr> <tr><td><code>requestResource</code><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#GroupVersionResource"><code>meta/v1.GroupVersionResource</code></a> </td> <td>
<p><code>requestResource</code> 是原始 API 请求的全限定资源名称(例如 v1.pods)。 如果此字段被指定且不同于 "resource" 中的值,则执行等效的匹配和转换。</p> <p>例如,如果 Deployment 可以通过 apps/v1 和 apps/v1beta1 修改,并且 Webhook 注册了 <code>apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"]</code> 和 <code>matchPolicy: Equivalent</code> 的规则,那么指向 apps/v1beta1 Deployment 的 API 请求将被转换并发送到 Webhook, 其中 <code>resource: {group:"apps", version:"v1", resource:"deployments"}</code> (与 Webhook 注册的资源匹配)以及 <code>requestResource: {group:"apps", version:"v1beta1", resource:"deployments"}</code>(指示原始 API 请求的资源)。</p> <p>参阅文档了解 Webhook 配置类型中 "matchPolicy" 字段的更多细节。</p> </td> </tr> <tr><td><code>requestSubResource</code><br/> <code>string</code> </td> <td> <p>
<code>requestSubResource</code> 是可能存在的、原始 API 所请求的子资源(例如 "status" 或 "scale")。 如果此字段被指定且不同于 "subResource" 中的值,则执行等效的匹配和转换。 参阅文档了解 Webhook 配置类型中的 "matchPolicy" 字段。 </p> </td> </tr> <tr><td><code>name</code><br/> <code>string</code> </td> <td> <p>
<code>name</code> 是出现在请求中的对象的名称。客户端在执行 CREATE 操作时,可以忽略此命令并依赖服务器生成此名称。 如果是这种情况,此字段将包含一个空白字符串。 </p> </td> </tr> <tr><td><code>namespace</code><br/> <code>string</code> </td> <td> <p>
<code>namespace</code> 是与请求(如果有的话)关联的命名空间。 </p> </td> </tr> <tr><td><code>operation</code> <br/> <a href="#admission-k8s-io-v1-Operation"><code>Operation</code></a> </td> <td> <p>
<code>operation</code> 是正在执行的操作。这可能不同于请求的操作, 例如 patch 可以造成 CREATE 或 UPDATE 操作。 </p> </td> </tr> <tr><td><code>userInfo</code> <br/> <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.37/#userinfo-v1-authentication-k8s-io"><code>authentication/v1.UserInfo</code></a> </td> <td> <p>
<code>userInfo</code> 是发出请求的用户的相关信息。 </p> </td> </tr> <tr><td><code>object</code><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/runtime/#RawExtension"><code>k8s.io/apimachinery/pkg/runtime.RawExtension</code></a> </td> <td> <p>
<code>object</code> 是来自传入请求的对象。 </p> </td> </tr> <tr><td><code>oldObject</code><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/runtime/#RawExtension"><code>k8s.io/apimachinery/pkg/runtime.RawExtension</code></a> </td> <td> <p>
<code>oldObject</code> 是现有的对象。只有 DELETE 和 UPDATE 请求中此字段会有值。 </p> </td> </tr> <tr><td><code>dryRun</code><br/> <code>bool</code> </td> <td> <p>
<code>dryRun</code> 表示此请求的修改绝对不会被持久化。默认为 false。 </p> </td> </tr> <tr><td><code>options</code><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/runtime/#RawExtension"><code>k8s.io/apimachinery/pkg/runtime.RawExtension</code></a> </td> <td> <p>
<code>options</code> 是正在执行的操作的操作选项结构。 例如 <code>meta.k8s.io/v1.DeleteOptions</code> 或 <code>meta.k8s.io/v1.CreateOptions</code>。 所设置的值可能不同于调用方所提供的选项。例如 patch 请求执行的操作可能是 CREATE,那这种情况下即使调用方提供了 <code>meta.k8s.io/v1.PatchOptions</code>,<code>options</code> 也将是 <code>meta.k8s.io/v1.CreateOptions</code>。 </p> </td> </tr> </tbody> </table>
AdmissionResponse {#admission-k8s-io-v1-AdmissionResponse}
出现在:
<p>
<code>AdmissionResponse</code> 描述准入响应。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>uid</code> <br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/types#UID"><code>k8s.io/apimachinery/pkg/types.UID</code></a> </td> <td> <p>
<code>uid</code> 是标识单独请求/响应的标识符。 它必须从相应的 AdmissionRequest 复制过来。 </p> </td> </tr> <tr><td><code>allowed</code> <br/> <code>bool</code> </td> <td> <p>
<code>allowed</code> 表示准入请求是否被允许。 </p> </td> </tr> <tr><td><code>status</code><br/> <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.37/#status-v1-meta"><code>meta/v1.Status</code></a> </td> <td> <p>
<code>status</code> 是结果,其中包含为什么准入请求被拒绝的额外细节。 如果 "allowed" 的值为 "true",则不会以任何方式使用此字段。 </p>
</td> </tr> <tr><td><code>patch</code><br/> <code>[]byte</code> </td> <td> <p>
<code>patch</code> 操作的主体。目前 Kubernetes 仅支持实现了 RFC 6902 的 "JSONPatch"。 </p> </td> </tr> <tr><td><code>patchType</code><br/> <a href="#admission-k8s-io-v1-PatchType"><code>PatchType</code></a> </td> <td> <p>
<code>patchType</code> 是 Patch 的类型。目前 Kubernetes 仅允许 "JSONPatch"。 </p> </td> </tr> <tr><td><code>auditAnnotations</code><br/> <code>map[string]string</code> </td> <td> <p>
<code>auditAnnotations</code> 是由远程准入控制器设置的非结构化键值映射(例如 error=image-blacklisted)。 MutatingAdmissionWebhook 和 ValidatingAdmissionWebhook 准入控制器将在键前缀中使用准入 Webhook 名称 (例如 <code>imagepolicy.example.com/error=image-blacklisted</code>)。<code>auditAnnotations</code> 将由准入 Webhook 提供,向此请求的审计日志添加额外的上下文。 </p>
</td> </tr> <tr><td><code>warnings</code><br/> <code>[]string</code> </td> <td> <p>
<code>warnings</code> 是警告消息的列表,返回给发出请求的 API 客户端。 这些警告消息描述客户端在进行 API 请求时应该纠正或注意的问题。 如果可能的话,将 <code>warnings</code> 限制在 120 个字符以内。 如果 <code>warnings</code> 中的消息超过 256 个字符,或 <code>warnings</code> 数量过多,可能会被截断。 </p>
</td> </tr> </tbody> </table>
Operation {#admission-k8s-io-v1-Operation}
(string 的别名)
出现在:
<p>
<code>Operation</code> 是正在检查准入控制时资源操作的类型。 </p>
PatchType {#admission-k8s-io-v1-PatchType}
(string 的别名)
出现在:
<p>
<code>PatchType</code> 是用于表示所变更对象的补丁类型。 </p>
来源:Kubernetes 文档贡献者 · 作者与贡献记录 · CC BY 4.0。离线整理了版式、链接和媒体显示。
