Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

11.4. ImageStreamImage [image.openshift.io/v1]

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

11.4.1. 规格
复制链接

Expand
属性类型描述

apiVersion

字符串

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

image

对象

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

kind

字符串

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

metadata

ObjectMeta

 

11.4.1.1. .image
复制链接

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

apiVersion

字符串

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

dockerImageConfig

字符串

DockerImageConfig 是一个 JSON blob，运行时用于设置容器。这是清单模式 v2 的一部分。

dockerImageLayers

array

dockerImageLayers 代表镜像中的层。如果镜像没有定义这些数据，则无法设置。

dockerImageLayers[]

对象

ImageLayer 代表镜像的一个层。有些镜像可能有多个层。有些内容可能没有。

dockerImageManifest

字符串

DockerImageManifest 是清单的原始 JSON

dockerImageManifestMediaType

字符串

DockerImageManifestMediaType 指定清单的 mediaType。这是清单模式 v2 的一部分。

dockerImageMetadata

RawExtension

dockerImageMetadata 包含有关此镜像的元数据

dockerImageMetadataVersion

字符串

dockerImageMetadataVersion 传递了对象的版本，如果为空默认为 "1.0"

dockerImageReference

字符串

dockerImageReference 是可用于拉取此镜像的字符串。

dockerImageSignatures

数组（字符串）

DockerImageSignatures 提供签名作为不透明 Blob。这是清单模式 v1 的一部分。

kind

字符串

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

metadata

ObjectMeta

 

签名

array

签名包含镜像的所有签名。

signatures[]

对象

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

11.4.1.2. .image.dockerImageLayers
复制链接

描述
dockerImageLayers 代表镜像中的层。如果镜像没有定义这些数据，则无法设置。
类型
array

11.4.1.3. .image.dockerImageLayers[]
复制链接

描述
ImageLayer 代表镜像的一个层。有些镜像可能有多个层。有些内容可能没有。
类型
对象
必填
  • name
  • size
  • mediaType
Expand
属性类型描述

mediaType

字符串

引用对象的 MediaType。

name

字符串

底层存储定义的层名称。

size

整数

由底层存储定义的层大小（以字节为单位）。

11.4.1.4. .image.signatures
复制链接

描述
签名包含镜像的所有签名。
类型
array

11.4.1.5. .image.signatures[]
复制链接

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

apiVersion

字符串

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

conditions

array

条件代表签名当前状态的最新可用影响。

conditions[]

对象

SignatureCondition 描述了特定探测时特定类型的镜像签名条件。

content

字符串

必需：不透明二进制字符串，即镜像签名。

created

time

如果指定，这是签名创建的时间。

imageIdentity

字符串

代表镜像身份的人类可读字符串。它可以是产品名称和版本，也可以是镜像拉取规格（如 "registry.access.redhat.com/rhel7/rhel:7.2"）。

issuedBy

对象

SignatureIssuer 包含有关签名证书或密钥签发者的信息。

issuedTo

对象

签名Subject 包含有关创建签名的个人或实体的信息。

kind

字符串

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

metadata

ObjectMeta

 

signedClaims

对象（字符串）

包含来自签名的声明。

type

字符串

必需：描述存储的 blob 类型。

11.4.1.6. .image.signatures[].conditions
复制链接

描述
条件代表签名当前状态的最新可用影响。
类型
array

11.4.1.7. .image.signatures[].conditions[]
复制链接

描述
SignatureCondition 描述了特定探测时特定类型的镜像签名条件。
类型
对象
必填
  • type
  • status
Expand
属性类型描述

lastProbeTime

time

检查条件最后一次的时间。

lastTransitionTime

time

条件从一个状态传输到另一个状态最后一次的时间。

message

字符串

人类可读的消息，指示最后一次转换的详细信息。

reason

字符串

(brief)条件最后一次转换的原因。

status

字符串

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

type

字符串

签名条件类型，完成或失败。

11.4.1.8. .image.signatures[].issuedBy
复制链接

描述
SignatureIssuer 包含有关签名证书或密钥签发者的信息。
类型
对象
Expand
属性类型描述

commonName

字符串

通用名称（如 openshift-signing-service）。

机构

字符串

机构名称。

11.4.1.9. .image.signatures[].issuedTo
复制链接

描述
签名Subject 包含有关创建签名的个人或实体的信息。
类型
对象
必填
  • publicKeyID
Expand
属性类型描述

commonName

字符串

通用名称（如 openshift-signing-service）。

机构

字符串

机构名称。

publicKeyID

字符串

如果存在，它是属于验证镜像签名的主题的公钥的人类可读密钥 ID。它应至少包含 64 位公钥的指纹（例如 0x685ebe62bf278440）。

11.4.2. API 端点
复制链接

可用的 API 端点如下：

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

    • GET ：读取指定的 ImageStreamImage
Expand
表 11.34. 全局路径参数
参数类型描述

name

字符串

ImageStreamImage 的名称

namespace

字符串

对象名称和身份验证范围，如团队和项目

Expand
表 11.35. 全局查询参数
参数类型描述

pretty

字符串

如果 'true'，则输出被用户友善。

HTTP 方法
GET
描述
读取指定的 ImageStreamImage
Expand
表 11.36. HTTP 响应
HTTP 代码响应正文

200 - OK

ImageStreamImage schema

401 - Unauthorized

空

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat