ImageStream [image.openshift.io/v1] - 镜像API | API 参考 | OpenShift Container Platform 4.17

描述: ImageStream 存储标签与镜像的映射、应用于流中标记镜像时的元数据覆盖以及对注册表上容器镜像存储库的可选引用。用户通常会更新 spec.tags 字段以指向外部镜像（使用您命名空间中具有 pull secret 类型的凭据从容器注册表导入）或指向可立即访问以进行标记或拉取的现有镜像流标签和镜像。应用于标签的镜像历史记录在 status.tags 字段中可见，任何可以查看镜像流的用户都可以将该镜像标记到他们自己的镜像流中。对从集成注册表拉取镜像的访问权限是通过对给定镜像流具有“获取 imagestreams/layers”权限来授予的。用户可以通过删除 imagestreamtag 资源来删除标签，这会导致该标签的 spec 和 status 都被删除。镜像流历史记录会保留，直到管理员运行修剪操作，该操作会删除不再使用的引用。要保留历史镜像，请确保 spec 中有一个标签指向该镜像及其摘要。

兼容性级别 1：在主要版本中至少稳定 12 个月或 3 个次要版本（以较长者为准）。
类型: 对象

规范

属性类型描述

属性	类型	描述
`apiVersion`	`字符串`	APIVersion 定义了此对象表示的版本化模式。服务器应将识别的模式转换为最新的内部值，并可能拒绝无法识别的值。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`种类`	`字符串`	Kind 是一个字符串值，表示此对象所代表的 REST 资源。服务器可以从客户端提交请求的端点推断出这一点。无法更新。使用驼峰命名法。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`元数据`	`ObjectMeta_v2`	metadata 是标准对象的元数据。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`规范`	`对象`	ImageStreamSpec 代表 ImageStream 的选项。
`状态`	`对象`	ImageStreamStatus 包含有关此镜像流状态的信息。

apiVersion

字符串

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

种类

字符串

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

元数据

ObjectMeta_v2

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

规范

对象

ImageStreamSpec 代表 ImageStream 的选项。

状态

对象

ImageStreamStatus 包含有关此镜像流状态的信息。

.spec

描述: ImageStreamSpec 代表 ImageStream 的选项。
类型: 对象

属性类型描述

属性	类型	描述
`dockerImageRepository`	`字符串`	dockerImageRepository 是可选的，如果指定，则此流由该服务器上的容器仓库支持已弃用：此字段自 v3.7 版本起已弃用，将在未来版本中删除。请改用 spec.tags.from 引用来指定要导入的标签的源。
`查找策略`	`对象`	ImageLookupPolicy 描述了如何使用镜像流来覆盖命名空间中 Pod、构建和其他资源使用的镜像引用。
`标签`	`数组`	tags 将任意字符串值映射到特定的镜像定位符。
`tags[]`	`对象`	TagReference 指定使用此标签的镜像的可选注释，以及此标签应跟踪的 ImageStreamTag、ImageStreamImage 或 DockerImage 的可选引用。

dockerImageRepository

字符串

dockerImageRepository 是可选的，如果指定，则此流由该服务器上的容器仓库支持已弃用：此字段自 v3.7 版本起已弃用，将在未来版本中删除。请改用 spec.tags.from 引用来指定要导入的标签的源。

查找策略

对象

ImageLookupPolicy 描述了如何使用镜像流来覆盖命名空间中 Pod、构建和其他资源使用的镜像引用。

标签

数组

tags 将任意字符串值映射到特定的镜像定位符。

tags[]

对象

TagReference 指定使用此标签的镜像的可选注释，以及此标签应跟踪的 ImageStreamTag、ImageStreamImage 或 DockerImage 的可选引用。

.spec.lookupPolicy

描述

ImageLookupPolicy 描述了如何使用镜像流来覆盖命名空间中 Pod、构建和其他资源使用的镜像引用。

类型

对象

必需

本地

属性类型描述

属性	类型	描述
`本地`	`布尔值`	local 将更改此命名空间中对象的 Docker 简短镜像引用（例如“mysql”或“php:latest”），使其在与该镜像流匹配时变为镜像 ID，而不是访问远程注册表。如果找到，名称将被完全限定为镜像 ID。替换值将考虑标签的 referencePolicy。仅在当前命名空间内有效。

本地

布尔值

local 将更改此命名空间中对象的 Docker 简短镜像引用（例如“mysql”或“php:latest”），使其在与该镜像流匹配时变为镜像 ID，而不是访问远程注册表。如果找到，名称将被完全限定为镜像 ID。替换值将考虑标签的 referencePolicy。仅在当前命名空间内有效。

.spec.tags

描述: tags 将任意字符串值映射到特定的镜像定位符。
类型: 数组

.spec.tags[]

描述

TagReference 指定使用此标签的镜像的可选注释，以及此标签应跟踪的 ImageStreamTag、ImageStreamImage 或 DockerImage 的可选引用。

类型

对象

必需

名称

属性类型描述

属性	类型	描述
`注释`	`对象（字符串）`	可选；如果指定，则将应用于通过 ImageStreamTags 获取的镜像的注释。
`来自`	`ObjectReference`	可选；如果指定，则引用此标签应指向的另一个镜像。有效值为 ImageStreamTag、ImageStreamImage 和 DockerImage。ImageStreamTag 引用只能引用此相同 ImageStream 中的标签。
`代`	`整数`	Generation 是一个计数器，用于跟踪对 spec 标签（用户意图）的更改。当标签引用更改时，generation 将设置为与当前流 generation（每次更改 spec 时都会递增）匹配。系统中的其他进程（如镜像导入程序）会观察到 spec 标签的 generation 比 status 中记录的 generation 更新，并将其用作导入最新远程标签的触发器。为了触发新的导入，客户端可以将此值设置为零，这将把 generation 重置为最新的流 generation。旧版客户端会将此值发送为 nil，这将与当前标签 generation 合并。
`导入策略`	`对象`	TagImportPolicy 控制如何导入与此标签相关的镜像。
`名称`	`字符串`	标签名称
`引用`	`布尔值`	Reference 指明是否将导入标签。默认值为 false，这意味着将导入标签。
`引用策略`	`对象`	TagReferencePolicy 描述了当部署配置或构建中的镜像更改触发器被解析时，如何生成此镜像流标签中镜像的 pull-spec。这允许镜像流作者控制如何访问镜像。

注释

对象（字符串）

可选；如果指定，则将应用于通过 ImageStreamTags 获取的镜像的注释。

来自

ObjectReference

可选；如果指定，则引用此标签应指向的另一个镜像。有效值为 ImageStreamTag、ImageStreamImage 和 DockerImage。ImageStreamTag 引用只能引用此相同 ImageStream 中的标签。

代

整数

Generation 是一个计数器，用于跟踪对 spec 标签（用户意图）的更改。当标签引用更改时，generation 将设置为与当前流 generation（每次更改 spec 时都会递增）匹配。系统中的其他进程（如镜像导入程序）会观察到 spec 标签的 generation 比 status 中记录的 generation 更新，并将其用作导入最新远程标签的触发器。为了触发新的导入，客户端可以将此值设置为零，这将把 generation 重置为最新的流 generation。旧版客户端会将此值发送为 nil，这将与当前标签 generation 合并。

导入策略

对象

TagImportPolicy 控制如何导入与此标签相关的镜像。

名称

字符串

标签名称

引用

布尔值

Reference 指明是否将导入标签。默认值为 false，这意味着将导入标签。

引用策略

对象

TagReferencePolicy 描述了当部署配置或构建中的镜像更改触发器被解析时，如何生成此镜像流标签中镜像的 pull-spec。这允许镜像流作者控制如何访问镜像。

.spec.tags[].importPolicy

描述: TagImportPolicy 控制如何导入与此标签相关的镜像。
类型: 对象

属性类型描述

属性	类型	描述
`导入模式`	`字符串`	ImportMode 描述如何导入镜像清单。
`不安全`	`布尔值`	如果服务器可能在镜像导入期间绕过证书验证或直接通过 HTTP 连接，则 Insecure 为 true。
`已计划`	`布尔值`	Scheduled 向服务器指示应定期检查此标签以确保其是最新的，并已导入。

导入模式

字符串

ImportMode 描述如何导入镜像清单。

不安全

布尔值

如果服务器可能在镜像导入期间绕过证书验证或直接通过 HTTP 连接，则 Insecure 为 true。

已计划

布尔值

Scheduled 向服务器指示应定期检查此标签以确保其是最新的，并已导入。

.spec.tags[].referencePolicy

描述

TagReferencePolicy 描述了当部署配置或构建中的镜像更改触发器被解析时，如何生成此镜像流标签中镜像的 pull-spec。这允许镜像流作者控制如何访问镜像。

类型

对象

必需

类型

属性类型描述

属性	类型	描述
`类型`	`字符串`	Type 确定当在部署配置触发器或新构建中使用镜像流标签时，应如何转换镜像 pull spec。默认值为 `Source`，表示应使用镜像的原始位置（如果已导入）。用户也可以指定 `Local`，表示 pull spec 应指向集成的容器镜像注册表，并利用注册表将 pull 代理到上游注册表的功能。`Local` 允许从镜像流的命名空间管理用于拉取此镜像的凭据，因此平台上的其他人可以访问远程镜像，但无权访问远程密钥。它还允许将镜像层镜像到本地注册表中，即使上游注册表不可用，也可以拉取镜像。

类型

字符串

Type 确定当在部署配置触发器或新构建中使用镜像流标签时，应如何转换镜像 pull spec。默认值为 `Source`，表示应使用镜像的原始位置（如果已导入）。用户也可以指定 `Local`，表示 pull spec 应指向集成的容器镜像注册表，并利用注册表将 pull 代理到上游注册表的功能。`Local` 允许从镜像流的命名空间管理用于拉取此镜像的凭据，因此平台上的其他人可以访问远程镜像，但无权访问远程密钥。它还允许将镜像层镜像到本地注册表中，即使上游注册表不可用，也可以拉取镜像。

.status

描述

ImageStreamStatus 包含有关此镜像流状态的信息。

类型

对象

必需

dockerImageRepository

属性类型描述

属性	类型	描述
`dockerImageRepository`	`字符串`	DockerImageRepository 代表此流可以访问的有效位置。在服务器确定仓库位置之前，它可能是空的。
`publicDockerImageRepository`	`字符串`	PublicDockerImageRepository 表示可以从集群外部提取镜像的公共位置。如果管理员没有公开集成的注册表，则此字段可能为空。
`标签`	`数组`	Tags 是与每个标签关联的镜像的历史记录。TagEvent 数组中的第一个条目是当前标记的镜像。
`tags[]`	`对象`	NamedTagEventList 将标签与其镜像历史记录关联起来。

dockerImageRepository

字符串

DockerImageRepository 代表此流可以访问的有效位置。在服务器确定仓库位置之前，它可能是空的。

publicDockerImageRepository

字符串

PublicDockerImageRepository 表示可以从集群外部提取镜像的公共位置。如果管理员没有公开集成的注册表，则此字段可能为空。

标签

数组

Tags 是与每个标签关联的镜像的历史记录。TagEvent 数组中的第一个条目是当前标记的镜像。

tags[]

对象

NamedTagEventList 将标签与其镜像历史记录关联起来。

.status.tags

描述: Tags 是与每个标签关联的镜像的历史记录。TagEvent 数组中的第一个条目是当前标记的镜像。
类型: 数组

.status.tags[]

描述

NamedTagEventList 将标签与其镜像历史记录关联起来。

类型

对象

必需

标签
项目

属性类型描述

属性	类型	描述
`条件`	`数组`	Conditions 是应用于标签事件列表的一组条件的数组。
`conditions[]`	`对象`	TagEventCondition 包含标签事件的条件信息。
`项目`	`数组`	标准对象的元数据。
`items[]`	`对象`	TagEvent 由 ImageStreamStatus 用于保存与标签关联的镜像的历史记录。
`标签`	`字符串`	Tag 是记录其历史记录的标签。

条件

数组

Conditions 是应用于标签事件列表的一组条件的数组。

conditions[]

对象

TagEventCondition 包含标签事件的条件信息。

项目

数组

标准对象的元数据。

items[]

对象

TagEvent 由 ImageStreamStatus 用于保存与标签关联的镜像的历史记录。

标签

字符串

Tag 是记录其历史记录的标签。

.status.tags[].conditions

描述: Conditions 是应用于标签事件列表的一组条件的数组。
类型: 数组

.status.tags[].conditions[]

描述

TagEventCondition 包含标签事件的条件信息。

类型

对象

必需

类型
状态
代

属性类型描述

属性	类型	描述
`代`	`整数`	Generation 是此状态对应的 spec 标签 generation。
`最后转换时间`	`时间`	LastTransitionTIme 是条件从一种状态转换为另一种状态的时间。
`消息`	`字符串`	Message 是关于最后一次转换的详细信息的人类可读描述，补充了原因。
`原因`	`字符串`	Reason 是对条件最后一次转换的简短机器可读解释。
`状态`	`字符串`	条件的状态，True、False、Unknown 之一。
`类型`	`字符串`	标签事件条件的类型，目前只有 ImportSuccess。

代

整数

Generation 是此状态对应的 spec 标签 generation。

最后转换时间

时间

LastTransitionTIme 是条件从一种状态转换为另一种状态的时间。

消息

字符串

Message 是关于最后一次转换的详细信息的人类可读描述，补充了原因。

原因

字符串

Reason 是对条件最后一次转换的简短机器可读解释。

状态

字符串

条件的状态，True、False、Unknown 之一。

类型

字符串

标签事件条件的类型，目前只有 ImportSuccess。

.status.tags[].items

描述: 标准对象的元数据。
类型: 数组

.status.tags[].items[]

描述

TagEvent 由 ImageStreamStatus 用于保存与标签关联的镜像的历史记录。

类型

对象

必需

创建
dockerImageReference
镜像
代

属性类型描述

属性	类型	描述
`创建`	`时间`	Created 包含创建 TagEvent 的时间。
`dockerImageReference`	`字符串`	DockerImageReference 是可用于提取此镜像的字符串。
`代`	`整数`	Generation 是导致此标签更新的 spec 标签 generation。
`镜像`	`字符串`	Image 是镜像。

创建

时间

Created 包含创建 TagEvent 的时间。

dockerImageReference

字符串

DockerImageReference 是可用于提取此镜像的字符串。

代

整数

Generation 是导致此标签更新的 spec 标签 generation。

镜像

字符串

Image 是镜像。

API 端点

提供以下 API 端点

/apis/image.openshift.io/v1/imagestreams
- GET：列出或监视 ImageStream 类型的对象。
/apis/image.openshift.io/v1/watch/imagestreams
- GET：监视对 ImageStream 列表的单个更改。已弃用：请改用列表操作中的“watch”参数。
/apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams
- DELETE：删除 ImageStream 集合。
- GET：列出或监视 ImageStream 类型的对象。
- POST：创建一个 ImageStream。
/apis/image.openshift.io/v1/watch/namespaces/{namespace}/imagestreams
- GET：监视对 ImageStream 列表的单个更改。已弃用：请改用列表操作中的“watch”参数。
/apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams/{name}
- DELETE：删除一个 ImageStream。
- GET：读取指定的 ImageStream。
- PATCH：部分更新指定的 ImageStream。
- PUT：替换指定的 ImageStream。
/apis/image.openshift.io/v1/watch/namespaces/{namespace}/imagestreams/{name}
- GET：观察 ImageStream 对象的更改。已弃用：请改用列表操作中的“watch”参数，并使用“fieldSelector”参数将其过滤为单个项目。
/apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams/{name}/status
- GET：读取指定 ImageStream 的状态
- PATCH：部分更新指定 ImageStream 的状态
- PUT：替换指定 ImageStream 的状态

/apis/image.openshift.io/v1/imagestreams

HTTP 方法: GET
描述: 列出或观察 ImageStream 对象

表 1. HTTP 响应
HTTP 代码	响应体
200 - OK	`ImageStreamList` 模式
401 - 未授权	空

/apis/image.openshift.io/v1/watch/imagestreams

HTTP 方法: GET
描述: 观察 ImageStream 列表的单个更改。已弃用：请改用列表操作中的“watch”参数。

表 2. HTTP 响应
HTTP 代码	响应体
200 - OK	`WatchEvent` 模式
401 - 未授权	空

/apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams

HTTP 方法: DELETE
描述: 删除 ImageStream 集合

表 3. 查询参数
参数	类型	描述
`dryRun`	`字符串`	如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

表 4. HTTP 响应
HTTP 代码	响应体
200 - OK	`Status_v5` 模式
401 - 未授权	空

HTTP 方法: GET
描述: 列出或观察 ImageStream 对象

表 5. HTTP 响应
HTTP 代码	响应体
200 - OK	`ImageStreamList` 模式
401 - 未授权	空

HTTP 方法: POST
描述: 创建 ImageStream

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

表 7. 主体参数
参数	类型	描述
`主体`	`ImageStream` 模式

表 8. HTTP 响应
HTTP 代码	响应体
200 - OK	`ImageStream` 模式
201 - 已创建	`ImageStream` 模式
202 - 已接受	`ImageStream` 模式
401 - 未授权	空

/apis/image.openshift.io/v1/watch/namespaces/{namespace}/imagestreams

HTTP 方法: GET
描述: 观察 ImageStream 列表的单个更改。已弃用：请改用列表操作中的“watch”参数。

表 9. HTTP 响应
HTTP 代码	响应体
200 - OK	`WatchEvent` 模式
401 - 未授权	空

/apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams/{name}

表 10. 全局路径参数
参数	类型	描述
`名称`	`字符串`	ImageStream 的名称

HTTP 方法: DELETE
描述: 删除 ImageStream

表 11. 查询参数
参数	类型	描述
`dryRun`	`字符串`	如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

表 12. HTTP 响应
HTTP 代码	响应体
200 - OK	`Status_v5` 模式
202 - 已接受	`Status_v5` 模式
401 - 未授权	空

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

表 13. HTTP 响应
HTTP 代码	响应体
200 - OK	`ImageStream` 模式
401 - 未授权	空

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

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

表 15. HTTP 响应
HTTP 代码	响应体
200 - OK	`ImageStream` 模式
201 - 已创建	`ImageStream` 模式
401 - 未授权	空

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

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

表 17. 主体参数
参数	类型	描述
`主体`	`ImageStream` 模式

表 18. HTTP 响应
HTTP 代码	响应体
200 - OK	`ImageStream` 模式
201 - 已创建	`ImageStream` 模式
401 - 未授权	空

/apis/image.openshift.io/v1/watch/namespaces/{namespace}/imagestreams/{name}

表 19. 全局路径参数
参数	类型	描述
`名称`	`字符串`	ImageStream 的名称

HTTP 方法: GET
描述: 观察 ImageStream 对象的更改。已弃用：请改用列表操作中的“watch”参数，并使用“fieldSelector”参数将其过滤为单个项目。

表 20. HTTP 响应
HTTP 代码	响应体
200 - OK	`WatchEvent` 模式
401 - 未授权	空

/apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams/{name}/status

表 21. 全局路径参数
参数	类型	描述
`名称`	`字符串`	ImageStream 的名称

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

表 22. HTTP 响应
HTTP 代码	响应体
200 - OK	`ImageStream` 模式
401 - 未授权	空

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

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

表 24. HTTP 响应
HTTP 代码	响应体
200 - OK	`ImageStream` 模式
201 - 已创建	`ImageStream` 模式
401 - 未授权	空

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

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

表 26. 主体参数
参数	类型	描述
`主体`	`ImageStream` 模式

表 27. HTTP 响应
HTTP 代码	响应体
200 - OK	`ImageStream` 模式
201 - 已创建	`ImageStream` 模式
401 - 未授权	空