ClusterTrustBundle v1alpha1

ClusterTrustBundle 是一个集群范围的容器，用于 X。

apiVersion: certificates.k8s.io/v1alpha1

import "k8s.io/api/certificates/v1alpha1"

ClusterTrustBundle

ClusterTrustBundle 是一个集群范围的容器，用于 X.509 信任锚点（根证书）。

ClusterTrustBundle 对象被认为是集群中任何经过身份验证的用户可读的，因为它们可以通过使用 clusterTrustBundle 投影的 Pod 挂载。默认情况下，所有服务帐户都具有对 ClusterTrustBundles 的读取权限。只有对集群具有命名空间级访问权限的用户可以通过模拟他们有权访问的服务帐户来读取 ClusterTrustBundles。

它可以可选地与特定分配者相关联，在这种情况下，它包含该签名者的一个有效信任锚点集。签名者可能有多个关联的 ClusterTrustBundles；每个都是该签名者的独立信任锚点集。准入控制用于强制执行，只有对签名者具有权限的用户才能创建或修改相应的捆绑包。

  • apiVersion: certificates.k8s.io/v1alpha1

  • kind: ClusterTrustBundle

  • metadata (ObjectMeta)

    metadata 包含对象元数据。

  • spec (ClusterTrustBundleSpec), 必需

    spec 包含签名者（如果有）和信任锚点。

ClusterTrustBundleSpec

ClusterTrustBundleSpec 包含签名者和信任锚点。

  • trustBundle (string), 必需

    trustBundle 包含此捆绑包的单个 X.509 信任锚点，作为 PEM 包含的 PEM 封装的 DER 格式 X.509 证书。

    数据必须仅包含解析为有效 X.509 证书的 PEM 证书块。每个证书必须包含一个基本约束扩展，其中 CA 位被设置为已设置。API 服务器将拒绝包含重复证书或使用 PEM 块头的对象。

    ClusterTrustBundles 的用户（包括 Kubelet）可以根据自己的逻辑自由地重新排序和删除此文件中的证书块，以及删除 PEM 块头和块间数据。

  • signerName (string)

    signerName 指示关联的签名者（如果有）。

    为了创建或更新设置 signerName 的 ClusterTrustBundle，您必须具有以下集群范围的权限：group=certificates.k8s.io resource=signers resourceName=<签名者名称> verb=attest。

    如果 signerName 不为空，则 ClusterTrustBundle 对象的名称必须以签名者名称作为前缀（将斜杠转换为冒号）。例如，对于签名者名称 example.com/foo，有效的 ClusterTrustBundle 对象名称包括 example.com:foo:abc 和 example.com:foo:v1。

    如果 signerName 为空，则 ClusterTrustBundle 对象的名称不得具有此类前缀。

    对 ClusterTrustBundles 的列表/观察请求可以使用 spec.signerName=NAME 字段选择器过滤此字段。

ClusterTrustBundleList

ClusterTrustBundleList 是 ClusterTrustBundle 对象的集合

  • apiVersion: certificates.k8s.io/v1alpha1

  • kind: ClusterTrustBundleList

  • metadata (ListMeta)

    metadata 包含列表元数据。

  • items ([]ClusterTrustBundle), 必需

    items 是 ClusterTrustBundle 对象的集合

操作

get 读取指定的 ClusterTrustBundle

HTTP 请求

GET /apis/certificates.k8s.io/v1alpha1/clustertrustbundles/{name}

参数

  • name (在路径中): string, 必需

    ClusterTrustBundle 的名称

  • pretty (在查询中): string

    pretty

响应

200 (ClusterTrustBundle): OK

401: 未授权

list 列出或观察 ClusterTrustBundle 类型的对象

HTTP 请求

GET /apis/certificates.k8s.io/v1alpha1/clustertrustbundles

参数

响应

200 (ClusterTrustBundleList): OK

401: 未授权

create 创建 ClusterTrustBundle

HTTP 请求

POST /apis/certificates.k8s.io/v1alpha1/clustertrustbundles

参数

响应

200 (ClusterTrustBundle): OK

201 (ClusterTrustBundle): 已创建

202 (ClusterTrustBundle): 已接受

401: 未授权

update 替换指定的 ClusterTrustBundle

HTTP 请求

PUT /apis/certificates.k8s.io/v1alpha1/clustertrustbundles/{name}

参数

响应

200 (ClusterTrustBundle): OK

201 (ClusterTrustBundle): 已创建

401: 未授权

patch 部分更新指定的 ClusterTrustBundle

HTTP 请求

PATCH /apis/certificates.k8s.io/v1alpha1/clustertrustbundles/{name}

参数

  • name (在路径中): string, 必需

    ClusterTrustBundle 的名称

  • body: Patch, 必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • force (在查询中): boolean

    force

  • pretty (在查询中): string

    pretty

响应

200 (ClusterTrustBundle): OK

201 (ClusterTrustBundle): 已创建

401: 未授权

delete 删除 ClusterTrustBundle

HTTP 请求

DELETE /apis/certificates.k8s.io/v1alpha1/clustertrustbundles/{name}

参数

响应

200 (Status): OK

202 (Status): 已接受

401: 未授权

deletecollection 删除 ClusterTrustBundle 的集合

HTTP 请求

DELETE /apis/certificates.k8s.io/v1alpha1/clustertrustbundles

参数

响应

200 (Status): OK

401: 未授权

此页面是自动生成的。

如果您打算报告此页面存在问题，请在您的问题描述中提及该页面是自动生成的。修复可能需要在 Kubernetes 项目中的其他地方进行。

最后修改时间：2023 年 4 月 3 日上午 8:22 PST: API Ref 多页 v1.27 (7b39e9a9ec)