主页
产品
Red Hat Quay
3.2
测试 REST
11.8. ImageStream [image.openshift.io/v1]

11.8. ImageStream [image.openshift.io/v1]

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

11.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`
`spec`	`对象`	ImageStreamSpec 代表 ImageStreams 的选项。
`status`	`对象`	ImageStreamStatus 包含此镜像流状态的信息。

11.8.1.1. .spec
复制链接

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

Expand

属性	类型	描述
`dockerImageRepository`	`字符串`	dockerImageRepository 是可选的，如果指定此流由这个服务器上的容器存储库支持：从 v3.7 开始已弃用，并将在以后的发行版本中删除。通过 spec.tags.from 引用来指定每个标签中要导入的标签的源。
`lookupPolicy`	`对象`	ImageLookupPolicy 描述了如何使用镜像流覆盖命名空间中 pod、构建和其他资源使用的镜像引用。
`tags`	`array`	标签将任意字符串值映射到特定的镜像 locators
`tags[]`	`对象`	TagReference 为使用此标签的镜像指定可选注解，以及此标签应跟踪的 ImageStreamTag、ImageStreamImage 或 DockerImage 的可选引用。

11.8.1.2. .spec.lookupPolicy
复制链接

描述

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

类型

对象

必填

local

Expand

属性	类型	描述
`local`	`布尔值`	每当与此镜像流匹配时，local 会将这个命名空间中的对象上的 docker 短镜像引用（如 "mysql" 或 "php:latest"）更改为镜像 ID，而不是到达远程 registry。如果找到，该名称将完全限定到镜像 ID。标签的 referencePolicy 会考虑替换的值。仅在当前命名空间中工作。

11.8.1.3. .spec.tags
复制链接

描述: 标签将任意字符串值映射到特定的镜像 locators
类型: array

11.8.1.4. .spec.tags[]
复制链接

描述

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

类型

对象

必填

name

Expand

属性	类型	描述
`annotations`	`对象（字符串）`	可选；如果指定，则应用于通过 ImageStreamTags 检索的镜像的注解。
`from`	`ObjectReference_v2`	可选；如果指定，则对此标签应指向的另一个镜像的引用。有效值为 ImageStreamTag、ImageStreamImage 和 DockerImage。ImageStreamTag 引用只能引用同一 ImageStream 中的标签。
`生成`	`整数`	生成是一个计数器，可跟踪到 spec 标签（用户意图）的变异。更改标签引用时，将生成设置为与当前流生成匹配（每次更改 spec 时就会递增）。镜像导入程序等系统中的其他进程会观察生成 spec 标签比状态中记录的生成更新，并使用该触发器导入最新的远程标签。要触发新导入，客户端可能会将此值设置为零，这会将生成重置为最新的流生成。旧客户端会将此值发送为 nil，该值将与当前标签生成合并。
`importPolicy`	`对象`	TagImportPolicy 控制如何导入与此标签相关的镜像。
`name`	`字符串`	标签的名称
`reference`	`布尔值`	引用状态，如果标签将导入。默认值为 false，这意味着将导入标签。
`referencePolicy`	`对象`	TagReferencePolicy 描述了当部署配置或构建中的镜像更改触发器时，此镜像流标签中镜像的 pull-specs 是如何生成的。这允许镜像流作者控制镜像的访问方式。

11.8.1.5. .spec.tags[].importPolicy
复制链接

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

Expand

属性	类型	描述
`insecure`	`布尔值`	如果服务器可以在镜像导入过程中绕过证书验证或直接通过 HTTP 连接，则不安全为 true。
`已调度`	`布尔值`	scheduled 表示应定期检查该标签的服务器以确保它最新并导入

11.8.1.6. .spec.tags[].referencePolicy
复制链接

描述

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

类型

对象

必填

type

Expand

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

11.8.1.7. .status
复制链接

描述

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

类型

对象

必填

dockerImageRepository

Expand

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

11.8.1.8. .status.tags
复制链接

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

11.8.1.9. .status.tags[]
复制链接

描述

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

类型

对象

必填

tag
items

Expand

属性	类型	描述
`conditions`	`array`	conditions 是应用到标签事件列表的条件数组。
`conditions[]`	`对象`	TagEventCondition 包含标签事件的条件信息。
`items`	`array`	标准对象元数据。
`items[]`	`对象`	ImageStreamStatus 使用 TagEvent 来保留与标签关联的镜像的历史记录。
`tag`	`字符串`	tag 是记录历史记录的标签

11.8.1.10. .status.tags[].conditions
复制链接

描述: conditions 是应用到标签事件列表的条件数组。
类型: array

11.8.1.11. .status.tags[].conditions[]
复制链接

描述

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

类型

对象

必填

type
status
生成

Expand

属性	类型	描述
`生成`	`整数`	生成是此状态对应的 spec 标签生成
`lastTransitionTime`	`time`	lastTransitionTime 是条件从一个状态转换到另一个状态的时间。
`message`	`字符串`	消息是最后一次转换的详细信息的人类可读描述，补充原因。
`reason`	`字符串`	reason 是条件最后一次转换的简短机器可读说明。
`status`	`字符串`	条件的状态，True, False, Unknown 之一。
`type`	`字符串`	标签事件状况类型，目前只有 ImportSuccess

11.8.1.12. .status.tags[].items
复制链接

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

11.8.1.13. .status.tags[].items[]
复制链接

描述

ImageStreamStatus 使用 TagEvent 来保留与标签关联的镜像的历史记录。

类型

对象

必填

created
dockerImageReference
image
生成

Expand

属性	类型	描述
`created`	`time`	created 包含 TagEvent 创建的时间
`dockerImageReference`	`字符串`	dockerImageReference 是可用于拉取此镜像的字符串
`生成`	`整数`	生成是导致此标签的 spec 标签生成更新
`image`	`字符串`	image 是镜像

11.8.2. 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 的状态

11.8.2.1. /apis/image.openshift.io/v1/imagestreams
复制链接

Expand

表 11.48. 全局查询参数
参数	类型	描述
`allowWatchBookmarks`	`布尔值`	allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。如果 apiserver 中没有启用功能门 WatchBookmarks，则忽略此字段。
`继续`	`字符串`	从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。
`fieldSelector`	`字符串`	用于限制返回的对象列表的选择器。默认为任何内容。
`labelSelector`	`字符串`	通过标签限制返回的对象列表的选择器。默认为任何内容。
`limit`	`整数`	限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。
`pretty`	`字符串`	如果 'true'，则输出被用户友善。
`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。

HTTP 方法: GET
描述: 列出或监视 ImageStream 类型的对象

Expand

表 11.49. HTTP 响应
HTTP 代码	响应正文
200 - OK	`ImageStreamList` schema
401 - Unauthorized	空

11.8.2.2. /apis/image.openshift.io/v1/watch/imagestreams
复制链接

Expand

表 11.50. 全局查询参数
参数	类型	描述
`allowWatchBookmarks`	`布尔值`	allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。如果 apiserver 中没有启用功能门 WatchBookmarks，则忽略此字段。
`继续`	`字符串`	从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。
`fieldSelector`	`字符串`	用于限制返回的对象列表的选择器。默认为任何内容。
`labelSelector`	`字符串`	通过标签限制返回的对象列表的选择器。默认为任何内容。
`limit`	`整数`	限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。
`pretty`	`字符串`	如果 'true'，则输出被用户友善。
`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。

HTTP 方法: GET
描述: 观察对 ImageStream 列表的各个更改。已弃用：改为使用 'watch' 参数以及 list 操作。

Expand

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

11.8.2.3. /apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams
复制链接

Expand

表 11.52. 全局路径参数
参数	类型	描述
`namespace`	`字符串`	对象名称和身份验证范围，如团队和项目

Expand

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

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

Expand

表 11.54. 查询参数
参数	类型	描述
`继续`	`字符串`	从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`fieldSelector`	`字符串`	用于限制返回的对象列表的选择器。默认为任何内容。
`gracePeriodSeconds`	`整数`	应该删除对象前的持续时间（以秒为单位）。值必须是非负整数。值零表示立即删除。如果这个值是 nil，则使用指定类型的默认宽限期。如果没有指定，则默认为每个对象值。零表示立即删除。
`labelSelector`	`字符串`	通过标签限制返回的对象列表的选择器。默认为任何内容。
`limit`	`整数`	限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。
`orphanDependents`	`布尔值`	弃用：请使用 PropagationPolicy，此字段将在 1.7 中被弃用。应该依赖的对象被孤立。如果为 true/false，"orphan"终结器将从对象的终结器列表添加到/删除。可以设置此字段或 PropagationPolicy，但不能同时设置两者。
`propagationPolicy`	`字符串`	是否以及是否执行垃圾回收。此字段或 OrphanDependents 可以设置，但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值为： 'Orphan' - 孤立依赖; 'Background' - 允许垃圾收集器在后台删除依赖的依赖关系； 'Foreground' - 一个删除前台所有依赖的级联策略。
`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 调用的超时。这限制了调用的时间，无论任何活动或不活跃。

Expand

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

Expand

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

HTTP 方法: GET
描述: 列出或监视 ImageStream 类型的对象

Expand

表 11.57. 查询参数
参数	类型	描述
`allowWatchBookmarks`	`布尔值`	allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。如果 apiserver 中没有启用功能门 WatchBookmarks，则忽略此字段。
`继续`	`字符串`	从服务器检索更多结果时，应设置 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

表 11.58. HTTP 响应
HTTP 代码	响应正文
200 - OK	`ImageStreamList` schema
401 - Unauthorized	空

HTTP 方法: POST
描述: 创建 ImageStream

Expand

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

Expand

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

Expand

表 11.61. HTTP 响应
HTTP 代码	响应正文
200 - OK	`ImageStream` schema
201 - Created	`ImageStream` schema
202 - Accepted	`ImageStream` schema
401 - Unauthorized	空

11.8.2.4. /apis/image.openshift.io/v1/watch/namespaces/{namespace}/imagestreams
复制链接

Expand

表 11.62. 全局路径参数
参数	类型	描述
`namespace`	`字符串`	对象名称和身份验证范围，如团队和项目

Expand

表 11.63. 全局查询参数
参数	类型	描述
`allowWatchBookmarks`	`布尔值`	allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。如果 apiserver 中没有启用功能门 WatchBookmarks，则忽略此字段。
`继续`	`字符串`	从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。
`fieldSelector`	`字符串`	用于限制返回的对象列表的选择器。默认为任何内容。
`labelSelector`	`字符串`	通过标签限制返回的对象列表的选择器。默认为任何内容。
`limit`	`整数`	限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。
`pretty`	`字符串`	如果 'true'，则输出被用户友善。
`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。

HTTP 方法: GET
描述: 观察对 ImageStream 列表的各个更改。已弃用：改为使用 'watch' 参数以及 list 操作。

Expand

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

11.8.2.5. /apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams/{name}
复制链接

Expand

表 11.65. 全局路径参数
参数	类型	描述
`name`	`字符串`	ImageStream 的名称
`namespace`	`字符串`	对象名称和身份验证范围，如团队和项目

Expand

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

HTTP 方法: DELETE
描述: 删除 ImageStream

Expand

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

Expand

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

Expand

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

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

Expand

表 11.70. HTTP 响应
HTTP 代码	响应正文
200 - OK	`ImageStream` schema
401 - Unauthorized	空

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

Expand

表 11.71. 查询参数
参数	类型	描述
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`fieldManager`	`字符串`	fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段，但对于非应用补丁类型(JsonPatch、MergePatch、OptMergePatch)是可选的。
`force`	`布尔值`	强制将"强制"应用请求。这意味着用户会重新清空由其他人员拥有的冲突字段。对于非应用补丁请求，必须取消设置 force 标志。

Expand

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

Expand

表 11.73. HTTP 响应
HTTP 代码	响应正文
200 - OK	`ImageStream` schema
401 - Unauthorized	空

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

Expand

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

Expand

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

Expand

表 11.76. HTTP 响应
HTTP 代码	响应正文
200 - OK	`ImageStream` schema
201 - Created	`ImageStream` schema
401 - Unauthorized	空

11.8.2.6. /apis/image.openshift.io/v1/watch/namespaces/{namespace}/imagestreams/{name}
复制链接

Expand

表 11.77. 全局路径参数
参数	类型	描述
`name`	`字符串`	ImageStream 的名称
`namespace`	`字符串`	对象名称和身份验证范围，如团队和项目

Expand

表 11.78. 全局查询参数
参数	类型	描述
`allowWatchBookmarks`	`布尔值`	allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。如果 apiserver 中没有启用功能门 WatchBookmarks，则忽略此字段。
`继续`	`字符串`	从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。
`fieldSelector`	`字符串`	用于限制返回的对象列表的选择器。默认为任何内容。
`labelSelector`	`字符串`	通过标签限制返回的对象列表的选择器。默认为任何内容。
`limit`	`整数`	限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。
`pretty`	`字符串`	如果 'true'，则输出被用户友善。
`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。

HTTP 方法: GET
描述: 观察对类型为 ImageStream 的对象的更改。已弃用：使用带有列表操作的 'watch' 参数，而是过滤到带有 'fieldSelector' 参数的单个项目。

Expand

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

11.8.2.7. /apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams/{name}/status
复制链接

Expand

表 11.80. 全局路径参数
参数	类型	描述
`name`	`字符串`	ImageStream 的名称
`namespace`	`字符串`	对象名称和身份验证范围，如团队和项目

Expand

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

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

Expand

表 11.82. HTTP 响应
HTTP 代码	响应正文
200 - OK	`ImageStream` schema
401 - Unauthorized	空

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

Expand

表 11.83. 查询参数
参数	类型	描述
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`fieldManager`	`字符串`	fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段，但对于非应用补丁类型(JsonPatch、MergePatch、OptMergePatch)是可选的。
`force`	`布尔值`	强制将"强制"应用请求。这意味着用户会重新清空由其他人员拥有的冲突字段。对于非应用补丁请求，必须取消设置 force 标志。

Expand

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

Expand

表 11.85. HTTP 响应
HTTP 代码	响应正文
200 - OK	`ImageStream` schema
401 - Unauthorized	空

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

Expand

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

Expand

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

Expand

表 11.88. HTTP 响应
HTTP 代码	响应正文
200 - OK	`ImageStream` schema
201 - Created	`ImageStream` schema
401 - Unauthorized	空

返回顶部

11.8. ImageStream [image.openshift.io/v1]

11.8.1. 规格
复制链接

11.8.1.1. .spec
复制链接

11.8.1.2. .spec.lookupPolicy
复制链接

11.8.1.3. .spec.tags
复制链接

11.8.1.4. .spec.tags[]
复制链接

11.8.1.5. .spec.tags[].importPolicy
复制链接

11.8.1.6. .spec.tags[].referencePolicy
复制链接

11.8.1.7. .status
复制链接

11.8.1.8. .status.tags
复制链接

11.8.1.9. .status.tags[]
复制链接

11.8.1.10. .status.tags[].conditions
复制链接

11.8.1.11. .status.tags[].conditions[]
复制链接

11.8.1.12. .status.tags[].items
复制链接

11.8.1.13. .status.tags[].items[]
复制链接

11.8.2. API 端点
复制链接

11.8.2.1. /apis/image.openshift.io/v1/imagestreams
复制链接

11.8.2.2. /apis/image.openshift.io/v1/watch/imagestreams
复制链接

11.8.2.3. /apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams
复制链接

11.8.2.4. /apis/image.openshift.io/v1/watch/namespaces/{namespace}/imagestreams
复制链接

11.8.2.5. /apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams/{name}
复制链接

11.8.2.6. /apis/image.openshift.io/v1/watch/namespaces/{namespace}/imagestreams/{name}
复制链接

11.8.2.7. /apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams/{name}/status
复制链接

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

11.8. ImageStream [image.openshift.io/v1]

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

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

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

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

11.8.1.4. .spec.tags[]复制链接链接已复制到粘贴板!

11.8.1.5. .spec.tags[].importPolicy复制链接链接已复制到粘贴板!

11.8.1.6. .spec.tags[].referencePolicy复制链接链接已复制到粘贴板!

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

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

11.8.1.9. .status.tags[]复制链接链接已复制到粘贴板!

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

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

11.8.1.12. .status.tags[].items复制链接链接已复制到粘贴板!

11.8.1.13. .status.tags[].items[]复制链接链接已复制到粘贴板!

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

11.8.2.1. /apis/image.openshift.io/v1/imagestreams复制链接链接已复制到粘贴板!

11.8.2.2. /apis/image.openshift.io/v1/watch/imagestreams复制链接链接已复制到粘贴板!

11.8.2.3. /apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams复制链接链接已复制到粘贴板!

11.8.2.4. /apis/image.openshift.io/v1/watch/namespaces/{namespace}/imagestreams复制链接链接已复制到粘贴板!

11.8.2.5. /apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams/{name}复制链接链接已复制到粘贴板!

11.8.2.6. /apis/image.openshift.io/v1/watch/namespaces/{namespace}/imagestreams/{name}复制链接链接已复制到粘贴板!

11.8.2.7. /apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams/{name}/status复制链接链接已复制到粘贴板!

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

11.8.1. 规格
复制链接

11.8.1.1. .spec
复制链接

11.8.1.2. .spec.lookupPolicy
复制链接

11.8.1.3. .spec.tags
复制链接

11.8.1.4. .spec.tags[]
复制链接

11.8.1.5. .spec.tags[].importPolicy
复制链接

11.8.1.6. .spec.tags[].referencePolicy
复制链接

11.8.1.7. .status
复制链接

11.8.1.8. .status.tags
复制链接

11.8.1.9. .status.tags[]
复制链接

11.8.1.10. .status.tags[].conditions
复制链接

11.8.1.11. .status.tags[].conditions[]
复制链接

11.8.1.12. .status.tags[].items
复制链接

11.8.1.13. .status.tags[].items[]
复制链接

11.8.2. API 端点
复制链接

11.8.2.1. /apis/image.openshift.io/v1/imagestreams
复制链接

11.8.2.2. /apis/image.openshift.io/v1/watch/imagestreams
复制链接

11.8.2.3. /apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams
复制链接

11.8.2.4. /apis/image.openshift.io/v1/watch/namespaces/{namespace}/imagestreams
复制链接

11.8.2.5. /apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams/{name}
复制链接

11.8.2.6. /apis/image.openshift.io/v1/watch/namespaces/{namespace}/imagestreams/{name}
复制链接

11.8.2.7. /apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams/{name}/status
复制链接