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

ServiceCA [operator.openshift.io/v1]

描述

ServiceCA 提供信息来配置操作符以管理服务证书控制器。兼容性级别 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 包含用户可设置的配置值

status

对象

status 包含从集群中观察到的值。它们不能被覆盖。

.spec

描述

spec 包含用户可设置的配置值

类型

对象

属性 类型 描述

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 包含从集群中观察到的值。它们不能被覆盖。

类型

对象

属性 类型 描述

conditions

数组

conditions 是条件及其状态的列表

conditions[]

对象

OperatorCondition 只是标准条件字段。

generations

数组

generations 用于确定何时需要协调项目或项目已发生需要做出反应的更改。

generations[]

对象

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

observedGeneration

整数

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

readyReplicas

整数

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

version

字符串

version 是此可用性适用的级别

.status.conditions

描述

conditions 是条件及其状态的列表

类型

数组

.status.conditions[]

描述

OperatorCondition 只是标准条件字段。

类型

对象

属性 类型 描述

lastTransitionTime

字符串

message

字符串

reason

字符串

status

字符串

type

字符串

.status.generations

描述

generations 用于确定何时需要协调项目或项目已发生需要做出反应的更改。

类型

数组

.status.generations[]

描述

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

类型

对象

属性 类型 描述

group

字符串

group 是您正在跟踪的事物的组

hash

字符串

hash 是为没有生成且对内容敏感的资源（如密钥和配置映射）设置的可选字段

lastGeneration

整数

lastGeneration 是所涉及的工作负载控制器的最后一代

name

字符串

name 是您正在跟踪的事物的名称

namespace

字符串

namespace 是您正在跟踪的事物所在的位置

resource

字符串

resource 是您正在跟踪的事物的资源类型

API 端点

以下API端点可用

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

    • DELETE: 删除ServiceCA集合

    • GET: 列出ServiceCA类型的对象

    • POST: 创建一个ServiceCA

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

    • DELETE: 删除一个ServiceCA

    • GET: 读取指定的ServiceCA

    • PATCH: 部分更新指定的ServiceCA

    • PUT: 替换指定的ServiceCA

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

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

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

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

/apis/operator.openshift.io/v1/servicecas

HTTP方法

DELETE

描述

删除ServiceCA集合

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

200 - OK

Status 模式

401 - 未授权

空
HTTP方法

GET

描述

列出ServiceCA类型的对象

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

200 - OK

ServiceCAList 模式

401 - 未授权

空
HTTP方法

POST

描述

创建一个ServiceCA

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

dryRun

字符串

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

fieldValidation

字符串

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

body

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

200 - OK

ServiceCA 模式

201 - 已创建

ServiceCA 模式

202 - 已接受

ServiceCA 模式

401 - 未授权

空

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

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

name

字符串

ServiceCA的名称
HTTP方法

DELETE

描述

删除一个ServiceCA

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

dryRun

字符串

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

200 - OK

Status 模式

202 - 已接受

Status 模式

401 - 未授权

空
HTTP方法

GET

描述

读取指定的ServiceCA

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

200 - OK

ServiceCA 模式

401 - 未授权

空
HTTP方法

PATCH

描述

部分更新指定的ServiceCA

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

dryRun

字符串

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

fieldValidation

字符串

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

200 - OK

ServiceCA 模式

401 - 未授权

空
HTTP方法

PUT

描述

替换指定的ServiceCA

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

dryRun

字符串

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

fieldValidation

字符串

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

body

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

200 - OK

ServiceCA 模式

201 - 已创建

ServiceCA 模式

401 - 未授权

空

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

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

name

字符串

ServiceCA的名称
HTTP方法

GET

描述

读取指定的ServiceCA的状态

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

200 - OK

ServiceCA 模式

401 - 未授权

空
HTTP方法

PATCH

描述

部分更新指定的ServiceCA的状态

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

dryRun

字符串

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

fieldValidation

字符串

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

200 - OK

ServiceCA 模式

401 - 未授权

空
HTTP方法

PUT

描述

替换指定的ServiceCA的状态

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

dryRun

字符串

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

fieldValidation

字符串

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

body

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

200 - OK

ServiceCA 模式

201 - 已创建

ServiceCA 模式

401 - 未授权

空