11장. VolumeSnapshot [snapshot.storage.k8s.io/v1]

설명

VolumeSnapshot는 영구 볼륨의 시점 스냅샷을 생성하거나 기존 스냅샷에 바인딩하는 사용자의 요청입니다.

유형

object

필수 항목

spec

11.1. 사양

속성	유형	설명
`apiVersion`	`string`	APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 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
`메타데이터`	`ObjectMeta`	표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`spec`	`object`	spec은 사용자가 요청한 스냅샷의 원하는 특성을 정의합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volume-snapshots#volumesnapshots 필수 항목입니다.
`status`	`object`	Status는 스냅샷의 현재 정보를 나타냅니다. 소비자는 이 오브젝트를 사용하기 전에 VolumeSnapshot 및 VolumeSnapshotContent 오브젝트 간 바인딩이 성공했는지 확인해야 합니다(모두 VolumeSnapshot 및 VolumeSnapshotContent 포인트 모두 확인).

11.1.1. .spec

설명

spec은 사용자가 요청한 스냅샷의 원하는 특성을 정의합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volume-snapshots#volumesnapshots 필수 항목입니다.

유형

object

필수 항목

소스

속성	유형	설명
`소스`	`object`	source는 스냅샷을 생성할 위치를 지정합니다. 생성 후에는 이 필드를 변경할 수 없습니다. 필수 항목입니다.
`volumeSnapshotClassName`	`string`	volumeSnapshotClassName은 VolumeSnapshot에서 요청한 VolumeSnapshotClass의 이름입니다. volumeSnapshotClassName은 기본 SnapshotClass를 사용해야 함을 나타내기 위해 nil을 남겨 둘 수 있습니다. 지정된 클러스터에 기본 볼륨 스냅샷 클래스가 여러 개 있을 수 있습니다. CSI 드라이버당 하나의 기본값입니다. VolumeSnapshot가 SnapshotClass를 지정하지 않으면 VolumeSnapshotSource가 연결된 CSI 드라이버가 무엇인지 파악하고 해당 CSI 드라이버와 연결된 기본 VolumeSnapshotClass가 사용됩니다. 지정된 CSI 드라이버에 둘 이상의 VolumeSnapshotClass가 있고 기본값으로 표시된 둘 이상의 VolumeSnapshotClass가 있는 경우 CreateSnapshot이 실패하고 이벤트를 생성합니다. 이 필드에는 빈 문자열이 허용되지 않습니다.

11.1.2. .spec.source

설명: source는 스냅샷을 생성할 위치를 지정합니다. 생성 후에는 이 필드를 변경할 수 없습니다. 필수 항목입니다.
유형: object

속성	유형	설명
`persistentVolumeClaimName`	`string`	persistentVolumeClaimName은 스냅샷을 생성해야 하는 볼륨을 나타내는 PersistentVolumeClaim 오브젝트의 이름을 지정합니다. 이 PVC는 VolumeSnapshot 오브젝트와 동일한 네임스페이스에 있는 것으로 간주됩니다. 스냅샷이 존재하지 않는 경우 이 필드를 설정해야 합니다. 이 필드는 변경할 수 없습니다.
`volumeSnapshotContentName`	`string`	volumeSnapshotContentName은 기존 볼륨 스냅샷을 나타내는 기존 VolumeSnapshotContent 오브젝트의 이름을 지정합니다. 스냅샷이 이미 존재하고 Kubernetes에 표현만 필요한 경우 이 필드를 설정해야 합니다. 이 필드는 변경할 수 없습니다.

11.1.3. .status

설명: Status는 스냅샷의 현재 정보를 나타냅니다. 소비자는 이 오브젝트를 사용하기 전에 VolumeSnapshot 및 VolumeSnapshotContent 오브젝트 간 바인딩이 성공했는지 확인해야 합니다(모두 VolumeSnapshot 및 VolumeSnapshotContent 포인트 모두 확인).
유형: object

속성	유형	설명
`boundVolumeSnapshotContentName`	`string`	boundVolumeSnapshotContentName은 이 VolumeSnapshot 오브젝트가 바인딩하려는 VolumeSnapshotContent 오브젝트의 이름입니다. 지정하지 않으면 VolumeSnapshot 오브젝트가 VolumeSnapshotContent 오브젝트에 성공적으로 바인딩되지 않았음을 나타냅니다. 참고: 가능한 보안 문제를 방지하려면 소비자가 이 오브젝트를 사용하기 전에 VolumeSnapshot 및 VolumeSnapshotContent 오브젝트 간 바인딩이 성공했는지 확인해야 합니다.
`creationTime`	`string`	creationTime은 기본 스토리지 시스템에서 지정 시간 스냅샷을 만들 때 타임스탬프입니다. 동적 스냅샷 생성 사례에서 이 필드는 CSI "CreateSnapshot" gRPC 호출에서 반환된 "creation_time" 값을 사용하여 스냅샷 컨트롤러에 의해 채워집니다. 기존 스냅샷의 경우 드라이버에서 지원하는 경우 CSI "ListSnapshots" gRPC 호출에서 반환된 "creation_time" 값으로 채워집니다. 지정하지 않으면 스냅샷 생성 시간을 알 수 없음을 나타낼 수 있습니다.
`error`	`object`	오류는 스냅샷 생성 중에 마지막으로 관찰된 오류(있는 경우)입니다. 이 필드는 보고된 오류 유형에 따라 스냅샷이 생성될 때까지 계속 대기해야 하는지 여부를 결정하는 데 도움이 될 수 있습니다. 스냅샷 생성 중에 오류가 발생하면 스냅샷 컨트롤러가 계속 재시도합니다. 성공하면 이 오류 필드가 지워집니다.
`readyToUse`	`boolean`	readyToUse는 볼륨을 복원하는 데 스냅샷을 사용할 준비가 되었는지를 나타냅니다. 동적 스냅샷 생성 사례에서 이 필드는 CSI "CreateSnapshot" gRPC 호출에서 반환된 "ready_to_use" 값을 사용하여 스냅샷 컨트롤러에 의해 채워집니다. 기존 스냅샷의 경우 이 필드는 CSI "ListSnapshots" gRPC 호출에서 반환된 "ready_to_use" 값으로 채워집니다. 그러지 않으면 이 필드는 "True"로 설정됩니다. 지정하지 않으면 스냅샷의 준비 상태를 알 수 없습니다.
`restoreSize`	`integer-or-string`	restoreSize는 이 스냅샷에서 볼륨을 생성하는 데 필요한 최소 볼륨 크기를 나타냅니다. 동적 스냅샷 생성 사례에서 이 필드는 CSI "CreateSnapshot" gRPC 호출에서 반환된 "size_bytes" 값을 사용하여 스냅샷 컨트롤러에 의해 채워집니다. 기존 스냅샷의 경우 드라이버에서 지원하는 경우 CSI "ListSnapshots" gRPC 호출에서 반환된 "size_bytes" 값으로 채워집니다. 이 스냅샷에서 볼륨을 복원할 때 볼륨 크기는 지정된 경우 restoreSize보다 작지 않아야 합니다. 그렇지 않으면 복원이 실패합니다. 지정하지 않으면 크기가 알 수 없음을 나타냅니다.
`volumeGroupSnapshotName`	`string`	VolumeGroupSnapshotName은 이 VolumeSnapshot가 포함된 VolumeGroupSnapshot의 이름입니다.

11.1.4. .status.error

설명: 오류는 스냅샷 생성 중에 마지막으로 관찰된 오류(있는 경우)입니다. 이 필드는 보고된 오류 유형에 따라 스냅샷이 생성될 때까지 계속 대기해야 하는지 여부를 결정하는 데 도움이 될 수 있습니다. 스냅샷 생성 중에 오류가 발생하면 스냅샷 컨트롤러가 계속 재시도합니다. 성공하면 이 오류 필드가 지워집니다.
유형: object

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

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

© 2024 Red Hat, Inc.