3.2. API 端点


可用的 API 端点如下:

  • /apis/image.openshift.io/v1/imagesignatures

    • POST :创建镜像签名
  • /apis/image.openshift.io/v1/imagesignatures/{name}

    • DELETE :删除镜像签名

3.2.1. /apis/image.openshift.io/v1/imagesignatures

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

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

fieldValidation

string

fieldValidation 指示服务器如何处理请求(POST/PUT/PATCH)中包含未知或重复字段的对象,只要 ServerSideFieldValidation 功能门也被启用。有效值为: - Ignore :忽略从对象中静默丢弃的未知字段,并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 之前的默认行为,是 ServerSideFieldValidation 功能门被禁用时的默认行为。- Warn: 这将通过从对象丢弃的每个未知字段的标准警告响应标头发送警告,以及遇到的每个重复字段。如果没有其他错误,请求仍会成功,且只保留重复字段的最后一个。当 ServerSideFieldValidation 功能门被启用时,这是默认设置。- Strict: 如果从对象中丢弃任何未知字段,则会失败并带有 BadRequest 错误,或者存在任何重复字段。从服务器返回的错误将包含遇到的,以及重复的字段。

pretty

字符串

如果为 'true',则输出会经过 pretty print 处理。

HTTP 方法
POST
描述
创建镜像签名
表 3.2. 主体参数
参数类型描述

正文(body)

ImageSignature 模式

 
表 3.3. HTTP 响应
HTTP 代码响应正文

200 - OK

ImageSignature 模式

201 - Created

ImageSignature 模式

202 - Accepted

ImageSignature 模式

401 - Unauthorized

3.2.2. /apis/image.openshift.io/v1/imagesignatures/{name}

表 3.4. 全局路径参数
参数类型描述

name

字符串

镜像签名的名称

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

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

gracePeriodSeconds

整数

应该删除对象前的持续时间(以秒为单位)。值必须是非负整数。值为零表示立即删除。如果这个值是 nil,则会使用指定类型的默认宽限期。如果没有指定,则默认为每个对象值。零表示立即删除。

orphanDependents

布尔值

弃用:请使用 PropagationPolicy,此字段将在 1.7 中弃用。如果依赖对象是孤立的。如果为 true/false,则 "orphan" finalizer 将添加到对象的终结器列表中。可以设置此字段或 PropagationPolicy,但不能同时设置。

pretty

字符串

如果为 'true',则输出会经过 pretty print 处理。

propagationPolicy

字符串

是否执行垃圾回收。可以设置此字段或 OrphanDependents,但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值有: 'Orphan' - 孤立的依赖项; 'Background' - 允许垃圾收集器删除依赖项,"Foreground' - 删除前台所有依赖的级联策略。

HTTP 方法
DELETE
描述
delete an ImageSignature
表 3.6. 主体参数
参数类型描述

正文(body)

DeleteOptions 模式

 
表 3.7. HTTP 响应
HTTP 代码响应正文

200 - OK

Status 模式

202 - Accepted

Status 模式

401 - Unauthorized

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

© 2024 Red Hat, Inc.