18.5. Console [operator.openshift.io/v1]


描述
控制台提供了一种方法来配置操作器来管理控制台。兼容性级别 1:在主发行版本中至少提供 12 个月或 3 个次版本(以更长的时间为准)。
类型
对象
必填
  • spec

18.5.1. 规格

Expand
属性类型描述

apiVersion

字符串

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

kind

字符串

kind 是一个字符串值,代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ObjectMeta_v2

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

spec

对象

ConsoleSpec 是控制台所需行为的规格。

status

对象

ConsoleStatus 定义控制台的观察状态。

18.5.1.1. .spec

描述
ConsoleSpec 是控制台所需行为的规格。
类型
对象
Expand
属性类型描述

自定义

对象

自定义用于选择性地为 web 控制台提供一组少量自定义选项。

logLevel

字符串

logLevel 是针对整个组件的意图日志。它并不提供精细的控制,但管理操作器必须为其操作对象解释的粒度日志记录选择的简单方法。有效值为:"Normal", "Debug", " Trace", " TraceAll"。默认为 "Normal"。

managementState

字符串

managementState 指明 Operator 是否应该如何管理组件

observedConfig

``

observedConfig 包含控制器从集群状态观察到的稀疏配置。它存在于 spec 中,因为它是 Operator 级别的输入

operatorLogLevel

字符串

operatorLogLevel 是 Operator 本身的基于日志的意图。它并不提供精细的控制,但是管理操作器必须自行解释的粒度日志记录选择的简单方法。有效值为:"Normal", "Debug", " Trace", " TraceAll"。默认为 "Normal"。

plugins

数组(字符串)

插件定义启用的控制台插件名称列表。

providers

对象

供应商包含用于使用特定服务提供商的配置。

route

对象

Route 包含包含服务证书的主机名和 secret 引用。如果指定了自定义路由,则会使用提供的主机名创建新路由,控制台将可用。如果自定义主机名使用集群的默认路由后缀,则不需要服务证书的 Secret 规格。如果自定义主机名指向任意域,则需要手动 DNS 配置步骤。如果删除了自定义路由,则默认控制台路由将被维护,以便为控制台保留默认主机名。如果未指定,则使用默认路由。弃用

unsupportedConfigOverrides

``

unsupportedConfigOverrides 包含一个稀疏配置,它将覆盖任何之前设置的选项。它只需要是覆盖它的字段,它将以以下顺序结束:1。硬编码的默认值 2. observedConfig 3. unsupportedConfigOverrides

18.5.1.2. .spec.customization

描述
自定义用于选择性地为 web 控制台提供一组少量自定义选项。
类型
对象
Expand
属性类型描述

addPage

对象

AddPage 允许自定义 Developer 视角中的 Add 页面的操作。

品牌

字符串

品牌是 Web 控制台的默认品牌,可通过提供品牌字段来覆盖。一组有限的特定品牌选项。此字段控制控制台的元素,如徽标。无效的值可防止控制台推出部署。

customLogoFile

对象

customLogoFile 替换 masthead 和关于对话框中的默认 OpenShift 徽标。它是对 openshift-config 命名空间中的 ConfigMap 的引用。这可以通过类似 'oc create configmap custom-logo --from-file=/path/to/file -n openshift-config' 的命令创建。镜像大小必须小于 1 MB,因为 ConfigMap 大小的限制。ConfigMap 键应包含文件扩展名,以便控制台使用正确的 MIME 类型提供文件。推荐的徽标规格:Dimensions: Max height of 68px and max width of 200px SVG format preferred

customProductName

字符串

customProductName 是页面标题、徽标 alt 文本以及相关对话框而不是常规 OpenShift 产品名称中显示的名称。

developerCatalog

对象

developerCatalog 允许配置显示的开发人员目录类别。

DocumentationBaseURL

字符串

web 控制台的不同部分显示了到外部文档的文档BaseURL 链接。提供文档BaseURL 将覆盖默认文档 URL。无效的值可防止控制台推出部署。

projectAccess

对象

ProjectAccess 允许在 Developer 视角 Project 访问页面中自定义可用 ClusterRole 列表,供项目管理员用来为其他用户指定角色,并限制项目中的访问。如果设置,列表将替换默认的 ClusterRole 选项。

quickStarts

对象

Quickstarts 允许在控制台中自定义可用的 ConsoleQuickStart 资源。

18.5.1.3. .spec.customization.addPage

描述
AddPage 允许自定义 Developer 视角中的 Add 页面的操作。
类型
对象
Expand
属性类型描述

disabledActions

数组(字符串)

disabledActions 是未向用户显示的操作列表。列表中的每个操作都由其 ID 表示。

18.5.1.4. .spec.customization.customLogoFile

描述
customLogoFile 替换 masthead 和关于对话框中的默认 OpenShift 徽标。它是对 openshift-config 命名空间中的 ConfigMap 的引用。这可以通过类似 'oc create configmap custom-logo --from-file=/path/to/file -n openshift-config' 的命令创建。镜像大小必须小于 1 MB,因为 ConfigMap 大小的限制。ConfigMap 键应包含文件扩展名,以便控制台使用正确的 MIME 类型提供文件。推荐的徽标规格:Dimensions: Max height of 68px and max width of 200px SVG format preferred
类型
对象
Expand
属性类型描述

key

字符串

键允许指向 configmap 中的特定键/值。这对于逻辑文件引用非常有用。

name

字符串

 

18.5.1.5. .spec.customization.developerCatalog

描述
developerCatalog 允许配置显示的开发人员目录类别。
类型
对象
Expand
属性类型描述

类别

array

开发人员目录中显示的类别。

categories[]

对象

开发人员控制台目录的 DeveloperConsoleCatalogCategory。

18.5.1.6. .spec.customization.developerCatalog.categories

描述
开发人员目录中显示的类别。
类型
array

18.5.1.7. .spec.customization.developerCatalog.categories[]

描述
开发人员控制台目录的 DeveloperConsoleCatalogCategory。
类型
对象
必填
  • id
  • label
Expand
属性类型描述

id

字符串

ID 是 URL 中使用的标识符,用于在控制台中启用深度链接。ID 是必需的,且必须安全有 1-32 URL (A-Z, a-z, 0-9, - 和 _)字符。

label

字符串

标签定义类别显示标签。它是必需的,必须具有 1-64 个字符。

subcategories

array

subcategories 定义子类别列表。

subcategories[]

对象

DeveloperConsoleCatalogCategoryMeta 是开发人员目录类别的关键标识符。

tags

数组(字符串)

标签是与类别匹配的字符串列表。所选类别显示所有在类别和项目之间至少有一个重叠标签的项目。

描述
subcategories 定义子类别列表。
类型
array
描述
DeveloperConsoleCatalogCategoryMeta 是开发人员目录类别的关键标识符。
类型
对象
必填
  • id
  • label
Expand
属性类型描述

id

字符串

ID 是 URL 中使用的标识符,用于在控制台中启用深度链接。ID 是必需的,且必须安全有 1-32 URL (A-Z, a-z, 0-9, - 和 _)字符。

label

字符串

标签定义类别显示标签。它是必需的,必须具有 1-64 个字符。

tags

数组(字符串)

标签是与类别匹配的字符串列表。所选类别显示所有在类别和项目之间至少有一个重叠标签的项目。

18.5.1.10. .spec.customization.projectAccess

描述
ProjectAccess 允许在 Developer 视角 Project 访问页面中自定义可用 ClusterRole 列表,供项目管理员用来为其他用户指定角色,并限制项目中的访问。如果设置,列表将替换默认的 ClusterRole 选项。
类型
对象
Expand
属性类型描述

availableClusterRoles

数组(字符串)

availableClusterRoles 是 ClusterRole 名称列表,可通过项目访问选项卡分配给用户。

18.5.1.11. .spec.customization.quickStarts

描述
Quickstarts 允许在控制台中自定义可用的 ConsoleQuickStart 资源。
类型
对象
Expand
属性类型描述

disabled

数组(字符串)

disabled 是一个 ConsoleQuickStart 资源名称列表,未向用户显示。

18.5.1.12. .spec.providers

描述
供应商包含用于使用特定服务提供商的配置。
类型
对象
Expand
属性类型描述

statuspage

对象

Statuspage 包含提供状态信息的状态page.io 页面的 ID。

18.5.1.13. .spec.providers.statuspage

描述
Statuspage 包含提供状态信息的状态page.io 页面的 ID。
类型
对象
Expand
属性类型描述

pageID

字符串

pageID 是页面的 Status 页分配的唯一 ID。这必须是公共页面。

18.5.1.14. .spec.route

描述
Route 包含包含服务证书的主机名和 secret 引用。如果指定了自定义路由,则会使用提供的主机名创建新路由,控制台将可用。如果自定义主机名使用集群的默认路由后缀,则不需要服务证书的 Secret 规格。如果自定义主机名指向任意域,则需要手动 DNS 配置步骤。如果删除了自定义路由,则默认控制台路由将被维护,以便为控制台保留默认主机名。如果未指定,则使用默认路由。弃用
类型
对象
Expand
属性类型描述

hostname

字符串

hostname 是所需的自定义域,控制台将位于其中。

secret

对象

secret 指向 openshift-config 命名空间中的 secret,其中包含自定义证书和密钥,需要由集群管理员手动创建。引用的 Secret 需要包含以下键值对: - "tls.crt" - 指定自定义证书 - "tls.key" - 如果自定义主机名使用集群的默认路由后缀,则不需要服务证书的 Secret 规格。

18.5.1.15. .spec.route.secret

描述
secret 指向 openshift-config 命名空间中的 secret,其中包含自定义证书和密钥,需要由集群管理员手动创建。引用的 Secret 需要包含以下键值对: - "tls.crt" - 指定自定义证书 - "tls.key" - 如果自定义主机名使用集群的默认路由后缀,则不需要服务证书的 Secret 规格。
类型
对象
必填
  • name
Expand
属性类型描述

name

字符串

name 是引用的 secret 的 metadata.name

18.5.1.16. .status

描述
ConsoleStatus 定义控制台的观察状态。
类型
对象
Expand
属性类型描述

conditions

array

conditions 是条件及其状态列表

conditions[]

对象

OperatorCondition 只是标准条件字段。

generations

array

生成用于确定何时需要协调项目,或者以需要反应的方式更改项目。

generations[]

对象

GenerationStatus 跟踪给定资源的生成,以便可以做出有关强制更新的决策。

observedGeneration

整数

observedGeneration 是您已处理的最后生成变化

readyReplicas

整数

readyReplicas 指示有多少副本就绪并处于所需的状态

version

字符串

版本是此可用性适用于的级别

18.5.1.17. .status.conditions

描述
conditions 是条件及其状态列表
类型
array

18.5.1.18. .status.conditions[]

描述
OperatorCondition 只是标准条件字段。
类型
对象
Expand
属性类型描述

lastTransitionTime

字符串

 

message

字符串

 

reason

字符串

 

status

字符串

 

type

字符串

 

18.5.1.19. .status.generations

描述
生成用于确定何时需要协调项目,或者以需要反应的方式更改项目。
类型
array

18.5.1.20. .status.generations[]

描述
GenerationStatus 跟踪给定资源的生成,以便可以做出有关强制更新的决策。
类型
对象
Expand
属性类型描述

group

字符串

group 是您要跟踪的项的组

hash

字符串

hash 是为没有生成的资源设置的可选字段,内容敏感,如 secret 和 configmaps

lastGeneration

整数

lastGeneration 是涉及的工作负载控制器的最后生成

name

字符串

name 是您要跟踪的项的名称

namespace

字符串

命名空间是您跟踪的事情的位置

resource

字符串

Resource 是您要跟踪的事情的资源类型

18.5.2. API 端点

可用的 API 端点如下:

  • /apis/operator.openshift.io/v1/consoles

    • DELETE :删除控制台的集合
    • GET: 列出控制台的对象
    • POST :创建控制台
  • /apis/operator.openshift.io/v1/consoles/{name}

    • DELETE :删除控制台
    • GET :读取指定的控制台
    • PATCH :部分更新指定的控制台
    • PUT :替换指定的控制台
  • /apis/operator.openshift.io/v1/consoles/{name}/status

    • GET :指定控制台的读取状态
    • PATCH :部分更新指定控制台的状态
    • PUT: 替换指定控制台的状态

18.5.2.1. /apis/operator.openshift.io/v1/consoles

Expand
表 18.94. 全局查询参数
参数类型描述

pretty

字符串

如果 'true',则输出被用户友善。

HTTP 方法
DELETE
描述
删除控制台集合
Expand
表 18.95. 查询参数
参数类型描述

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。

继续

字符串

从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。

当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

Expand
表 18.96. HTTP 响应
HTTP 代码响应正文

200 - OK

Status_v2 模式

401 - Unauthorized

HTTP 方法
GET
描述
列出控制台的对象
Expand
表 18.97. 查询参数
参数类型描述

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。

继续

字符串

从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。

当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

Expand
表 18.98. HTTP 响应
HTTP 代码响应正文

200 - OK

ConsoleList 模式

401 - Unauthorized

HTTP 方法
POST
描述
创建控制台
Expand
表 18.99. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 18.100. 主体参数
参数类型描述

正文(body)

Console 模式

 
Expand
表 18.101. HTTP 响应
HTTP 代码响应正文

200 - OK

Console 模式

201 - Created

Console 模式

202 - Accepted

Console 模式

401 - Unauthorized

18.5.2.2. /apis/operator.openshift.io/v1/consoles/{name}

Expand
表 18.102. 全局路径参数
参数类型描述

name

字符串

控制台的名称

Expand
表 18.103. 全局查询参数
参数类型描述

pretty

字符串

如果 'true',则输出被用户友善。

HTTP 方法
DELETE
描述
删除控制台
Expand
表 18.104. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

gracePeriodSeconds

整数

应该删除对象前的持续时间(以秒为单位)。值必须是非负整数。值零表示立即删除。如果这个值是 nil,则使用指定类型的默认宽限期。如果没有指定,则默认为每个对象值。零表示立即删除。

orphanDependents

布尔值

弃用:请使用 PropagationPolicy,此字段将在 1.7 中被弃用。应该依赖的对象被孤立。如果为 true/false,"orphan"终结器将从对象的终结器列表添加到/删除。可以设置此字段或 PropagationPolicy,但不能同时设置两者。

propagationPolicy

字符串

是否以及是否执行垃圾回收。此字段或 OrphanDependents 可以设置,但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值为: 'Orphan' - 孤立依赖; 'Background' - 允许垃圾收集器在后台删除依赖的依赖关系; 'Foreground' - 一个删除前台所有依赖的级联策略。

Expand
表 18.105. 主体参数
参数类型描述

正文(body)

DeleteOptions_v2 schema

 
Expand
表 18.106. HTTP 响应
HTTP 代码响应正文

200 - OK

Status_v2 模式

202 - Accepted

Status_v2 模式

401 - Unauthorized

HTTP 方法
GET
描述
读取指定的控制台
Expand
表 18.107. 查询参数
参数类型描述

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

Expand
表 18.108. HTTP 响应
HTTP 代码响应正文

200 - OK

Console 模式

401 - Unauthorized

HTTP 方法
PATCH
描述
部分更新指定的控制台
Expand
表 18.109. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 18.110. 主体参数
参数类型描述

正文(body)

Patch 模式

 
Expand
表 18.111. HTTP 响应
HTTP 代码响应正文

200 - OK

Console 模式

401 - Unauthorized

HTTP 方法
PUT
描述
替换指定的控制台
Expand
表 18.112. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 18.113. 主体参数
参数类型描述

正文(body)

Console 模式

 
Expand
表 18.114. HTTP 响应
HTTP 代码响应正文

200 - OK

Console 模式

201 - Created

Console 模式

401 - Unauthorized

Expand
表 18.115. 全局路径参数
参数类型描述

name

字符串

控制台的名称

Expand
表 18.116. 全局查询参数
参数类型描述

pretty

字符串

如果 'true',则输出被用户友善。

HTTP 方法
GET
描述
指定控制台的读取状态
Expand
表 18.117. 查询参数
参数类型描述

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

Expand
表 18.118. HTTP 响应
HTTP 代码响应正文

200 - OK

Console 模式

401 - Unauthorized

HTTP 方法
PATCH
描述
指定控制台的部分更新状态
Expand
表 18.119. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 18.120. 主体参数
参数类型描述

正文(body)

Patch 模式

 
Expand
表 18.121. HTTP 响应
HTTP 代码响应正文

200 - OK

Console 模式

401 - Unauthorized

HTTP 方法
PUT
描述
替换指定控制台的状态
Expand
表 18.122. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 18.123. 主体参数
参数类型描述

正文(body)

Console 模式

 
Expand
表 18.124. HTTP 响应
HTTP 代码响应正文

200 - OK

Console 模式

201 - Created

Console 模式

401 - Unauthorized

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat