Secret

Secret 包含特定类型的敏感数据。

apiVersion: v1

import "k8s.io/api/core/v1"

Secret

Secret 包含特定类型的敏感数据。Data 字段中所有值的总字节数必须小于 MaxSecretSize 字节。


  • apiVersion: v1

  • kind: Secret

  • metadata (ObjectMeta)

    标准对象的元数据。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

  • data (map[string][]byte)

    Data 包含敏感数据。每个键必须由字母数字字符、'-'、'_' 或 '.' 组成。敏感数据的序列化形式是 Base64 编码的字符串,代表任意(可能不是字符串)数据值。详见:https://tools.ietf.org/html/rfc4648#section-4

  • immutable (boolean)

    Immutable,如果设置为 true,则确保 Secret 中存储的数据不可更新(只能修改对象元数据)。如果未设置为 true,则此字段可以随时修改。默认为 nil。

  • stringData (map[string]string)

    stringData 允许以字符串形式指定非二进制敏感数据。为方便起见,此字段作为只写输入字段提供。在写入时,所有键和值都会合并到 data 字段中,覆盖任何现有值。从 API 读取时,stringData 字段永远不会输出。

  • type (string)

    用于方便对敏感数据进行程序化处理。更多信息:https://kubernetes.ac.cn/docs/concepts/configuration/secret/#secret-types

SecretList

SecretList 是 Secret 的列表。


操作


get 读取指定的 Secret

HTTP 请求

GET /api/v1/namespaces/{namespace}/secrets/{name}

参数

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

    Secret 的名称

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

    namespace

  • pretty (在查询参数中):string

    pretty

响应

200 (Secret):OK

401:未授权

list 列出或监听类型为 Secret 的对象

HTTP 请求

GET /api/v1/namespaces/{namespace}/secrets

参数

响应

200 (SecretList):OK

401:未授权

list 列出或监听类型为 Secret 的对象

HTTP 请求

GET /api/v1/secrets

参数

响应

200 (SecretList):OK

401:未授权

create 创建 Secret

HTTP 请求

POST /api/v1/namespaces/{namespace}/secrets

参数

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

    namespace

  • bodySecret,必需

  • dryRun (在查询参数中):string

    dryRun

  • fieldManager (在查询参数中):string

    fieldManager

  • fieldValidation (在查询参数中):string

    fieldValidation

  • pretty (在查询参数中):string

    pretty

响应

200 (Secret):OK

201 (Secret):Created

202 (Secret):Accepted

401:未授权

update 替换指定的 Secret

HTTP 请求

PUT /api/v1/namespaces/{namespace}/secrets/{name}

参数

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

    Secret 的名称

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

    namespace

  • bodySecret,必需

  • dryRun (在查询参数中):string

    dryRun

  • fieldManager (在查询参数中):string

    fieldManager

  • fieldValidation (在查询参数中):string

    fieldValidation

  • pretty (在查询参数中):string

    pretty

响应

200 (Secret):OK

201 (Secret):Created

401:未授权

patch 部分更新指定的 Secret

HTTP 请求

PATCH /api/v1/namespaces/{namespace}/secrets/{name}

参数

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

    Secret 的名称

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

    namespace

  • bodyPatch,必需

  • dryRun (在查询参数中):string

    dryRun

  • fieldManager (在查询参数中):string

    fieldManager

  • fieldValidation (在查询参数中):string

    fieldValidation

  • force (在查询参数中):boolean

    force

  • pretty (在查询参数中):string

    pretty

响应

200 (Secret):OK

201 (Secret):Created

401:未授权

delete 删除 Secret

HTTP 请求

DELETE /api/v1/namespaces/{namespace}/secrets/{name}

参数

响应

200 (Status):OK

202 (Status):Accepted

401:未授权

deletecollection 删除 Secret 集合

HTTP 请求

DELETE /api/v1/namespaces/{namespace}/secrets

参数

响应

200 (Status):OK

401:未授权

此页面为自动生成。

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

最后修改于太平洋标准时间 2025 年 4 月 9 日下午 6:36:更新 v1.32 的 API 参考文档 (a3b579d035)