13장. VolumeSnapshotContent [snapshot.storage.k8s.io/v1]

deletionPolicy

string

deletionPolicy는 바인딩된 VolumeSnapshot를 삭제할 때 기본 스토리지 시스템의 이 VolumeSnapshotContent 및 물리적 스냅샷을 삭제해야 하는지 여부를 결정합니다. 지원되는 값은 "Retain" 및 "Delete"입니다. "retain"은 기본 스토리지 시스템의 VolumeSnapshotContent 및 해당 물리적 스냅샷을 보관함을 의미합니다. "삭제"는 기본 스토리지 시스템의 VolumeSnapshotContent 및 물리적 스냅샷이 삭제됨을 의미합니다. 동적으로 프로비저닝된 스냅샷의 경우 이 필드는 해당 VolumeSnapshotClass에 정의된 "DeletionPolicy" 필드를 사용하여 CSI 스냅샷터 사이드카에 의해 자동으로 채워집니다. 기존 스냅샷의 경우 VolumeSnapshotContent 오브젝트를 생성할 때 이 필드를 지정해야 합니다. 필수 항목입니다.

드라이버

string

드라이버는 기본 스토리지 시스템에서 물리적 스냅샷을 생성하는 데 사용되는 CSI 드라이버의 이름입니다. 이는 해당 드라이버에 대한 CSI GetPluginName() 호출에서 반환된 이름과 동일해야 합니다. 필수 항목입니다.

소스

object

source는 스냅샷이 동적으로 프로비저닝되었는지 또는 이미 존재하는지 여부를 지정하고 Kubernetes 오브젝트 표현만 필요합니다. 생성 후에는 이 필드를 변경할 수 없습니다. 필수 항목입니다.

sourceVolumeMode

string

SourceVolumeMode는 스냅샷을 만든 볼륨의 모드입니다. "Filesystem" 또는 "Block"일 수 있습니다. 지정하지 않으면 소스 볼륨의 모드를 알 수 없음을 나타냅니다. 이 필드는 변경할 수 없습니다. 이 필드는 알파 필드입니다.

volumeSnapshotClassName

string

이 스냅샷이 생성된 VolumeSnapshotClass의 이름입니다. 프로비저닝 후 VolumeSnapshotClass는 다른 값 세트로 삭제하거나 다시 생성할 수 있으므로 기록 후 생성을 참조해서는 안 됩니다.

volumeSnapshotRef

object

volumeSnapshotRef는 이 VolumeSnapshotContent 오브젝트가 바인딩된 VolumeSnapshot 오브젝트를 지정합니다. VolumeSnapshot.Spec.VolumeSnapshotContentName 필드는 양방향 바인딩이 유효한 경우 이 VolumeSnapshotContent의 이름을 참조해야 합니다. 기존 VolumeSnapshotContent 오브젝트의 경우 VolumeSnapshot 오브젝트의 이름과 네임스페이스를 바인딩하기 위해 제공해야 합니다. 생성 후에는 이 필드를 변경할 수 없습니다. 필수 항목입니다.

snapshotHandle

string

snapshotHandle은 Kubernetes 오브젝트 표현이 생성되거나 생성되어야 하는 기본 스토리지 시스템에서 기존 스냅샷의 CSI "snapshot_id"를 지정합니다. 이 필드는 변경할 수 없습니다.

volumeHandle

string

volumeHandle은 스냅샷을 동적으로 가져와야 하는 볼륨의 CSI "volume_id"를 지정합니다. 이 필드는 변경할 수 없습니다.

apiVersion

string

참조의 API 버전입니다.

fieldPath

string

전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. TODO: 이 설계는 최종적이지 않으며 이 필드는 향후 변경될 수 있습니다.

kind

string

일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

네임스페이스

string

참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

string

이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

uid

string

참조의 UID입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

creationTime

integer

creationTime은 기본 스토리지 시스템에서 지정 시간 스냅샷을 만들 때 타임스탬프입니다. 동적 스냅샷 생성 사례에서 이 필드는 CSI "CreateSnapshot" gRPC 호출에서 반환된 "creation_time" 값을 사용하여 CSI 스냅샷 사이드카에 의해 채워집니다. 기존 스냅샷의 경우 드라이버에서 지원하는 경우 CSI "ListSnapshots" gRPC 호출에서 반환된 "creation_time" 값으로 채워집니다. 지정하지 않으면 생성 시간을 알 수 없음을 나타냅니다. 이 필드의 형식은 int64로 인코딩된 Unix 나노초 시간입니다. Unix에서 명령 날짜 +%%% N 은 1970-01-01 00:00:00 UTC 이후 나노초 단위로 현재 시간을 반환합니다.

error

object

오류는 스냅샷 생성 중에 마지막으로 관찰된 오류(있는 경우)입니다. 재시도 후 성공 시 이 오류 필드가 지워집니다.

readyToUse

boolean

readyToUse는 볼륨을 복원하는 데 스냅샷을 사용할 준비가 되었는지를 나타냅니다. 동적 스냅샷 생성 사례에서 이 필드는 CSI "CreateSnapshot" gRPC 호출에서 반환된 "ready_to_use" 값을 사용하여 CSI 스냅샷 사이드카에 의해 채워집니다. 기존 스냅샷의 경우 이 필드는 CSI "ListSnapshots" gRPC 호출에서 반환된 "ready_to_use" 값으로 채워집니다. 그러지 않으면 이 필드는 "True"로 설정됩니다. 지정하지 않으면 스냅샷의 준비 상태를 알 수 없습니다.

restoreSize

integer

restoreSize는 스냅샷의 전체 크기를 바이트 단위로 나타냅니다. 동적 스냅샷 생성 사례에서 이 필드는 CSI "CreateSnapshot" gRPC 호출에서 반환된 "size_bytes" 값을 사용하여 CSI 스냅샷 사이드카에 의해 채워집니다. 기존 스냅샷의 경우 드라이버에서 지원하는 경우 CSI "ListSnapshots" gRPC 호출에서 반환된 "size_bytes" 값으로 채워집니다. 이 스냅샷에서 볼륨을 복원할 때 볼륨 크기는 지정된 경우 restoreSize보다 작지 않아야 합니다. 그렇지 않으면 복원이 실패합니다. 지정하지 않으면 크기가 알 수 없음을 나타냅니다.

snapshotHandle

string

snapshotHandle은 기본 스토리지 시스템에 있는 스냅샷의 CSI "snapshot_id"입니다. 지정하지 않으면 동적 스냅샷 생성이 실패했거나 아직 진행 중임을 나타냅니다.

volumeGroupSnapshotHandle

string

VolumeGroupSnapshotHandle은 기본 스토리지 시스템의 그룹 스냅샷의 CSI "group_snapshot_id"입니다.

message

string

message는 지정된 경우 스냅샷 생성 중에 발생한 오류를 자세히 설명하는 문자열입니다. 참고: 메시지는 기록될 수 있으며 중요한 정보가 포함되어 있지 않아야 합니다.

time

string

Time은 오류가 발생한 타임스탬프입니다.