스토리지 API
스토리지 API에 대한 참조 가이드
초록
1장. 스토리지 API 링크 복사링크가 클립보드에 복사되었습니다!
1.1. CSIDriver [storage.k8s.io/v1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- CSIDriver는 클러스터에 배포된 CSI(Container Storage Interface) 볼륨 드라이버에 대한 정보를 캡처합니다. Kubernetes 연결 분리 컨트롤러는 이 오브젝트를 사용하여 attach가 필요한지 여부를 확인합니다. kubelet은 이 오브젝트를 사용하여 마운트 시 Pod 정보를 전달해야 하는지 여부를 결정합니다. CSIDriver 오브젝트는 네임스페이스가 아닙니다.
- 유형
-
object
1.2. CSINode [storage.k8s.io/v1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- CSINode는 노드에 설치된 모든 CSI 드라이버에 대한 정보를 보유합니다. CSI 드라이버는 CSINode 오브젝트를 직접 생성할 필요가 없습니다. node-driver-registrar 사이드카 컨테이너를 사용하는 한 kubelet은 kubelet 플러그인 등록의 일부로 CSI 드라이버의 CSINode 오브젝트를 자동으로 채웁니다. CSINode의 이름은 노드와 동일합니다. 오브젝트가 누락된 경우 노드에 사용 가능한 CSI 드라이버가 없거나 Kubelet 버전이 이 오브젝트를 생성하지 않을 만큼 충분히 낮은 것입니다. CSINode에는 해당 노드 오브젝트를 가리키는 OwnerReference가 있습니다.
- 유형
-
object
1.3. CSIStorageCapacity [storage.k8s.io/v1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
CSIStorageCapacity는 하나의 CSI GetCapacity 호출 결과를 저장합니다. 지정된 StorageClass의 경우 특정 토폴로지 세그먼트에서 사용 가능한 용량을 설명합니다. 이는 새 PersistentVolume을 인스턴스화할 위치를 고려할 때 사용할 수 있습니다.
예를 들어, StorageClass "standard"에는 "topology.kubernetes.io/zone=us-east1"에서 사용할 수 있는 "1234GiB" - StorageClass "localssd"에는 "kubernetes.io/hostname=knode-abc123"에서 "10GiB"를 사용할 수 있습니다.
다음 세 가지 경우 모두 특정 조합에 사용할 수 있는 용량이 없음을 의미합니다. - 적절한 토폴로지 및 스토리지 클래스 이름이 있는 오브젝트가 없음 - 이러한 오브젝트가 존재하지만 용량은 설정되지 않음 - 이러한 객체는 존재하지만 용량은 0입니다.
이러한 오브젝트의 생산자는 어떤 접근 방식이 더 적합한지 결정할 수 있습니다.
CSI 드라이버가 CSIDriverSpec.StorageCapacity를 사용하여 용량 인식 스케줄링을 선택할 때 kube-scheduler에서 사용합니다. 스케줄러는 MaximumVolumeSize를 보류 볼륨의 요청된 크기와 비교하여 적합하지 않은 노드를 필터링합니다. MaximumVolumeSize가 설정되지 않은 경우 덜 정확한 용량과 비교하면 됩니다. 또한 설정되지 않은 경우 스케줄러는 해당 용량이 충분하지 않다고 가정하고 다른 노드를 시도합니다.
- 유형
-
object
1.4. PersistentVolume [v1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- PV(PersistentVolume)는 관리자가 프로비저닝한 스토리지 리소스입니다. 이는 노드와 유사합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes
- 유형
-
object
1.5. PersistentVolumeClaim [v1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- PersistentVolumeClaim은 영구 볼륨에 대한 사용자 요청 및 클레임입니다.
- 유형
-
object
1.6. StorageClass [storage.k8s.io/v1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
StorageClass는 PersistentVolumes를 동적으로 프로비저닝할 수 있는 스토리지 클래스의 매개변수를 설명합니다.
StorageClass는 네임스페이스가 아닙니다. etcd에 따른 스토리지 클래스의 이름은 ObjectMeta.Name에 있습니다.
- 유형
-
object
1.7. StorageState [migration.k8s.io/v1alpha1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 특정 리소스의 스토리지 상태입니다.
- 유형
-
object
1.8. StorageVersionMigration [migration.k8s.io/v1alpha1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- StorageVersionMigration은 저장된 데이터를 최신 스토리지 버전으로 마이그레이션하는 것을 나타냅니다.
- 유형
-
object
1.9. VolumeAttachment [storage.k8s.io/v1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
VolumeAttachment는 지정된 볼륨을 지정된 노드에서/에서 연결하거나 분리하려는 의도를 캡처합니다.
VolumeAttachment 오브젝트는 네임스페이스가 아닙니다.
- 유형
-
object
1.10. VolumeSnapshot [snapshot.storage.k8s.io/v1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- VolumeSnapshot는 영구 볼륨의 시점 스냅샷을 생성하거나 기존 스냅샷에 바인딩하는 사용자의 요청입니다.
- 유형
-
object
1.11. VolumeSnapshotClass [snapshot.storage.k8s.io/v1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- VolumeSnapshotClass는 볼륨 스냅샷을 생성할 때 기본 스토리지 시스템이 사용하는 매개변수를 지정합니다. 특정 VolumeSnapshotClass는 VolumeSnapshot 오브젝트에 이름을 지정하는 데 사용됩니다. VolumeSnapshotClasses가 네임스페이스가 아닌 경우
- 유형
-
object
1.12. VolumeSnapshotContent [snapshot.storage.k8s.io/v1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- VolumeSnapshotContent는 기본 스토리지 시스템의 실제 "디스크" 스냅샷 오브젝트를 나타냅니다.
- 유형
-
object
2장. CSIDriver [storage.k8s.io/v1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- CSIDriver는 클러스터에 배포된 CSI(Container Storage Interface) 볼륨 드라이버에 대한 정보를 캡처합니다. Kubernetes 연결 분리 컨트롤러는 이 오브젝트를 사용하여 attach가 필요한지 여부를 확인합니다. kubelet은 이 오브젝트를 사용하여 마운트 시 Pod 정보를 전달해야 하는지 여부를 결정합니다. CSIDriver 오브젝트는 네임스페이스가 아닙니다.
- 유형
-
object
- 필수 항목
-
spec
-
2.1. 사양 링크 복사링크가 클립보드에 복사되었습니다!
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트 metadata. metadata.Name은 이 오브젝트가 참조하는 CSI 드라이버의 이름을 나타냅니다. 해당 드라이버의 CSI GetPluginName() 호출에서 반환한 이름과 같아야 합니다. 드라이버 이름은 63자 이상이어야 하며, 시작 후 대시(-), 점(.) 및 영숫자 사이의 영숫자([a-z0-9A-Z])로 끝나야 합니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| CSIDriverSpec은 CSIDriver의 사양입니다. |
2.1.1. .spec 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- CSIDriverSpec은 CSIDriver의 사양입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| attachRequired는 이 CSI 볼륨 드라이버에 연결 작업이 필요함( CSI ControllerPublishVolume() 메서드를 구현함) 및 Kubernetes 연결 분리 컨트롤러에서 볼륨 연결 상태를 확인하는 attach 볼륨 인터페이스를 호출하고 볼륨이 마운트되기 전에 볼륨이 연결될 때까지 대기해야 함을 나타냅니다. CSI 외부 연결자는 CSI 볼륨 드라이버와 조정하고 연결 작업이 완료되면 볼륨 연결 상태를 업데이트합니다. CSIDriverRegistry 기능 게이트가 활성화되어 있고 값이 false로 지정되면 연결 작업을 건너뜁니다. 그렇지 않으면 연결 작업이 호출됩니다. 이 필드는 변경할 수 없습니다. |
|
| fsGroupPolicy는 기본 볼륨이 마운트되기 전에 볼륨의 소유권 및 권한 변경을 지원하는지 여부를 정의합니다. 자세한 내용은 특정 FSGroupPolicy 값을 참조하십시오. 이 필드는 변경할 수 없습니다. 기본값은 ReadWriteOnceWithFSType으로, 각 볼륨을 검사하여 Kubernetes가 볼륨의 소유권 및 권한을 수정해야 하는지 결정합니다. 기본 정책에서는 fstype이 정의되고 볼륨의 액세스 모드에 ReadWriteOnce가 포함된 경우에만 정의된 fsGroup이 적용됩니다. |
|
| podInfoOnMount는 이 CSI 볼륨 드라이버에 마운트 작업 중 podName, podUID 등과 같은 추가 Pod 정보가 필요함을 나타냅니다. false로 설정하면 마운트 시 Pod 정보가 전달되지 않습니다. 기본값은 false입니다. CSI 드라이버는 드라이버 배포의 일부로 podInfoOnMount를 지정합니다. true인 경우 Kubelet은 CSI NodePublishVolume() 호출에서 VolumeContext로 Pod 정보를 전달합니다. CSI 드라이버는 VolumeContext로 전달된 정보를 구문 분석하고 검증합니다. podInfoOnMount가 true로 설정된 경우 다음 VolumeContext가 전달됩니다. 이 목록이 증가할 수 있지만 접두사가 사용됩니다. "csi.storage.k8s.io/pod.name": pod.Name "csi.storage.k8s.io/pod.namespace": pod.Namespace "csi.storage.k8s.io/pod.uid": string(pod.UID) "csi.storage.k8s.io/ephemeral": "csi.storage.k8s.io/ephemeral": CSIVolume에 의해 정의된 경우 "true" "CSI.storage.k8s.io/ephemeral"은 Kubernetes 1.16의 새로운 기능입니다. "Persistent" 및 "Ephemeral" VolumeLifecycleMode를 모두 지원하는 드라이버에만 필요합니다. 다른 드라이버는 Pod 정보를 비활성화 상태로 두거나 이 필드를 무시할 수 있습니다. Kubernetes 1.15는 이 필드를 지원하지 않으므로 이러한 클러스터에 배포되는 경우 드라이버는 하나의 모드만 지원할 수 있으며 배포는 예를 들어 드라이버의 명령행 매개 변수를 통해 어떤 모드인지 결정합니다. 이 필드는 변경할 수 없습니다. |
|
|
requiresRepublish는 마운트된 볼륨에서 가능한 변경 사항을 반영하기 위해 CSI 드라이버에서 참고: 초기 NodePublishVolume 호출이 성공한 후 NodePublishVolume에 대한 후속 호출은 볼륨의 콘텐츠만 업데이트해야 합니다. 실행 중인 컨테이너에서 새 마운트 지점을 볼 수 없습니다. |
|
| seLinuxMount는 CSI 드라이버가 "-o context" 마운트 옵션을 지원하는지 여부를 지정합니다.
"true"인 경우 CSI 드라이버는 다른 "false"인 경우 Kubernetes는 특수 SELinux 마운트 옵션을 드라이버에 전달하지 않습니다. 이는 더 큰 공유 파일 시스템의 하위 디렉터리를 나타내는 볼륨에 일반적으로 사용됩니다. 기본값은 "false"입니다. |
|
| StorageCapacity는 CSI 볼륨 드라이버가 Pod 예약이 true로 설정된 경우 용량 정보를 사용하여 CSIStorageCapacity 오브젝트를 생성하여 드라이버 배포에서 보고할 스토리지 용량을 고려하려고 함을 나타냅니다. 드라이버를 배포할 때 검사를 즉시 활성화할 수 있습니다. 이 경우 최신 바인딩으로 새 볼륨을 프로비저닝하면 드라이버 배포가 적합한 CSIStorageCapacity 오브젝트가 게시될 때까지 일시 중지됩니다. 또는 설정되지 않은 필드 또는 false를 사용하여 드라이버를 배포할 수 있으며 나중에 스토리지 용량 정보가 게시되면 전환될 수 있습니다. 이 필드는 Kubernetes Cryostat 1.22에서 변경할 수 없으며 이제 변경할 수 있습니다. |
|
| tokenRequests는 CSI 드라이버에 필요한 인증을 수행하기 위해 볼륨을 마운트하는 Pod의 서비스 계정 토큰이 필요함을 나타냅니다. kubelet은 CSI NodePublishVolume 호출에서 VolumeContext에 토큰을 전달합니다. CSI 드라이버는 다음 VolumeContext를 구문 분석하고 검증해야 합니다. "csi.storage.k8s.io/serviceAccount.tokens": { "<audience>": { "token": <token>, "expirationTimestamp": <expiration timestamp in RFC3339>, }, … } 참고: 각 TokenRequest의 Audience는 달라야 하며 대부분의 토큰은 빈 문자열입니다. 만료 후 새 토큰을 수신하려면 RequiresRepublish를 사용하여 NodePublishVolume을 주기적으로 트리거할 수 있습니다. |
|
| TokenRequest에는 서비스 계정 토큰의 매개변수가 포함되어 있습니다. |
|
| volumeLifecycleModes는 이 CSI 볼륨 드라이버가 지원하는 볼륨 유형을 정의합니다. 목록이 비어 있는 경우 기본값은 "Persistent"입니다. 이는 CSI 사양에 의해 정의되고 일반적인 PV/PVC 메커니즘을 통해 Kubernetes에 구현되는 사용량입니다. 다른 모드는 "임시"입니다. 이 모드에서 볼륨은 CSIVolumeSource를 사용하여 Pod 사양 내부에서 인라인으로 정의되고 해당 Pod의 라이프사이클과 연결되어 있습니다. 드라이버는 이러한 볼륨에 대한 NodePublishVolume 호출만 받기 때문에 이를 알고 있어야 합니다. 이 모드 구현에 대한 자세한 내용은 https://kubernetes-csi.github.io/docs/ephemeral-local-volumes.html 드라이버가 이러한 모드 중 하나 이상을 지원할 수 있으며 나중에 더 많은 모드가 추가될 수 있습니다. 이 필드는 베타입니다. 이 필드는 변경할 수 없습니다. |
2.1.2. .spec.tokenRequests 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
tokenRequests는 CSI 드라이버에 필요한 인증을 수행하기 위해 볼륨을 마운트하는 Pod의 서비스 계정 토큰이 필요함을 나타냅니다. kubelet은 CSI NodePublishVolume 호출에서 VolumeContext에 토큰을 전달합니다. CSI 드라이버는 다음 VolumeContext를 구문 분석하고 검증해야 합니다. "csi.storage.k8s.io/serviceAccount.tokens": { "<audience>": { "token": <token>, "expirationTimestamp": <expiration timestamp in RFC3339>, }, … }
참고: 각 TokenRequest의 Audience는 달라야 하며 대부분의 토큰은 빈 문자열입니다. 만료 후 새 토큰을 수신하려면 RequiresRepublish를 사용하여 NodePublishVolume을 주기적으로 트리거할 수 있습니다.
- 유형
-
array
2.1.3. .spec.tokenRequests[] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- TokenRequest에는 서비스 계정 토큰의 매개변수가 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
대상
-
속성 | 유형 | 설명 |
---|---|---|
|
| audience는 "TokenRequestSpec"의 토큰 대상입니다. 기본적으로 kube apiserver의 대상입니다. |
|
| expirationSeconds는 "TokenRequestSpec"의 토큰 유효 기간입니다. "TokenRequestSpec"의 기본값인 "ExpirationSeconds"가 동일합니다. |
2.2. API 끝점 링크 복사링크가 클립보드에 복사되었습니다!
다음 API 끝점을 사용할 수 있습니다.
/apis/storage.k8s.io/v1/csidrivers
-
DELETE
: CSIDriver의 컬렉션 삭제 -
GET
: CSIDriver 유형의 오브젝트 나열 또는 감시 -
POST
: CSIDriver 생성
-
/apis/storage.k8s.io/v1/watch/csidrivers
-
GET
: CSIDriver 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
-
/apis/storage.k8s.io/v1/csidrivers/{name}
-
DELETE
: CSIDriver 삭제 -
GET
: 지정된 CSIDriver 읽기 -
PATCH
: 지정된 CSIDriver를 부분적으로 업데이트 -
PUT
: 지정된 CSIDriver로 교체
-
/apis/storage.k8s.io/v1/watch/csidrivers/{name}
-
GET
: CSIDriver 유형의 오브젝트 변경 사항을 조사합니다. 더 이상 사용되지 않는 경우 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
-
2.2.1. /apis/storage.k8s.io/v1/csidrivers 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
DELETE
- 설명
- CSIDriver 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- CSIDriver 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- CSIDriver 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
2.2.2. /apis/storage.k8s.io/v1/watch/csidrivers 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
GET
- 설명
- CSIDriver 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
2.2.3. /apis/storage.k8s.io/v1/csidrivers/{name} 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| CSIDriver의 이름 |
- HTTP 방법
-
DELETE
- 설명
- CSIDriver 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 CSIDriver 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 CSIDriver를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
- HTTP 방법
-
PUT
- 설명
- 지정된 CSIDriver를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
2.2.4. /apis/storage.k8s.io/v1/watch/csidrivers/{name} 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| CSIDriver의 이름 |
- HTTP 방법
-
GET
- 설명
- CSIDriver 유형의 오브젝트 변경 사항을 확인합니다. 더 이상 사용되지 않는 'watch' 매개변수를 대신 목록 작업과 함께 사용하여 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링됩니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
3장. CSINode [storage.k8s.io/v1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- CSINode는 노드에 설치된 모든 CSI 드라이버에 대한 정보를 보유합니다. CSI 드라이버는 CSINode 오브젝트를 직접 생성할 필요가 없습니다. node-driver-registrar 사이드카 컨테이너를 사용하는 한 kubelet은 kubelet 플러그인 등록의 일부로 CSI 드라이버의 CSINode 오브젝트를 자동으로 채웁니다. CSINode의 이름은 노드와 동일합니다. 오브젝트가 누락된 경우 노드에 사용 가능한 CSI 드라이버가 없거나 Kubelet 버전이 이 오브젝트를 생성하지 않을 만큼 충분히 낮은 것입니다. CSINode에는 해당 노드 오브젝트를 가리키는 OwnerReference가 있습니다.
- 유형
-
object
- 필수 항목
-
spec
-
3.1. 사양 링크 복사링크가 클립보드에 복사되었습니다!
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 metadata. metadata.name은 Kubernetes 노드 이름이어야 합니다. | |
|
| CSINodeSpec에는 노드에 설치된 모든 CSI 드라이버의 사양에 대한 정보가 있습니다. |
3.1.1. .spec 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- CSINodeSpec에는 노드에 설치된 모든 CSI 드라이버의 사양에 대한 정보가 있습니다.
- 유형
-
object
- 필수 항목
-
드라이버
-
속성 | 유형 | 설명 |
---|---|---|
|
| 드라이버는 노드에 존재하는 모든 CSI 드라이버의 정보 목록입니다. 목록의 모든 드라이버가 제거되면 비어 있을 수 있습니다. |
|
| CSINodeDriver에는 노드에 설치된 하나의 CSI 드라이버의 사양에 대한 정보가 들어 있습니다. |
3.1.2. .spec.drivers 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 드라이버는 노드에 존재하는 모든 CSI 드라이버의 정보 목록입니다. 목록의 모든 드라이버가 제거되면 비어 있을 수 있습니다.
- 유형
-
array
3.1.3. .spec.drivers[] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- CSINodeDriver에는 노드에 설치된 하나의 CSI 드라이버의 사양에 대한 정보가 들어 있습니다.
- 유형
-
object
- 필수 항목
-
name
-
nodeID
-
속성 | 유형 | 설명 |
---|---|---|
|
| VolumeNodeResources는 볼륨 스케줄링을 위한 리소스 제한 세트입니다. |
|
| name은 이 오브젝트가 참조하는 CSI 드라이버의 이름을 나타냅니다. 해당 드라이버에 대한 CSI GetPluginName() 호출에서 반환한 이름과 동일해야 합니다. |
|
| 드라이버 관점에서 노드의 NODEID입니다. 이 필드를 사용하면 Kubernetes가 노드의 nomenclature를 공유하지 않는 스토리지 시스템과 통신할 수 있습니다. 예를 들어 Kubernetes는 지정된 노드를 "node1"로 참조할 수 있지만 스토리지 시스템은 "nodeA"와 동일한 노드를 참조할 수 있습니다. Kubernetes에서 특정 노드에 볼륨을 연결하기 위해 스토리지 시스템에 명령을 발행하는 경우 이 필드를 사용하여 스토리지 시스템이 이해할 ID를 사용하여 노드 이름을 참조할 수 있습니다(예: "node1" 대신 "nodeA"). 이 필드는 필수입니다. |
|
| topologyKeys는 드라이버에서 지원하는 키 목록입니다. 클러스터에서 드라이버를 초기화하면 이해할 수 있는 토폴로지 키 세트(예: "company.com/zone", "company.com/region")를 제공합니다. 노드에서 드라이버가 초기화되면 값과 함께 동일한 토폴로지 키를 제공합니다. kubelet은 이러한 토폴로지 키를 자체 노드 오브젝트의 라벨로 노출합니다. Kubernetes에서 프로비저닝을 인식하면 이 목록을 사용하여 노드 오브젝트에서 검색하고 드라이버로 다시 전달해야 하는 레이블을 결정할 수 있습니다. 다른 노드에서 다른 토폴로지 키를 사용할 수 있습니다. 드라이버에서 토폴로지를 지원하지 않는 경우 비어 있을 수 있습니다. |
3.1.4. .spec.drivers[].allocatable 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- VolumeNodeResources는 볼륨 스케줄링을 위한 리소스 제한 세트입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| count는 노드에서 사용할 수 있는 CSI 드라이버에서 관리하는 최대 고유 볼륨 수를 나타냅니다. 노드에 연결 및 마운트된 볼륨은 두 번이 아닌 한 번 사용되는 것으로 간주됩니다. 동일한 노드의 여러 Pod에서 공유하는 고유 볼륨에도 동일한 규칙이 적용됩니다. 이 필드를 지정하지 않으면 이 노드에서 지원되는 볼륨 수가 바인딩되지 않습니다. |
3.2. API 끝점 링크 복사링크가 클립보드에 복사되었습니다!
다음 API 끝점을 사용할 수 있습니다.
/apis/storage.k8s.io/v1/csinodes
-
DELETE
: CSINode의 컬렉션 삭제 -
GET
: CSINode 유형의 오브젝트 나열 또는 감시 -
POST
: CSINode 생성
-
/apis/storage.k8s.io/v1/watch/csinodes
-
GET
: CSINode. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용하십시오.
-
/apis/storage.k8s.io/v1/csinodes/{name}
-
DELETE
: CSINode 삭제 -
GET
: 지정된 CSINode 읽기 -
PATCH
: 지정된 CSINode를 부분적으로 업데이트 -
PUT
: 지정된 CSINode를 교체
-
/apis/storage.k8s.io/v1/watch/csinodes/{name}
-
GET
: CSINode. deprecated 오브젝트의 변경 사항을 조사합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용하고 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링합니다.
-
3.2.1. /apis/storage.k8s.io/v1/csinodes 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
DELETE
- 설명
- CSINode 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- CSINode 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- CSINode 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
3.2.2. /apis/storage.k8s.io/v1/watch/csinodes 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
GET
- 설명
- CSINode. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
3.2.3. /apis/storage.k8s.io/v1/csinodes/{name} 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| CSINode의 이름 |
- HTTP 방법
-
DELETE
- 설명
- CSINode 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 CSINode 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 CSINode를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
- HTTP 방법
-
PUT
- 설명
- 지정된 CSINode를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
3.2.4. /apis/storage.k8s.io/v1/watch/csinodes/{name} 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| CSINode의 이름 |
- HTTP 방법
-
GET
- 설명
- CSINode. deprecated 오브젝트 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용하여 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
4장. CSIStorageCapacity [storage.k8s.io/v1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
CSIStorageCapacity는 하나의 CSI GetCapacity 호출 결과를 저장합니다. 지정된 StorageClass의 경우 특정 토폴로지 세그먼트에서 사용 가능한 용량을 설명합니다. 이는 새 PersistentVolume을 인스턴스화할 위치를 고려할 때 사용할 수 있습니다.
예를 들어, StorageClass "standard"에는 "topology.kubernetes.io/zone=us-east1"에서 사용할 수 있는 "1234GiB" - StorageClass "localssd"에는 "kubernetes.io/hostname=knode-abc123"에서 "10GiB"를 사용할 수 있습니다.
다음 세 가지 경우 모두 특정 조합에 사용할 수 있는 용량이 없음을 의미합니다. - 적절한 토폴로지 및 스토리지 클래스 이름이 있는 오브젝트가 없음 - 이러한 오브젝트가 존재하지만 용량은 설정되지 않음 - 이러한 객체는 존재하지만 용량은 0입니다.
이러한 오브젝트의 생산자는 어떤 접근 방식이 더 적합한지 결정할 수 있습니다.
CSI 드라이버가 CSIDriverSpec.StorageCapacity를 사용하여 용량 인식 스케줄링을 선택할 때 kube-scheduler에서 사용합니다. 스케줄러는 MaximumVolumeSize를 보류 볼륨의 요청된 크기와 비교하여 적합하지 않은 노드를 필터링합니다. MaximumVolumeSize가 설정되지 않은 경우 덜 정확한 용량과 비교하면 됩니다. 또한 설정되지 않은 경우 스케줄러는 해당 용량이 충분하지 않다고 가정하고 다른 노드를 시도합니다.
- 유형
-
object
- 필수 항목
-
storageClassName
-
4.1. 사양 링크 복사링크가 클립보드에 복사되었습니다!
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
| capacity는 이전 필드와 일치하는 토폴로지 및 매개변수를 사용하여 GetCapacityRequest에 대해 GetCapacityResponse의 CSI 드라이버에서 보고하는 값입니다. 의미 체계는 현재 (CSI 사양 1.2)로 정의됩니다. 사용 가능한 용량은 볼륨을 프로비저닝하는 데 사용할 수 있는 스토리지의 바이트 단위로 정의됩니다. 설정되지 않은 경우 현재 해당 정보를 사용할 수 없습니다. | |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| maximumVolumeSize는 이전 필드와 일치하는 토폴로지 및 매개변수를 사용하여 GetCapacityRequest에 대해 GetCapacityResponse의 CSI 드라이버에서 보고하는 값입니다. CSI 사양 1.4.0은 CreateVolumeRequest.capacity_range.required_bytes 필드에서 사용할 수 있는 가장 큰 크기로 정의되므로 GetCapacityRequest의 매개변수와 동일한 매개변수를 사용하여 볼륨을 생성합니다. Kubernetes API의 해당 값은 볼륨 클레임의 ResourceRequirements.Requests입니다. | |
| 표준 오브젝트의 메타데이터입니다. 이름에는 특별한 의미가 없습니다. DNS 하위 도메인이어야 합니다(할당할 수 있는 점, 253자). 클러스터의 다른 CSI 드라이버와 충돌하지 않도록 권장 사항은 csisc-<uuid>, 생성된 이름 또는 고유 CSI 드라이버 이름으로 끝나는 역방향 도메인 이름을 사용하는 것입니다. 오브젝트는 네임스페이스가 지정됩니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
| NodeTopology는 보고된 용량을 위한 스토리지에 액세스할 수 있는 노드를 정의합니다. 설정되지 않은 경우 클러스터의 노드에서 스토리지에 액세스할 수 없습니다. 비어 있는 경우 모든 노드에서 스토리지에 액세스할 수 있습니다. 이 필드는 변경할 수 없습니다. | |
|
| storageClassName은 보고된 용량이 적용되는 StorageClass의 이름을 나타냅니다. StorageClass 오브젝트의 이름과 동일한 요구 사항(비어 있음, DNS 하위 도메인)을 충족해야 합니다. 해당 오브젝트가 더 이상 존재하지 않는 경우 CSIStorageCapacity 오브젝트는 사용되지 않으며 작성자가 제거해야 합니다. 이 필드는 변경할 수 없습니다. |
4.2. API 끝점 링크 복사링크가 클립보드에 복사되었습니다!
다음 API 끝점을 사용할 수 있습니다.
/apis/storage.k8s.io/v1/csistoragecapacities
-
GET
: CSIStorageCapacity 유형의 오브젝트 나열 또는 감시
-
/apis/storage.k8s.io/v1/watch/csistoragecapacities
-
GET
: CSIStorageCapacity 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
-
/apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities
-
DELETE
: CSIStorageCapacity의 컬렉션 삭제 -
GET
: CSIStorageCapacity 유형의 오브젝트 나열 또는 감시 -
POST
: CSIStorageCapacity 생성
-
/apis/storage.k8s.io/v1/watch/namespaces/{namespace}/csistoragecapacities
-
GET
: CSIStorageCapacity 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
-
/apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities/{name}
-
DELETE
: CSIStorageCapacity 삭제 -
GET
: 지정된 CSIStorageCapacity 읽기 -
PATCH
: 지정된 CSIStorageCapacity를 부분적으로 업데이트 -
PUT
: 지정된 CSIStorageCapacity를 교체
-
/apis/storage.k8s.io/v1/watch/namespaces/{namespace}/csistoragecapacities/{name}
-
GET
: 종류의 CSIStorageCapacity 오브젝트를 변경합니다. 더 이상 사용되지 않습니다. 더 이상 사용되지 않는 'watch' 매개변수를 목록 작업과 함께 사용하여 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링됩니다.
-
4.2.1. /apis/storage.k8s.io/v1/csistoragecapacities 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
GET
- 설명
- CSIStorageCapacity 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
4.2.2. /apis/storage.k8s.io/v1/watch/csistoragecapacities 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
GET
- 설명
- CSIStorageCapacity 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
4.2.3. /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
DELETE
- 설명
- CSIStorageCapacity 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- CSIStorageCapacity 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- CSIStorageCapacity 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
202 - 승인됨 | |
401 - 무단 | 빈 |
4.2.4. /apis/storage.k8s.io/v1/watch/namespaces/{namespace}/csistoragecapacities 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
GET
- 설명
- CSIStorageCapacity 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
4.2.5. /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities/{name} 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| CSIStorageCapacity 이름 |
- HTTP 방법
-
DELETE
- 설명
- delete a CSIStorageCapacity
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 CSIStorageCapacity 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 CSIStorageCapacity를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 CSIStorageCapacity 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
401 - 무단 | 빈 |
4.2.6. /apis/storage.k8s.io/v1/watch/namespaces/{namespace}/csistoragecapacities/{name} 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| CSIStorageCapacity 이름 |
- HTTP 방법
-
GET
- 설명
- CSIStorageCapacity 유형의 오브젝트 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 'fieldSelector' 매개변수를 사용하여 목록 작업과 함께 'watch' 매개변수를 단일 항목으로 필터링합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
5장. PersistentVolume [v1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- PV(PersistentVolume)는 관리자가 프로비저닝한 스토리지 리소스입니다. 이는 노드와 유사합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes
- 유형
-
object
5.1. 사양 링크 복사링크가 클립보드에 복사되었습니다!
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| PersistentVolumeSpec은 영구 볼륨의 사양입니다. |
|
| PersistentVolumeStatus는 영구 볼륨의 현재 상태입니다. |
5.1.1. .spec 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- PersistentVolumeSpec은 영구 볼륨의 사양입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| accessModes에는 볼륨을 마운트할 수 있는 모든 방법이 포함되어 있습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes |
|
| AWS의 영구 디스크 리소스를 나타냅니다. 컨테이너에 마운트하기 전에 AWS EBS 디스크가 있어야 합니다. 디스크도 kubelet과 동일한 AWS 영역에 있어야 합니다. AWS EBS 디스크는 읽기/쓰기로 한 번만 마운트할 수 있습니다. AWS EBS 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| AzureDisk는 호스트의 Azure Data Disk 마운트를 나타내며 Pod에 마운트를 바인딩합니다. |
|
| AzureFile은 호스트의 Azure File Service 마운트를 나타내며 Pod에 마운트를 바인딩합니다. |
| capacity는 영구 볼륨의 리소스 및 용량에 대한 설명입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity | |
|
| Pod Cephfs 볼륨의 수명이 지속되는 Ceph Filesystem 마운트는 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다. |
|
| Openstack의 cinder 볼륨 리소스를 나타냅니다. 컨테이너에 마운트하기 전에 Cinder 볼륨이 있어야 합니다. 볼륨도 kubelet과 동일한 리전에 있어야 합니다. Cinder 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다. |
|
| 외부 CSI 볼륨 드라이버(베타 기능)에서 관리하는 스토리지를 나타냅니다. |
|
| 파이버 채널 볼륨을 나타냅니다. 파이버 채널 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. 파이버 채널 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| exec 기반 플러그인을 사용하여 프로비저닝/연결되는 일반 영구 볼륨 리소스를 나타냅니다. |
|
| Flocker 에이전트가 마운트한 Flocker 볼륨을 나타냅니다. datasetName 및 datasetUUID 중 하나만 설정해야 합니다. flocker 볼륨은 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다. |
|
| Google Compute Engine의 영구 디스크 리소스를 나타냅니다. 컨테이너에 마운트하기 전에 GCE PD가 있어야 합니다. 디스크도 kubelet과 동일한 GCE 프로젝트 및 영역에 있어야 합니다. GCE PD는 한 번만 읽기/쓰기로 마운트하거나 읽기 전용으로 마운트할 수 있습니다. GCE PD는 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| Pod의 수명을 지속되는 Glusterfs 마운트를 나타냅니다. GlusterFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다. |
|
| Pod에 매핑된 호스트 경로를 나타냅니다. 호스트 경로 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다. |
|
| ISCSIPersistentVolumeSource는 ISCSI 디스크를 나타냅니다. iSCSI 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. ISCSI 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| local은 노드 유사성을 사용하여 직접 연결된 스토리지를 나타냅니다(베타 기능) |
|
| mountOptions는 마운트 옵션 목록입니다(예: ["ro", "soft"]). 검증되지 않음 - 마운트가 유효하지 않은 경우 간단히 실패합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options |
|
| Pod의 수명을 지속되는 NFS 마운트를 나타냅니다. NFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다. |
|
| VolumeNodeAffinity는 이 볼륨에 액세스할 수 있는 노드를 제한하는 제약 조건을 정의합니다. |
|
| persistentVolumeReclaimPolicy는 클레임에서 릴리스될 때 영구 볼륨에 어떤 일이 발생하는지 정의합니다. 유효한 옵션은 Retain(수동으로 생성된 PersistentVolumes의 기본값), Delete( dynamically provisioned PersistentVolumes) 및 Recycle(더 이상 사용되지 않음)입니다. 이 PersistentVolume 기본 볼륨 플러그인에서 recycle를 지원해야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#reclaiming
가능한 열거 값: - |
|
| Cryostat 컨트롤러 영구 디스크 리소스를 나타냅니다. |
|
| PortworxVolumeSource는 Portworx 볼륨 리소스를 나타냅니다. |
|
| Pod의 수명을 지속되는 Quobyte 마운트를 나타냅니다. Quobyte 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다. |
|
| Pod의 수명을 지속되는 Rados Block Device 마운트를 나타냅니다. RBD 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| scaleIOPersistentVolumeSource는 영구 scaleIO 볼륨을 나타냅니다. |
|
| storageClassName은 이 영구 볼륨이 속한 StorageClass의 이름입니다. 빈 값은 이 볼륨이 StorageClass에 속하지 않음을 의미합니다. |
|
| StorageOS 영구 볼륨 리소스를 나타냅니다. |
|
| 이 영구 볼륨이 속하는 VolumeAttributesClass의 이름입니다. 빈 값은 허용되지 않습니다. 이 필드를 설정하지 않으면 이 볼륨이 VolumeAttributesClass에 속하지 않음을 나타냅니다. 이 필드는 변경할 수 있으며 볼륨이 새 클래스로 성공적으로 업데이트된 후 CSI 드라이버에서 변경할 수 있습니다. 바인딩되지 않은 PersistentVolume의 경우 volumeAttributesClassName은 바인딩 프로세스 중에 unbound PersistentVolumeClaims와 일치합니다. 이는 alpha 필드이며 VolumeAttributesClass 기능을 활성화해야 합니다. |
|
| volumeMode는 볼륨이 포맷된 파일 시스템과 함께 사용되는지 또는 원시 블록 상태로 유지되도록 하는지를 정의합니다. spec에 포함되지 않은 경우 Filesystem의 값이 포함됩니다.
가능한 enum 값: - |
|
| vSphere 볼륨 리소스를 나타냅니다. |
5.1.2. .spec.awsElasticBlockStore 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
AWS의 영구 디스크 리소스를 나타냅니다.
컨테이너에 마운트하기 전에 AWS EBS 디스크가 있어야 합니다. 디스크도 kubelet과 동일한 AWS 영역에 있어야 합니다. AWS EBS 디스크는 읽기/쓰기로 한 번만 마운트할 수 있습니다. AWS EBS 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
- 유형
-
object
- 필수 항목
-
volumeID
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
|
| partition은 마운트하려는 볼륨의 파티션입니다. 생략하면 기본값은 볼륨 이름으로 마운트됩니다. 예: 볼륨 /dev/sda1의 경우 파티션을 "1"로 지정합니다. 마찬가지로 /dev/sda의 볼륨 파티션은 "0"입니다(또는 속성을 비워 둘 수 있음). |
|
| readonly value true는 VolumeMounts에서 readOnly 설정을 강제 적용합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
|
| volumeID는 AWS(Amazon EBS 볼륨)의 영구 디스크 리소스의 고유 ID입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
5.1.3. .spec.azureDisk 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- AzureDisk는 호스트의 Azure Data Disk 마운트를 나타내며 Pod에 마운트를 바인딩합니다.
- 유형
-
object
- 필수 항목
-
diskName
-
diskURI
-
속성 | 유형 | 설명 |
---|---|---|
|
| cachingMode는 Host Caching 모드입니다: None, Read Only, Read Write.
가능한 열거 값: - |
|
| diskName은 Blob 스토리지에 있는 데이터 디스크의 이름입니다. |
|
| diskURI는 Blob 스토리지의 데이터 디스크 URI입니다. |
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| 종류의 예상 값은 공유: 스토리지 계정 전용당 여러 Blob 디스크: 스토리지 계정당 단일 Blob 디스크: Azure 관리 데이터 디스크(관리형 가용성 세트에서만). 기본값은 shared입니다.
가능한 열거 값: - |
|
| Readonly 기본값은 false(읽기/쓰기)로 설정됩니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
5.1.4. .spec.azureFile 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- AzureFile은 호스트의 Azure File Service 마운트를 나타내며 Pod에 마운트를 바인딩합니다.
- 유형
-
object
- 필수 항목
-
secretName
-
shareName
-
속성 | 유형 | 설명 |
---|---|---|
|
| readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| secretName은 Azure Storage 계정 이름과 키가 포함된 시크릿의 이름입니다. |
|
| secretNamespace는 Azure Storage 계정 이름이 포함된 시크릿의 네임스페이스이며 Key 기본값은 Pod와 동일합니다. |
|
| 공유 이름은 azure Share Name입니다. |
5.1.5. .spec.cephfs 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- Pod Cephfs 볼륨의 수명이 지속되는 Ceph Filesystem 마운트는 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다.
- 유형
-
object
- 필수 항목
-
모니터
-
속성 | 유형 | 설명 |
---|---|---|
|
| 모니터는 필수 항목입니다. 모니터는 Ceph 모니터 모음입니다. https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
| path는 선택 사항입니다. 전체 Ceph 트리가 아닌 마운트된 루트로 사용됩니다. 기본값은 /입니다. |
|
| readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 자세한 내용은 https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
| secretFile은 선택 사항입니다. SecretFile은 사용자의 키 링 경로입니다. 기본값은 /etc/ceph/user.secret 추가 정보: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
|
| 사용자는 선택 사항입니다. 사용자는 rados 사용자 이름이며 기본값은 관리자 추가 정보입니다. https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
5.1.6. .spec.cephfs.secretRef 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
5.1.7. .spec.cinder 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- Openstack의 cinder 볼륨 리소스를 나타냅니다. 컨테이너에 마운트하기 전에 Cinder 볼륨이 있어야 합니다. 볼륨도 kubelet과 동일한 리전에 있어야 합니다. Cinder 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
- 유형
-
object
- 필수 항목
-
volumeID
-
속성 | 유형 | 설명 |
---|---|---|
|
| 마운트할 fstype 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. More info: https://examples.k8s.io/mysql-cinder-pd/README.md |
|
| readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. More info: https://examples.k8s.io/mysql-cinder-pd/README.md |
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
|
| cinder에서 볼륨을 식별하는 데 사용되는 volumeID입니다. More info: https://examples.k8s.io/mysql-cinder-pd/README.md |
5.1.8. .spec.cinder.secretRef 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
5.1.9. .spec.claimRef 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 참조의 API 버전입니다. |
|
| 전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. |
|
| 일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
|
| 이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
| 참조의 UID입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
5.1.10. .spec.csi 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 외부 CSI 볼륨 드라이버(베타 기능)에서 관리하는 스토리지를 나타냅니다.
- 유형
-
object
- 필수 항목
-
드라이버
-
volumeHandle
-
속성 | 유형 | 설명 |
---|---|---|
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
|
| driver는 이 볼륨에 사용할 드라이버의 이름입니다. 필수 항목입니다. |
|
| 마운트할 fstype. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". |
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
|
| ControllerPublishVolumeRequest에 전달할 읽기 전용 값입니다. 기본값은 false(읽기/쓰기)입니다. |
|
| 게시할 볼륨의 volumeAttributes입니다. |
|
| volumeHandle은 모든 후속 호출에서 볼륨을 참조하기 위해 CSI 볼륨 플러그인의 CreateVolume에서 반환한 고유한 볼륨 이름입니다. 필수 항목입니다. |
5.1.11. .spec.csi.controllerExpandSecretRef 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
5.1.12. .spec.csi.controllerPublishSecretRef 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
5.1.13. .spec.csi.nodeExpandSecretRef 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
5.1.14. .spec.csi.nodePublishSecretRef 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
5.1.15. .spec.csi.nodeStageSecretRef 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
5.1.16. .spec.fc 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 파이버 채널 볼륨을 나타냅니다. 파이버 채널 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. 파이버 채널 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| LUN은 선택 사항입니다. FC 대상 lun 번호 |
|
| readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| targetWWNs는 선택 사항입니다. FC 대상 전 세계 이름(WWN) |
|
| WWID 선택 사항: FC 볼륨 전체 식별자(wwids) 또는 targetWWN과 lun의 조합을 설정해야 하지만 동시에 둘 다 설정해서는 안 됩니다. |
5.1.17. .spec.flexVolume 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- exec 기반 플러그인을 사용하여 프로비저닝/연결되는 일반 영구 볼륨 리소스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
드라이버
-
속성 | 유형 | 설명 |
---|---|---|
|
| driver는 이 볼륨에 사용할 드라이버의 이름입니다. |
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 기본 파일 시스템은 FlexVolume 스크립트에 따라 다릅니다. |
|
| 옵션은 선택 사항입니다. 이 필드에는 추가 명령 옵션이 있습니다. |
|
| readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
5.1.18. .spec.flexVolume.secretRef 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
5.1.19. .spec.flocker 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- Flocker 에이전트가 마운트한 Flocker 볼륨을 나타냅니다. datasetName 및 datasetUUID 중 하나만 설정해야 합니다. flocker 볼륨은 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| DatasetsName은 메타데이터로 저장된 데이터 집합의 이름 → Flocker의 데이터 세트 이름은 더 이상 사용되지 않는 것으로 간주되어야 합니다. |
|
| datasetUUID는 데이터 세트의 UUID입니다. Flocker 데이터 세트의 고유 식별자입니다. |
5.1.20. .spec.gcePersistentDisk 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
Google Compute Engine의 영구 디스크 리소스를 나타냅니다.
컨테이너에 마운트하기 전에 GCE PD가 있어야 합니다. 디스크도 kubelet과 동일한 GCE 프로젝트 및 영역에 있어야 합니다. GCE PD는 한 번만 읽기/쓰기로 마운트하거나 읽기 전용으로 마운트할 수 있습니다. GCE PD는 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
- 유형
-
object
- 필수 항목
-
pdName
-
속성 | 유형 | 설명 |
---|---|---|
|
| 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은 GCE의 PD 리소스의 고유한 이름입니다. GCE에서 디스크를 식별하는 데 사용됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본값은 false입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
5.1.21. .spec.glusterfs 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- Pod의 수명을 지속되는 Glusterfs 마운트를 나타냅니다. GlusterFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
- 유형
-
object
- 필수 항목
-
끝점
-
path
-
속성 | 유형 | 설명 |
---|---|---|
|
| 엔드포인트는 Glusterfs 토폴로지를 자세히 설명하는 엔드포인트 이름입니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
|
| endpointNamespace는 Glusterfs 끝점이 포함된 네임스페이스입니다. 이 필드가 비어 있으면 EndpointNamespace의 기본값은 바인딩된 PVC와 동일한 네임스페이스로 설정됩니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
|
| path는 Glusterfs 볼륨 경로입니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
|
| 여기에서 readonly는 읽기 전용 권한으로 Glusterfs 볼륨을 강제로 마운트합니다. 기본값은 false입니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
5.1.22. .spec.hostPath 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- Pod에 매핑된 호스트 경로를 나타냅니다. 호스트 경로 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
- 유형
-
object
- 필수 항목
-
path
-
속성 | 유형 | 설명 |
---|---|---|
|
| 호스트의 디렉터리 경로입니다. 경로가 심볼릭 링크인 경우 실제 경로의 링크를 따릅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#hostpath |
|
| HostPath Volume 기본값을 "" 추가 정보: https://kubernetes.io/docs/concepts/storage/volumes#hostpath
가능한 enum 값: - |
5.1.23. .spec.iscsi 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- ISCSIPersistentVolumeSource는 ISCSI 디스크를 나타냅니다. iSCSI 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. ISCSI 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
- 유형
-
object
- 필수 항목
-
targetPortal
-
IQN
-
lun
-
속성 | 유형 | 설명 |
---|---|---|
|
| chapAuthDiscovery는 iSCSI Discovery CHAP 인증을 지원하는지 여부를 정의합니다. |
|
| chapAuthSession은 iSCSI 세션 CHAP 인증을 지원하는지 여부를 정의합니다. |
|
| fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#iscsi |
|
| initiatorname은 사용자 지정 iSCSI 이니시에이터 이름입니다. iscsiInterface를 동시에 사용하여 initiatorName을 지정하면 연결에 사용할 새 iSCSI 인터페이스 <target portal>:<volume name>이 생성됩니다. |
|
| IQN은 대상 iSCSI 정규화된 이름입니다. |
|
| iscsiInterface는 iSCSI 전송을 사용하는 인터페이스 이름입니다. 기본값은 'default'(tcp)입니다. |
|
| LUN은 iSCSI 대상 Lun 번호입니다. |
|
| 포털은 iSCSI 대상 포털 목록입니다. 포트가 기본값 이외의 경우 포털은 IP 또는 ip_addr:port입니다(일반적으로 TCP 포트 860 및 3260). |
|
| 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본값은 false입니다. |
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
|
| targetPortal은 iSCSI 대상 포털입니다. 포트가 기본값 이외의 경우 포털은 IP 또는 ip_addr:port입니다(일반적으로 TCP 포트 860 및 3260). |
5.1.24. .spec.iscsi.secretRef 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
5.1.25. .spec.local 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- local은 노드 유사성을 사용하여 직접 연결된 스토리지를 나타냅니다(베타 기능)
- 유형
-
object
- 필수 항목
-
path
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형입니다. 경로가 블록 장치인 경우에만 적용됩니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 기본값은 지정되지 않은 경우 파일 시스템을 자동 선택하는 것입니다. |
|
| 노드의 전체 볼륨 경로입니다. 디렉터리 또는 블록 장치(디스크, 파티션, …)일 수 있습니다. |
5.1.26. .spec.nfs 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- Pod의 수명을 지속되는 NFS 마운트를 나타냅니다. NFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
- 유형
-
object
- 필수 항목
-
server
-
path
-
속성 | 유형 | 설명 |
---|---|---|
|
| NFS 서버에서 내보낸 경로입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#nfs |
|
| 여기에서 readonly는 읽기 전용 권한으로 NFS 내보내기를 강제로 마운트합니다. 기본값은 false입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#nfs |
|
| 서버는 NFS 서버의 호스트 이름 또는 IP 주소입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#nfs |
5.1.27. .spec.nodeAffinity 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- VolumeNodeAffinity는 이 볼륨에 액세스할 수 있는 노드를 제한하는 제약 조건을 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 노드 선택기는 노드 세트에 대한 하나 이상의 레이블 쿼리의 결과 결합을 나타냅니다. 즉, 노드 선택기 용어로 표시되는 선택기 중 OR를 나타냅니다. |
5.1.28. .spec.nodeAffinity.required 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 노드 선택기는 노드 세트에 대한 하나 이상의 레이블 쿼리의 결과 결합을 나타냅니다. 즉, 노드 선택기 용어로 표시되는 선택기 중 OR를 나타냅니다.
- 유형
-
object
- 필수 항목
-
nodeSelectorTerms
-
속성 | 유형 | 설명 |
---|---|---|
|
| 필수 항목입니다. 노드 선택기 용어 목록입니다. 용어는 ORed입니다. |
|
| null 또는 빈 노드 선택기 용어는 오브젝트와 일치하지 않습니다. 이러한 요구 사항은 AND로 표시됩니다. TopologySelectorTerm 유형은 NodeSelectorTerm의 하위 집합을 구현합니다. |
5.1.29. .spec.nodeAffinity.required.nodeSelectorTerms 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 필수 항목입니다. 노드 선택기 용어 목록입니다. 용어는 ORed입니다.
- 유형
-
array
5.1.30. .spec.nodeAffinity.required.nodeSelectorTerms[] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- null 또는 빈 노드 선택기 용어는 오브젝트와 일치하지 않습니다. 이러한 요구 사항은 AND로 표시됩니다. TopologySelectorTerm 유형은 NodeSelectorTerm의 하위 집합을 구현합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다. |
|
| 노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
| 노드의 필드별 노드 선택기 요구 사항 목록입니다. |
|
| 노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
5.1.31. .spec.nodeAffinity.required.nodeSelectorTerms[].matchExpressions 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.
- 유형
-
array
5.1.32. .spec.nodeAffinity.required.nodeSelectorTerms[].matchExpressions[] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
- 유형
-
object
- 필수 항목
-
key
-
operator
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택기가 적용되는 라벨 키입니다. |
|
| 값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.
가능한 열거 값: - |
|
| 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다. |
5.1.33. .spec.nodeAffinity.required.nodeSelectorTerms[].matchFields 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 노드의 필드별 노드 선택기 요구 사항 목록입니다.
- 유형
-
array
5.1.34. .spec.nodeAffinity.required.nodeSelectorTerms[].matchFields[] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
- 유형
-
object
- 필수 항목
-
key
-
operator
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택기가 적용되는 라벨 키입니다. |
|
| 값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.
가능한 열거 값: - |
|
| 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다. |
5.1.35. .spec.photonPersistentDisk 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- Cryostat 컨트롤러 영구 디스크 리소스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
pdID
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| pdID는 Cryostat 컨트롤러 영구 디스크를 식별하는 ID입니다. |
5.1.36. .spec.portworxVolume 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- PortworxVolumeSource는 Portworx 볼륨 리소스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
volumeID
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형을 나타내며 호스트 운영 체제에서 지원하는 파일 시스템 유형입니다. Ex. "ext4", "xfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| volumeID는 Portworx 볼륨을 고유하게 식별합니다. |
5.1.37. .spec.quobyte 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- Pod의 수명을 지속되는 Quobyte 마운트를 나타냅니다. Quobyte 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
- 유형
-
object
- 필수 항목
-
레지스트리
-
volume
-
속성 | 유형 | 설명 |
---|---|---|
|
| 볼륨 액세스를 Default에 매핑하는 그룹은 그룹이 아닙니다. |
|
| 여기에서 readonly는 읽기 전용 권한으로 Quobyte 볼륨을 강제로 마운트합니다. 기본값은 false입니다. |
|
| registry는 볼륨의 중앙 레지스트리 역할을 하는 host:port 쌍으로 지정된 하나 이상의 Quobyte 레지스트리 서비스를 host:port 쌍으로 나타냅니다(여러 항목은 쉼표로 구분됨) |
|
| 백엔드에서 지정된 Quobyte 볼륨을 소유하는 테넌트는 동적으로 프로비저닝된 Quobyte 볼륨과 함께 사용되며 플러그인에 의해 값이 설정됩니다. |
|
| 사용자는 볼륨 액세스를 기본값에 매핑하여 serivceaccount 사용자에게 매핑합니다. |
|
| volume은 이미 생성된 Quobyte 볼륨을 이름으로 참조하는 문자열입니다. |
5.1.38. .spec.rbd 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- Pod의 수명을 지속되는 Rados Block Device 마운트를 나타냅니다. RBD 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
- 유형
-
object
- 필수 항목
-
모니터
-
image
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#rbd |
|
| image는 rados 이미지 이름입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| 인증 키는 RBDUser의 키 링의 경로입니다. 기본값은 /etc/ceph/keyring입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| 모니터는 Ceph 모니터의 컬렉션입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| pool은 rados 풀 이름입니다. 기본값은 rbd입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본값은 false입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
|
| 사용자는 rados 사용자 이름입니다. 기본값은 admin입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
5.1.39. .spec.rbd.secretRef 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
5.1.40. .spec.scaleIO 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- scaleIOPersistentVolumeSource는 영구 scaleIO 볼륨을 나타냅니다.
- 유형
-
object
- 필수 항목
-
gateway
-
system
-
secretRef
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 기본값은 "xfs"입니다. |
|
| Gateway는 scaleIO API 게이트웨이의 호스트 주소입니다. |
|
| protectionDomain은 구성된 스토리지에 대한 scaleIO Protection Domain의 이름입니다. |
|
| readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
|
| sslEnabled는 게이트웨이와 SSL 통신을 활성화/비활성화하는 플래그이며 기본 false |
|
| storageMode는 볼륨의 스토리지가 ThickProvisioned 또는 ThinProvisioned여야 하는지 여부를 나타냅니다. 기본값은 ThinProvisioned입니다. |
|
| StoragePool은 보호 도메인과 연결된 scaleIO 스토리지 풀입니다. |
|
| 시스템은 scaleIO에 구성된 스토리지 시스템의 이름입니다. |
|
| volumeName은 이 볼륨 소스와 연결된 scaleIO 시스템에서 이미 생성된 볼륨의 이름입니다. |
5.1.41. .spec.scaleIO.secretRef 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
5.1.42. .spec.storageos 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- StorageOS 영구 볼륨 리소스를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다. |
|
| volumeName은 사람이 읽을 수 있는 StorageOS 볼륨의 이름입니다. 볼륨 이름은 네임스페이스 내에서만 고유합니다. |
|
| volumeNamespace는 StorageOS 내의 볼륨 범위를 지정합니다. 네임스페이스를 지정하지 않으면 Pod의 네임스페이스가 사용됩니다. 이를 통해 더 긴밀한 통합을 위해 Kubernetes 이름 범위를 StorageOS 내에서 미러링할 수 있습니다. 기본 동작을 재정의하려면 VolumeName을 임의의 이름으로 설정합니다. StorageOS 내에서 네임스페이스를 사용하지 않는 경우 "default"로 설정합니다. StorageOS 내에서 사전 존재하지 않는 네임스페이스가 생성됩니다. |
5.1.43. .spec.storageos.secretRef 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 참조의 API 버전입니다. |
|
| 전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. |
|
| 일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
|
| 이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
| 참조의 UID입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
5.1.44. .spec.vsphereVolume 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- vSphere 볼륨 리소스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
volumePath
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| storagePolicyID는 StoragePolicyName과 연결된SPBM(Storage Policy Based Management) 프로필 ID입니다. |
|
| storagePolicyName은 스토리지 정책 기반 관리(SPBM) 프로필 이름입니다. |
|
| volumePath는 vSphere 볼륨 vmdk를 식별하는 경로입니다. |
5.1.45. .status 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- PersistentVolumeStatus는 영구 볼륨의 현재 상태입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| lastPhaseTransitionTime은 단계에서 다른 단계로 전환되고 볼륨 단계가 전환될 때마다 자동으로 현재 시간으로 재설정되는 시간입니다. 베타 필드이며 PersistentVolumeLastPhaseTransitionTime 기능을 활성화해야 합니다(기본적으로 활성화). | |
|
| message는 볼륨이 이 상태에 있는 이유에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. |
|
| phase는 볼륨을 사용할 수 있는지, 클레임에 바인딩되었는지 또는 클레임에 의해 해제되었는지를 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#phase
가능한 enum 값: - 아직 사용 가능한 볼륨이 아직 바인딩되지 않은 PersistentVolumes에 사용되는 |
|
| 이유는 오류를 설명하는 짧은 CamelCase 문자열이며 CLI에서 머신 구문 분석 및 tidy 표시를 의미합니다. |
5.2. API 끝점 링크 복사링크가 클립보드에 복사되었습니다!
다음 API 끝점을 사용할 수 있습니다.
/api/v1/persistentvolumes
-
DELETE
: PersistentVolume 컬렉션 삭제 -
GET
: PersistentVolume 유형의 오브젝트를 나열하거나 조사 -
POST
: PersistentVolume 생성
-
/api/v1/watch/persistentvolumes
-
GET
: PersistentVolume. deprecated 목록의 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
-
/api/v1/persistentvolumes/{name}
-
DELETE
: PersistentVolume 삭제 -
GET
: 지정된 PersistentVolume 읽기 -
PATCH
: 지정된 PersistentVolume을 부분적으로 업데이트 -
PUT
: 지정된 PersistentVolume을 교체
-
/api/v1/watch/persistentvolumes/{name}
-
GET
: PersistentVolume. deprecated 오브젝트의 변경 사항을 감시합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용하여 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링합니다.
-
/api/v1/persistentvolumes/{name}/status
-
GET
: 지정된 PersistentVolume의 읽기 상태 -
PATCH
: 지정된 PersistentVolume의 부분적으로 업데이트 -
PUT
: 지정된 PersistentVolume의 상태
-
5.2.1. /api/v1/persistentvolumes 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
DELETE
- 설명
- PersistentVolume의 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- PersistentVolume 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- PersistentVolume 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
5.2.2. /api/v1/watch/persistentvolumes 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
GET
- 설명
- PersistentVolume. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
5.2.3. /api/v1/persistentvolumes/{name} 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| PersistentVolume의 이름 |
- HTTP 방법
-
DELETE
- 설명
- PersistentVolume 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 PersistentVolume 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 PersistentVolume을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 PersistentVolume을 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
5.2.4. /api/v1/watch/persistentvolumes/{name} 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| PersistentVolume의 이름 |
- HTTP 방법
-
GET
- 설명
- PersistentVolume. deprecated 오브젝트의 변경 사항을 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
5.2.5. /api/v1/persistentvolumes/{name}/status 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| PersistentVolume의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 PersistentVolume의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 PersistentVolume의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 PersistentVolume의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
6장. PersistentVolumeClaim [v1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- PersistentVolumeClaim은 영구 볼륨에 대한 사용자 요청 및 클레임입니다.
- 유형
-
object
6.1. 사양 링크 복사링크가 클립보드에 복사되었습니다!
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| PersistentVolumeClaimSpec은 스토리지 장치의 공통 속성을 설명하고 공급자별 속성에 대해 소스를 허용합니다. |
|
| PersistentVolumeClaimStatus는 영구 볼륨 클레임의 현재 상태입니다. |
6.1.1. .spec 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- PersistentVolumeClaimSpec은 스토리지 장치의 공통 속성을 설명하고 공급자별 속성에 대해 소스를 허용합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| accessModes에는 볼륨에 필요한 액세스 모드가 포함되어 있습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 |
|
| TypedLocalObjectReference에는 동일한 네임 스페이스 내에서 형식화된 참조 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| dataSourceRef는 비어 있지 않은 볼륨이 필요한 경우 볼륨을 데이터로 채울 오브젝트를 지정합니다. 비어 있지 않은 API 그룹(코어 오브젝트가 아님) 또는 PersistentVolumeClaim 오브젝트의 모든 오브젝트일 수 있습니다. 이 필드가 지정되면 지정된 오브젝트의 유형이 설치된 일부 볼륨 팝업 또는 동적 프로비저너와 일치하는 경우에만 볼륨 바인딩이 성공적으로 수행됩니다. 이 필드는 dataSource 필드의 기능을 대체하므로 두 필드가 모두 비어 있지 않은 경우 동일한 값이 있어야 합니다. 이전 버전과의 호환성을 위해 dataSourceRef에 네임스페이스가 지정되지 않으면 둘 다 필드(dataSource 및 dataSourceRef)가 비어 있고 다른 하나는 비어 있지 않은 경우 자동으로 동일한 값으로 설정됩니다. dataSourceRef에 네임스페이스가 지정되면 dataSource는 동일한 값으로 설정되지 않으며 비어 있어야 합니다. dataSource와 dataSourceRef에는 세 가지 중요한 차이점이 있습니다. * dataSource는 두 가지 특정 유형의 오브젝트만 허용하는 반면, dataSourceRef에서는 비 코어 오브젝트 및 PersistentVolumeClaim 오브젝트를 허용합니다. * dataSource는 허용하지 않는 값을 무시(dropping)하는 동안 dataSourceRef는 모든 값을 유지하고 허용하지 않는 값이 지정된 경우 오류를 생성합니다. * dataSource는 로컬 오브젝트만 허용하지만 dataSourceRef는 모든 네임스페이스의 오브젝트를 허용합니다. (베타) 이 필드를 사용하려면 AnyVolumeDataSource 기능 게이트를 활성화해야 합니다. (alpha) dataSourceRef의 namespace 필드를 사용하려면 CrossNamespaceVolumeDataSource 기능 게이트를 활성화해야 합니다. |
|
| VolumeResourceRequirements는 볼륨의 스토리지 리소스 요구 사항을 설명합니다. |
| selector는 바인딩에 대해 고려할 볼륨에 대한 레이블 쿼리입니다. | |
|
| storageClassName은 클레임에 필요한 StorageClass의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1 |
|
| volumeAttributesClassName을 사용하여 이 클레임에서 사용하는 VolumeAttributesClass를 설정할 수 있습니다. 지정된 경우 CSI 드라이버는 해당 VolumeAttributesClass에 정의된 특성으로 볼륨을 생성하거나 업데이트합니다. 이는 storageClassName과 다른 용도로, 클레임을 생성한 후 변경할 수 있습니다. 빈 문자열 값은 VolumeAttributesClass가 클레임에 적용되지 않지만 설정된 후에는 이 필드를 빈 문자열로 재설정할 수 없음을 의미합니다. 지정되지 않고 PersistentVolumeClaim이 바인딩되지 않은 경우 기본 VolumeAttributesClass는 persistentvolume 컨트롤러에서 설정합니다. volumeAttributesClass에서 참조하는 리소스가 없는 경우, 리소스가 존재할 때까지 modifyVolumeStatus 필드에 반영된 대로 이 PersistentVolumeClaim은 Pending 상태로 설정됩니다. 자세한 정보: https://kubernetes.io/docs/concepts/storage/persistent-volumes#volumeattributesclass (Alpha) 이 필드를 사용하려면 VolumeAttributesClass 기능 게이트를 활성화해야 합니다. |
|
| volumeMode는 클레임에 필요한 볼륨 유형을 정의합니다. claim 사양에 포함되지 않은 경우 Filesystem의 값이 포함됩니다.
가능한 enum 값: - |
|
| volumeName은 이 클레임을 지원하는 PersistentVolume에 대한 바인딩 참조입니다. |
6.1.2. .spec.dataSource 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- TypedLocalObjectReference에는 동일한 네임 스페이스 내에서 형식화된 참조 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
kind
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| APIGroup은 참조 중인 리소스의 그룹입니다. APIGroup을 지정하지 않으면 지정된Kind이 코어 API 그룹에 있어야 합니다. 다른 타사 유형의 경우 APIGroup이 필요합니다. |
|
| kind는 참조되는 리소스 유형입니다. |
|
| name은 참조되는 리소스의 이름입니다. |
6.1.3. .spec.dataSourceRef 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- dataSourceRef는 비어 있지 않은 볼륨이 필요한 경우 볼륨을 데이터로 채울 오브젝트를 지정합니다. 비어 있지 않은 API 그룹(코어 오브젝트가 아님) 또는 PersistentVolumeClaim 오브젝트의 모든 오브젝트일 수 있습니다. 이 필드가 지정되면 지정된 오브젝트의 유형이 설치된 일부 볼륨 팝업 또는 동적 프로비저너와 일치하는 경우에만 볼륨 바인딩이 성공적으로 수행됩니다. 이 필드는 dataSource 필드의 기능을 대체하므로 두 필드가 모두 비어 있지 않은 경우 동일한 값이 있어야 합니다. 이전 버전과의 호환성을 위해 dataSourceRef에 네임스페이스가 지정되지 않으면 둘 다 필드(dataSource 및 dataSourceRef)가 비어 있고 다른 하나는 비어 있지 않은 경우 자동으로 동일한 값으로 설정됩니다. dataSourceRef에 네임스페이스가 지정되면 dataSource는 동일한 값으로 설정되지 않으며 비어 있어야 합니다. dataSource와 dataSourceRef에는 세 가지 중요한 차이점이 있습니다. * dataSource는 두 가지 특정 유형의 오브젝트만 허용하는 반면, dataSourceRef에서는 비 코어 오브젝트 및 PersistentVolumeClaim 오브젝트를 허용합니다. * dataSource는 허용하지 않는 값을 무시(dropping)하는 동안 dataSourceRef는 모든 값을 유지하고 허용하지 않는 값이 지정된 경우 오류를 생성합니다. * dataSource는 로컬 오브젝트만 허용하지만 dataSourceRef는 모든 네임스페이스의 오브젝트를 허용합니다. (베타) 이 필드를 사용하려면 AnyVolumeDataSource 기능 게이트를 활성화해야 합니다. (alpha) dataSourceRef의 namespace 필드를 사용하려면 CrossNamespaceVolumeDataSource 기능 게이트를 활성화해야 합니다.
- 유형
-
object
- 필수 항목
-
kind
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| APIGroup은 참조 중인 리소스의 그룹입니다. APIGroup을 지정하지 않으면 지정된Kind이 코어 API 그룹에 있어야 합니다. 다른 타사 유형의 경우 APIGroup이 필요합니다. |
|
| kind는 참조되는 리소스 유형입니다. |
|
| name은 참조되는 리소스의 이름입니다. |
|
| namespace는 네임스페이스가 지정되면 해당 네임스페이스의 소유자가 참조를 수락할 수 있도록 참조 네임스페이스에 gateway.networking.k8s.io/ReferenceGrant 오브젝트가 필요합니다. 자세한 내용은 ReferenceGrant 문서를 참조하십시오. (alpha) 이 필드에는 CrossNamespaceVolumeDataSource 기능 게이트를 활성화해야 합니다. |
6.1.4. .spec.resources 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- VolumeResourceRequirements는 볼륨의 스토리지 리소스 요구 사항을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 제한은 허용되는 최대 컴퓨팅 리소스 양을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ | |
| 요청은 필요한 최소 컴퓨팅 리소스 양을 설명합니다. 컨테이너에 대한 Requests를 생략하면 구현 정의된 값을 제외하고 명시적으로 지정된 경우 기본값은 Limits로 설정됩니다. 요청은 제한을 초과할 수 없습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
6.1.5. .status 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- PersistentVolumeClaimStatus는 영구 볼륨 클레임의 현재 상태입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| accessModes에는 PVC가 지원하는 실제 액세스 모드가 포함되어 있습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 |
|
| allocatedResourceStatuses는 지정된 PVC의 크기를 조정하는 리소스의 상태를 저장합니다. 키 이름은 표준 Kubernetes 라벨 구문을 따릅니다. 유효한 값은 * 접두사가 지정되지 않은 키: - storage - 볼륨의 용량 중 하나입니다. * 사용자 정의 리소스는 위의 값에서 "example.com/my-custom-resource"와 같은 구현 정의 접두사 이름을 사용해야 합니다. 그렇지 않은 키 또는 kubernetes.io 접두사가 예약된 키로 간주되므로 사용할 수 없습니다. ClaimResourceStatus는 - ControllerResizeInProgress의 상태에 있을 수 있습니다. 컨트롤러의 크기 조정 컨트롤러에서 컨트롤 플레인에서 볼륨 크기 조정을 시작할 때 상태 설정. - ControllerResizeFailed: 터미널 오류가 있는 컨트롤러 크기 조정에 실패한 경우 상태 설정. - NodeResizePending: 컨트롤러의 크기 조정이 완료되면 볼륨 크기 조정이 완료되지만 노드에 볼륨 크기 조정이 필요합니다. - NodeResizeInProgress: kubelet이 볼륨 크기 조정을 시작할 때 상태 세트입니다. - NodeResizeFailed: 터미널 오류와 함께 kubelet에서 크기 조정에 실패한 경우 상태 세트입니다. 일시적인 오류는 NodeResizeFailed를 설정하지 않습니다. 예를 들어, 더 많은 용량을 위해 PVC를 확장하는 경우 - pvc.status.allocatedResourceStatus['storage'] = "ControllerResizeInProgress" - pvc.status.allocatedResourceStatus['storage'] = "ControllerResizeFailed" - pvc.status['storage'] - pvc.status['storage'] - pvc.status['storage'] - pvc.status['storage'] - pvc.status['storage'] = "NodeResizePending" - pvc.status.allocatedResourceStatus['storage'] = "NodeResizeInProgress" - pvc.status.allocatedResourceStatus['storage'] = "NodeResizeFailed" 이는 지정된 PVC에 대한 크기 조정 작업이 진행되지 않음을 의미합니다. 이전에 알 수 없는 resourceName 또는 ClaimResourceStatus를 사용하여 PVC 업데이트를 수신하는 컨트롤러는 설계된 목적에 대한 업데이트를 무시해야 합니다. 예를 들어 볼륨 용량의 크기만 담당하는 컨트롤러는 PVC와 연결된 다른 유효한 리소스를 변경하는 PVC 업데이트를 무시해야 합니다. 알파 필드이며 RecoverVolumeExpansionFailure 기능을 활성화해야 합니다. |
| allocatedResources는 용량을 포함하여 PVC에 할당된 리소스를 추적합니다. 키 이름은 표준 Kubernetes 라벨 구문을 따릅니다. 유효한 값은 * 접두사가 지정되지 않은 키: - storage - 볼륨의 용량 중 하나입니다. * 사용자 정의 리소스는 위의 값에서 "example.com/my-custom-resource"와 같은 구현 정의 접두사 이름을 사용해야 합니다. 그렇지 않은 키 또는 kubernetes.io 접두사가 예약된 키로 간주되므로 사용할 수 없습니다. 여기서 보고된 용량은 볼륨 확장 작업이 요청될 때 실제 용량보다 클 수 있습니다. 스토리지 할당량의 경우 allocatedResources 및 PVC.spec.resources의 더 큰 값이 사용됩니다. allocatedResources가 설정되지 않은 경우 할당량 계산에 PVC.spec.resources만 사용됩니다. 볼륨 확장 용량 요청이 감소하면 진행 중인 확장 작업이 없고 실제 볼륨 용량이 요청된 용량보다 작거나 같은 경우에만 allocatedResources가 낮아집니다. 이전에 알 수 없는 resourceName으로 PVC 업데이트를 수신하는 컨트롤러는 설계된 목적에 대한 업데이트를 무시해야 합니다. 예를 들어 볼륨 용량의 크기만 담당하는 컨트롤러는 PVC와 연결된 다른 유효한 리소스를 변경하는 PVC 업데이트를 무시해야 합니다. 알파 필드이며 RecoverVolumeExpansionFailure 기능을 활성화해야 합니다. | |
| capacity는 기본 볼륨의 실제 리소스를 나타냅니다. | |
|
| 조건은 영구 볼륨 클레임의 현재 조건입니다. 기본 영구 볼륨의 크기를 조정하는 경우 Condition이 'ResizeStarted'로 설정됩니다. |
|
| PersistentVolumeClaimCondition에는 pvc 상태에 대한 세부 정보가 포함되어 있습니다. |
|
| currentVolumeAttributesClassName은 PVC가 사용 중인 VolumeAttributesClass의 현재 이름입니다. 설정되지 않으면 이 PersistentVolumeClaim에 적용된 VolumeAttributeClass가 알파 필드이며 VolumeAttributesClass 기능을 활성화해야 합니다. |
|
| ModifyVolumeStatus는 ControllerModifyVolume 작업의 상태 오브젝트를 나타냅니다. |
|
| phase는 PersistentVolumeClaim의 현재 단계를 나타냅니다.
가능한 enum 값: - 바인딩된 PersistentVolumeClaims에 사용되는 |
6.1.6. .status.conditions 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 조건은 영구 볼륨 클레임의 현재 조건입니다. 기본 영구 볼륨의 크기를 조정하는 경우 Condition이 'ResizeStarted'로 설정됩니다.
- 유형
-
array
6.1.7. .status.conditions[] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- PersistentVolumeClaimCondition에는 pvc 상태에 대한 세부 정보가 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
type
-
status
-
속성 | 유형 | 설명 |
---|---|---|
| lastProbeTime은 조건을 조사한 시간입니다. | |
| lastTransitionTime은 조건이 한 상태에서 다른 상태로 전환된 시간입니다. | |
|
| message는 마지막 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. |
|
| 이유는 고유합니다. 이는 조건의 마지막 전환 이유를 제공하는 짧은 머신 이해할 수 있는 문자열이어야 합니다. "ResizeStarted"를 보고하는 경우 기본 영구 볼륨의 크기를 조정할 수 있습니다. |
|
| |
|
|
6.1.8. .status.modifyVolumeStatus 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- ModifyVolumeStatus는 ControllerModifyVolume 작업의 상태 오브젝트를 나타냅니다.
- 유형
-
object
- 필수 항목
-
status
-
속성 | 유형 | 설명 |
---|---|---|
|
| 상태는 ControllerModifyVolume 작업의 상태입니다. 다음과 같은 상태에 있을 수 있습니다. - Pending Pending는 지정된 VolumeAttributesClass가 존재하지 않는 등 미해결 요구 사항으로 인해 PersistentVolumeClaim을 수정할 수 없음을 나타냅니다. - InProgress InProgress는 볼륨이 수정되었음을 나타냅니다. - Infeasible Infeasible은 요청이 CSI 드라이버에서 유효하지 않은 것으로 거부되었음을 나타냅니다. 오류를 해결하려면 유효한 VolumeAttributesClass를 지정해야 합니다. 참고: 향후 새 상태를 추가할 수 있습니다. 소비자는 알 수 없는 상태를 확인하고 적절하게 실패해야 합니다.
가능한 enum 값: - |
|
| targetVolumeAttributesClassName은 현재 PVC가 조정 중인 VolumeAttributesClass의 이름입니다. |
6.2. API 끝점 링크 복사링크가 클립보드에 복사되었습니다!
다음 API 끝점을 사용할 수 있습니다.
/api/v1/persistentvolumeclaims
-
GET
: PersistentVolumeClaim 유형의 오브젝트를 나열하거나 감시합니다.
-
/api/v1/watch/persistentvolumeclaims
-
GET
: PersistentVolumeClaim. deprecated 목록의 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
-
/api/v1/namespaces/{namespace}/persistentvolumeclaims
-
DELETE
: PersistentVolumeClaim의 컬렉션 삭제 -
GET
: PersistentVolumeClaim 유형의 오브젝트를 나열하거나 감시합니다. -
POST
: PersistentVolumeClaim 생성
-
/api/v1/watch/namespaces/{namespace}/persistentvolumeclaims
-
GET
: PersistentVolumeClaim. deprecated 목록의 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
-
/api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}
-
DELETE
: PersistentVolumeClaim 삭제 -
GET
: 지정된 PersistentVolumeClaim 읽기 -
PATCH
: 지정된 PersistentVolumeClaim을 부분적으로 업데이트 -
PUT
: 지정된 PersistentVolumeClaim을 교체
-
/api/v1/watch/namespaces/{namespace}/persistentvolumeclaims/{name}
-
GET
: PersistentVolumeClaim. deprecated 오브젝트의 변경 사항을 감시합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용하여 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링합니다.
-
/api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}/status
-
GET
: 지정된 PersistentVolumeClaim의 읽기 상태 -
PATCH
: 지정된 PersistentVolumeClaim의 부분 업데이트 상태 -
PUT
: 지정된 PersistentVolumeClaim의 상태 교체
-
6.2.1. /api/v1/persistentvolumeclaims 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
GET
- 설명
- PersistentVolumeClaim 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
6.2.2. /api/v1/watch/persistentvolumeclaims 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
GET
- 설명
- PersistentVolumeClaim. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
6.2.3. /api/v1/namespaces/{namespace}/persistentvolumeclaims 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
DELETE
- 설명
- PersistentVolumeClaim의 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- PersistentVolumeClaim 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- PersistentVolumeClaim 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
202 - 승인됨 | |
401 - 무단 | 빈 |
6.2.4. /api/v1/watch/namespaces/{namespace}/persistentvolumeclaims 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
GET
- 설명
- PersistentVolumeClaim. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
6.2.5. /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name} 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| PersistentVolumeClaim의 이름 |
- HTTP 방법
-
DELETE
- 설명
- delete a PersistentVolumeClaim
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
202 - 승인됨 | |
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 PersistentVolumeClaim 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 PersistentVolumeClaim을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 PersistentVolumeClaim을 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
401 - 무단 | 빈 |
6.2.6. /api/v1/watch/namespaces/{namespace}/persistentvolumeclaims/{name} 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| PersistentVolumeClaim의 이름 |
- HTTP 방법
-
GET
- 설명
- PersistentVolumeClaim. deprecated 오브젝트의 변경 사항을 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
6.2.7. /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}/status 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| PersistentVolumeClaim의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 PersistentVolumeClaim의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 PersistentVolumeClaim의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 PersistentVolumeClaim의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
401 - 무단 | 빈 |
7장. StorageClass [storage.k8s.io/v1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
StorageClass는 PersistentVolumes를 동적으로 프로비저닝할 수 있는 스토리지 클래스의 매개변수를 설명합니다.
StorageClass는 네임스페이스가 아닙니다. etcd에 따른 스토리지 클래스의 이름은 ObjectMeta.Name에 있습니다.
- 유형
-
object
- 필수 항목
-
프로비저너
-
7.1. 사양 링크 복사링크가 클립보드에 복사되었습니다!
속성 | 유형 | 설명 |
---|---|---|
|
| allowVolumeExpansion은 스토리지 클래스가 볼륨 확장을 허용하는지 여부를 보여줍니다. |
| allowedTopologies는 볼륨을 동적으로 프로비저닝할 수 있는 노드 토폴로지를 제한합니다. 각 볼륨 플러그인은 지원되는 자체 토폴로지 사양을 정의합니다. 빈 TopologySelectorTerm 목록은 토폴로지 제한이 없음을 의미합니다. 이 필드는 VolumeScheduling 기능을 활성화하는 서버에서만 적용됩니다. | |
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| mountOptions는 이 스토리지 클래스의 동적으로 프로비저닝된 PersistentVolume에 대한 mountOptions를 제어합니다. 예를 들어 ["ro", "soft"]. 검증되지 않음 - PV 마운트가 유효하지 않은 경우 단순히 실패합니다. |
|
| 매개변수에는 이 스토리지 클래스의 볼륨을 생성해야 하는 프로비저너의 매개변수가 포함되어 있습니다. |
|
| 프로비저너는 프로비저너 유형을 나타냅니다. |
|
| reclaimPolicy는 이 스토리지 클래스의 동적으로 프로비저닝된 PersistentVolume에 대한 reclaimPolicy를 제어합니다. 기본값은 Delete입니다.
가능한 열거 값: - |
|
| volumeBindingMode는 PersistentVolumeClaims를 프로비저닝하고 바인딩하는 방법을 나타냅니다. 설정되지 않으면 VolumeBindingImmediate가 사용됩니다. 이 필드는 VolumeScheduling 기능을 활성화하는 서버에서만 적용됩니다.
가능한 열거 값: - |
7.2. API 끝점 링크 복사링크가 클립보드에 복사되었습니다!
다음 API 끝점을 사용할 수 있습니다.
/apis/storage.k8s.io/v1/storageclasses
-
DELETE
: StorageClass의 컬렉션 삭제 -
GET
: StorageClass 유형의 오브젝트 목록 또는 감시 -
POST
: StorageClass 생성
-
/apis/storage.k8s.io/v1/watch/storageclasses
-
GET
: StorageClass 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
-
/apis/storage.k8s.io/v1/storageclasses/{name}
-
DELETE
: StorageClass 삭제 -
GET
: 지정된 StorageClass 읽기 -
PATCH
: 지정된 StorageClass를 부분적으로 업데이트 -
PUT
: 지정된 StorageClass를 교체
-
/apis/storage.k8s.io/v1/watch/storageclasses/{name}
-
GET
: kind StorageClass의 오브젝트 변경 사항을 조사합니다. 더 이상 사용되지 않는 경우 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링되어 목록 작업과 함께 'watch' 매개변수를 사용합니다.
-
7.2.1. /apis/storage.k8s.io/v1/storageclasses 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
DELETE
- 설명
- StorageClass의 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- StorageClass의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- StorageClass 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
7.2.2. /apis/storage.k8s.io/v1/watch/storageclasses 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
GET
- 설명
- StorageClass 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
7.2.3. /apis/storage.k8s.io/v1/storageclasses/{name} 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| StorageClass의 이름 |
- HTTP 방법
-
DELETE
- 설명
- StorageClass 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 StorageClass 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 StorageClass를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 StorageClass를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
7.2.4. /apis/storage.k8s.io/v1/watch/storageclasses/{name} 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| StorageClass의 이름 |
- HTTP 방법
-
GET
- 설명
- 더 이상 사용되지 않는 StorageClass의 오브젝트를 감시합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
8장. StorageState [migration.k8s.io/v1alpha1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 특정 리소스의 스토리지 상태입니다.
- 유형
-
object
8.1. 사양 링크 복사링크가 클립보드에 복사되었습니다!
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| 스토리지 상태에 대한 사양입니다. |
|
| 스토리지 상태 상태. |
8.1.1. .spec 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 스토리지 상태에 대한 사양입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이 storageState가 설명하는 리소스입니다. |
8.1.2. .spec.resource 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 이 storageState가 설명하는 리소스입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 그룹의 이름입니다. |
|
| 리소스의 이름. |
8.1.3. .status 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 스토리지 상태 상태.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| API 서버에서 제공하는 검색 문서에 표시된 현재 스토리지 버전의 해시 값입니다. Storage Version은 개체가 유지되기 전에 변환되는 버전입니다. |
|
| LastHeartbeatTime은 스토리지 마이그레이션 트리거 컨트롤러가 검색 문서에서 이 리소스의 스토리지 버전 해시를 확인하고 이 필드를 업데이트하는 마지막 시간입니다. |
|
| spec.resource의 인스턴스를 유지한 스토리지 버전의 해시 값은 여전히 에 인코딩될 수 있습니다. "알 수 없음"은 목록에서 유효한 값이며 이는 기본값입니다. 이 필드에 나열된 모든 버전을 지원하지 않거나 "알 수 없음"이 나열된 apiserver 바이너리로 업그레이드하거나 다운그레이드하는 것은 안전하지 않습니다. 이 리소스에 대한 스토리지 버전 마이그레이션이 완료되면 현재StorageVersionHash만 포함하도록 이 필드의 값이 구체화됩니다. apiserver가 스토리지 버전을 변경하면 새 스토리지 버전이 목록에 추가됩니다. |
8.2. API 끝점 링크 복사링크가 클립보드에 복사되었습니다!
다음 API 끝점을 사용할 수 있습니다.
/apis/migration.k8s.io/v1alpha1/storagestates
-
DELETE
: StorageState의 컬렉션 삭제 -
GET
: 종류의 StorageState 오브젝트 나열 -
POST
: StorageState 생성
-
/apis/migration.k8s.io/v1alpha1/storagestates/{name}
-
DELETE
: StorageState 삭제 -
GET
: 지정된 StorageState 읽기 -
PATCH
: 지정된 StorageState를 부분적으로 업데이트 -
PUT
: 지정된 StorageState를 교체
-
/apis/migration.k8s.io/v1alpha1/storagestates/{name}/status
-
GET
: 지정된 StorageState의 읽기 상태 -
PATCH
: 지정된 StorageState의 부분적으로 업데이트 상태 -
PUT
: 지정된 StorageState의 상태
-
8.2.1. /apis/migration.k8s.io/v1alpha1/storagestates 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
DELETE
- 설명
- StorageState의 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 종류의 StorageState 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- 스토리지 상태 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
8.2.2. /apis/migration.k8s.io/v1alpha1/storagestates/{name} 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| StorageState의 이름 |
- HTTP 방법
-
DELETE
- 설명
- 스토리지 상태 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 StorageState 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 StorageState를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 StorageState를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
8.2.3. /apis/migration.k8s.io/v1alpha1/storagestates/{name}/status 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| StorageState의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 StorageState의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 StorageState의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 StorageState의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
9장. StorageVersionMigration [migration.k8s.io/v1alpha1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- StorageVersionMigration은 저장된 데이터를 최신 스토리지 버전으로 마이그레이션하는 것을 나타냅니다.
- 유형
-
object
9.1. 사양 링크 복사링크가 클립보드에 복사되었습니다!
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| 마이그레이션의 사양입니다. |
|
| 마이그레이션 상태. |
9.1.1. .spec 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 마이그레이션의 사양입니다.
- 유형
-
object
- 필수 항목
-
resource
-
속성 | 유형 | 설명 |
---|---|---|
|
| 목록 옵션에 사용되는 토큰을 사용하여 마이그레이션할 다음 오브젝트 청크를 가져옵니다. .status.conditions에서 마이그레이션이 "실행 중"임을 나타내는 경우 사용자는 이 토큰을 사용하여 마이그레이션 진행 상황을 확인할 수 있습니다. |
|
| 마이그레이션 중인 리소스입니다. migrator는 리소스를 제공하는 엔드포인트에 요청을 보냅니다. 변경할 수 없습니다. |
9.1.2. .spec.resource 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 마이그레이션 중인 리소스입니다. migrator는 리소스를 제공하는 엔드포인트에 요청을 보냅니다. 변경할 수 없습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 그룹의 이름입니다. |
|
| 리소스의 이름. |
|
| 버전의 이름입니다. |
9.1.3. .status 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 마이그레이션 상태.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 마이그레이션의 현재 상태에 대한 사용 가능한 최신 관찰입니다. |
|
| 특정 시점에서 마이그레이션 상태를 설명합니다. |
9.1.4. .status.conditions 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 마이그레이션의 현재 상태에 대한 사용 가능한 최신 관찰입니다.
- 유형
-
array
9.1.5. .status.conditions[] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 특정 시점에서 마이그레이션 상태를 설명합니다.
- 유형
-
object
- 필수 항목
-
status
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| 이 조건이 마지막으로 업데이트된 시간입니다. |
|
| 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. |
|
| 조건의 마지막 전환 이유는 다음과 같습니다. |
|
| 조건의 상태, True, False, 알 수 없음. |
|
| 조건의 유형입니다. |
9.2. API 끝점 링크 복사링크가 클립보드에 복사되었습니다!
다음 API 끝점을 사용할 수 있습니다.
/apis/migration.k8s.io/v1alpha1/storageversionmigrations
-
DELETE
: StorageVersionMigration의 컬렉션 삭제 -
GET
: StorageVersionMigration 유형의 오브젝트 나열 -
POST
: StorageVersionMigration 생성
-
/apis/migration.k8s.io/v1alpha1/storageversionmigrations/{name}
-
DELETE
: StorageVersionMigration 삭제 -
GET
: 지정된 StorageVersionMigration 읽기 -
PATCH
: 지정된 StorageVersionMigration을 부분적으로 업데이트 -
PUT
: 지정된 StorageVersionMigration을 교체합니다.
-
/apis/migration.k8s.io/v1alpha1/storageversionmigrations/{name}/status
-
GET
: 지정된 StorageVersionMigration의 읽기 상태 -
PATCH
: 지정된 StorageVersionMigration의 부분적으로 업데이트 상태 -
PUT
: 지정된 StorageVersionMigration의 상태
-
9.2.1. /apis/migration.k8s.io/v1alpha1/storageversionmigrations 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
DELETE
- 설명
- StorageVersionMigration의 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- StorageVersionMigration 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- StorageVersionMigration 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
202 - 승인됨 | |
401 - 무단 | 빈 |
9.2.2. /apis/migration.k8s.io/v1alpha1/storageversionmigrations/{name} 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| StorageVersionMigration의 이름 |
- HTTP 방법
-
DELETE
- 설명
- StorageVersionMigration 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 StorageVersionMigration 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 StorageVersionMigration을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 StorageVersionMigration을 교체합니다.
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
401 - 무단 | 빈 |
9.2.3. /apis/migration.k8s.io/v1alpha1/storageversionmigrations/{name}/status 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| StorageVersionMigration의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 StorageVersionMigration의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 StorageVersionMigration의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 StorageVersionMigration의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
401 - 무단 | 빈 |
10장. VolumeAttachment [storage.k8s.io/v1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
VolumeAttachment는 지정된 볼륨을 지정된 노드에서/에서 연결하거나 분리하려는 의도를 캡처합니다.
VolumeAttachment 오브젝트는 네임스페이스가 아닙니다.
- 유형
-
object
- 필수 항목
-
spec
-
10.1. 사양 링크 복사링크가 클립보드에 복사되었습니다!
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| VolumeAttachmentSpec은 VolumeAttachment 요청 사양입니다. |
|
| VolumeAttachmentStatus는 VolumeAttachment 요청의 상태입니다. |
10.1.1. .spec 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- VolumeAttachmentSpec은 VolumeAttachment 요청 사양입니다.
- 유형
-
object
- 필수 항목
-
attacher
-
소스
-
nodeName
-
속성 | 유형 | 설명 |
---|---|---|
|
| attacher는 이 요청을 처리해야 하는 볼륨 드라이버의 이름을 나타냅니다. GetPluginName()에서 반환한 이름입니다. |
|
| nodename은 볼륨을 연결해야 하는 노드를 나타냅니다. |
|
| VolumeAttachmentSource는 연결해야 하는 볼륨을 나타냅니다. 이제 PersistenVolume만 외부 연결기를 통해 연결할 수 있습니다. 나중에 Pod에서 인라인 볼륨도 허용할 수 있습니다. 정확히 하나의 멤버를 설정할 수 있습니다. |
10.1.2. .spec.source 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- VolumeAttachmentSource는 연결해야 하는 볼륨을 나타냅니다. 이제 PersistenVolume만 외부 연결기를 통해 연결할 수 있습니다. 나중에 Pod에서 인라인 볼륨도 허용할 수 있습니다. 정확히 하나의 멤버를 설정할 수 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| inlineVolumeSpec에는 Pod의 인라인 VolumeSource에서 정의한 영구 볼륨을 연결하는 데 필요한 모든 정보가 포함되어 있습니다. 이 필드는 CSIMigration 기능에 대해서만 채워집니다. Pod의 인라인 VolumeSource에서 PersistentVolumeSpec으로 변환된 필드가 포함되어 있습니다. 이 필드는 베타 수준이며 CSIMigration 기능을 활성화한 서버에서만 적용됩니다. | |
|
| persistentVolumeName은 연결할 영구 볼륨의 이름을 나타냅니다. |
10.1.3. .status 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- VolumeAttachmentStatus는 VolumeAttachment 요청의 상태입니다.
- 유형
-
object
- 필수 항목
-
연결됨
-
속성 | 유형 | 설명 |
---|---|---|
|
| VolumeError는 볼륨 작업 중에 발생한 오류를 캡처합니다. |
|
| attached는 볼륨이 성공적으로 연결되었음을 나타냅니다. 이 필드는 연결 작업을 완료하는 엔티티(예: external-attacher)만 설정해야 합니다. |
|
| attachmentMetadata는 연결 작업에서 반환한 모든 정보로 채워집니다. 이 연결은 후속 WaitForAttach 또는 Mount 호출로 전달되어야 합니다. 이 필드는 연결 작업을 완료하는 엔티티(예: external-attacher)만 설정해야 합니다. |
|
| VolumeError는 볼륨 작업 중에 발생한 오류를 캡처합니다. |
10.1.4. .status.attachError 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- VolumeError는 볼륨 작업 중에 발생한 오류를 캡처합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| message는 Attach 또는 Detach 작업 중에 발생한 오류를 나타냅니다. 이 문자열은 기록될 수 있으므로 민감한 정보를 포함해서는 안 됩니다. |
| Time은 오류가 발생한 시간을 나타냅니다. |
10.1.5. .status.detachError 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- VolumeError는 볼륨 작업 중에 발생한 오류를 캡처합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| message는 Attach 또는 Detach 작업 중에 발생한 오류를 나타냅니다. 이 문자열은 기록될 수 있으므로 민감한 정보를 포함해서는 안 됩니다. |
| Time은 오류가 발생한 시간을 나타냅니다. |
10.2. API 끝점 링크 복사링크가 클립보드에 복사되었습니다!
다음 API 끝점을 사용할 수 있습니다.
/apis/storage.k8s.io/v1/volumeattachments
-
DELETE
: VolumeAttachment의 컬렉션 삭제 -
GET
: VolumeAttachment 유형의 오브젝트 나열 또는 감시 -
POST
: VolumeAttachment를 생성
-
/apis/storage.k8s.io/v1/watch/volumeattachments
-
GET
: VolumeAttachment 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
-
/apis/storage.k8s.io/v1/volumeattachments/{name}
-
DELETE
: VolumeAttachment 삭제 -
GET
: 지정된 VolumeAttachment를 읽습니다. -
PATCH
: 지정된 VolumeAttachment를 부분적으로 업데이트 -
PUT
: 지정된 VolumeAttachment를 교체합니다.
-
/apis/storage.k8s.io/v1/watch/volumeattachments/{name}
-
GET
: VolumeAttachment 유형의 오브젝트 변경 사항을 조사합니다. 더 이상 사용되지 않는 경우 'watch' 매개변수를 목록 작업과 함께 사용하고 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링됩니다.
-
/apis/storage.k8s.io/v1/volumeattachments/{name}/status
-
GET
: 지정된 VolumeAttachment의 읽기 상태 -
PATCH
: 지정된 VolumeAttachment의 부분 업데이트 상태 -
PUT
: 지정된 VolumeAttachment의 상태
-
10.2.1. /apis/storage.k8s.io/v1/volumeattachments 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
DELETE
- 설명
- VolumeAttachment의 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- VolumeAttachment 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- VolumeAttachment 만들기
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
10.2.2. /apis/storage.k8s.io/v1/watch/volumeattachments 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
GET
- 설명
- VolumeAttachment 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
10.2.3. /apis/storage.k8s.io/v1/volumeattachments/{name} 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| VolumeAttachment의 이름 |
- HTTP 방법
-
DELETE
- 설명
- VolumeAttachment 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 VolumeAttachment 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 VolumeAttachment를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 VolumeAttachment를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
10.2.4. /apis/storage.k8s.io/v1/watch/volumeattachments/{name} 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| VolumeAttachment의 이름 |
- HTTP 방법
-
GET
- 설명
- VolumeAttachment 유형의 오브젝트 변경 사항을 확인합니다. 더 이상 사용되지 않는: 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
10.2.5. /apis/storage.k8s.io/v1/volumeattachments/{name}/status 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| VolumeAttachment의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 VolumeAttachment의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 VolumeAttachment의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 VolumeAttachment의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
11장. VolumeSnapshot [snapshot.storage.k8s.io/v1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- VolumeSnapshot는 영구 볼륨의 시점 스냅샷을 생성하거나 기존 스냅샷에 바인딩하는 사용자의 요청입니다.
- 유형
-
object
- 필수 항목
-
spec
-
11.1. 사양 링크 복사링크가 클립보드에 복사되었습니다!
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| spec은 사용자가 요청한 스냅샷의 원하는 특성을 정의합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volume-snapshots#volumesnapshots 필수 항목입니다. |
|
| Status는 스냅샷의 현재 정보를 나타냅니다. 소비자는 이 오브젝트를 사용하기 전에 VolumeSnapshot 및 VolumeSnapshotContent 오브젝트 간 바인딩이 성공했는지 확인해야 합니다(모두 VolumeSnapshot 및 VolumeSnapshotContent 포인트 모두 확인). |
11.1.1. .spec 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- spec은 사용자가 요청한 스냅샷의 원하는 특성을 정의합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volume-snapshots#volumesnapshots 필수 항목입니다.
- 유형
-
object
- 필수 항목
-
소스
-
속성 | 유형 | 설명 |
---|---|---|
|
| source는 스냅샷을 생성할 위치를 지정합니다. 생성 후에는 이 필드를 변경할 수 없습니다. 필수 항목입니다. |
|
| 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은 스냅샷을 생성해야 하는 볼륨을 나타내는 PersistentVolumeClaim 오브젝트의 이름을 지정합니다. 이 PVC는 VolumeSnapshot 오브젝트와 동일한 네임스페이스에 있는 것으로 간주됩니다. 스냅샷이 존재하지 않는 경우 이 필드를 설정해야 합니다. 이 필드는 변경할 수 없습니다. |
|
| volumeSnapshotContentName은 기존 볼륨 스냅샷을 나타내는 기존 VolumeSnapshotContent 오브젝트의 이름을 지정합니다. 스냅샷이 이미 존재하고 Kubernetes에 표현만 필요한 경우 이 필드를 설정해야 합니다. 이 필드는 변경할 수 없습니다. |
11.1.3. .status 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- Status는 스냅샷의 현재 정보를 나타냅니다. 소비자는 이 오브젝트를 사용하기 전에 VolumeSnapshot 및 VolumeSnapshotContent 오브젝트 간 바인딩이 성공했는지 확인해야 합니다(모두 VolumeSnapshot 및 VolumeSnapshotContent 포인트 모두 확인).
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| boundVolumeSnapshotContentName은 이 VolumeSnapshot 오브젝트가 바인딩하려는 VolumeSnapshotContent 오브젝트의 이름입니다. 지정하지 않으면 VolumeSnapshot 오브젝트가 VolumeSnapshotContent 오브젝트에 성공적으로 바인딩되지 않았음을 나타냅니다. 참고: 가능한 보안 문제를 방지하려면 소비자가 이 오브젝트를 사용하기 전에 VolumeSnapshot 및 VolumeSnapshotContent 오브젝트 간 바인딩이 성공했는지 확인해야 합니다. |
|
| creationTime은 기본 스토리지 시스템에서 지정 시간 스냅샷을 만들 때 타임스탬프입니다. 동적 스냅샷 생성 사례에서 이 필드는 CSI "CreateSnapshot" gRPC 호출에서 반환된 "creation_time" 값을 사용하여 스냅샷 컨트롤러에 의해 채워집니다. 기존 스냅샷의 경우 드라이버에서 지원하는 경우 CSI "ListSnapshots" gRPC 호출에서 반환된 "creation_time" 값으로 채워집니다. 지정하지 않으면 스냅샷 생성 시간을 알 수 없음을 나타낼 수 있습니다. |
|
| 오류는 스냅샷 생성 중에 마지막으로 관찰된 오류(있는 경우)입니다. 이 필드는 보고된 오류 유형에 따라 스냅샷이 생성될 때까지 계속 대기해야 하는지 여부를 결정하는 데 도움이 될 수 있습니다. 스냅샷 생성 중에 오류가 발생하면 스냅샷 컨트롤러가 계속 재시도합니다. 성공하면 이 오류 필드가 지워집니다. |
|
| readyToUse는 볼륨을 복원하는 데 스냅샷을 사용할 준비가 되었는지를 나타냅니다. 동적 스냅샷 생성 사례에서 이 필드는 CSI "CreateSnapshot" gRPC 호출에서 반환된 "ready_to_use" 값을 사용하여 스냅샷 컨트롤러에 의해 채워집니다. 기존 스냅샷의 경우 이 필드는 CSI "ListSnapshots" gRPC 호출에서 반환된 "ready_to_use" 값으로 채워집니다. 그러지 않으면 이 필드는 "True"로 설정됩니다. 지정하지 않으면 스냅샷의 준비 상태를 알 수 없습니다. |
|
| restoreSize는 이 스냅샷에서 볼륨을 생성하는 데 필요한 최소 볼륨 크기를 나타냅니다. 동적 스냅샷 생성 사례에서 이 필드는 CSI "CreateSnapshot" gRPC 호출에서 반환된 "size_bytes" 값을 사용하여 스냅샷 컨트롤러에 의해 채워집니다. 기존 스냅샷의 경우 드라이버에서 지원하는 경우 CSI "ListSnapshots" gRPC 호출에서 반환된 "size_bytes" 값으로 채워집니다. 이 스냅샷에서 볼륨을 복원할 때 볼륨 크기는 지정된 경우 restoreSize보다 작지 않아야 합니다. 그렇지 않으면 복원이 실패합니다. 지정하지 않으면 크기가 알 수 없음을 나타냅니다. |
|
| VolumeGroupSnapshotName은 이 VolumeSnapshot가 포함된 VolumeGroupSnapshot의 이름입니다. |
11.1.4. .status.error 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 오류는 스냅샷 생성 중에 마지막으로 관찰된 오류(있는 경우)입니다. 이 필드는 보고된 오류 유형에 따라 스냅샷이 생성될 때까지 계속 대기해야 하는지 여부를 결정하는 데 도움이 될 수 있습니다. 스냅샷 생성 중에 오류가 발생하면 스냅샷 컨트롤러가 계속 재시도합니다. 성공하면 이 오류 필드가 지워집니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| message는 지정된 경우 스냅샷 생성 중에 발생한 오류를 자세히 설명하는 문자열입니다. 참고: 메시지는 기록될 수 있으며 중요한 정보가 포함되어 있지 않아야 합니다. |
|
| Time은 오류가 발생한 타임스탬프입니다. |
11.2. API 끝점 링크 복사링크가 클립보드에 복사되었습니다!
다음 API 끝점을 사용할 수 있습니다.
/apis/snapshot.storage.k8s.io/v1/volumesnapshots
-
GET
: 종류의 VolumeSnapshot 오브젝트 나열
-
/apis/snapshot.storage.k8s.io/v1/namespaces/{namespace}/volumesnapshots
-
DELETE
: VolumeSnapshot의 컬렉션 삭제 -
GET
: 종류의 VolumeSnapshot 오브젝트 나열 -
POST
: VolumeSnapshot 생성
-
/apis/snapshot.storage.k8s.io/v1/namespaces/{namespace}/volumesnapshots/{name}
-
DELETE
: VolumeSnapshot 삭제 -
GET
: 지정된 VolumeSnapshot 읽기 -
PATCH
: 지정된 VolumeSnapshot를 부분적으로 업데이트 -
PUT
: 지정된 VolumeSnapshot로 교체
-
/apis/snapshot.storage.k8s.io/v1/namespaces/{namespace}/volumesnapshots/{name}/status
-
GET
: 지정된 VolumeSnapshot의 읽기 상태 -
PATCH
: 지정된 VolumeSnapshot의 부분 업데이트 상태 -
PUT
: 지정된 VolumeSnapshot의 상태
-
11.2.1. /apis/snapshot.storage.k8s.io/v1/volumesnapshots 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
GET
- 설명
- 종류의 VolumeSnapshot 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
11.2.2. /apis/snapshot.storage.k8s.io/v1/namespaces/{namespace}/volumesnapshots 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
DELETE
- 설명
- VolumeSnapshot 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 종류의 VolumeSnapshot 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- VolumeSnapshot 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
11.2.3. /apis/snapshot.storage.k8s.io/v1/namespaces/{namespace}/volumesnapshots/{name} 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| VolumeSnapshot의 이름 |
- HTTP 방법
-
DELETE
- 설명
- VolumeSnapshot 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 VolumeSnapshot 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 VolumeSnapshot를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 VolumeSnapshot를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| VolumeSnapshot의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 VolumeSnapshot의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 VolumeSnapshot의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 VolumeSnapshot의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
12장. VolumeSnapshotClass [snapshot.storage.k8s.io/v1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- VolumeSnapshotClass는 볼륨 스냅샷을 생성할 때 기본 스토리지 시스템이 사용하는 매개변수를 지정합니다. 특정 VolumeSnapshotClass는 VolumeSnapshot 오브젝트에 이름을 지정하는 데 사용됩니다. VolumeSnapshotClasses가 네임스페이스가 아닌 경우
- 유형
-
object
- 필수 항목
-
deletionPolicy
-
드라이버
-
12.1. 사양 링크 복사링크가 클립보드에 복사되었습니다!
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| deletionPolicy는 VolumeSnapshotClass를 통해 생성된 VolumeSnapshotContent가 바인딩된 VolumeSnapshot를 삭제할 때 삭제해야 하는지 여부를 결정합니다. 지원되는 값은 "Retain" 및 "Delete"입니다. "retain"은 기본 스토리지 시스템의 VolumeSnapshotContent 및 해당 물리적 스냅샷을 보관함을 의미합니다. "삭제"는 기본 스토리지 시스템의 VolumeSnapshotContent 및 물리적 스냅샷이 삭제됨을 의미합니다. 필수 항목입니다. |
|
| driver는 이 VolumeSnapshotClass를 처리하는 스토리지 드라이버의 이름입니다. 필수 항목입니다. |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| 매개변수는 스냅샷을 생성하기 위한 스토리지 드라이버 특정 매개변수가 있는 키-값 맵입니다. 이러한 값은 Kubernetes에 대한 불투명입니다. |
12.2. API 끝점 링크 복사링크가 클립보드에 복사되었습니다!
다음 API 끝점을 사용할 수 있습니다.
/apis/snapshot.storage.k8s.io/v1/volumesnapshotclasses
-
DELETE
: VolumeSnapshotClass의 컬렉션 삭제 -
GET
: 종류의 VolumeSnapshotClass 오브젝트 나열 -
POST
: VolumeSnapshotClass 생성
-
/apis/snapshot.storage.k8s.io/v1/volumesnapshotclasses/{name}
-
DELETE
: VolumeSnapshotClass 삭제 -
GET
: 지정된 VolumeSnapshotClass 읽기 -
PATCH
: 지정된 VolumeSnapshotClass를 부분적으로 업데이트 -
PUT
: 지정된 VolumeSnapshotClass를 교체합니다.
-
12.2.1. /apis/snapshot.storage.k8s.io/v1/volumesnapshotclasses 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
DELETE
- 설명
- VolumeSnapshotClass의 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- VolumeSnapshotClass 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- VolumeSnapshotClass 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
202 - 승인됨 | |
401 - 무단 | 빈 |
12.2.2. /apis/snapshot.storage.k8s.io/v1/volumesnapshotclasses/{name} 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| VolumeSnapshotClass의 이름 |
- HTTP 방법
-
DELETE
- 설명
- VolumeSnapshotClass 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 VolumeSnapshotClass 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 VolumeSnapshotClass를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 VolumeSnapshotClass를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
401 - 무단 | 빈 |
13장. VolumeSnapshotContent [snapshot.storage.k8s.io/v1] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- VolumeSnapshotContent는 기본 스토리지 시스템의 실제 "디스크" 스냅샷 오브젝트를 나타냅니다.
- 유형
-
object
- 필수 항목
-
spec
-
13.1. 사양 링크 복사링크가 클립보드에 복사되었습니다!
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| spec은 기본 스토리지 시스템에서 생성한 VolumeSnapshotContent의 속성을 정의합니다. 필수 항목입니다. |
|
| Status는 스냅샷의 현재 정보를 나타냅니다. |
13.1.1. .spec 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- spec은 기본 스토리지 시스템에서 생성한 VolumeSnapshotContent의 속성을 정의합니다. 필수 항목입니다.
- 유형
-
object
- 필수 항목
-
deletionPolicy
-
드라이버
-
소스
-
volumeSnapshotRef
-
속성 | 유형 | 설명 |
---|---|---|
|
| deletionPolicy는 바인딩된 VolumeSnapshot를 삭제할 때 기본 스토리지 시스템의 이 VolumeSnapshotContent 및 물리적 스냅샷을 삭제해야 하는지 여부를 결정합니다. 지원되는 값은 "Retain" 및 "Delete"입니다. "retain"은 기본 스토리지 시스템의 VolumeSnapshotContent 및 해당 물리적 스냅샷을 보관함을 의미합니다. "삭제"는 기본 스토리지 시스템의 VolumeSnapshotContent 및 물리적 스냅샷이 삭제됨을 의미합니다. 동적으로 프로비저닝된 스냅샷의 경우 이 필드는 해당 VolumeSnapshotClass에 정의된 "DeletionPolicy" 필드를 사용하여 CSI 스냅샷터 사이드카에 의해 자동으로 채워집니다. 기존 스냅샷의 경우 VolumeSnapshotContent 오브젝트를 생성할 때 이 필드를 지정해야 합니다. 필수 항목입니다. |
|
| 드라이버는 기본 스토리지 시스템에서 물리적 스냅샷을 생성하는 데 사용되는 CSI 드라이버의 이름입니다. 이는 해당 드라이버에 대한 CSI GetPluginName() 호출에서 반환된 이름과 동일해야 합니다. 필수 항목입니다. |
|
| source는 스냅샷이 동적으로 프로비저닝되었는지 또는 이미 존재하는지 여부를 지정하고 Kubernetes 오브젝트 표현만 필요합니다. 생성 후에는 이 필드를 변경할 수 없습니다. 필수 항목입니다. |
|
| SourceVolumeMode는 스냅샷을 만든 볼륨의 모드입니다. "Filesystem" 또는 "Block"일 수 있습니다. 지정하지 않으면 소스 볼륨의 모드를 알 수 없음을 나타냅니다. 이 필드는 변경할 수 없습니다. 이 필드는 알파 필드입니다. |
|
| 이 스냅샷이 생성된 VolumeSnapshotClass의 이름입니다. 프로비저닝 후 VolumeSnapshotClass는 다른 값 세트로 삭제하거나 다시 생성할 수 있으므로 기록 후 생성을 참조해서는 안 됩니다. |
|
| volumeSnapshotRef는 이 VolumeSnapshotContent 오브젝트가 바인딩된 VolumeSnapshot 오브젝트를 지정합니다. VolumeSnapshot.Spec.VolumeSnapshotContentName 필드는 양방향 바인딩이 유효한 경우 이 VolumeSnapshotContent의 이름을 참조해야 합니다. 기존 VolumeSnapshotContent 오브젝트의 경우 VolumeSnapshot 오브젝트의 이름과 네임스페이스를 바인딩하기 위해 제공해야 합니다. 생성 후에는 이 필드를 변경할 수 없습니다. 필수 항목입니다. |
13.1.2. .spec.source 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- source는 스냅샷이 동적으로 프로비저닝되었는지 또는 이미 존재하는지 여부를 지정하고 Kubernetes 오브젝트 표현만 필요합니다. 생성 후에는 이 필드를 변경할 수 없습니다. 필수 항목입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| snapshotHandle은 Kubernetes 오브젝트 표현이 생성되거나 생성되어야 하는 기본 스토리지 시스템에서 기존 스냅샷의 CSI "snapshot_id"를 지정합니다. 이 필드는 변경할 수 없습니다. |
|
| volumeHandle은 스냅샷을 동적으로 가져와야 하는 볼륨의 CSI "volume_id"를 지정합니다. 이 필드는 변경할 수 없습니다. |
13.1.3. .spec.volumeSnapshotRef 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- volumeSnapshotRef는 이 VolumeSnapshotContent 오브젝트가 바인딩된 VolumeSnapshot 오브젝트를 지정합니다. VolumeSnapshot.Spec.VolumeSnapshotContentName 필드는 양방향 바인딩이 유효한 경우 이 VolumeSnapshotContent의 이름을 참조해야 합니다. 기존 VolumeSnapshotContent 오브젝트의 경우 VolumeSnapshot 오브젝트의 이름과 네임스페이스를 바인딩하기 위해 제공해야 합니다. 생성 후에는 이 필드를 변경할 수 없습니다. 필수 항목입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 참조의 API 버전입니다. |
|
| 전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. TODO: 이 설계는 최종적이지 않으며 이 필드는 향후 변경될 수 있습니다. |
|
| 일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
|
| 이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
| 참조의 UID입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
13.1.4. .status 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- Status는 스냅샷의 현재 정보를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
|
creationTime은 기본 스토리지 시스템에서 지정 시간 스냅샷을 만들 때 타임스탬프입니다. 동적 스냅샷 생성 사례에서 이 필드는 CSI "CreateSnapshot" gRPC 호출에서 반환된 "creation_time" 값을 사용하여 CSI 스냅샷 사이드카에 의해 채워집니다. 기존 스냅샷의 경우 드라이버에서 지원하는 경우 CSI "ListSnapshots" gRPC 호출에서 반환된 "creation_time" 값으로 채워집니다. 지정하지 않으면 생성 시간을 알 수 없음을 나타냅니다. 이 필드의 형식은 int64로 인코딩된 Unix 나노초 시간입니다. Unix에서 명령 |
|
| 오류는 스냅샷 생성 중에 마지막으로 관찰된 오류(있는 경우)입니다. 재시도 후 성공 시 이 오류 필드가 지워집니다. |
|
| readyToUse는 볼륨을 복원하는 데 스냅샷을 사용할 준비가 되었는지를 나타냅니다. 동적 스냅샷 생성 사례에서 이 필드는 CSI "CreateSnapshot" gRPC 호출에서 반환된 "ready_to_use" 값을 사용하여 CSI 스냅샷 사이드카에 의해 채워집니다. 기존 스냅샷의 경우 이 필드는 CSI "ListSnapshots" gRPC 호출에서 반환된 "ready_to_use" 값으로 채워집니다. 그러지 않으면 이 필드는 "True"로 설정됩니다. 지정하지 않으면 스냅샷의 준비 상태를 알 수 없습니다. |
|
| restoreSize는 스냅샷의 전체 크기를 바이트 단위로 나타냅니다. 동적 스냅샷 생성 사례에서 이 필드는 CSI "CreateSnapshot" gRPC 호출에서 반환된 "size_bytes" 값을 사용하여 CSI 스냅샷 사이드카에 의해 채워집니다. 기존 스냅샷의 경우 드라이버에서 지원하는 경우 CSI "ListSnapshots" gRPC 호출에서 반환된 "size_bytes" 값으로 채워집니다. 이 스냅샷에서 볼륨을 복원할 때 볼륨 크기는 지정된 경우 restoreSize보다 작지 않아야 합니다. 그렇지 않으면 복원이 실패합니다. 지정하지 않으면 크기가 알 수 없음을 나타냅니다. |
|
| snapshotHandle은 기본 스토리지 시스템에 있는 스냅샷의 CSI "snapshot_id"입니다. 지정하지 않으면 동적 스냅샷 생성이 실패했거나 아직 진행 중임을 나타냅니다. |
|
| VolumeGroupSnapshotHandle은 기본 스토리지 시스템의 그룹 스냅샷의 CSI "group_snapshot_id"입니다. |
13.1.5. .status.error 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 오류는 스냅샷 생성 중에 마지막으로 관찰된 오류(있는 경우)입니다. 재시도 후 성공 시 이 오류 필드가 지워집니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| message는 지정된 경우 스냅샷 생성 중에 발생한 오류를 자세히 설명하는 문자열입니다. 참고: 메시지는 기록될 수 있으며 중요한 정보가 포함되어 있지 않아야 합니다. |
|
| Time은 오류가 발생한 타임스탬프입니다. |
13.2. API 끝점 링크 복사링크가 클립보드에 복사되었습니다!
다음 API 끝점을 사용할 수 있습니다.
/apis/snapshot.storage.k8s.io/v1/volumesnapshotcontents
-
DELETE
: VolumeSnapshotContent의 컬렉션 삭제 -
GET
: VolumeSnapshotContent 유형의 오브젝트 나열 -
POST
: VolumeSnapshotContent 생성
-
/apis/snapshot.storage.k8s.io/v1/volumesnapshotcontents/{name}
-
DELETE
: VolumeSnapshotContent 삭제 -
GET
: 지정된 VolumeSnapshotContent 읽기 -
PATCH
: 지정된 VolumeSnapshotContent를 부분적으로 업데이트 -
PUT
: 지정된 VolumeSnapshotContent를 교체
-
/apis/snapshot.storage.k8s.io/v1/volumesnapshotcontents/{name}/status
-
GET
: 지정된 VolumeSnapshotContent의 읽기 상태 -
PATCH
: 지정된 VolumeSnapshotContent의 부분적으로 업데이트 상태 -
PUT
: 지정된 VolumeSnapshotContent의 상태
-
13.2.1. /apis/snapshot.storage.k8s.io/v1/volumesnapshotcontents 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
DELETE
- 설명
- VolumeSnapshotContent 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- VolumeSnapshotContent 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- VolumeSnapshotContent 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
202 - 승인됨 | |
401 - 무단 | 빈 |
13.2.2. /apis/snapshot.storage.k8s.io/v1/volumesnapshotcontents/{name} 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| VolumeSnapshotContent의 이름 |
- HTTP 방법
-
DELETE
- 설명
- VolumeSnapshotContent 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 VolumeSnapshotContent 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 VolumeSnapshotContent를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 VolumeSnapshotContent 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
401 - 무단 | 빈 |
13.2.3. /apis/snapshot.storage.k8s.io/v1/volumesnapshotcontents/{name}/status 링크 복사링크가 클립보드에 복사되었습니다!
매개변수 | 유형 | 설명 |
---|---|---|
|
| VolumeSnapshotContent의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 VolumeSnapshotContent의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 VolumeSnapshotContent의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 VolumeSnapshotContent의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
401 - 무단 | 빈 |
Legal Notice
링크 복사링크가 클립보드에 복사되었습니다!
Copyright © 2025 Red Hat
OpenShift documentation is licensed under the Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0).
Modified versions must remove all Red Hat trademarks.
Portions adapted from https://github.com/kubernetes-incubator/service-catalog/ with modifications by Red Hat.
Red Hat, Red Hat Enterprise Linux, the Red Hat logo, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation’s permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.