OpenShift 文档正在迁移，很快将只在 docs.redhat.com（所有 Red Hat 产品文档的中心）提供。立即体验 新的文档体验。
  1. 文档
    2. history bug_report picture_as_pdf
×

OpenShiftAPIServer [operator.openshift.io/v1]

描述

OpenShiftAPIServer 提供信息来配置一个操作符以管理 openshift-apiserver。兼容性级别 1：在主要版本中稳定至少 12 个月或 3 个次要版本（以较长者为准）。

类型

对象

必需

  • spec

规范

属性 类型 描述

apiVersion

字符串

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

kind

字符串

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

metadata

ObjectMeta

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

spec

对象

spec 是 OpenShift API 服务器所需行为的规范。

status

对象

status 定义 OpenShift API 服务器的观察到的状态。

.spec

描述

spec 是 OpenShift API 服务器所需行为的规范。

类型

对象

属性 类型 描述

logLevel

字符串

logLevel 是基于意图的整体组件日志记录。它不提供细粒度的控制，但它是一种简单的方法来管理操作员必须为其操作数解释的粗粒度日志记录选择。有效值为：“Normal”、“Debug”、“Trace”、“TraceAll”。默认为“Normal”。

managementState

字符串

managementState 指示操作员是否以及如何管理组件

observedConfig

``

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

operatorLogLevel

字符串

operatorLogLevel 是操作员本身的基于意图的日志记录。它不提供细粒度的控制，但它是一种简单的方法来管理操作员必须为自身解释的粗粒度日志记录选择。有效值为：“Normal”、“Debug”、“Trace”、“TraceAll”。默认为“Normal”。

unsupportedConfigOverrides

``

unsupportedConfigOverrides 覆盖了操作员计算的最终配置。Red Hat 不支持使用此字段。误用此字段可能导致意外行为或与其他配置选项冲突。在使用此字段之前，请寻求 Red Hat 支持的指导。使用此属性会阻止集群升级，必须在升级集群之前将其删除。

.status

描述

status 定义 OpenShift API 服务器的观察到的状态。

类型

对象

属性 类型 描述

conditions

数组

conditions 是条件及其状态的列表

conditions[]

对象

OperatorCondition 只是标准条件字段。

generations

数组

generations 用于确定何时需要协调项目或项目以需要反应的方式发生了更改。

generations[]

对象

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

latestAvailableRevision

整数

latestAvailableRevision 是用作已修订的密钥（如 encryption-config）后缀的最新修订版。新的修订版会导致 Pod 的重新部署。

observedGeneration

整数

observedGeneration 是您处理的最后一次生成更改

readyReplicas

整数

readyReplicas 指示有多少个副本已准备好并处于所需状态

version

字符串

version 是此可用性适用的级别

.status.conditions

描述

conditions 是条件及其状态的列表

类型

数组

.status.conditions[]

描述

OperatorCondition 只是标准条件字段。

类型

对象

必需

  • type

属性 类型 描述

lastTransitionTime

字符串

message

字符串

reason

字符串

status

字符串

type

字符串

.status.generations

描述

generations 用于确定何时需要协调项目或项目以需要反应的方式发生了更改。

类型

数组

.status.generations[]

描述

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

类型

对象

属性 类型 描述

group

字符串

group 是您正在跟踪的对象所属的组。

hash

字符串

hash 是一个可选字段，用于设置那些没有 generation 但对内容敏感的资源，例如密钥和 ConfigMap。

lastGeneration

整数

lastGeneration 是参与的工作负载控制器的最后一代。

name

字符串

name 是您正在跟踪的对象的名称。

namespace

字符串

namespace 是您正在跟踪的对象所在的命名空间。

resource

字符串

resource 是您正在跟踪的对象的资源类型。

API 端点

以下 API 端点可用：

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

    • DELETE: 删除 OpenShiftAPIServer 集合

    • GET: 列出 OpenShiftAPIServer 对象

    • POST: 创建一个 OpenShiftAPIServer

  • /apis/operator.openshift.io/v1/openshiftapiservers/{name}

    • DELETE: 删除一个 OpenShiftAPIServer

    • GET: 读取指定的 OpenShiftAPIServer

    • PATCH: 部分更新指定的 OpenShiftAPIServer

    • PUT: 替换指定的 OpenShiftAPIServer

  • /apis/operator.openshift.io/v1/openshiftapiservers/{name}/status

    • GET: 读取指定的 OpenShiftAPIServer 的状态

    • PATCH: 部分更新指定的 OpenShiftAPIServer 的状态

    • PUT: 替换指定的 OpenShiftAPIServer 的状态

/apis/operator.openshift.io/v1/openshiftapiservers

HTTP 方法

DELETE

描述

删除 OpenShiftAPIServer 集合

表 1. HTTP 响应
HTTP 代码 响应体

200 - OK

Status schema

401 - 未授权

空
HTTP 方法

GET

描述

列出 OpenShiftAPIServer 对象

表 2. HTTP 响应
HTTP 代码 响应体

200 - OK

OpenShiftAPIServerList schema

401 - 未授权

空
HTTP 方法

POST

描述

创建一个 OpenShiftAPIServer

表 3. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略任何被对象静默丢弃的未知字段，并将忽略解码器遇到的所有重复字段中的最后一个字段以外的字段。这是 v1.23 之前的默认行为。- Warn：这将通过标准警告响应标头为每个从对象中删除的未知字段和遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍然会成功，并且只会持久化任何重复字段中的最后一个。这是 v1.23 及更高版本的默认值 - Strict：如果任何未知字段将从对象中删除，或者如果存在任何重复字段，则此操作将使用 BadRequest 错误使请求失败。服务器返回的错误将包含遇到的所有未知和重复字段。
表 4. 请求体参数
参数 类型 描述

body

OpenShiftAPIServer schema
表 5. HTTP 响应
HTTP 代码 响应体

200 - OK

OpenShiftAPIServer schema

201 - 已创建

OpenShiftAPIServer schema

202 - 已接受

OpenShiftAPIServer schema

401 - 未授权

空

/apis/operator.openshift.io/v1/openshiftapiservers/{name}

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

name

字符串

OpenShiftAPIServer 的名称
HTTP 方法

DELETE

描述

删除一个 OpenShiftAPIServer

表 7. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段
表 8. HTTP 响应
HTTP 代码 响应体

200 - OK

Status schema

202 - 已接受

Status schema

401 - 未授权

空
HTTP 方法

GET

描述

读取指定的 OpenShiftAPIServer

表 9. HTTP 响应
HTTP 代码 响应体

200 - OK

OpenShiftAPIServer schema

401 - 未授权

空
HTTP 方法

PATCH

描述

部分更新指定的 OpenShiftAPIServer

表 10. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略任何被对象静默丢弃的未知字段，并将忽略解码器遇到的所有重复字段中的最后一个字段以外的字段。这是 v1.23 之前的默认行为。- Warn：这将通过标准警告响应标头为每个从对象中删除的未知字段和遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍然会成功，并且只会持久化任何重复字段中的最后一个。这是 v1.23 及更高版本的默认值 - Strict：如果任何未知字段将从对象中删除，或者如果存在任何重复字段，则此操作将使用 BadRequest 错误使请求失败。服务器返回的错误将包含遇到的所有未知和重复字段。
表 11. HTTP 响应
HTTP 代码 响应体

200 - OK

OpenShiftAPIServer schema

401 - 未授权

空
HTTP 方法

PUT

描述

替换指定的 OpenShiftAPIServer

表 12. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略任何被对象静默丢弃的未知字段，并将忽略解码器遇到的所有重复字段中的最后一个字段以外的字段。这是 v1.23 之前的默认行为。- Warn：这将通过标准警告响应标头为每个从对象中删除的未知字段和遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍然会成功，并且只会持久化任何重复字段中的最后一个。这是 v1.23 及更高版本的默认值 - Strict：如果任何未知字段将从对象中删除，或者如果存在任何重复字段，则此操作将使用 BadRequest 错误使请求失败。服务器返回的错误将包含遇到的所有未知和重复字段。
表 13. 请求体参数
参数 类型 描述

body

OpenShiftAPIServer schema
表 14. HTTP 响应
HTTP 代码 响应体

200 - OK

OpenShiftAPIServer schema

201 - 已创建

OpenShiftAPIServer schema

401 - 未授权

空

/apis/operator.openshift.io/v1/openshiftapiservers/{name}/status

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

name

字符串

OpenShiftAPIServer 的名称
HTTP 方法

GET

描述

读取指定的 OpenShiftAPIServer 的状态

表 16. HTTP 响应
HTTP 代码 响应体

200 - OK

OpenShiftAPIServer schema

401 - 未授权

空
HTTP 方法

PATCH

描述

部分更新指定的 OpenShiftAPIServer 的状态

表 17. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略任何被对象静默丢弃的未知字段，并将忽略解码器遇到的所有重复字段中的最后一个字段以外的字段。这是 v1.23 之前的默认行为。- Warn：这将通过标准警告响应标头为每个从对象中删除的未知字段和遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍然会成功，并且只会持久化任何重复字段中的最后一个。这是 v1.23 及更高版本的默认值 - Strict：如果任何未知字段将从对象中删除，或者如果存在任何重复字段，则此操作将使用 BadRequest 错误使请求失败。服务器返回的错误将包含遇到的所有未知和重复字段。
表 18. HTTP 响应
HTTP 代码 响应体

200 - OK

OpenShiftAPIServer schema

401 - 未授权

空
HTTP 方法

PUT

描述

替换指定的 OpenShiftAPIServer 的状态

表 19. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略任何被对象静默丢弃的未知字段，并将忽略解码器遇到的所有重复字段中的最后一个字段以外的字段。这是 v1.23 之前的默认行为。- Warn：这将通过标准警告响应标头为每个从对象中删除的未知字段和遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍然会成功，并且只会持久化任何重复字段中的最后一个。这是 v1.23 及更高版本的默认值 - Strict：如果任何未知字段将从对象中删除，或者如果存在任何重复字段，则此操作将使用 BadRequest 错误使请求失败。服务器返回的错误将包含遇到的所有未知和重复字段。
表 20. 请求体参数
参数 类型 描述

body

OpenShiftAPIServer schema
表 21. HTTP 响应
HTTP 代码 响应体

200 - OK

OpenShiftAPIServer schema

201 - 已创建

OpenShiftAPIServer schema

401 - 未授权

空