第 12 章 VolumeSnapshotContent [snapshot.storage.k8s.io/v1]

deletionPolicy

string

deletionPolicy 决定在删除绑定 VolumeSnapshot 时，是否应该删除此 VolumeSnapshotContent 及其物理快照。支持的值有 "Retain" 和 "Delete"。"恢复"意味着在底层存储系统中保留 VolumeSnapshotContent 及其物理快照。"delete"表示删除底层存储系统上的 VolumeSnapshotContent 及其物理快照。对于动态置备的快照，这个字段由 CSI 快照ter sidecar 使用对应的 VolumeSnapshotClass 中定义的 "DeletionPolicy" 字段自动填充。对于预先存在的快照，用户必须在创建 VolumeSnapshotContent 对象时指定此字段。必需。

driver

string

driver 是用于在底层存储系统上创建物理快照的 CSI 驱动程序名称。这必须与该驱动程序的 CSI GetPluginName （）调用返回的名称相同。必需。

source

object

Source 指定快照是（或应该是）动态置备或已存在，只需要 Kubernetes 对象表示。此字段在创建后是不可变的。必需。

sourceVolumeMode

string

SourceVolumeMode 是执行快照的卷的模式。可以是 "Filesystem" 或 "Block"。如果没有指定，这表示源卷的模式未知。此字段不可变。此字段是一个 alpha 字段。

volumeSnapshotClassName

string

创建此快照的 VolumeSnapshotClass 的名称。请注意，在置备后，可以使用不同值集删除或重新创建 VolumeSnapshotClass，因此不应引用 post-snapshot 创建。

volumeSnapshotRef

object

volumeSnapshotRef 指定此 VolumeSnapshotContent 对象绑定到的 VolumeSnapshot 对象。VolumeSnapshot.Spec.VolumeSnapshotContentName 字段必须引用此 VolumeSnapshotContent 的双向绑定名称。对于预先存在的 VolumeSnapshotContent 对象，您必须提供 VolumeSnapshot 对象的名称和命名空间，以便进行绑定。此字段在创建后是不可变的。必需。

snapshotHandle

string

snapshotHandle 指定底层存储系统上已存在的快照的 CSI "snapshot_id"，其创建 Kubernetes 对象表示（或应该是）。此字段不可变。

volumeHandle

string

volumeHandle 指定从其中动态获取快照的卷的 CSI "volume_id"。此字段不可变。

apiVersion

字符串

引用的 API 版本。

fieldPath

字符串

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

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

creationTime

整数

creationTime 是底层存储系统执行点快照时的时间戳。在动态快照创建情形中，此字段由 CSI 快照ter sidecar 使用从 CSI "CreateSnapshot" gRPC 调用返回的 "creation_time" 值填充。对于预先存在的快照，此字段将填充从 CSI "ListSnapshots" gRPC 调用返回的 "creation_time" 值（如果驱动程序支持）。如果没有指定，这表示创建时间未知。此字段的格式是 Unix 纳秒时间编码为 int64。在 Unix 上，自 1970-01-01 00:00:00 UTC 起，命令 date +%s%N 返回当前的时间（以纳秒为单位）。

错误

object

error 是快照创建过程中最后观察到的错误（若有）。重试成功后，此错误字段将被清除。

readyToUse

布尔值

readyToUse 表示快照是否准备好用于恢复卷。在动态快照创建案例中，此字段由 CSI 快照ter sidecar 填充，并从 CSI "CreateSnapshot" gRPC 调用返回的 "ready_to_use" 值。对于预先存在的快照，此字段将填充从 CSI "ListSnapshots" gRPC 调用返回的 "ready_to_use" 值（如果驱动程序支持），否则此字段将被设置为 "True"。如果没有指定，这表示快照的就绪状态未知。

restoreSize

整数

restoreSize 代表快照的完整大小，以字节为单位。在动态快照创建情况下，这个字段由 CSI 快照ter sidecar 填充，并带有从 CSI "CreateSnapshot" gRPC 调用返回的 "size_bytes" 值。对于预先存在的快照，如果驱动程序支持，此字段将填充从 CSI "ListSnapshots" gRPC 调用返回的 "size_bytes" 值。当从这个快照恢复卷时，如果指定了 restoreSize，则卷的大小不能小于 restoreSize。如果没有指定，这表示大小未知。

snapshotHandle

string

snapshotHandle 是底层存储系统上快照的 CSI "snapshot_id"。如果没有指定，这表示动态快照创建失败，或者仍在进行中。

message

string

如果指定，消息是一个字符串，详细描述了快照创建过程中遇到的错误。注意：消息可能已记录，并且不应包含敏感信息。

time

string

时间是遇到错误时的时间戳。