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

11.3. ImageSignature [image.openshift.io/v1]

描述

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

类型

对象

必填

type
content

11.3.1. 规格
复制链接

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.3.1.1. .conditions
复制链接

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

11.3.1.2. .conditions[]
复制链接

描述

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

类型

对象

必填

type
status

Expand

属性	类型	描述
`lastProbeTime`	`time`	检查条件最后一次的时间。
`lastTransitionTime`	`time`	条件从一个状态传输到另一个状态最后一次的时间。
`message`	`字符串`	人类可读的消息，指示最后一次转换的详细信息。
`reason`	`字符串`	(brief)条件最后一次转换的原因。
`status`	`字符串`	条件的状态，True, False, Unknown 之一。
`type`	`字符串`	签名条件类型，完成或失败。

11.3.1.3. .issuedBy
复制链接

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

Expand

属性	类型	描述
`commonName`	`字符串`	通用名称（如 openshift-signing-service）。
`机构`	`字符串`	机构名称。

11.3.1.4. .issuedTo
复制链接

描述

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

类型

对象

必填

publicKeyID

Expand

属性	类型	描述
`commonName`	`字符串`	通用名称（如 openshift-signing-service）。
`机构`	`字符串`	机构名称。
`publicKeyID`	`字符串`	如果存在，它是属于验证镜像签名的主题的公钥的人类可读密钥 ID。它应至少包含 64 位公钥的指纹（例如 0x685ebe62bf278440）。

11.3.2. API 端点
复制链接

可用的 API 端点如下：

/apis/image.openshift.io/v1/imagesignatures
- POST ：创建镜像签名
/apis/image.openshift.io/v1/imagesignatures/{name}
- DELETE ：删除镜像签名

11.3.2.1. /apis/image.openshift.io/v1/imagesignatures
复制链接

Expand

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

HTTP 方法: POST
描述: 创建镜像签名

Expand

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

Expand

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

11.3.2.2. /apis/image.openshift.io/v1/imagesignatures/{name}
复制链接

Expand

表 11.30. 全局路径参数
参数	类型	描述
`name`	`字符串`	镜像签名的名称

Expand

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

HTTP 方法: DELETE
描述: 删除镜像签名

Expand

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

Expand

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

返回顶部

11.3. ImageSignature [image.openshift.io/v1]

11.3.1. 规格
复制链接

11.3.1.1. .conditions
复制链接

11.3.1.2. .conditions[]
复制链接

11.3.1.3. .issuedBy
复制链接

11.3.1.4. .issuedTo
复制链接

11.3.2. API 端点
复制链接

11.3.2.1. /apis/image.openshift.io/v1/imagesignatures
复制链接

11.3.2.2. /apis/image.openshift.io/v1/imagesignatures/{name}
复制链接

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

11.3. ImageSignature [image.openshift.io/v1]

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

11.3.1.1. .conditions复制链接链接已复制到粘贴板!

11.3.1.2. .conditions[]复制链接链接已复制到粘贴板!

11.3.1.3. .issuedBy复制链接链接已复制到粘贴板!

11.3.1.4. .issuedTo复制链接链接已复制到粘贴板!

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

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

11.3.2.2. /apis/image.openshift.io/v1/imagesignatures/{name}复制链接链接已复制到粘贴板!

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

11.3.1. 规格
复制链接

11.3.1.1. .conditions
复制链接

11.3.1.2. .conditions[]
复制链接

11.3.1.3. .issuedBy
复制链接

11.3.1.4. .issuedTo
复制链接

11.3.2. API 端点
复制链接

11.3.2.1. /apis/image.openshift.io/v1/imagesignatures
复制链接

11.3.2.2. /apis/image.openshift.io/v1/imagesignatures/{name}
复制链接