API 参考

v1

1 级

v1beta1

2 级

v1alpha1

4 级

route.openshift.io/v1

1 级

security.openshift.io/v1

1 级，除 RangeAllocation (4 级) 和 *Reviews (2 级)

1 级

在一个主版本内是稳定的。它们在主版本中可能被弃用，但在后续的主发行版本前不会删除它们。

2 级

从公布弃用后的 9 个月或 3 个发行版本（以更长的时间为准）。

3 级

请参阅特定于组件的调度。

4 级

无。无法保证兼容性。

正式发布(GA)

标志和命令

1 级

技术预览

标志和命令

3 级

开发者预览

标志和命令

4 级

1 级

在一个主版本内是稳定的。它们在主版本中可能被弃用，但在后续的主发行版本前不会删除它们。

2 级

从公布弃用后的 9 个月或 3 个发行版本（以更长的时间为准）。

3 级

请参阅特定于组件的调度。

4 级

无。无法保证兼容性。

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(MutatingWebhookConfiguration)

MutatingWebhookConfiguration 列表。

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(ValidatingWebhookConfiguration)

ValidatingWebhookConfiguration 列表。

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(ControllerRevision)

items 是 ControllerRevisions 列表

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(DaemonSet)

守护进程集列表。

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

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

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组（部署）

items 是 Deployment 列表。

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(ReplicaSet)

ReplicaSet 列表。更多信息： https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(StatefulSet)

items 是有状态的集合的列表。

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

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

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

array (HorizontalPodAutoscaler)

items 是 pod 横向自动扩展对象的列表。

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

metadata 是标准列表元数据。

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(CronJob)

items 是 CronJobs 列表。

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

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

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(Job)

items 是作业列表。

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

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

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(CertificateSigningRequest)

items 是 CertificateSigningRequest 对象的集合

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组（租用）

items 是 schema 对象的列表。

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

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

nodeAffinity

NodeAffinity

描述 pod 的节点关联性调度规则。

podAffinity

podAffinity

描述 pod 关联性调度规则（例如，将这个 pod 位于同一个节点、区等）中。

podAntiAffinity

podAntiAffinity

描述 pod 反关联性调度规则（例如，避免将此 pod 放置到同一个节点、区等）。

fsType

string

fstype 是您要挂载的卷的文件系统类型。提示： 确保主机操作系统支持文件系统类型。示例："ext4", "xfs", "ntfs"。如果未指定，则隐式推断为 "ext4"。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

分区

整数

partition 是您要挂载的卷中的分区。如果省略，则默认使用卷名称来挂载。示例： 对于卷 /dev/sda1，您可以将分区指定为 "1"。同样，/dev/sda 的卷分区是"0" （或者您可以将属性留空）。

readOnly

布尔值

readonly 值 true 将强制 VolumeMount 中的 readOnly 设置。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

volumeID

string

VolumeId 是 AWS (Amazon EBS 卷)中持久磁盘资源的唯一 ID。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

cachingMode

string

cachingMode 是主机缓存模式： None、Read Only、Read Write。

可能枚举值： - "None" - "ReadOnly" - "ReadWrite"

diskName

string

diskname 是 blob 存储中的数据磁盘的 Name

diskURI

string

diskURI 是 blob 存储中的数据磁盘的 URI

fsType

string

fstype 是要挂载的 Filesystem 类型。必须是主机操作系统支持的文件系统类型。例如，"ext4", "xfs", "ntfs".如果未指定，则隐式推断为 "ext4"。

kind

string

kind 预期值为 Shared: 每个存储帐户 Dedicated 有多个 blob 磁盘：每个存储帐户 Managed: azure managed data disk (only on managed availability set). 默认为 shared

可能枚举值： - "Dedicated" - "Managed" - "Shared"

readOnly

布尔值

readonly Defaults to false (read/write)。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。

readOnly

布尔值

readonly 默认为 false （读/写）。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。

secretName

string

secretName 是包含 Azure Storage Account Name 和 Key 的 secret 名称

secretNamespace

string

secretNamespace 是包含 Azure Storage Account Name 和 Key default 的 secret 的命名空间与 Pod 相同

shareName

string

sharename 是 azure Share Name

readOnly

布尔值

readonly 默认为 false （读/写）。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。

secretName

string

secretName 是包含 Azure Storage Account Name 和 Key 的 secret 名称

shareName

string

sharename 是 azure 共享名称

add

数组（字符串）

添加了功能

drop

数组（字符串）

删除的功能

monitor

数组（字符串）

monitor 是必需的： monitor 是 Ceph 监视器更多信息的集合： https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

path

string

路径为可选：作为挂载的 root 使用，而不是完整的 Ceph 树，默认为 /

readOnly

布尔值

readonly 为 Optional: Defaults to false (read/write)。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。更多信息： https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretFile

string

secretfile 为 Optional: SecretFile 是用户密钥环的路径，默认为 /etc/ceph/user.secret 更多信息 ：https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretRef

SecretReference

secretRef 为 Optional: SecretRef 对 User 的身份验证 secret 的引用，默认为空。更多信息： https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

user

string

用户是可选的：用户是 rados 用户名，默认为 admin 更多信息： https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

monitor

数组（字符串）

monitor 是必需的： monitor 是 Ceph 监视器更多信息的集合： https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

path

string

路径为可选：作为挂载的 root 使用，而不是完整的 Ceph 树，默认为 /

readOnly

布尔值

readonly 为 Optional: Defaults to false (read/write)。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。更多信息： https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretFile

string

secretfile 为 Optional: SecretFile 是用户密钥环的路径，默认为 /etc/ceph/user.secret 更多信息 ：https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretRef

LocalObjectReference

secretRef 为 Optional: SecretRef 对 User 的身份验证 secret 的引用，默认为空。更多信息： https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

user

string

User 是可选的：用户是 rados 用户名，默认为 admin 更多信息： https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

fsType

string

要挂载的 fstype Filesystem 类型。必须是主机操作系统支持的文件系统类型。示例："ext4", "xfs", "ntfs"。如果未指定，则隐式推断为 "ext4"。更多信息： https://examples.k8s.io/mysql-cinder-pd/README.md

readOnly

布尔值

readonly 为 Optional: Defaults to false (read/write)。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。更多信息： https://examples.k8s.io/mysql-cinder-pd/README.md

secretRef

SecretReference

secretRef 是 Optional: 指向包含用于连接到 OpenStack 的参数的 secret 对象。

volumeID

string

用于识别 cinder 中的卷的 VolumeId。更多信息： https://examples.k8s.io/mysql-cinder-pd/README.md

fsType

string

fstype 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。示例："ext4", "xfs", "ntfs"。如果未指定，则隐式推断为 "ext4"。更多信息： https://examples.k8s.io/mysql-cinder-pd/README.md

readOnly

布尔值

readonly 默认为 false （读/写）。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。更多信息： https://examples.k8s.io/mysql-cinder-pd/README.md

secretRef

LocalObjectReference

secretRef 是可选的：指向包含用于连接到 OpenStack 的参数的 secret 对象。

volumeID

string

用于识别 cinder 中的卷的 VolumeId。更多信息： https://examples.k8s.io/mysql-cinder-pd/README.md

resourceClaimName

string

ResourceClaimName 是与这个 pod 相同的命名空间中的 ResourceClaim 对象的名称。

resourceClaimTemplateName

string

ResourceClaimTemplateName 是与这个 pod 相同的命名空间中的 ResourceClaimTemplate 对象的名称。

该模板将用于创建新的 ResourceClaim，它将绑定到此容器集。删除此 pod 时，ResourceClaim 也会被删除。ResourceClaim 的名称将是 <pod name>-<resource name>，其中 <resource name> 是 PodResourceClaim.Name。如果串联的名称对 ResourceClaim （例如太长）无效，则 Pod 验证将拒绝 pod。

具有名称不归 pod 所有的现有 ResourceClaim 将不会用于 pod，以避免错误地使用不相关的资源。然后，调度和 pod 启动会被阻止，直到删除不相关的 ResourceClaim。

此字段不可变，在创建 ResourceClaim 后 control plane 将不会对对应的 ResourceClaim 进行任何更改。

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(ComponentStatus)

ComponentStatus 对象列表。

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

布尔值

指定是否必须定义 ConfigMap

key

字符串

要选择的密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

布尔值

指定是否必须定义 ConfigMap 还是其键

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(ConfigMap)

items 是 ConfigMap 的列表。

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

items

数组(KeyToPath)

如果未指定，则引用的 ConfigMap 的 Data 字段中每个键值对将投射到卷中，其名称是键，内容是值。如果指定，列出的键将投射到指定的路径中，并且不会出现未列出的键。如果指定了没有存在于 ConfigMap 中的键，则卷设置将失败，除非标记为可选。路径必须是相对的，且不能包含 '..' 路径，或者以 '..' 开始。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

布尔值

（可选）指定是否必须定义 ConfigMap 或其键

defaultMode

整数

defaultMode 是可选的：默认用于在创建的文件上设置权限的模式位。必须是一个 0000 到 0777 之间的八进制数值，或者 0 到 511 之间的十进制值。YAML 接受八进制和十进制值，JSON 需要模式位的值为十进制值。默认值为 0644。路径中的目录不受此设置的影响。这可能与影响文件模式的其他选项（如 fsGroup ）冲突，结果可以是其他模式位。

items

数组(KeyToPath)

如果未指定，则引用的 ConfigMap 的 Data 字段中每个键值对将投射到卷中，其名称是键，内容是值。如果指定，列出的键将投射到指定的路径中，并且不会出现未列出的键。如果指定了没有存在于 ConfigMap 中的键，则卷设置将失败，除非标记为可选。路径必须是相对的，且不能包含 '..' 路径，或者以 '..' 开始。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

布尔值

（可选）指定是否必须定义 ConfigMap 或其键

args

数组（字符串）

入口点的参数。如果没有提供，则使用容器镜像的 CMD。变量引用 $(VAR_NAME)使用容器的环境扩展。如果无法解析变量，则输入字符串中的引用将保持不变。双引号被缩减为一个单个 $，它用于转义 $(VAR_NAME)语法：即 " (VAR_NAME) " 将生成字符串 "$(VAR_NAME) "。转义的引用永远不会扩展，无论变量是否存在。无法更新。更多信息： https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

命令

数组（字符串）

ENTRYPOINT 数组.没有在 shell 中执行。如果未提供此容器镜像，则使用容器镜像的 ENTRYPOINT。变量引用 $(VAR_NAME)使用容器的环境扩展。如果无法解析变量，则输入字符串中的引用将保持不变。双引号被缩减为一个单个 $，它用于转义 $(VAR_NAME)语法：即 " (VAR_NAME) " 将生成字符串 "$(VAR_NAME) "。转义的引用永远不会扩展，无论变量是否存在。无法更新。更多信息： https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

env

array (EnvVar)

容器中要设置的环境变量列表。无法更新。

envFrom

array (EnvFromSource)

在容器中填充环境变量的源列表。源中定义的键必须是 C_IDENTIFIER。当容器启动时，所有无效密钥都会被报告为事件。当多个源中存在键时，与最后一个源关联的值将具有优先权。由带有重复键的 Env 定义的值将具有优先权。无法更新。

image

string

容器镜像名称。更多信息： https://kubernetes.io/docs/concepts/containers/images 此字段是可选的，允许更高级别的配置管理默认或覆盖工作负载控制器（如 Deployments 和 StatefulSets）中的容器镜像。

imagePullPolicy

字符串

镜像拉取(pull)策略。Always, Never, IfNotPresent 之一。如果指定了 :latest 标签，则默认为 Always，否则则默认为 IfNotPresent。无法更新。更多信息： https://kubernetes.io/docs/concepts/containers/images#updating-images

可能枚举值： - "Always" 表示 kubelet 始终尝试拉取最新的镜像。如果拉取失败，则容器将失败。- "IfNotPresent" 表示如果镜像在磁盘上不存在，kubelet 会拉取。如果镜像不存在且拉取失败，则容器将失败。- "Never" 表示 kubelet 永不拉取镜像，但只使用本地镜像。如果镜像不存在，容器将失败

生命周期

生命周期

管理系统应采取的操作来响应容器生命周期事件。无法更新。

livenessProbe

probe

容器存活度探测.如果探测失败，容器将重启。无法更新。更多信息： https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

name

字符串

指定为 DNS_LABEL 的容器名称。pod 中的每个容器都必须具有唯一的名称(DNS_LABEL)。无法更新。

ports

数组(ContainerPort)

从容器公开的端口列表。这里没有指定端口不会阻止公开该端口。所有正在侦听容器内默认"0.0.0.0"地址的端口均可从网络访问。使用策略合并补丁修改阵列可能会破坏数据。如需更多信息，请参阅 https://github.com/kubernetes/kubernetes/issues/108255。无法更新。

readinessProbe

probe

容器服务的定期探测到就绪状态。如果探测失败，容器将从服务端点中删除。无法更新。更多信息： https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

resizePolicy

数组(ContainerResizePolicy)

容器的资源重新定义策略。

resources

ResourceRequirements

此容器所需的计算资源。无法更新。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

securityContext

SecurityContext

securityContext 定义容器应运行的安全选项。如果设置，SecurityContext 的字段会覆盖 PodSecurityContext 的等效字段。更多信息： https://kubernetes.io/docs/tasks/configure-pod-container/security-context/

startupProbe

probe

startupProbe 表示 Pod 已成功初始化。如果指定，则不会执行其他探测，直到成功完成为止。如果这个探测失败，则 Pod 将重启，就像 livenessProbe 失败一样。这可用于在 Pod 生命周期开始时提供不同的探测参数，当可能需要很长时间才能加载数据或温缓存时，而不是在 steady-state 操作过程中提供不同的探测参数。这不能更新。更多信息： https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

stdin

布尔值

此容器是否应该在容器运行时中为 stdin 分配缓冲区。如果没有设置，则容器中的 stdin 读取将始终会导致 EOF。默认为 false。

stdinOnce

布尔值

容器运行时是否应在由单个附加打开后关闭 stdin 频道。当 stdin 为 true 时，stdin 流将在多个附加会话中保持打开状态。如果 stdinOnce 设为 true，则 stdin 会在容器启动时打开，直到第一个客户端附加到 stdin，然后保持打开并接受数据，直到客户端断开连接，此时 stdin 已关闭并保持关闭，直到容器重启为止。如果此标志为 false，则从 stdin 读取的容器进程永远不会收到 EOF。默认为 false

terminationMessagePath

字符串

可选：将容器终止消息写入的文件的路径挂载到容器的文件系统中。编写的消息应当是最终状态，如断言失败消息。如果超过 4096 字节，节点将截断。所有容器的总消息长度将限制为 12kb。默认为 /dev/termination-log。无法更新。

terminationMessagePolicy

字符串

指明应当如何填充终止消息。文件将使用 terminationMessagePath 的内容在成功或失败时填充容器状态消息。如果终止消息文件为空，则 FallbackToLogsOnError 将使用容器日志输出的最后块，并且容器退出并显示错误。日志输出限制为 2048 字节或 80 行，以较小者。默认为 File。无法更新。

可能枚举值：- "FallbackToLogsOnError" 将在容器退出时读取容器状态消息的最新内容，并且 terminationMessagePath 没有任何内容。- "File" 是默认行为，并在容器退出时将容器状态消息设置为容器的 terminationMessagePath 的内容。

tty

布尔值

此容器是否应为自己分配 TTY，也要求 'stdin' 为 true。默认为 false。

volumeDevices

数组(VolumeDevice)

volumeDevices 是容器要使用的块设备列表。

volumeMounts

数组(VolumeMount)

要挂载到容器文件系统的 Pod 卷。无法更新。

workingDir

字符串

容器的工作目录。如果未指定，则将使用容器运行时的默认值，该默认值可能在容器镜像中配置。无法更新。

containerPort

整数

pod IP 地址上公开的端口号。这必须是有效的端口号 0 < x < 65536。

hostIP

字符串

将外部端口绑定到的主机 IP。

hostPort

整数

主机上公开的端口号。如果指定，这必须是有效的端口号 0 < x < 65536。如果指定了 HostNetwork，它必须与 ContainerPort 匹配。大多数容器都不需要这样做。

name

字符串

如果指定，这必须是 IANA_SVC_NAME，在 pod 中唯一。pod 中的每个命名端口都必须具有唯一的名称。服务可以引用的端口的名称。

protocol

字符串

端口的协议。必须是 UDP、TCP 或 SCTP。默认为 "TCP"。

可能枚举值： - "SCTP" 是 SCTP 协议。- "TCP" 是 TCP 协议。- "UDP" 是 UDP 协议。

resourceName

string

此资源重新定义策略应用到的资源的名称。支持的值有：cpu、memory。

restartPolicy

string

在指定资源调整大小时，重启策略会被应用。如果没有指定，则默认为 NotRequired。

controllerExpandSecretRef

SecretReference

controllerExpandSecretRef 是包含敏感信息的 secret 对象的引用，以传递给 CSI 驱动程序，以完成 CSI ControllerExpandVolume 调用。此字段是可选的，如果不需要 secret，则可能会为空。如果 secret 对象包含多个 secret，则会传递所有 secret。

controllerPublishSecretRef

SecretReference

controllerPublishSecretRef 是包含敏感信息的 secret 对象的引用，以传递给 CSI 驱动程序，以完成 CSI ControllerPublishVolume 和 ControllerUnpublishVolume 调用。此字段是可选的，如果不需要 secret，则可能会为空。如果 secret 对象包含多个 secret，则会传递所有 secret。

driver

string

driver 是用于此卷的驱动程序的名称。必需。

fsType

string

要挂载的 fstype。必须是主机操作系统支持的文件系统类型。例如，"ext4", "xfs", "ntfs".

nodeExpandSecretRef

SecretReference

nodeExpandSecretRef 是包含敏感信息的 secret 对象的引用，以传递给 CSI 驱动程序，以完成 CSI NodeExpandVolume 调用。这是 CSINodeExpandSecret 功能门默认启用的 beta 字段。此字段是可选的，如果没有 secret，则可能会省略。如果 secret 对象包含多个 secret，则会传递所有 secret。

nodePublishSecretRef

SecretReference

nodePublishSecretRef 是包含敏感信息的 secret 对象的引用，以传递给 CSI 驱动程序，以完成 CSI NodePublishVolume 和 NodeUnpublishVolume 调用。此字段是可选的，如果不需要 secret，则可能会为空。如果 secret 对象包含多个 secret，则会传递所有 secret。

nodeStageSecretRef

SecretReference

NodeStageSecretRef 是包含敏感信息的 secret 对象的引用，以传递给 CSI 驱动程序，以完成 CSI NodeStageVolume 和 NodeStageVolume 和 NodeUnstageVolume 调用。此字段是可选的，如果不需要 secret，则可能会为空。如果 secret 对象包含多个 secret，则会传递所有 secret。

readOnly

布尔值

传递给 ControllerPublishVolumeRequest 的 readonly 值。默认为 false （读/写）。

volumeAttributes

对象（字符串）

要发布的卷的 volumeAttributes。

volumeHandle

string

volumeHandle 是 CSI 卷插件的 CreateVolume 返回的唯一卷名称，以便在所有后续调用中引用卷。必需。

driver

string

driver 是处理此卷的 CSI 驱动程序的名称。请联系您的 admin，了解集群中注册的正确名称。

fsType

string

要挂载的 fstype。例如，"ext4", "xfs", "ntfs".如果没有提供，则会将空值传递给关联的 CSI 驱动程序，该驱动程序将决定要应用的默认文件系统。

nodePublishSecretRef

LocalObjectReference

nodePublishSecretRef 是包含敏感信息的 secret 对象的引用，以传递给 CSI 驱动程序，以完成 CSI NodePublishVolume 和 NodeUnpublishVolume 调用。此字段是可选的，如果不需要 secret，则可能会为空。如果 secret 对象包含多个 secret，则会传递所有 secret 引用。

readOnly

布尔值

readOnly 将卷指定为只读。默认为 false （读/写）。

volumeAttributes

对象（字符串）

volumeAttributes 存储传递给 CSI 驱动程序的驱动程序特定属性。有关支持的值，请参阅驱动程序的文档。

items

数组(DownwardAPIVolumeFile)

items 是 DownwardAPIVolume 文件列表

fieldRef

ObjectFieldSelector

必需：选择 pod 的字段：只支持注解、标签、名称和命名空间。

模式

整数

可选：用于设置此文件权限的模式位，必须是 0000 到 0777 之间的数值，或 0 到 511 之间的十进制值。YAML 接受八进制和十进制值，JSON 需要模式位的值为十进制值。如果没有指定，则使用卷 defaultMode。这可能与影响文件模式的其他选项（如 fsGroup ）冲突，结果可以是其他模式位。

path

字符串

必需：Path 是要创建的文件的相对路径名称。不能是绝对的，也不能包含 '..' 路径。必须经过 utf-8 编码。相对路径的第一个项不能以 '..' 开头。

resourceFieldRef

ResourceFieldSelector

选择容器的资源：目前只支持资源限值和请求(limits.cpu、limits.memory、requests.cpu 和 requests.memory)。

defaultMode

整数

可选：默认在创建的文件上使用模式位。必须是 Optional: 模式位，用于默认对创建的文件设置权限。必须是一个 0000 到 0777 之间的八进制数值，或者 0 到 511 之间的十进制值。YAML 接受八进制和十进制值，JSON 需要模式位的值为十进制值。默认值为 0644。路径中的目录不受此设置的影响。这可能与影响文件模式的其他选项（如 fsGroup ）冲突，结果可以是其他模式位。

items

数组(DownwardAPIVolumeFile)

items 是 Downward API 卷文件的列表

中

string

Medium 代表存储介质类型应支持这个目录。默认值为 ""，这意味着使用节点的默认介质。必须是空字符串（默认）或 Memory。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#emptydir

sizeLimit

数量

sizeLimit 是这个 EmptyDir 卷所需的本地存储总量。大小限制也适用于内存介质。内存用量的最大使用量为此处指定的 SizeLimit 和 pod 中所有容器的内存限值总和。默认值为 nil，这意味着限制未定义。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#emptydir

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(Endpoints)

端点列表。

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

configMapRef

ConfigMapEnvSource

要从中选择的 ConfigMap

prefix

字符串

要添加到 ConfigMap 中每个键的可选标识符。必须是 C_IDENTIFIER。

secretRef

SecretEnvSource

要从中选择的 Secret

name

字符串

环境变量的名称。必须是 C_IDENTIFIER。

value

字符串

变量引用 $(VAR_NAME)使用容器中之前定义的环境变量以及任何服务环境变量进行扩展。如果无法解析变量，则输入字符串中的引用将保持不变。双引号被缩减为一个单个 $，它用于转义 $(VAR_NAME)语法：即 " (VAR_NAME) " 将生成字符串 "$(VAR_NAME) "。转义的引用永远不会扩展，无论变量是否存在。默认为 ""。

valueFrom

EnvVarSource

环境变量的值的源。如果值不为空，则无法使用。

configMapKeyRef

ConfigMapKeySelector

选择 ConfigMap 的键。

fieldRef

ObjectFieldSelector

选择 pod 的字段：支持 metadata.name、metadata.namespace、metadata.labels['<KEY>'], metadata.annotations['<KEY>'], spec.nodeName, spec.serviceAccountName, status.hostIP, status.podIP, status.podIPs.

resourceFieldRef

ResourceFieldSelector

选择容器的资源：当前仅支持资源限值和请求(limits.cpu, limits.memory, limits.ephemeral-storage, requests.cpu, requests.memory and requests.ephemeral-storage)。

secretKeyRef

SecretKeySelector

在 pod 命名空间中选择 secret 的键

args

数组（字符串）

入口点的参数。如果未提供该镜像，则使用镜像的 CMD。变量引用 $(VAR_NAME)使用容器的环境扩展。如果无法解析变量，则输入字符串中的引用将保持不变。双引号被缩减为一个单个 $，它用于转义 $(VAR_NAME)语法：即 " (VAR_NAME) " 将生成字符串 "$(VAR_NAME) "。转义的引用永远不会扩展，无论变量是否存在。无法更新。更多信息： https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

命令

数组（字符串）

ENTRYPOINT 数组.没有在 shell 中执行。如果未提供该镜像，则使用镜像的 ENTRYPOINT。变量引用 $(VAR_NAME)使用容器的环境扩展。如果无法解析变量，则输入字符串中的引用将保持不变。双引号被缩减为一个单个 $，它用于转义 $(VAR_NAME)语法：即 " (VAR_NAME) " 将生成字符串 "$(VAR_NAME) "。转义的引用永远不会扩展，无论变量是否存在。无法更新。更多信息： https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

env

array (EnvVar)

容器中要设置的环境变量列表。无法更新。

envFrom

array (EnvFromSource)

在容器中填充环境变量的源列表。源中定义的键必须是 C_IDENTIFIER。当容器启动时，所有无效密钥都会被报告为事件。当多个源中存在键时，与最后一个源关联的值将具有优先权。由带有重复键的 Env 定义的值将具有优先权。无法更新。

image

string

容器镜像名称。更多信息： https://kubernetes.io/docs/concepts/containers/images

imagePullPolicy

字符串

镜像拉取(pull)策略。Always, Never, IfNotPresent 之一。如果指定了 :latest 标签，则默认为 Always，否则则默认为 IfNotPresent。无法更新。更多信息： https://kubernetes.io/docs/concepts/containers/images#updating-images

可能枚举值： - "Always" 表示 kubelet 始终尝试拉取最新的镜像。如果拉取失败，则容器将失败。- "IfNotPresent" 表示如果镜像在磁盘上不存在，kubelet 会拉取。如果镜像不存在且拉取失败，则容器将失败。- "Never" 表示 kubelet 永不拉取镜像，但只使用本地镜像。如果镜像不存在，容器将失败

生命周期

生命周期

临时容器不允许生命周期。

livenessProbe

probe

临时容器不允许探测。

name

字符串

指定为 DNS_LABEL 的临时容器的名称。此名称在所有容器、init 容器和临时容器中必须是唯一的。

ports

数组(ContainerPort)

临时容器不允许使用端口。

readinessProbe

probe

临时容器不允许探测。

resizePolicy

数组(ContainerResizePolicy)

容器的资源重新定义策略。

resources

ResourceRequirements

临时容器不允许使用资源。临时容器使用已分配给 pod 的备用资源。

securityContext

SecurityContext

可选： SecurityContext 定义临时容器应该运行的安全选项。如果设置，SecurityContext 的字段会覆盖 PodSecurityContext 的等效字段。

startupProbe

probe

临时容器不允许探测。

stdin

布尔值

此容器是否应该在容器运行时中为 stdin 分配缓冲区。如果没有设置，则容器中的 stdin 读取将始终会导致 EOF。默认为 false。

stdinOnce

布尔值

容器运行时是否应在由单个附加打开后关闭 stdin 频道。当 stdin 为 true 时，stdin 流将在多个附加会话中保持打开状态。如果 stdinOnce 设为 true，则 stdin 会在容器启动时打开，直到第一个客户端附加到 stdin，然后保持打开并接受数据，直到客户端断开连接，此时 stdin 已关闭并保持关闭，直到容器重启为止。如果此标志为 false，则从 stdin 读取的容器进程永远不会收到 EOF。默认为 false

targetContainerName

字符串

如果设置，则来自此临时容器目标的 PodSpec 的容器名称。临时容器将在此容器的命名空间中运行(IPC、PID 等)。如果没有设置，则临时容器将使用 Pod spec 中配置的命名空间。

容器运行时必须实施对此功能的支持。如果运行时不支持命名空间目标，则设置此字段的结果未定义。

terminationMessagePath

字符串

可选：将容器终止消息写入的文件的路径挂载到容器的文件系统中。编写的消息应当是最终状态，如断言失败消息。如果超过 4096 字节，节点将截断。所有容器的总消息长度将限制为 12kb。默认为 /dev/termination-log。无法更新。

terminationMessagePolicy

字符串

指明应当如何填充终止消息。文件将使用 terminationMessagePath 的内容在成功或失败时填充容器状态消息。如果终止消息文件为空，则 FallbackToLogsOnError 将使用容器日志输出的最后块，并且容器退出并显示错误。日志输出限制为 2048 字节或 80 行，以较小者。默认为 File。无法更新。

可能枚举值：- "FallbackToLogsOnError" 将在容器退出时读取容器状态消息的最新内容，并且 terminationMessagePath 没有任何内容。- "File" 是默认行为，并在容器退出时将容器状态消息设置为容器的 terminationMessagePath 的内容。

tty

布尔值

此容器是否应为自己分配 TTY，也要求 'stdin' 为 true。默认为 false。

volumeDevices

数组(VolumeDevice)

volumeDevices 是容器要使用的块设备列表。

volumeMounts

数组(VolumeMount)

要挂载到容器文件系统的 Pod 卷。临时容器不允许使用 subPath 挂载。无法更新。

workingDir

字符串

容器的工作目录。如果未指定，则将使用容器运行时的默认值，该默认值可能在容器镜像中配置。无法更新。

volumeClaimTemplate

PersistentVolumeClaimTemplate

将用于创建独立 PVC 来置备卷。嵌入此 EphemeralVolumeSource 的 pod 将是 PVC 的所有者，即 PVC 将与 pod 一起删除。PVC 的名称将是 < pod name>-<volume name>，其中 <volume name> 是 PodSpec.Volumes 数组条目中的名称。如果串联的名称对 PVC 无效（例如，太长），pod 验证将拒绝 pod。

具有名称不归 pod 所有的现有 PVC 将不会 用于 pod，以避免错误地使用不相关的卷。然后，启动 pod 会被阻断，直到删除不相关的 PVC。如果 pod 使用这样的预先创建的 PVC，则必须在 pod 存在后使用对 pod 的所有者引用来更新 PVC。通常，这应该不需要，但手动重建一个有问题的集群时可能会很有用。

此字段是只读的，Kubernetes 在创建后不会对 PVC 进行任何更改。

必需，不能是 nil。

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(Event)

事件列表

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

component

字符串

从中生成事件的组件。

主机

字符串

生成事件的节点名称。

命令

数组（字符串）

命令是在容器内执行的命令行，而 命令的工作目录是容器文件系统中的 root ('/')。命令只是 exec'd，它不会在 shell 中运行，因此传统的 shell 指令('|' 等)将无法工作。要使用 shell，您需要明确调用该 shell。0 的退出状态被视为 live/healthy，非零不健康。

fsType

string

fstype 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如，"ext4", "xfs", "ntfs".如果未指定，则隐式推断为 "ext4"。

lun

整数

LUN 是可选的：FC 目标 lun 号

readOnly

布尔值

readonly 为 Optional: Defaults to false (read/write)。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。

targetWWNs

数组（字符串）

targetWWNs 是可选：FC 目标全球名称(WWN)

wwids

数组（字符串）

wwids 可选：FC 卷全局范围标识符(wwids) Either wwids 或 targetWWN 和 lun 的组合必须被设置，但不能同时设置。

driver

string

driver 是用于此卷的驱动程序的名称。

fsType

string

fstype 是要挂载的 Filesystem 类型。必须是主机操作系统支持的文件系统类型。例如，"ext4", "xfs", "ntfs".默认文件系统依赖于 FlexVolume 脚本。

options

对象（字符串）

选项为 Optional：此字段包含额外的命令选项（若有）。

readOnly

布尔值

readonly 为 Optional: 默认为 false （读/写）。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。

secretRef

SecretReference

secretRef 为 Optional: SecretRef 对包含敏感信息的 secret 对象的引用，以传递给插件脚本。如果没有指定 secret 对象，这可能为空。如果 secret 对象包含多个 secret，则所有 secret 都会传递给插件脚本。

driver

string

driver 是用于此卷的驱动程序的名称。

fsType

string

fstype 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如，"ext4", "xfs", "ntfs".默认文件系统依赖于 FlexVolume 脚本。

options

对象（字符串）

选项为 Optional：此字段包含额外的命令选项（若有）。

readOnly

布尔值

readonly 为 Optional: 默认为 false （读/写）。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。

secretRef

LocalObjectReference

secretRef 是 Optional: secretRef 引用了包含敏感信息的 secret 对象，以传递给插件脚本。如果没有指定 secret 对象，这可能为空。如果 secret 对象包含多个 secret，则所有 secret 都会传递给插件脚本。

datasetName

string

datasetName 是数据存储为 Flocker dataset 上的 metadata → name 的 Name，应被视为已弃用

datasetUUID

string

datasetUUID 是 dataset 的 UUID。这是 Flocker 数据集的唯一标识符

fsType

string

fstype 是您要挂载的卷的文件系统类型。提示： 确保主机操作系统支持文件系统类型。示例："ext4", "xfs", "ntfs"。如果未指定，则隐式推断为 "ext4"。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

分区

整数

partition 是您要挂载的卷中的分区。如果省略，则默认使用卷名称来挂载。示例： 对于卷 /dev/sda1，您可以将分区指定为 "1"。同样，/dev/sda 的卷分区是"0" （或者您可以将属性留空）。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

pdName

string

pdName 是 GCE 中的 PD 资源的唯一名称。用于识别 GCE 中的磁盘。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

readOnly

布尔值

此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。默认为false。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

directory

string

directory 是目标目录名称。不得包含或以 '..' 开头。如果提供了 '.'，则卷目录将是 git 存储库。否则，如果指定，卷将在带有给定名称的子目录中包含 git 存储库。

软件仓库

string

repository 是 URL

revision

string

revision 是指定修订版本的提交哈希。

端点

string

Endpoints 是 Glusterfs 拓扑的详细信息的端点名称。更多信息： https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

endpointsNamespace

string

endpointNamespace 是包含 Glusterfs 端点的命名空间。如果此字段为空，则 EndpointNamespace 默认为与绑定 PVC 相同的命名空间。更多信息： https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

path

string

path 是 Glusterfs 卷路径。更多信息： https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

readOnly

布尔值

此处的 readonly 将强制 Glusterfs 卷以只读权限挂载。默认为false。更多信息： https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

端点

string

Endpoints 是 Glusterfs 拓扑的详细信息的端点名称。更多信息： https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

path

string

path 是 Glusterfs 卷路径。更多信息： https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

readOnly

布尔值

此处的 readonly 将强制 Glusterfs 卷以只读权限挂载。默认为false。更多信息： https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

port

整数

gRPC 服务的端口号。number 必须在 1 到 65535 之间。

service

string

service 是要放入 gRPC HealthCheckRequest 中的服务名称（请参阅 https://github.com/grpc/grpc/blob/master/doc/health-checking.md）。

如果没有指定，则默认行为由 gRPC 定义。

hostnames

数组（字符串）

以上 IP 地址的主机名。

ip

字符串

主机文件条目的 IP 地址。

path

string

主机上目录的路径。如果路径是符号链接，它将遵循指向实际路径的链接。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#hostpath

type

string

HostPath Volume 默认为 "" 更多信息： https://kubernetes.io/docs/concepts/storage/volumes#hostpath

可能枚举值：- "" 用于向后兼容，如果给定路径上不存在 "BlockDevice" A 块设备，则必须存在于给定路径 - "Directory" A 字符设备，则给定路径 - "Directory" A 目录必须存在于给定路径中 - "DirectoryOrCreate " （如果给定路径中不存在），则会根据需要创建空目录，并带有文件模式 0755，使用 Kubelet 相同的组和所有权。- "File " A file must the given path - "FileOrCreate " 如果给定路径中没有，则会根据需要创建一个空文件，且文件模式为 0644，具有与 Kubelet 相同的组和所有权。- "Socket " A UNIX socket 必须存在于给定路径中

主机

字符串

要连接到的主机名，默认为 pod IP。您可能想在 httpHeaders 中设置"主机"。

httpHeaders

数组(HTTPHeader)

在请求中设置的自定义标头。HTTP 允许重复的标头。

path

字符串

在 HTTP 服务器上访问的路径。

port

IntOrString

用于访问容器的端口的名称或编号。number 必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。

scheme

字符串

用于连接到主机的方案。默认为 HTTP。

可能枚举值： - "HTTP" 表示使用的方案为 http:// - "HTTPS" 表示使用的方案是 https://

name

string

标头字段名称。这将在输出时规范，因此理解 case-variant 名称与相同的标头一样。

value

字符串

标头字段值

chapAuthDiscovery

布尔值

chapAuthDiscovery 定义是否支持 iSCSI Discovery CHAP 身份验证

chapAuthSession

布尔值

chapAuthSession 定义是否支持 iSCSI 会话 CHAP 身份验证

fsType

string

fstype 是您要挂载的卷的文件系统类型。提示： 确保主机操作系统支持文件系统类型。示例："ext4", "xfs", "ntfs"。如果未指定，则隐式推断为 "ext4"。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#iscsi

initiatorName

string

initiatorname 是自定义 iSCSI 启动器名称。如果同时使用 iscsiInterface 指定 initiatorName，则会为连接创建新的 iSCSI 接口 <target portal>:<volume name>。

iqn

string

IQN 是目标 iSCSI 限定名称。

iscsiInterface

string

iscsiInterface 是使用 iSCSI 传输的接口名称。默认为 'default'(tcp)。

lun

整数

LUN 是 iSCSI 目标号。

门户

数组（字符串）

门户是 iSCSI 目标门户列表。如果端口不是默认值（通常为 TCP 端口 860 和 3260），则门户是 IP 或 ip_addr:port。

readOnly

布尔值

此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。默认为false。

secretRef

SecretReference

secretRef 是 iSCSI 目标和发起方身份验证的 CHAP Secret

targetPortal

string

targetPortal 是 iSCSI 目标门户。如果端口不是默认值（通常为 TCP 端口 860 和 3260），则门户是 IP 或 ip_addr:port。

chapAuthDiscovery

布尔值

chapAuthDiscovery 定义是否支持 iSCSI Discovery CHAP 身份验证

chapAuthSession

布尔值

chapAuthSession 定义是否支持 iSCSI 会话 CHAP 身份验证

fsType

string

fstype 是您要挂载的卷的文件系统类型。提示： 确保主机操作系统支持文件系统类型。示例："ext4", "xfs", "ntfs"。如果未指定，则隐式推断为 "ext4"。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#iscsi

initiatorName

string

initiatorname 是自定义 iSCSI 启动器名称。如果同时使用 iscsiInterface 指定 initiatorName，则会为连接创建新的 iSCSI 接口 <target portal>:<volume name>。

iqn

string

IQN 是目标 iSCSI 限定名称。

iscsiInterface

string

iscsiInterface 是使用 iSCSI 传输的接口名称。默认为 'default'(tcp)。

lun

整数

LUN 表示 iSCSI 目标 Lun 编号。

门户

数组（字符串）

门户是 iSCSI 目标门户列表。如果端口不是默认值（通常为 TCP 端口 860 和 3260），则门户是 IP 或 ip_addr:port。

readOnly

布尔值

此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。默认为false。

secretRef

LocalObjectReference

secretRef 是 iSCSI 目标和发起方身份验证的 CHAP Secret

targetPortal

string

targetPortal 是 iSCSI 目标门户。如果端口不是默认值（通常为 TCP 端口 860 和 3260），则门户是 IP 或 ip_addr:port。

key

string

key 是项目的关键。

模式

整数

模式为可选：用于设置此文件权限的模式位。必须是一个 0000 到 0777 之间的八进制数值，或者 0 到 511 之间的十进制值。YAML 接受八进制和十进制值，JSON 需要模式位的值为十进制值。如果没有指定，则使用卷 defaultMode。这可能与影响文件模式的其他选项（如 fsGroup ）冲突，结果可以是其他模式位。

path

string

path 是将键映射到的文件的相对路径。可能不是绝对路径。不得包含路径元素 '..'。不得以字符串 '..' 开头。

postStart

LifecycleHandler

postStart 在容器被创建后立即调用。如果处理程序失败，则容器将根据其重启策略终止并重启。容器块的其他管理，直到 hook 完成为止。更多信息： https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks

preStop

LifecycleHandler

preStop 在因为 API 请求或管理事件而终止容器前马上调用，如存活度/启动探测失败、抢占、资源争用等。如果容器崩溃或退出，则不会调用处理程序。Pod 的终止宽限期倒计时开始，然后再执行 PreStop hook。无论处理程序的结果是什么，容器最终都会在 Pod 的终止宽限期内终止（除非被终结器造成延迟）。容器的其他管理块直到 hook 完成或直至到达终止宽限期为止。更多信息： https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks

exec

ExecAction

exec 指定要执行的操作。

httpGet

HTTPGetAction

httpGet 指定要执行的 http 请求。

tcpSocket

TCPSocketAction

已弃用。tcpSocket 不支持作为 LifecycleHandler，并且保持向后兼容性。指定 tcp 处理程序时，没有此字段的验证和生命周期 hook 将在运行时失败。

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(LimitRange)

项是 LimitRange 对象的列表。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

fsType

string

fstype 是要挂载的文件系统类型。只有在 Path 是块设备时才适用。必须是主机操作系统支持的文件系统类型。例如，"ext4", "xfs", "ntfs".如果未指定，则默认值为自动选择文件系统。

path

string

到节点上卷的完整路径的路径。它可以是目录或块设备(disk, partition, …​)。

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(Namespace)

items 是列表中的 Namespace 对象列表。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

path

string

NFS 服务器导出的路径。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#nfs

readOnly

布尔值

此处的只读将强制使用只读权限挂载 NFS 导出。默认为false。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#nfs

server

string

server 是 NFS 服务器的主机名或 IP 地址。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#nfs

preferredDuringSchedulingIgnoredDuringExecution

数组(PreferredSchedulingTerm)

调度程序更喜欢将 pod 调度到满足此字段指定的关联性表达式的节点，但可能会选择违反一个或多个表达式的节点。最首选节点是具有最大权重总和的节点，即对于满足所有调度要求（资源请求、必需关联表达式等）的每个节点，计算出一个总和总和总和总和（如果节点与相应的 matchExpressions 匹配），则计算总和最高的节点是最首选的。

requiredDuringSchedulingIgnoredDuringExecution

NodeSelector

如果在调度时没有满足此字段指定的关联性要求，则 pod 不会被调度到该节点上。如果此字段指定的关联性要求在 pod 执行期间某一点满足（例如，由于更新），则系统可能或可能无法最终从其节点驱除 pod。

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(Node)

节点列表

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

nodeSelectorTerms

数组(NodeSelectorTerm)

必需。节点选择器术语列表。术语为 ORed。

key

字符串

选择器应用到的标签键。

operator

字符串

代表键与一组值的关系。有效的运算符为 In、NotIn、Exists、DoesNotExist。gt 和 Lt.

可能枚举值： - "DoesNotExist" - "Exists" - "Gt" - "In" - "Lt" - "NotIn"

values

数组（字符串）

字符串值数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。如果运算符是 Gt 或 Lt，则值数组必须具有单个元素，它将解释为整数。这个数组会在策略性合并补丁中被替换。

matchExpressions

数组(NodeSelectorRequirement)

按节点标签划分的节点选择器要求列表。

matchFields

数组(NodeSelectorRequirement)

按节点字段划分的节点选择器要求列表。

apiVersion

字符串

模式的版本是按术语编写的 FieldPath，默认为 "v1"。

fieldPath

字符串

在指定 API 版本中选择的字段路径。

apiVersion

字符串

引用的 API 版本。

fieldPath

字符串

如果引用的是对象的一部分而非整个对象，则该字符串应包含有效的 JSON/Go 字段访问声明，如 desiredState.manifest.containers[2]。例如，如果对象引用是一个 pod 中的容器，它应该还以下类似： "spec.containers{name}"（其中 "name" 是指触发事件的容器的名称）,如果不使用容器名称，则应类似于 "spec.containers[2]"（使用此 pod 中索引值为 2 的容器）。选择这个语法的原因是，为了有一些指向对象部分的正确定义方法。

kind

字符串

引用的类型。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

namespace

字符串

引用的命名空间。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

字符串

指定构成这个引用的 resourceVersion（如果存在）。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

uid

字符串

引用的 UID。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ObjectMeta

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

spec

对象

PersistentVolumeClaimSpec 描述了存储设备的通用属性，并允许 Source 用于特定于供应商的属性

status

对象

PersistentVolumeClaimStatus 是持久性卷声明的当前状态。

accessModes

数组（字符串）

accessModes 包含卷应具有所需的访问模式。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1

dataSource

对象

TypedLocalObjectReference 包含足够信息，以便您在同一命名空间中找到类型引用的对象。

dataSourceRef

object

如果需要非空卷，则 dataSourceRef 指定要使用数据填充卷的对象。这可以是来自非空 API 组（非核心对象）或 PersistentVolumeClaim 对象的任何对象。当指定对象的类型与某些安装的卷填充或动态置备程序匹配时，卷绑定才会成功。此字段将替换 dataSource 字段的功能，如果两个字段都不是空的，则它们必须具有相同的值。为了向后兼容，当命名空间没有在 dataSourceRef 中指定时，如果其中一个为空，则两个字段(dataSource 和 dataSourceRef)都会自动设置为相同的值，另一个是非空的。当在 dataSourceRef 中指定 namespace 时，dataSource 不设置为相同的值，必须为空。dataSource 和 dataSourceRef 之间有三个重要区别：* While dataSource 只允许两种特定类型的对象，dataSourceRef 允许任何非核心对象，以及 PersistentVolumeClaim 对象。* 虽然 dataSource 忽略了禁止的值（丢弃它们），dataSourceRef 保留所有值，并在指定禁止的值时生成错误。* 虽然 dataSource 只允许本地对象，dataSourceRef 允许任何命名空间中的对象。(Beta)使用此字段需要启用 AnyVolumeDataSource 功能门。(Alpha)使用 dataSourceRef 的 namespace 字段需要启用 CrossNamespaceVolumeDataSource 功能门。

resources

对象

ResourceRequirements 描述了计算资源要求。

selector

LabelSelector

selector 是要考虑绑定的卷的标签查询。

storageClassName

string

storageClassName 是声明所需的 StorageClass 的名称。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1

volumeMode

字符串

volumeMode 定义声明需要哪些卷类型。当未包含在 claim spec 中时，文件系统的值会被表示。

可能枚举值： - "Block" 表示卷不会格式化为文件系统，并保留原始块设备。- "Filesystem" 表示卷将被格式化为文件系统或使用文件系统格式化。

volumeName

string

volumeName 是对此声明支持的 PersistentVolume 的绑定引用。

apiGroup

字符串

APIGroup 是所引用资源的组。如果没有指定 APIGroup，则指定的 Kind 必须位于 core API 组中。对于任何其他第三方类型，需要 APIGroup。

kind

字符串

kind 是被引用的资源类型

name

字符串

name 是被引用的资源的名称

apiGroup

字符串

APIGroup 是所引用资源的组。如果没有指定 APIGroup，则指定的 Kind 必须位于 core API 组中。对于任何其他第三方类型，需要 APIGroup。

kind

字符串

kind 是被引用的资源类型

name

字符串

name 是被引用的资源的名称

namespace

string

命名空间是被引用的资源的命名空间，请注意，当指定命名空间时，引用命名空间中需要一个 gateway.networking.k8s.io/ReferenceGrant 对象来允许该命名空间的所有者接受引用。详情请查看 ReferenceGrant 文档。(alpha)此字段需要启用 CrossNamespaceVolumeDataSource 功能门。

claims

数组

claim 列出此容器使用的 spec.resourceClaims 中定义的资源名称。

这是一个 alpha 字段，需要启用 DynamicResourceAllocation 功能门。

此字段不可变。它只能为容器设置。

claims[]

object

ResourceClaim 引用 PodSpec.ResourceClaims 中的一个条目。

limits

对象（数量）

限制描述了允许的最大计算资源量。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

对象（数量）

Requests 描述了所需的最少计算资源。如果容器省略了 Requests，则默认为 Limits （如果明确指定），否则默认为实现定义的值。请求不能超过限值。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

name

string

name 必须与使用此字段的 Pod 的 pod.spec.resourceClaims 中的一个条目的名称匹配。它允许容器内部使用该资源。

accessModes

数组（字符串）

accessModes 包含 PVC 支持的卷的实际访问模式。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1

allocatedResources

对象（数量）

allocatedResources 是 AllocatedResources 中的存储资源跟踪分配给 PVC 的容量。当请求卷扩展操作时，它可能大于实际容量。对于存储配额，使用来自 allocatedResources 和 PVC.spec.resources 的值。如果没有设置 allocatedResources，则单独使用 PVC.spec.resources 进行配额计算。如果卷扩展容量请求被较低，则只有当没有进行中的扩展操作或当实际卷容量相等或低于请求的容量时，才会降低 allocatedResources。这是一个 alpha 字段，需要启用 RecoverVolumeExpansionFailure 功能。

capacity

对象（数量）

capacity 代表底层卷的实际资源。

conditions

数组

conditions 是持久性卷声明的当前条件。如果底层持久性卷被调整大小，则条件将设置为 'ResizeStarted'。

conditions[]

object

PersistentVolumeClaimCondition 包含有关 pvc 状态的详细信息

phase

string

phase 代表 PersistentVolumeClaim 的当前阶段。

可能的枚举值： - "Bound"，用于绑定的 PersistentVolumeClaim - "Lost"，用于丢失其底层 PersistentVolume 的 PersistentVolumeClaim。这个声明绑定到一个 PersistentVolume，这个卷不再存在，并会丢失它的所有数据。- "Pending" 用于尚未绑定的 PersistentVolumeClaim 的

resizeStatus

string

resizeStatus 存储调整大小操作的状态。默认不会设置 ResizeStatus，但当扩展完成 resizeStatus 时，通过调整 controller 或 kubelet 设置为空字符串。这是一个 alpha 字段，需要启用 RecoverVolumeExpansionFailure 功能。

可能枚举值：- "" 在扩展完成后，通过 resize controller 或 kubelet 设置空字符串。- 在扩展调整控制器时设置了 "ControllerExpansionFailed" State 设置，并显示终端错误。临时错误（如 timeout ）不应设置这个状态，并且应该不修改 ResizeStatus，因此大小控制器可以恢复卷扩展。- 在调整控制器开始扩展 control-plane - "NodeExpansionFailed" State 时设置 "ControllerExpansionInProgress" State 时设置 "ControllerExpansionInProgress" State 设置时。临时错误没有设置 NodeExpansionFailed。- 当 kubelet 开始扩展卷时设置 "NodeExpansionInProgress" State。- 在调整大小控制器完成扩展卷时，"NodeExpansionPending" State 设置，但节点上需要进一步扩展。

lastProbeTime

时间

lastProbeTime 是我们探测到条件的时间。

lastTransitionTime

时间

lastTransitionTime 是条件从一个状态转换到另一个状态的时间。

message

string

Message 是人类可读的消息，指示最后一次转换的详细信息。

reason

string

reason 是唯一的，这应该是一个简短的机器理解的字符串，给出了条件最后一次转换的原因。如果报告"ResizeStarted"，则表示已调整底层持久性卷的大小。

status

字符串

type

字符串

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(PersistentVolumeClaim)

items 是持久性卷声明列表。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

accessModes

数组（字符串）

accessModes 包含卷应具有所需的访问模式。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1

dataSource

TypedLocalObjectReference

Datasource 字段可以用来指定：* 一个现有的 VolumeSnapshot 对象(snapshot.storage.k8s.io/VolumeSnapshot)* 一个现有的 PVC (PersistentVolumeClaim)，如果置备程序或外部控制器可以支持指定的数据源，它将基于指定数据源的内容创建一个新卷。当启用 AnyVolumeDataSource 功能门时，dataSource 内容将复制到 dataSourceRef 中，当未指定 dataSourceRef.namespace 时，dataSourceRef 内容将复制到 dataSource 中。如果指定了 namespace，则不会将 dataSourceRef 复制到 dataSource 中。

dataSourceRef

TypedObjectReference

如果需要非空卷，则 dataSourceRef 指定要使用数据填充卷的对象。这可以是来自非空 API 组（非核心对象）或 PersistentVolumeClaim 对象的任何对象。当指定对象的类型与某些安装的卷填充或动态置备程序匹配时，卷绑定才会成功。此字段将替换 dataSource 字段的功能，如果两个字段都不是空的，则它们必须具有相同的值。为了向后兼容，当命名空间没有在 dataSourceRef 中指定时，如果其中一个为空，则两个字段(dataSource 和 dataSourceRef)都会自动设置为相同的值，另一个是非空的。当在 dataSourceRef 中指定 namespace 时，dataSource 不设置为相同的值，必须为空。dataSource 和 dataSourceRef 之间有三个重要区别：* While dataSource 只允许两种特定类型的对象，dataSourceRef 允许任何非核心对象，以及 PersistentVolumeClaim 对象。* 虽然 dataSource 忽略了禁止的值（丢弃它们），dataSourceRef 保留所有值，并在指定禁止的值时生成错误。* 虽然 dataSource 只允许本地对象，dataSourceRef 允许任何命名空间中的对象。(Beta)使用此字段需要启用 AnyVolumeDataSource 功能门。(Alpha)使用 dataSourceRef 的 namespace 字段需要启用 CrossNamespaceVolumeDataSource 功能门。

resources

ResourceRequirements

resources 代表卷应具有的最小资源。如果启用了 RecoverVolumeExpansionFailure 功能，用户可以指定小于之前值的资源要求，但仍必须高于声明的 status 字段中记录的容量。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources

selector

LabelSelector

selector 是要考虑绑定的卷的标签查询。

storageClassName

string

storageClassName 是声明所需的 StorageClass 的名称。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1

volumeMode

字符串

volumeMode 定义声明需要哪些卷类型。当未包含在 claim spec 中时，文件系统的值会被表示。

可能枚举值： - "Block" 表示卷不会格式化为文件系统，并保留原始块设备。- "Filesystem" 表示卷将被格式化为文件系统或使用文件系统格式化。

volumeName

string

volumeName 是对此声明支持的 PersistentVolume 的绑定引用。

metadata

ObjectMeta

可能包含创建 PVC 时将复制到 PVC 的标签和注解。不允许其他字段，并在验证过程中被拒绝。

spec

PersistentVolumeClaimSpec

PersistentVolumeClaim 的规格。整个内容保持不变复制到从该模板创建的 PVC 中。PersistentVolumeClaim 中与 相同的字段也有效。

claimName

string

claimName 是与使用这个卷的 pod 相同的命名空间中的 PersistentVolumeClaim 的名称。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims

readOnly

布尔值

readonly 将强制 VolumeMount 中的 ReadOnly 设置。默认 false。

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(PersistentVolume)

items 是持久性卷的列表。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes

kind

string

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

accessModes

数组（字符串）

accessModes 包含可以挂载卷的所有方法。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes

awsElasticBlockStore

AWSElasticBlockStoreVolumeSource

awsElasticBlockStore 代表一个 AWS Disk 资源，附加到 kubelet 的主机机器，然后公开给 pod。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

azureDisk

AzureDiskVolumeSource

azureDisk 代表主机上的 Azure Data Disk 挂载，并绑定到 pod。

azureFile

AzureFilePersistentVolumeSource

azureFile 代表主机上的 Azure File Service 挂载，并绑定到 pod。

capacity

对象（数量）

capacity 是持久性卷资源和容量的描述。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity

cephfs

CephFSPersistentVolumeSource

CephFS 代表共享 pod 生命周期的主机上的 Ceph FS 挂载

cinder

CinderPersistentVolumeSource

Cinder 代表附加并挂载到 kubelet 主机机器上的 cinder 卷。更多信息： https://examples.k8s.io/mysql-cinder-pd/README.md

claimRef

ObjectReference

claimRef 是 PersistentVolume 和 PersistentVolumeClaim 之间的双向绑定的一部分。当 bound. claim.VolumeName 是 PV 和 PVC 之间的权威绑定时，预期为非 nil。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#binding

csi

CSIPersistentVolumeSource

CSI 代表由外部 CSI 驱动程序处理的存储(Beta 功能)。

fc

FCVolumeSource

FC 代表附加到 kubelet 主机机器的光纤通道资源，然后公开给 pod。

flexVolume

FlexPersistentVolumeSource

FlexVolume 代表使用基于 exec 的插件置备的/附加的通用卷资源。

flocker

FlockerVolumeSource

flocker 代表附加到 kubelet 主机机器的 Flocker 卷，并公开给 pod 以供使用。这取决于正在运行的 Flocker 控制服务

gcePersistentDisk

GCEPersistentDiskVolumeSource

gcePersistentDisk 代表一个 GCE Disk 资源，该资源附加到 kubelet 的主机机器，然后公开给 pod。由管理员调配。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

glusterfs

GlusterfsPersistentVolumeSource

GlusterFS 代表附加到主机的 Glusterfs 卷，并公开给 pod。由管理员调配。更多信息： https://examples.k8s.io/volumes/glusterfs/README.md

hostPath

HostPathVolumeSource

hostpath 代表主机上的一个目录。由开发人员或测试者调配。这仅适用于单节点开发和测试。主机存储不以任何方式支持，在多节点集群中的 WILL NOT WORK 不被支持。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#hostpath

iscsi

ISCSIPersistentVolumeSource

iSCSI 代表附加到 kubelet 主机机器的 ISCSI Disk 资源，然后公开给 pod。由管理员调配。

local

LocalVolumeSource

Local 代表带有节点关联性的直接附加存储

mountOptions

数组（字符串）

mountOptions 是挂载选项的列表，如 ["ro", "soft"]。未验证 - 如果挂载无效，则挂载将失败。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options

nfs

NFSVolumeSource

NFS 代表主机上的 NFS 挂载。由管理员调配。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#nfs

nodeAffinity

VolumeNodeAffinity

nodeAffinity 定义限制来限制可以从哪个节点访问这个卷。此字段会影响使用这个卷的 pod 的调度。

persistentVolumeReclaimPolicy

string

persistentVolumeReclaimPolicy 定义从声明中释放持久性卷时会发生什么。有效选项为 Retain （手动创建 PersistentVolume 的默认设置）、Delete （动态置备的 PersistentVolume 的默认）和 Recycle （已弃用）。Recycle 必须由此 PersistentVolume 的卷插件支持。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#reclaiming

可能枚举值： - "Delete" 表示该卷将从声明发行版中从 Kubernetes 版本中删除。卷插件必须支持 Deletion. - "Recycle" 意味着该卷将从声明中回收回未绑定持久性卷的池。卷插件必须支持 Recycling。- "Retain" 表示卷将保留在当前阶段(Released)，供管理员手动重新声明。默认策略为 Retain。

photonPersistentDisk

PhotonPersistentDiskVolumeSource

photonPersistentDisk 代表附加并挂载到 kubelets 主机上的 PhotonController 持久磁盘

portworxVolume

PortworxVolumeSource

portworxVolume 代表附加并挂载到 kubelets 主机上的 portworx 卷

quobyte

QuobyteVolumeSource

quobyte 代表共享 pod 生命周期的主机上执行 Quobyte 挂载

rbd

RBDPersistentVolumeSource

RBD 代表共享 pod 生命周期的主机上 Rados 块设备挂载。更多信息： https://examples.k8s.io/volumes/rbd/README.md

scaleIO

ScaleIOPersistentVolumeSource

scaleIO 代表附加并挂载到 Kubernetes 节点上的 ScaleIO 持久性卷。

storageClassName

string

storageClassName 是此持久性卷所属的 StorageClass 的名称。空值表示这个卷不属于任何 StorageClass。

storageos

StorageOSPersistentVolumeSource

storageos 代表一个 StorageOS 卷，它附加到 kubelet 的主机机器中并挂载到 pod 更多信息：https://examples.k8s.io/volumes/storageos/README.md

volumeMode

字符串

volumeMode 定义卷是否要与格式化的文件系统一起使用，或者保持在原始块状态。当没有包含在 spec 中时，文件系统的值会被表示。

可能枚举值： - "Block" 表示卷不会格式化为文件系统，并保留原始块设备。- "Filesystem" 表示卷将被格式化为文件系统或使用文件系统格式化。

vsphereVolume

VsphereVirtualDiskVolumeSource

vsphereVolume 代表附加并挂载到 kubelets 主机上的 vSphere 卷

fsType

string

fstype 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如，"ext4", "xfs", "ntfs".如果未指定，则隐式推断为 "ext4"。

pdID

string

pdID 是标识 Photon Controller 持久磁盘的 ID

preferredDuringSchedulingIgnoredDuringExecution

数组(WeightedPodAffinityTerm)

调度程序更喜欢将 pod 调度到满足此字段指定的关联性表达式的节点，但可能会选择违反一个或多个表达式的节点。最首选的节点是具有最大权重总和的节点（即，对于满足所有调度要求的节点(resource request、requiredDuringScheduling 关联性表达式等)的每个节点，计算并迭代此字段元素，并在节点具有与对应 podAffinityTerm 匹配的 pod 时，将"weight"添加到总和（如果节点具有最高 podAffinityTerm）、具有最高总和最高的节点是首选。

requiredDuringSchedulingIgnoredDuringExecution

array (PodAffinityTerm)

如果在调度时没有满足此字段指定的关联性要求，则 pod 不会被调度到该节点上。如果此字段指定的关联性要求在 pod 执行期间某一点满足（例如，由于 pod 标签更新），则系统可能或可能无法最终从其节点驱除 pod。当有多个元素时，与每个 podAffinityTerm 对应的节点列表都会被交集，例如必须满足所有术语。

labelSelector

LabelSelector

对一组资源进行标签查询，本例中为 pod。

namespaceSelector

LabelSelector

术语适用的命名空间集合上的标签查询。术语应用于此字段选定的命名空间的 union，以及 namespaces 字段中列出的命名空间。null selector 和 null 或空命名空间列表表示"此 pod 的命名空间"。空选择器({})匹配所有命名空间。

命名空间

数组（字符串）

namespaces 指定术语应用到的命名空间名称的静态列表。术语应用到此字段中列出的命名空间的 union，namespaceSelector 选择的命名空间列表和 null namespaceSelector 表示 " this pod 的命名空间"。

topologyKey

字符串

此 pod 应该在指定命名空间中与 labelSelector 匹配的 pod 共存（反关联性），其中 co-located 定义为在运行所选 pod 的节点的值为 running 的节点上运行。不允许为空 topologyKey。