diff --git a/content/zh-cn/docs/reference/kubernetes-api/extend-resources/_index.md b/content/zh-cn/docs/reference/kubernetes-api/extend-resources/_index.md index de42eb4957c..edcda43798c 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/extend-resources/_index.md +++ b/content/zh-cn/docs/reference/kubernetes-api/extend-resources/_index.md @@ -1,8 +1,9 @@ --- title: "扩展资源" weight: 7 -auto_generated: true --- - - - + diff --git a/content/zh-cn/docs/reference/kubernetes-api/extend-resources/custom-resource-definition-v1.md b/content/zh-cn/docs/reference/kubernetes-api/extend-resources/custom-resource-definition-v1.md index dd6bdd983fb..8601a2050f7 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/extend-resources/custom-resource-definition-v1.md +++ b/content/zh-cn/docs/reference/kubernetes-api/extend-resources/custom-resource-definition-v1.md @@ -33,9 +33,9 @@ CustomResourceDefinition 表示应在 API 服务器上公开的资源。其名
-- **apiVersion**: apiextensions.k8s.io/v1 +- **apiVersion**：apiextensions.k8s.io/v1 -- **kind**: CustomResourceDefinition +- **kind**：CustomResourceDefinition - **metadata** (}}">ObjectMeta) @@ -426,17 +426,17 @@ CustomResourceDefinitionSpec 描述了用户希望资源的呈现方式。 strategy 指定如何在版本之间转换自定义资源。允许的值为： - - `None`：转换器仅更改 apiVersion 并且不会触及自定义资源中的任何其他字段。 - - `Webhook`：API 服务器将调用外部 Webhook 进行转换。此选项需要其他信息。这要求 - spec.preserveUnknownFields 为 false，并且设置 spec.conversion.webhook。 + - `"None"`：转换器仅更改 apiVersion 并且不会触及自定义资源中的任何其他字段。 + - `"Webhook"`：API 服务器将调用外部 Webhook 进行转换。此选项需要其他信息。这要求 + spec.preserveUnknownFields 为 false，并且设置 spec.conversion.webhook。 - **conversion.webhook** (WebhookConversion) - webhook 描述了如何调用转换 Webhook。当 `strategy` 设置为 `Webhook` 时有效。 + webhook 描述了如何调用转换 Webhook。当 `strategy` 设置为 `"Webhook"` 时有效。 - `apiVersion`, `kind`, `metadata.name` 和 `metadata.generateName` 总是可以从对象的根和任何带 + `apiVersion`、`kind`、`metadata.name` 和 `metadata.generateName` 总是可以从对象的根和任何带 x-kubernetes-embedded-resource 注解的对象访问。其他元数据属性都无法访问。 + messageExpression 声明一个 CEL 表达式，其计算结果是此规则失败时返回的验证失败消息。 + 由于 messageExpression 用作失败消息，因此它的值必须是一个字符串。 + 如果在规则中同时存在 message 和 messageExpression，则在验证失败时使用 messageExpression。 + 如果是 messageExpression 出现运行时错误，则会记录运行时错误，并生成验证失败消息， + 就好像未设置 messageExpression 字段一样。如果 messageExpression 求值为空字符串、 + 只包含空格的字符串或包含换行符的字符串，则验证失败消息也将像未设置 messageExpression 字段一样生成， + 并记录 messageExpression 生成空字符串/只包含空格的字符串/包含换行符的字符串的事实。 + messageExpression 可以访问的变量与规则相同；唯一的区别是返回类型。 + 例如："x must be less than max ("+string(self.max)+")"。 + ## CustomResourceDefinitionStatus {#CustomResourceDefinitionStatus} + @@ -1030,7 +1046,7 @@ CustomResourceDefinitionStatus 表示 CustomResourceDefinition 的状态。 plural is the plural name of the resource to serve. The custom resources are served under `/apis/\/\/.../\`. Must match the name of the CustomResourceDefinition (in the form `\.\`). Must be all lowercase. --> - - **acceptedNames.plural** (string), required + - **acceptedNames.plural** (string)，必需 plural 是所提供的资源的复数名称，自定义资源在 `/apis///.../` 下提供。 必须与 CustomResourceDefinition 的名称匹配（格式为 `.`）。必须全部小写。 @@ -1162,7 +1178,7 @@ CustomResourceDefinitionList 是 CustomResourceDefinition 对象的列表。 - **items** ([]}}">CustomResourceDefinition)，必需 - items 列出单个 CustomResourceDefinition 对象 + items 列出单个 CustomResourceDefinition 对象。 - **apiVersion** (string) @@ -1179,8 +1195,9 @@ CustomResourceDefinitionList 是 CustomResourceDefinition 对象的列表。 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/sig-architecture/api-conventions.md#types-kinds --> - kind 是一个字符串值，表示该对象所表示的 REST 资源。服务器可以从客户端提交请求的端点推断出 REST 资源。不能被更新。驼峰命名。 - 更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds + kind 是一个字符串值，表示该对象所表示的 REST 资源。服务器可以从客户端提交请求的端点推断出 REST 资源。 + 不能被更新。驼峰命名。更多信息： + https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds - **metadata** (}}">ListMeta) @@ -1216,7 +1233,7 @@ GET /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name} - **name** （**路径参数**）：string，必需 - CustomResourceDefinition 的名称 + CustomResourceDefinition 的名称。 - **pretty** （**查询参数**）：string @@ -1253,7 +1270,7 @@ GET /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}/status - **name** （**路径参数**）：string，必需 - CustomResourceDefinition 的名称 + CustomResourceDefinition 的名称。 - **pretty** （**查询参数**）：string @@ -1316,6 +1333,10 @@ GET /apis/apiextensions.k8s.io/v1/customresourcedefinitions }}">resourceVersionMatch +- **sendInitialEvents** （**查询参数**）: boolean + + }}">sendInitialEvents + - **timeoutSeconds** （**查询参数**）：integer }}">timeoutSeconds @@ -1406,7 +1427,7 @@ PUT /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name} - **name** （**路径参数**）：string，必需 - CustomResourceDefinition 的名称 + CustomResourceDefinition 的名称。 - **body**: }}">CustomResourceDefinition，必需 @@ -1461,7 +1482,7 @@ PUT /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}/status - **name** （**路径参数**）：string，必需 - CustomResourceDefinition 的名称 + CustomResourceDefinition 的名称。 - **body**: }}">CustomResourceDefinition，必需 @@ -1516,7 +1537,7 @@ PATCH /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name} - **name** （**路径参数**）：string，必需 - CustomResourceDefinition 的名称 + CustomResourceDefinition 的名称。 - **body**: }}">Patch，必需 @@ -1575,7 +1596,7 @@ PATCH /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}/status - **name** （**路径参数**）：string，必需 - CustomResourceDefinition 的名称 + CustomResourceDefinition 的名称。 - **body**: }}">Patch，必需 @@ -1632,7 +1653,7 @@ DELETE /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name} - **name** （**路径参数**）：string，必需 - CustomResourceDefinition 的名称 + CustomResourceDefinition 的名称。 - **body**: }}">DeleteOptions @@ -1721,6 +1742,10 @@ DELETE /apis/apiextensions.k8s.io/v1/customresourcedefinitions }}">resourceVersionMatch +- **sendInitialEvents** （**查询参数**）: boolean + + }}">sendInitialEvents + - **timeoutSeconds** （**查询参数**）：integer }}">timeoutSeconds @@ -1733,4 +1758,3 @@ DELETE /apis/apiextensions.k8s.io/v1/customresourcedefinitions 200 (}}">Status): OK 401: Unauthorized - diff --git a/content/zh-cn/docs/reference/kubernetes-api/extend-resources/mutating-webhook-configuration-v1.md b/content/zh-cn/docs/reference/kubernetes-api/extend-resources/mutating-webhook-configuration-v1.md index 4d949bc17a6..5a37b56926b 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/extend-resources/mutating-webhook-configuration-v1.md +++ b/content/zh-cn/docs/reference/kubernetes-api/extend-resources/mutating-webhook-configuration-v1.md @@ -29,15 +29,13 @@ weight: 3 - MutatingWebhookConfiguration 描述准入 Webhook 的配置，该 Webhook 可接受或拒绝对象请求，并且可能变更对象。
-- **apiVersion**: admissionregistration.k8s.io/v1 - -- **kind**: MutatingWebhookConfiguration +- **apiVersion**：admissionregistration.k8s.io/v1 +- **kind**：MutatingWebhookConfiguration #### 参数 -- **name** (**路径参数**): string, 必需 +- **name**（**路径参数**）：string, 必需 MutatingWebhookConfiguration 的名称。 @@ -663,7 +663,7 @@ GET /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name} --> -- **pretty** (**查询参数**): string +- **pretty**（**查询参数**）：string }}">pretty @@ -696,7 +696,7 @@ GET /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations --> #### 参数 -- **allowWatchBookmarks** (**查询参数**): boolean +- **allowWatchBookmarks**（**查询参数**）：boolean }}">allowWatchBookmarks @@ -706,7 +706,7 @@ GET /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">continue --> -- **continue** (**查询参数**): string +- **continue**（**查询参数**）：string }}">continue @@ -716,7 +716,7 @@ GET /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">fieldSelector --> -- **fieldSelector** (**查询参数**): string +- **fieldSelector**（**查询参数**）：string }}">fieldSelector @@ -726,7 +726,7 @@ GET /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">labelSelector --> -- **fieldSelector** (**查询参数**): string +- **fieldSelector**（**查询参数**）：string }}">fieldSelector @@ -736,7 +736,7 @@ GET /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">limit --> -- **limit** (**查询参数**): integer +- **limit**（**查询参数**）：integer }}">limit @@ -746,7 +746,7 @@ GET /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">pretty --> -- **pretty** (**查询参数**): string +- **pretty**（**查询参数**）：string }}">pretty @@ -756,7 +756,7 @@ GET /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">resourceVersion --> -- **resourceVersion** (**查询参数**): string +- **resourceVersion**（**查询参数**）：string }}">resourceVersion @@ -766,7 +766,7 @@ GET /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">resourceVersionMatch --> -- **resourceVersionMatch** (**查询参数**): string +- **resourceVersionMatch**（**查询参数**）：string }}">resourceVersionMatch @@ -775,7 +775,7 @@ GET /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">sendInitialEvents --> -- **sendInitialEvents** (**查询参数**): boolean +- **sendInitialEvents**（**查询参数**）：boolean }}">sendInitialEvents @@ -785,7 +785,7 @@ GET /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">timeoutSeconds --> -- **timeoutSeconds** (**查询参数**): integer +- **timeoutSeconds**（**查询参数**）：integer }}">timeoutSeconds @@ -795,7 +795,7 @@ GET /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">watch --> -- **watch** (**查询参数**): boolean +- **watch**（**查询参数**）：boolean }}">watch @@ -835,7 +835,7 @@ POST /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">dryRun --> -- **dryRun** (**查询参数**): string +- **dryRun**（**查询参数**）：string }}">dryRun @@ -845,7 +845,7 @@ POST /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">fieldManager --> -- **fieldManager** (**查询参数**): string +- **fieldManager**（**查询参数**）：string }}">fieldManager @@ -855,7 +855,7 @@ POST /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">fieldValidation --> -- **fieldValidation** (**查询参数**): string +- **fieldValidation**（**查询参数**）：string }}">fieldValidation @@ -865,7 +865,7 @@ POST /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">pretty --> -- **pretty** (**查询参数**): string +- **pretty**（**查询参数**）：string }}">pretty @@ -902,7 +902,7 @@ PUT /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name} --> #### 参数 -- **name** (**路径参数**): string, 必需 +- **name**（**路径参数**）：string, 必需 MutatingWebhookConfiguration 的名称。 @@ -918,7 +918,7 @@ PUT /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name} }}">dryRun --> -- **dryRun** (**查询参数**): string +- **dryRun**（**查询参数**）：string }}">dryRun @@ -928,7 +928,7 @@ PUT /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name} }}">fieldManager --> -- **fieldManager** (**查询参数**): string +- **fieldManager**（**查询参数**）：string }}">fieldManager @@ -938,7 +938,7 @@ PUT /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name} }}">fieldValidation --> -- **fieldValidation** (**查询参数**): string +- **fieldValidation**（**查询参数**）：string }}">fieldValidation @@ -948,7 +948,7 @@ PUT /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name} }}">pretty --> -- **pretty** (**查询参数**): string +- **pretty**（**查询参数**）：string }}">pretty @@ -983,7 +983,7 @@ PATCH /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name} --> #### 参数 -- **name** (**路径参数**): string, 必需 +- **name**（**路径参数**）：string, 必需 MutatingWebhookConfiguration 的名称。 @@ -999,7 +999,7 @@ PATCH /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name} }}">dryRun --> -- **dryRun** (**查询参数**): string +- **dryRun**（**查询参数**）：string }}">dryRun @@ -1009,7 +1009,7 @@ PATCH /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name} }}">fieldManager --> -- **fieldManager** (**查询参数**): string +- **fieldManager**（**查询参数**）：string }}">fieldManager @@ -1019,7 +1019,7 @@ PATCH /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name} }}">fieldValidation --> -- **fieldValidation** (**查询参数**): string +- **fieldValidation**（**查询参数**）：string }}">fieldValidation @@ -1029,7 +1029,7 @@ PATCH /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name} }}">force --> -- **force** (**查询参数**): boolean +- **force**（**查询参数**）：boolean }}">force @@ -1039,7 +1039,7 @@ PATCH /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name} }}">pretty --> -- **pretty** (**查询参数**): string +- **pretty**（**查询参数**）：string }}">pretty @@ -1074,7 +1074,7 @@ DELETE /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name --> #### 参数 -- **name** (**路径参数**): string, 必需 +- **name**（**路径参数**）：string, 必需 MutatingWebhookConfiguration 的名称。 @@ -1086,7 +1086,7 @@ DELETE /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name }}">dryRun --> -- **dryRun** (**查询参数**): string +- **dryRun**（**查询参数**）：string }}">dryRun @@ -1096,7 +1096,7 @@ DELETE /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name }}">gracePeriodSeconds --> -- **gracePeriodSeconds** (**查询参数**): integer +- **gracePeriodSeconds**（**查询参数**）：integer }}">gracePeriodSeconds @@ -1106,7 +1106,7 @@ DELETE /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name }}">pretty --> -- **pretty** (**查询参数**): string +- **pretty**（**查询参数**）：string }}">pretty @@ -1116,7 +1116,7 @@ DELETE /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name }}">propagationPolicy --> -- **propagationPolicy** (**查询参数**): string +- **propagationPolicy**（**查询参数**）：string }}">propagationPolicy @@ -1155,7 +1155,7 @@ DELETE /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">continue --> -- **continue** (**查询参数**): string +- **continue**（**查询参数**）：string }}">continue @@ -1165,7 +1165,7 @@ DELETE /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">dryRun --> -- **dryRun** (**查询参数**): string +- **dryRun**（**查询参数**）：string }}">dryRun @@ -1175,7 +1175,7 @@ DELETE /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">fieldSelector --> -- **fieldSelector** (**查询参数**): string +- **fieldSelector**（**查询参数**）：string }}">fieldSelector @@ -1185,7 +1185,7 @@ DELETE /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">gracePeriodSeconds --> -- **gracePeriodSeconds** (**查询参数**): integer +- **gracePeriodSeconds**（**查询参数**）：integer }}">gracePeriodSeconds @@ -1195,7 +1195,7 @@ DELETE /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">labelSelector --> -- **labelSelector** (**查询参数**): string +- **labelSelector**（**查询参数**）：string }}">labelSelector @@ -1205,7 +1205,7 @@ DELETE /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">limit --> -- **limit** (**查询参数**): integer +- **limit**（**查询参数**）：integer }}">limit @@ -1215,7 +1215,7 @@ DELETE /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">pretty --> -- **pretty** (**查询参数**): string +- **pretty**（**查询参数**）：string }}">pretty @@ -1225,7 +1225,7 @@ DELETE /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">propagationPolicy --> -- **propagationPolicy** (**查询参数**): string +- **propagationPolicy**（**查询参数**）：string }}">propagationPolicy @@ -1235,7 +1235,7 @@ DELETE /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">resourceVersion --> -- **resourceVersion** (**查询参数**): string +- **resourceVersion**（**查询参数**）：string }}">resourceVersion @@ -1245,7 +1245,7 @@ DELETE /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">resourceVersionMatch --> -- **resourceVersionMatch** (**查询参数**): string +- **resourceVersionMatch**（**查询参数**）：string }}">resourceVersionMatch @@ -1254,7 +1254,7 @@ DELETE /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">sendInitialEvents --> -- **sendInitialEvents** (**查询参数**): boolean +- **sendInitialEvents**（**查询参数**）：boolean }}">sendInitialEvents @@ -1264,7 +1264,7 @@ DELETE /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations }}">timeoutSeconds --> -- **timeoutSeconds** (**查询参数**): integer +- **timeoutSeconds**（**查询参数**）：integer }}">timeoutSeconds