主页
产品
Red Hat Quay
3.2
测试 REST
18.8. Config [samples.operator.openshift.io/v1]

18.8. Config [samples.operator.openshift.io/v1]

描述

config 包含 Samples Operator 的配置和详细条件状态。

类型

对象

必填

metadata
spec

18.8.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`	`对象`	ConfigSpec 包含 Samples Operator 所需的配置和状态，控制它在 openshift 命名空间中创建/更新镜像流和模板的各种行为。
`status`	`对象`	ConfigStatus 包含生效的实际配置，以及描述 Samples Operator 状态的各种详情。

18.8.1.1. .spec
复制链接

描述: ConfigSpec 包含 Samples Operator 所需的配置和状态，控制它在 openshift 命名空间中创建/更新镜像流和模板的各种行为。
类型: 对象

Expand

属性	类型	描述
`architectures`	`数组（字符串）`	架构决定要安装的硬件架构，其中 x86_64、ppc64le 和 s390x 是当前唯一支持的选择。
`managementState`	`字符串`	managementState 是所有 Operator 的顶级开启/关闭类型的交换机。当 "Managed" 时，此操作器会处理配置并相应地操作示例。当 "Unmanaged" 时，此操作器会忽略它监视的资源的任何更新。当 "Removed" 时，它响应与删除 Config 对象时相同，这意味着它管理的任何 ImageStream 或模板（例如，它遵循跳过的列表）并删除 registry secret，以及代表操作示例的最后配置的 operator 命名空间中的 ConfigMap。
`samplesRegistry`	`字符串`	samplesRegistry 允许规格 ImageStreams 访问哪个 registry 的内容。默认为拉取到此 github 软件仓库的 https://github.com/openshift/library 内容，但基于我们拉取的 ocp 内容，它通常默认为 registry.redhat.io。
`skippedImagestreams`	`数组（字符串）`	skippedImagestreams 指定不应创建/更新的镜像流的名称。管理员可以使用此选项删除他们不希望的内容。它们仍然需要手动删除内容，但 Operator 不会重新创建（或更新）任何列出的内容。
`skippedTemplates`	`数组（字符串）`	skippedTemplates 指定不应创建/更新的模板名称。管理员可以使用此选项删除他们不希望的内容。它们仍然需要手动删除内容，但 Operator 不会重新创建（或更新）任何列出的内容。

18.8.1.2. .status
复制链接

描述: ConfigStatus 包含生效的实际配置，以及描述 Samples Operator 状态的各种详情。
类型: 对象

Expand

属性	类型	描述
`architectures`	`数组（字符串）`	架构决定要安装的硬件架构，其中 x86_64 和 ppc64le 是支持的选择。
`conditions`	`array`	条件代表示例镜像流和模板的可用维护状态。
`conditions[]`	`对象`	ConfigCondition 在处理条目时捕获 Config 的各种条件。
`managementState`	`字符串`	managementState 反映了 Operator 的 on/off 开关的当前操作状态。此 operator 将 ManagementState 进行比较，作为确定我们重新打开 Operator 的一部分（例如："managed"，当之前被"非受管"时。
`samplesRegistry`	`字符串`	samplesRegistry 允许规格 ImageStreams 访问哪个 registry 的内容。默认为拉取到此 github 软件仓库的 https://github.com/openshift/library 内容，但基于我们拉取的 ocp 内容，它通常默认为 registry.redhat.io。
`skippedImagestreams`	`数组（字符串）`	skippedImagestreams 指定不应创建/更新的镜像流的名称。管理员可以使用此选项删除他们不希望的内容。它们仍然需要手动删除内容，但 Operator 不会重新创建（或更新）任何列出的内容。
`skippedTemplates`	`数组（字符串）`	skippedTemplates 指定不应创建/更新的模板名称。管理员可以使用此选项删除他们不希望的内容。它们仍然需要手动删除内容，但 Operator 不会重新创建（或更新）任何列出的内容。
`version`	`字符串`	version 是 Operator 在最后一次成功处理时基于 Operator 的有效负载指标的值

18.8.1.3. .status.conditions
复制链接

描述: 条件代表示例镜像流和模板的可用维护状态。
类型: array

18.8.1.4. .status.conditions[]
复制链接

描述

ConfigCondition 在处理条目时捕获 Config 的各种条件。

类型

对象

必填

status
type

Expand

属性	类型	描述
`lastTransitionTime`	`字符串`	lastTransitionTime 是条件从一个状态转换到另一个状态最后一次的时间。
`lastUpdateTime`	`字符串`	lastUpdateTime 是最后一次更新此条件的时间。
`message`	`字符串`	Message 是人类可读的消息，指示有关转换的详细信息。
`reason`	`字符串`	原因是导致条件最后一次转换的原因。
`status`	`字符串`	条件的状态，True, False, Unknown 之一。
`type`	`字符串`	条件类型。

18.8.2. API 端点
复制链接

可用的 API 端点如下：

/apis/samples.operator.openshift.io/v1/configs
- DELETE ：删除配置的集合
- GET ：列出类型为 Config 的对象
- POST ：创建配置
/apis/samples.operator.openshift.io/v1/configs/{name}
- DELETE ：删除配置
- GET ：读取指定的配置
- PATCH ：部分更新指定的配置
- PUT ：替换指定的配置
/apis/samples.operator.openshift.io/v1/configs/{name}/status
- GET ：指定配置的读取状态
- PATCH ：部分更新指定配置的状态
- PUT ：替换指定配置的状态

18.8.2.1. /apis/samples.operator.openshift.io/v1/configs
复制链接

Expand

表 18.187. 全局查询参数
参数	类型	描述
`pretty`	`字符串`	如果 'true'，则输出被用户友善。

HTTP 方法: DELETE
描述: 删除配置集合

Expand

表 18.188. 查询参数
参数	类型	描述
`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.189. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Status_v2` 模式
401 - Unauthorized	空

HTTP 方法: GET
描述: 列出类型为 Config 的对象

Expand

表 18.190. 查询参数
参数	类型	描述
`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.191. HTTP 响应
HTTP 代码	响应正文
200 - OK	`ConfigList` schema
401 - Unauthorized	空

HTTP 方法: POST
描述: 创建配置

Expand

表 18.192. 查询参数
参数	类型	描述
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`fieldManager`	`字符串`	fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand

表 18.193. 主体参数
参数	类型	描述
`正文（body）`	`Config` 模式

Expand

表 18.194. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Config` 模式
201 - Created	`Config` 模式
202 - Accepted	`Config` 模式
401 - Unauthorized	空

18.8.2.2. /apis/samples.operator.openshift.io/v1/configs/{name}
复制链接

Expand

表 18.195. 全局路径参数
参数	类型	描述
`name`	`字符串`	配置的名称

Expand

表 18.196. 全局查询参数
参数	类型	描述
`pretty`	`字符串`	如果 'true'，则输出被用户友善。

HTTP 方法: DELETE
描述: 删除配置

Expand

表 18.197. 查询参数
参数	类型	描述
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`gracePeriodSeconds`	`整数`	应该删除对象前的持续时间（以秒为单位）。值必须是非负整数。值零表示立即删除。如果这个值是 nil，则使用指定类型的默认宽限期。如果没有指定，则默认为每个对象值。零表示立即删除。
`orphanDependents`	`布尔值`	弃用：请使用 PropagationPolicy，此字段将在 1.7 中被弃用。应该依赖的对象被孤立。如果为 true/false，"orphan"终结器将从对象的终结器列表添加到/删除。可以设置此字段或 PropagationPolicy，但不能同时设置两者。
`propagationPolicy`	`字符串`	是否以及是否执行垃圾回收。此字段或 OrphanDependents 可以设置，但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值为： 'Orphan' - 孤立依赖; 'Background' - 允许垃圾收集器在后台删除依赖的依赖关系； 'Foreground' - 一个删除前台所有依赖的级联策略。

Expand

表 18.198. 主体参数
参数	类型	描述
`正文（body）`	`DeleteOptions_v2` schema

Expand

表 18.199. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Status_v2` 模式
202 - Accepted	`Status_v2` 模式
401 - Unauthorized	空

HTTP 方法: GET
描述: 读取指定的配置

Expand

表 18.200. 查询参数
参数	类型	描述
`resourceVersion`	`字符串`	resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置

Expand

表 18.201. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Config` 模式
401 - Unauthorized	空

HTTP 方法: PATCH
描述: 部分更新指定的配置

Expand

表 18.202. 查询参数
参数	类型	描述
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`fieldManager`	`字符串`	fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand

表 18.203. 主体参数
参数	类型	描述
`正文（body）`	`Patch` 模式

Expand

表 18.204. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Config` 模式
401 - Unauthorized	空

HTTP 方法: PUT
描述: 替换指定的配置

Expand

表 18.205. 查询参数
参数	类型	描述
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`fieldManager`	`字符串`	fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand

表 18.206. 主体参数
参数	类型	描述
`正文（body）`	`Config` 模式

Expand

表 18.207. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Config` 模式
201 - Created	`Config` 模式
401 - Unauthorized	空

18.8.2.3. /apis/samples.operator.openshift.io/v1/configs/{name}/status
复制链接

Expand

表 18.208. 全局路径参数
参数	类型	描述
`name`	`字符串`	配置的名称

Expand

表 18.209. 全局查询参数
参数	类型	描述
`pretty`	`字符串`	如果 'true'，则输出被用户友善。

HTTP 方法: GET
描述: 指定配置的读取状态

Expand

表 18.210. 查询参数
参数	类型	描述
`resourceVersion`	`字符串`	resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置

Expand

表 18.211. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Config` 模式
401 - Unauthorized	空

HTTP 方法: PATCH
描述: 指定 Config 的部分更新状态

Expand

表 18.212. 查询参数
参数	类型	描述
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`fieldManager`	`字符串`	fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand

表 18.213. 主体参数
参数	类型	描述
`正文（body）`	`Patch` 模式

Expand

表 18.214. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Config` 模式
401 - Unauthorized	空

HTTP 方法: PUT
描述: 替换指定配置的状态

Expand

表 18.215. 查询参数
参数	类型	描述
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`fieldManager`	`字符串`	fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand

表 18.216. 主体参数
参数	类型	描述
`正文（body）`	`Config` 模式

Expand

表 18.217. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Config` 模式
201 - Created	`Config` 模式
401 - Unauthorized	空

返回顶部

18.8. Config [samples.operator.openshift.io/v1]

18.8.1. 规格
复制链接

18.8.1.1. .spec
复制链接

18.8.1.2. .status
复制链接

18.8.1.3. .status.conditions
复制链接

18.8.1.4. .status.conditions[]
复制链接

18.8.2. API 端点
复制链接

18.8.2.1. /apis/samples.operator.openshift.io/v1/configs
复制链接

18.8.2.2. /apis/samples.operator.openshift.io/v1/configs/{name}
复制链接

18.8.2.3. /apis/samples.operator.openshift.io/v1/configs/{name}/status
复制链接

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

18.8. Config [samples.operator.openshift.io/v1]

18.8.1. 规格复制链接链接已复制到粘贴板!

18.8.1.1. .spec复制链接链接已复制到粘贴板!

18.8.1.2. .status复制链接链接已复制到粘贴板!

18.8.1.3. .status.conditions复制链接链接已复制到粘贴板!

18.8.1.4. .status.conditions[]复制链接链接已复制到粘贴板!

18.8.2. API 端点复制链接链接已复制到粘贴板!

18.8.2.1. /apis/samples.operator.openshift.io/v1/configs复制链接链接已复制到粘贴板!

18.8.2.2. /apis/samples.operator.openshift.io/v1/configs/{name}复制链接链接已复制到粘贴板!

18.8.2.3. /apis/samples.operator.openshift.io/v1/configs/{name}/status复制链接链接已复制到粘贴板!

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

18.8.1. 规格
复制链接

18.8.1.1. .spec
复制链接

18.8.1.2. .status
复制链接

18.8.1.3. .status.conditions
复制链接

18.8.1.4. .status.conditions[]
复制链接

18.8.2. API 端点
复制链接

18.8.2.1. /apis/samples.operator.openshift.io/v1/configs
复制链接

18.8.2.2. /apis/samples.operator.openshift.io/v1/configs/{name}
复制链接

18.8.2.3. /apis/samples.operator.openshift.io/v1/configs/{name}/status
复制链接