第 11 章镜像 API

11.1. 镜像 API
复制链接

11.1.1. Image [image.openshift.io/v1]
复制链接

描述: 镜像是容器镜像和元数据的不可变表示。镜像通过取其内容的哈希值（元数据和内容）以及格式、内容或元数据的更改来命名，这会导致新名称。images 资源主要供集群管理员使用，以及集群镜像 registry 等集成 - 最终用户通过 imagestreamtags 或 imagestreamimages 资源访问镜像。虽然镜像元数据存储在 API 中，实现容器镜像 registry API 的任何集成都必须为原始清单数据、镜像配置和层内容提供自己的存储。
类型: 对象

11.1.2. ImageSignature [image.openshift.io/v1]
复制链接

描述: 镜像签名包含镜像签名。只要签名被信任，就可以验证镜像身份和其他声明。根据此信息，可以将可运行的镜像限制为匹配的集群范围策略。必要字段应由执行镜像验证的客户端解析。其他对象由服务器从签名的内容解析。它们只用于说明目的。
类型: 对象

11.1.3. ImageStreamImage [image.openshift.io/v1]
复制链接

描述: ImageStreamImage 代表由来自 ImageStream 的镜像名称检索的镜像。用户界面和常规用户可以使用此资源来访问镜像流历史记录中标记的镜像的元数据详情，因为最终用户无法直接访问镜像资源。如果没有通过 ImageStream 中的标签引用这样的镜像，则返回一个 not found 错误。当在代表外部 registry 中的镜像的镜像流上设置 spec 标签时，镜像会被创建，当推送到集成 registry 时，或者在将现有镜像从一个镜像流标记到另一个镜像流时创建。镜像流镜像的名称采用 "<STREAM>@<DIGEST>" 格式，其中 digest 是镜像(sha256:xxxxx…)的内容地址标识符。您可以使用 ImageStreamImages 作为镜像流标签的 from.kind 来完全引用镜像。imagestreamimage 端点上唯一支持的操作才会检索镜像。
类型: 对象

11.1.4. ImageStreamImport [image.openshift.io/v1]
复制链接

描述

镜像流导入资源为用户提供了从其他容器镜像 registry 中查找和导入容器镜像至服务器的简单方法。可能会导入单个镜像或整个镜像存储库，用户可以在将生成的镜像标记到指定镜像流前查看导入的结果。

此 API 适用于需要查看导入前镜像元数据的最终用户工具（例如，从其中生成应用程序）。知道所需镜像的客户端可以继续直接在其镜像流中创建 spec.tags。

类型

对象

11.1.5. ImageStreamLayers [image.openshift.io/v1]
复制链接

描述: ImageStreamLayers 描述了此镜像流中镜像引用的层的信息。
类型: 对象

11.1.6. ImageStreamMapping [image.openshift.io/v1]
复制链接

描述: ImageStreamMapping 代表从单个镜像流标签到容器镜像的映射，以及镜像来自的容器镜像的引用。特权集成器使用此资源来创建镜像资源，并将其与 status tags 字段中的镜像流关联。创建 ImageStreamMapping 将允许任何可以查看镜像流的用户进行标签或拉取该镜像，因此仅创建用户能够直接访问镜像内容的用户。此资源唯一支持的操作是 create，元数据名称和命名空间应设置为包含应更新的标签的镜像流。
类型: 对象

11.1.7. ImageStream [image.openshift.io/v1]
复制链接

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

11.1.8. ImageStreamTag [image.openshift.io/v1]
复制链接

描述: ImageStreamTag 代表通过来自 ImageStream 的标签名称检索的镜像。使用此资源通过标签与镜像流中的标签和镜像交互，或者查看特定标签的镜像详情。与此资源关联的镜像是最近标记、导入或推送镜像（如此标签的镜像流 status.tags.items 列表中所述）。如果导入正在进行，或者显示上一个镜像失败。删除镜像流标签会清除镜像流的 status 和 spec 字段。如果没有可为给定标签检索镜像，则返回未找到的错误。
类型: 对象

11.1.9. ImageTag [image.openshift.io/v1]
复制链接

描述: ImageTag 代表镜像流中的单个标签，包括 spec、状态历史记录和当前引用的镜像（若有）。此类型通过提供标签的完整视图来替换 ImageStreamTag。为镜像流上存在的每个 spec 或 status 标签返回 imagetags。如果任一形式都不存在标签，API 将返回 not found 错误。如果尚未定义 spec 标签并且设置了 spec 字段，则 create 操作将成功。delete 将从镜像流中删除 spec 和 status 元素。
类型: 对象

11.1.10. SecretList [image.openshift.io/v1]
复制链接

描述: SecretList 是 Secret 列表。
类型: 对象

返回顶部

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat