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

Etcd [operator.openshift.io/v1]

描述

Etcd 提供信息来配置操作员以管理 etcd。兼容性级别 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

对象

status

对象

.spec

描述
类型

对象

属性 类型 描述

controlPlaneHardwareSpeed

字符串

HardwareSpeed 允许用户更改 etcd 调优配置文件，该配置文件配置心跳间隔和领导者选举超时的延迟参数，从而允许集群容忍 etcd 成员之间的更长往返时间。“”表示没有意见，平台将选择合理的默认值，该值可能会在未经通知的情况下更改。

failedRevisionLimit

整数

failedRevisionLimit 是要保留在磁盘和 api 上的失败静态 pod 安装程序修订版的数量 -1 = 无限，0 或未设置 = 5（默认值）

forceRedeploymentReason

字符串

forceRedeploymentReason 可用于通过提供唯一的字符串来强制重新部署操作数。这提供了一种机制来启动先前失败的部署，并说明您为什么认为这次会成功而不是在相同的配置上再次失败。

logLevel

字符串

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

managementState

字符串

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

observedConfig

``

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

operatorLogLevel

字符串

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

succeededRevisionLimit

整数

succeededRevisionLimit 是要保留在磁盘和 api 上的成功静态 pod 安装程序修订版的数量 -1 = 无限，0 或未设置 = 5（默认值）

unsupportedConfigOverrides

``

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

.status

描述
类型

对象

属性 类型 描述

conditions

数组

conditions 是条件及其状态的列表

conditions[]

对象

OperatorCondition 只是标准条件字段。

controlPlaneHardwareSpeed

字符串

ControlPlaneHardwareSpeed 声明有效的硬件速度容差级别

generations

数组

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

generations[]

对象

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

latestAvailableRevision

整数

latestAvailableRevision 是最新部署的 deploymentID

latestAvailableRevisionReason

字符串

latestAvailableRevisionReason 描述最新部署的详细原因

nodeStatuses

数组

nodeStatuses 跟踪各个节点上的部署值和错误

nodeStatuses[]

对象

NodeStatus 提供有关此操作员管理的特定节点的当前状态的信息。

observedGeneration

整数

observedGeneration 是您处理的最后一代变化

readyReplicas

整数

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

version

字符串

version 是此可用性适用的级别

.status.conditions

描述

conditions 是条件及其状态的列表

类型

数组

.status.conditions[]

描述

OperatorCondition 只是标准条件字段。

类型

对象

必需

  • type

属性 类型 描述

lastTransitionTime

字符串

message

字符串

reason

字符串

status

字符串

type

字符串

.status.generations

描述

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

类型

数组

.status.generations[]

描述

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

类型

对象

属性 类型 描述

组

字符串

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

哈希值

字符串

哈希值是一个可选字段，用于设置对内容敏感且没有世代的资源，例如密钥和配置映射。

最后一代

整数

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

名称

字符串

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

命名空间

字符串

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

资源

字符串

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

.status.nodeStatuses

描述

nodeStatuses 跟踪各个节点上的部署值和错误

类型

数组

.status.nodeStatuses[]

描述

NodeStatus 提供有关此操作员管理的特定节点的当前状态的信息。

类型

对象

必需

  • 节点名称

属性 类型 描述

当前版本

整数

currentRevision 是最近一次成功部署的世代。

最后一次失败次数

整数

lastFailedCount 是上次失败版本的安装程序 Pod 失败的次数。

最后一次失败原因

字符串

lastFailedReason 是一个机器可读的失败原因字符串。

最后一次失败的版本

整数

lastFailedRevision 是我们尝试部署但失败的部署的世代。

最后一次失败的版本错误

数组 (字符串)

lastFailedRevisionErrors 是在 lastFailedRevision 中引用的失败部署期间出现的人类可读错误列表。

最后一次失败时间

字符串

lastFailedTime 是上次失败版本最后一次失败的时间。

最后一次回退次数

整数

lastFallbackCount 是回退到先前版本的次数。

节点名称

字符串

nodeName 是节点的名称。

目标版本

整数

targetRevision 是我们正在尝试应用的部署的世代。

API 端点

提供以下 API 端点：

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

    • DELETE：删除 Etcd 集合

    • GET：列出 Etcd 类型的对象

    • POST：创建 Etcd

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

    • DELETE：删除 Etcd

    • GET：读取指定的 Etcd

    • PATCH：部分更新指定的 Etcd

    • PUT：替换指定的 Etcd

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

    • GET：读取指定 Etcd 的状态

    • PATCH：部分更新指定 Etcd 的状态

    • PUT：替换指定 Etcd 的状态

/apis/operator.openshift.io/v1/etcds

HTTP 方法

DELETE

描述

删除 Etcd 集合

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

200 - OK

Status 模式

401 - 未授权

空
HTTP 方法

GET

描述

列出 Etcd 类型的对象

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

200 - OK

EtcdList 模式

401 - 未授权

空
HTTP 方法

POST

描述

创建 Etcd

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

dryRun

字符串

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

fieldValidation

字符串

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

body

Etcd 模式
表 5. HTTP 响应
HTTP 代码 响应体

200 - OK

Etcd 模式

201 - 已创建

Etcd 模式

202 - 已接受

Etcd 模式

401 - 未授权

空

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

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

名称

字符串

Etcd 的名称
HTTP 方法

DELETE

描述

删除 Etcd

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

dryRun

字符串

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

200 - OK

Status 模式

202 - 已接受

Status 模式

401 - 未授权

空
HTTP 方法

GET

描述

读取指定的 Etcd

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

200 - OK

Etcd 模式

401 - 未授权

空
HTTP 方法

PATCH

描述

部分更新指定的 Etcd

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

dryRun

字符串

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

fieldValidation

字符串

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

200 - OK

Etcd 模式

401 - 未授权

空
HTTP 方法

PUT

描述

替换指定的 Etcd

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

dryRun

字符串

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

fieldValidation

字符串

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

body

Etcd 模式
表 14. HTTP 响应
HTTP 代码 响应体

200 - OK

Etcd 模式

201 - 已创建

Etcd 模式

401 - 未授权

空

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

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

名称

字符串

Etcd 的名称
HTTP 方法

GET

描述

读取指定 Etcd 的状态

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

200 - OK

Etcd 模式

401 - 未授权

空
HTTP 方法

PATCH

描述

部分更新指定 Etcd 的状态

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

dryRun

字符串

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

fieldValidation

字符串

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

200 - OK

Etcd 模式

401 - 未授权

空
HTTP 方法

PUT

描述

替换指定 Etcd 的状态

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

dryRun

字符串

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

fieldValidation

字符串

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

body

Etcd 模式
表 21. HTTP 响应
HTTP 代码 响应体

200 - OK

Etcd 模式

201 - 已创建

Etcd 模式

401 - 未授权

空