KRM API backup.gdc.goog/v1

backup.gdc.goog/v1

백업

Backup API의 스키마를 정의합니다.

표시 위치: - BackupList

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 Backup
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec BackupSpec
status BackupStatus

BackupConfig

이 백업 계획에서 백업을 생성하는 구성을 정의하는 내부 메시지 유형을 나타냅니다.

표시 위치: - BackupPlanSpec - BackupSpec

필드 설명
backupScope BackupScope 백업의 리소스 선택 범위입니다. 예로는 all_namespaces, 선택한 네임스페이스, 선택한 애플리케이션이 있습니다. backup_scope에 단일 값을 지정해야 합니다. BackupScope 값은 BackupConfig_AllNamespaces, BackupConfig_SelectedNamespaces, BackupConfig_SelectedApplications 유형 중 하나여야 합니다.
backupRepository 문자열 이 BackupPlan 리소스의 보조 스토리지를 식별하는 BackupRepository 리소스의 이름입니다.
includeVolumeData 불리언 볼륨 데이터가 백업되는지 여부를 지정합니다. 설정하지 않으면 기본값은 False입니다.
includeSecrets 불리언 보안 비밀이 백업되는지 여부를 지정합니다. 설정하지 않으면 기본값은 False입니다.
encryptionKey EncryptionKey 암호화 키. 이 필드는 변경할 수 없습니다.
volumeStrategy VolumeStrategy 볼륨을 백업할 때 사용할 절충안입니다.

BackupInfo

RecentBackups 필드에 백업의 이름과 상태를 나타냅니다 .

표시 위치: - BackupPlanStatus

필드 설명
name 문자열 백업 이름
state BackupState 가장 최근에 실행된 백업의 상태입니다.

BackupList

백업 목록을 포함합니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 BackupList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items 백업 배열

BackupPlan

BackupPlan API의 스키마를 정의합니다.

표시 위치: - BackupPlanList

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 BackupPlan
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec BackupPlanSpec
status BackupPlanStatus

BackupPlanList

백업 계획 목록을 포함합니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 BackupPlanList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items BackupPlan 배열

BackupPlanSpec

백업 계획에 대해 원하는 상태를 정의합니다.

표시 위치: - BackupPlan

필드 설명
clusterName 문자열 이 백업 계획이 백업하는 데이터가 포함된 클러스터의 이름입니다. 기본적으로 이 백업 계획이 생성된 클러스터입니다.
backupSchedule 예약 이 백업 계획에 따라 예약된 백업 생성입니다.
backupConfig BackupConfig 이 백업 계획의 백업 구성입니다.
retentionPolicy RetentionPolicy 이 계획에 따라 생성된 백업의 수명 주기입니다.
description 문자열 이 백업 계획에 대해 사용자가 지정한 설명 문자열입니다.
deactivated 불리언 요금제가 비활성화되었는지 여부를 지정합니다. 이 필드를 'True'로 설정하면 요금제가 잠기므로 비활성화된 필드의 변경사항을 비롯한 추가 업데이트가 허용되지 않습니다. 또한 이 계획에서 수동 또는 예약된 새 백업이 생성되지 않습니다. 기본값은 'False'입니다.

BackupPlanStatus

백업 계획의 관찰된 상태를 정의합니다.

표시 위치: - BackupPlan

필드 설명
lastBackupTime 시간 최근에 실행된 백업의 타임스탬프입니다.
nextBackupTime 시간 다음으로 예약된 백업의 타임스탬프입니다.
state 주 백업 계획의 현재 상태입니다.
lastBackupState BackupState 가장 최근에 생성된 백업의 상태입니다.
lastBackupStateReason 문자열 마지막 백업이 현재 상태인 이유에 대해 사람이 읽을 수 있는 설명입니다.
errorStatus ErrorStatus 관찰된 시간이 포함된 가장 최근 오류입니다.
conditions Condition 배열 Conditions는 이 백업 계획의 현재 상태에 대한 관찰 결과를 나타냅니다.
recentBackups BackupInfo 배열 백업 계획으로 생성된 최근 백업입니다.

BackupRepository

BackupRepository API의 스키마를 정의합니다.

표시 위치: - BackupRepositoryList

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 BackupRepository
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec BackupRepositorySpec
status BackupRepositoryStatus

BackupRepositoryList

백업 저장소 리소스 목록을 포함합니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 BackupRepositoryList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items BackupRepository 배열

BackupRepositoryManager

BackupRepositoryManager는 backuprepositorymanagers API의 스키마입니다.

표시 위치: - BackupRepositoryManagerList

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 BackupRepositoryManager
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec BackupRepositoryManagerSpec
status BackupRepositoryManagerStatus

BackupRepositoryManagerList

BackupRepositoryManagerList에는 BackupRepositoryManager 목록이 포함됩니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 BackupRepositoryManagerList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items BackupRepositoryManager 배열

BackupRepositoryManagerSpec

BackupRepositoryManagerSpec은 원하는 BackupRepositoryManager 상태를 정의합니다.

표시 위치: - BackupRepositoryManager

필드 설명
backupRepositorySpec BackupRepositorySpec BackupRepositorySpec에는 사용자 클러스터 내에 백업 저장소를 만드는 데 필요한 모든 세부정보가 포함되어 있습니다. 여기서는 BackupRepositorySpec의 ImportPolicy 필드가 적용되지 않습니다. 생성된 BackupRepository는 생성되는 클러스터가 ReadWriteCluster인 경우 'ReadWrite'가 됩니다. 생성되는 클러스터가 ReadOnlyClusters 목록에 있으면 'ReadOnly'가 됩니다. 이 필드는 변경할 수 없습니다.
readWriteCluster NamespacedName ReadWriteCluster는 BackupRepositorySpec 필드의 데이터를 사용하여 ReadWrite 백업 저장소를 만들 권한이 있는 단일 클러스터 (baremetal.cluster.gke.io/Cluster)를 지정합니다. ReadWrite 저장소는 백업, 백업 계획, 복원을 예약/생성하는 데 사용할 수 있으며, 생성된 클러스터가 효과적으로 소유합니다. 참고: BackupRepository는 최대 하나의 k8s 클러스터에서만 ReadWrite로 사용할 수 있습니다. 이 필드를 변경할 수 있습니다.
readOnlyClusters NamespacedName 배열 ReadOnlyClusters는 BackupRepositorySpec 필드의 데이터를 사용하여 ReadOnly 백업 저장소를 만들 권한이 있는 클러스터 (baremetal.cluster.gke.io/Cluster) 목록을 지정합니다. ReadOnly 저장소는 백업을 가져오고 보는 데만 사용할 수 있습니다. 이 저장소에서는 새 백업/리소스를 만들 수 없지만 복원에서는 읽기 전용 백업을 사용하여 복원할 수 있습니다. 클러스터 간 복원을 위해 다른 클러스터에서 백업을 가져오기 위한 것입니다. BackupRepository를 ReadOnly로 사용할 수 있는 빈도에는 제한이 없습니다. 이 필드를 변경할 수 있습니다.

BackupRepositoryManagerStatus

BackupRepositoryManagerStatus는 관찰된 BackupRepositoryManager 상태를 정의합니다.

표시 위치: - BackupRepositoryManager

필드 설명
backupCount 정수 BackupCount는 BackupRepositorySpec이 가리키는 스토리지 버킷 내에 생성된 총 백업 수입니다.
backupPlanCount 정수 BackupPlanCount는 BackupRepositorySpec이 가리키는 스토리지 버킷 내에 생성된 총 백업 계획 수입니다.
restoreCount 정수 RestoreCount는 BackupRepositorySpec이 가리키는 스토리지 버킷 내에 생성된 복원의 총수입니다.
restorePlanCount 정수 RestorePlanCount는 BackupRepositorySpec이 가리키는 스토리지 버킷 내에 생성된 총 복원 계획 수입니다.
clusterStatuses ClusterStatus 배열 ClusterStatuses에는 각 클러스터에서 원하는 백업 저장소를 생성하는 것과 관련된 현재 상태가 포함되어 있습니다. 목록에는 ReadOnlyClusters 목록에 지정된 모든 클러스터와 ReadWriteCluster의 항목이 포함됩니다. 클러스터에 백업 저장소가 성공적으로 생성되었는지 여부는 ClusterStatuses 배열의 항목에 'Ready' 조건이 'True'로 표시되는지 여부로 나타냅니다. 그렇지 않으면 'False'로 표시됩니다.
conditions 조건 조건은 백업 저장소 관리자와 생성된 백업 저장소가 정상 상태인지 여부를 나타냅니다.
errorStatus ErrorStatus 관찰된 시간이 포함된 조정의 가장 최근 오류입니다.

BackupRepositorySpec

백업 저장소에 대해 원하는 상태를 정의합니다.

표시 위치: - BackupRepository

필드 설명
secretReference SecretReference 선택한 스토리지 시스템에 종속된 액세스 보안 비밀에 대한 참조입니다. 이 보안 비밀은 이 엔드포인트에 대한 요청에 사용됩니다. 예를 들어 S3 액세스 보안 비밀입니다.
endpoint 문자열 백업 저장소에 액세스하는 데 사용되는 엔드포인트입니다. Google 프라이빗 클라우드의 경우 테넌트 프로젝트에 대한 액세스를 제공하는 S3 엔드포인트입니다.
type RepositoryType 백업 저장소의 유형입니다. 예를 들어 S3 또는 Google Cloud Storage입니다. 에이전트에게 사용할 스토리지 시스템이나 API를 알려줍니다.
s3Options S3Options S3 호환 BackupRepo 리소스에 대한 액세스를 구성하는 데 사용되는 데이터입니다.
importPolicy ImportPolicy 이 백업 저장소가 읽기 전용인지 읽기-쓰기인지 여부를 결정하는 정책입니다.
importSubstitution ImportSubstitution 이 필드는 가져온 리소스의 백업 저장소 이름을 이 백업 저장소 이름으로 대체할지 여부를 결정합니다.
force 불리언 초기화된 스토리지 버킷이 이미 다른 백업 저장소에 의해 사용된 경우 읽기-쓰기 백업 저장소가 취하는 작업을 지정합니다. True인 경우 새 백업 저장소는 기존 센티널 파일을 자체 센티널 파일로 대체하여 스토리지 버킷의 소유권을 계속 주장합니다. False인 경우 새 백업 저장소 생성이 오류와 함께 실패합니다. 기본값은 False입니다. 이 옵션은 재정의된 센티널 파일에 더 이상 백업 저장소가 없는 경우에만 사용해야 합니다. 그렇지 않으면 백업 저장소가 오류 상태가 되어 원치 않는 부작용이 발생할 수 있습니다.

BackupRepositoryStatus

백업 저장소의 관찰된 상태를 정의합니다.

표시 위치: - BackupRepository

필드 설명
sentinelEtag 문자열 백업 저장소를 소유한 센티널 파일에 연결하는 필드입니다.
reconciliationError ReconciliationError 백업 저장소의 가장 최근 조정 시도 중에 발생한 오류입니다.
reconciliationErrorMessage 문자열 조정 중에 발생했을 수 있는 오류 메시지입니다.
errorStatus ErrorStatus 관찰된 시간이 포함된 조정의 가장 최근 오류입니다.
initialImportDone 불리언 이 백업 저장소의 초기 가져오기가 완료되었는지 여부를 지정합니다.
conditions Condition 배열 Conditions는 이 백업 저장소의 현재 상태에 대한 모니터링 결과를 나타냅니다. 알려진 조건 유형: Ready

BackupRetentionPolicy

백업의 보관 정책을 나타냅니다.

표시 위치: - ClusterBackupSpec

필드 설명
deleteLockDays 정수 이 백업이 생성된 후 삭제가 차단되는 일수입니다. 백업 일정에서 자동으로 생성된 백업의 경우 이 필드는 ClusterBackupPlan.RetentionPolicy.backup_delete_block_days 값으로 설정됩니다. 이 필드를 지정하지 않고 수동으로 생성된 백업의 경우 서비스에서 ClusterBackupPlan.RetentionPolicy.backup_delete_block_days 값을 할당합니다. 이 필드의 값이 ClusterBackupPlan.RetentionPolicy.backup_delete_block_days 값보다 작은 백업이 생성되면 서비스에서 잘못된 응답이 반환됩니다. 이 필드는 0-90 사이의 정수 값이어야 합니다. 이 필드는 업데이트 요청에 의해서만 증가해야 하며, 그렇지 않으면 서비스에서 잘못된 응답을 반환합니다. 이 필드는 Succeeded 상태의 백업에만 적용됩니다.
retainDays 정수 이 클러스터 백업을 보관할 일수입니다. 이 일수가 지나면 자동으로 삭제됩니다. 이는 클러스터 백업의 create_time에서 계산됩니다. 이 필드를 지정하지 않거나 0로 설정하면 백업이 자동으로 삭제되지 않습니다. 일정에서 자동으로 생성된 클러스터 백업의 경우 이 필드에 ClusterBackupPlan.RetentionPolicy.backup_retain_days 값이 할당됩니다. 이 필드를 지정하지 않고 수동으로 생성된 백업의 경우 서비스에서 ClusterBackupPlan.RetentionPolicy.backup_retain_days 값을 할당합니다. 이 필드의 값이 delete_lock_days 값보다 작은 백업이 생성되면 서비스에서 잘못된 응답이 반환됩니다. 이 필드는 업데이트 요청에 의해서만 증가해야 하며, 그렇지 않으면 서비스에서 잘못된 응답을 반환합니다.

BackupScope

백업할 네임스페이스와 애플리케이션을 정의합니다.

표시 위치: - BackupConfig - RestoreConfig

필드 설명
allNamespaces 불리언 모든 네임스페이스가 백업되는지 여부를 지정합니다. True로 설정되면 모든 네임스페이스를 백업해야 함을 나타냅니다.
selectedNamespaces 네임스페이스 백업할 네임스페이스 목록입니다.
selectedApplications NamespacedNames 백업할 애플리케이션 목록입니다.

BackupSpec

백업에 대해 원하는 상태를 정의합니다.

표시 위치: - 백업

필드 설명
clusterName 문자열 백업된 클러스터의 이름입니다. 기본적으로 이 백업이 생성된 클러스터입니다.
backupPlanName 문자열 이 백업이 생성된 백업 계획의 이름입니다.
backupConfig BackupConfig 지정된 백업 계획에서 이 백업이 생성될 때 사용되는 구성입니다. 이는 참조가 아닌 이 백업이 생성된 백업 계획에서 복사해야 합니다. 이 필드는 사용자가 설정해서는 안 되며 백업 계획 스케줄러와 ManualBackupRequest 리소스만 설정해야 합니다.
description 문자열 백업에 대한 선택적 문자열 설명입니다. 이 필드는 기능에 영향을 미치지 않습니다.
manual 불리언 백업 리소스가 수동으로 생성되었는지 여부를 지정합니다. True인 경우 이 백업이 수동으로 생성된 것입니다. False인 경우 이 백업이 백업 계획 일정에서 자동으로 생성된 것입니다.
deleteLockDays 정수 이 백업의 create_time부터 삭제가 차단되는 일수입니다. 백업 일정에서 자동으로 생성된 백업의 경우 이 필드는 BackupPlan.RetentionPolicy.backup_delete_block_days 값으로 설정됩니다. 이 필드를 지정하지 않고 수동으로 생성된 백업의 경우 서비스에서 BackupPlan.RetentionPolicy.backup_delete_block_days 값을 할당합니다. 이 필드의 값이 BackupPlan.RetentionPolicy.backup_delete_block_days 값보다 작은 백업이 생성되면 서비스에서 잘못된 응답이 반환됩니다. 이 필드는 0-90 사이의 정수 값이어야 합니다. 이 필드는 업데이트 요청에 의해서만 증가해야 하며, 그렇지 않으면 서비스에서 잘못된 응답을 반환합니다. 이 필드는 Succeeded 상태의 백업에만 적용됩니다. 기본값은 0입니다.
retainDays 정수 이 백업을 보관할 일수입니다. 이 기간이 지나면 백업이 자동으로 삭제됩니다. 이는 백업의 create_time에서 계산됩니다. 이 필드를 지정하지 않거나 0로 설정하면 백업이 자동으로 삭제되지 않습니다. 백업 일정에서 자동으로 생성된 백업의 경우 이 필드에 BackupPlan.RetentionPolicy.backup_retain_days 값이 할당됩니다. 이 필드를 지정하지 않고 수동으로 생성된 백업의 경우 서비스에서 BackupPlan.RetentionPolicy.backup_retain_days 값을 할당합니다. 이 필드의 값이 delete_lock_days 값보다 작은 백업이 생성되면 서비스에서 잘못된 응답이 반환됩니다. 이 필드는 업데이트 요청에 의해서만 증가해야 하며, 그렇지 않으면 서비스에서 잘못된 응답을 반환합니다. 기본값은 0입니다.

BackupStatus

백업의 관찰된 상태를 정의합니다.

표시 위치: - 백업

필드 설명
clusterMetadata ClusterMetadata 클러스터의 메타데이터입니다.
jobCreated 불리언 이 백업에 백업 작업이 생성되었는지 여부를 지정합니다.
state BackupState 백업의 현재 상태입니다.
reason 문자열 백업이 현재 상태인 이유에 대해 사람이 읽을 수 있는 설명입니다.
errorStatus ErrorStatus 관찰된 시간이 포함된 가장 최근 오류입니다.
conditions Condition 배열 Conditions는 이 백업의 현재 상태에 대한 관찰 결과를 나타냅니다. 알려진 조건 유형: 성공
createTime 시간 이 백업 리소스가 생성된 시점의 타임스탬프입니다. RFC 3339로 변환되거나 RFC 3339에서 변환될 수 있습니다.
updateTime 시간 이 백업 계획이 마지막으로 업데이트된 시점의 타임스탬프입니다. RFC 3339로 변환되거나 RFC 3339에서 변환될 수 있습니다.
resourceCount 정수 백업된 총 리소스 수입니다.
volumeCount 정수 백업된 볼륨의 총수입니다.
sizeBytes 정수 총 크기(바이트)입니다.
podCount 정수 백업된 워크로드 포드의 총수입니다.
systemPodCount 정수 백업된 시스템 포드의 총수입니다. 이러한 포드는 청구에서 제외됩니다.
vmCount 정수 백업된 가상 머신의 총수입니다.
deleteLockExpireTime 시간 삭제 잠금이 만료되는 시간입니다. create_time 및 delete_lock_days의 결합된 값에서 계산되는 출력 전용 필드이며 백업의 delete_lock_days 필드가 업데이트되면 이에 따라 업데이트됩니다. 이 필드는 Succeeded 상태의 백업에만 적용됩니다.
retainExpireTime 시간 백업이 자동으로 삭제되는 시간입니다. create_time 및 retain_days의 결합된 값에서 계산되는 출력 전용 필드이며 백업의 retain_days 필드가 업데이트되면 이에 따라 업데이트됩니다.
completeTime 시간 백업 완료 시간입니다.

ClusterBackup

표시 위치: - ClusterBackupList

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ClusterBackup
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec ClusterBackupSpec
status ClusterBackupStatus

ClusterBackupConfig

이 백업 계획에서 백업을 생성하는 구성을 정의하는 내부 메시지 유형을 나타냅니다.

표시 위치: - ClusterBackupPlanSpec - ClusterBackupSpec

필드 설명
backupScope BackupScope 백업의 리소스 선택 범위입니다. 예로는 all_namespaces, 선택한 네임스페이스, 선택한 애플리케이션이 있습니다. backup_scope에 단일 값을 지정해야 합니다. BackupScope 값은 BackupConfig_AllNamespaces, BackupConfig_SelectedNamespaces, BackupConfig_SelectedApplications 유형 중 하나여야 합니다.
backupRepositoryName 문자열 이 ClusterBackupPlan 리소스의 보조 스토리지를 식별하는 BackupRepositoryRef 리소스의 이름입니다.
clusterBackupRepositoryName 문자열 이 ClusterBackupPlan 리소스의 보조 스토리지를 식별하는 ClusterBackupRepositoryRef 리소스의 이름입니다.
includeVolumeData 불리언 볼륨 데이터가 백업되는지 여부를 지정합니다. 설정하지 않으면 기본값은 false입니다.
includeSecrets 불리언 보안 비밀이 백업되는지 여부를 지정합니다. 설정하지 않으면 기본값은 false입니다.
volumeStrategy VolumeStrategy 실행할 볼륨 백업 유형입니다.

ClusterBackupList

클러스터 백업 목록을 나타냅니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ClusterBackupList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items ClusterBackup 배열

ClusterBackupPlan

표시 위치: - ClusterBackupPlanList

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ClusterBackupPlan
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec ClusterBackupPlanSpec
status BackupPlanStatus

ClusterBackupPlanList

ClusterBackup 목록을 나타냅니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ClusterBackupPlanList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items ClusterBackupPlan 배열

ClusterBackupPlanSpec

backupv1.BackupPlan 커스텀 리소스를 래핑하는 API를 나타냅니다. 대부분 동일하지만 선택적으로 생략되는 필드가 있습니다.

표시 위치: - ClusterBackupPlan

필드 설명
targetCluster TargetCluster 백업할 클러스터입니다.
backupSchedule 예약 이 백업 계획에 따라 예약된 백업 생성입니다.
clusterBackupConfig ClusterBackupConfig 이 백업 계획의 백업 구성입니다.
retentionPolicy RetentionPolicy 이 계획에 따라 생성된 백업의 수명 주기입니다.
description 문자열 이 백업 계획에 대해 사용자가 지정한 설명 문자열입니다.
deactivated 불리언 요금제가 비활성화되었는지 여부를 지정합니다. 이 필드를 'true'로 설정하면 요금제가 잠기므로 비활성화된 필드의 변경사항을 비롯한 추가 업데이트가 허용되지 않습니다. 또한 이 계획에서 수동 또는 예약된 새 백업이 생성되지 않습니다. 기본값은 'false'입니다.

ClusterBackupRepository

ClusterBackupRepository API의 스키마를 정의합니다.

표시 위치: - ClusterBackupRepositoryList

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ClusterBackupRepository
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec ClusterBackupRepositorySpec
status ClusterBackupRepositoryStatus

ClusterBackupRepositoryList

ClusterBackupRepository 리소스 목록이 포함되어 있습니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ClusterBackupRepositoryList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items ClusterBackupRepository 배열

ClusterBackupRepositorySpec

ClusterBackupRepositorySpec 리소스에 대해 원하는 상태를 정의합니다.

표시 위치: - ClusterBackupRepository

필드 설명
secretReference SecretReference 선택한 스토리지 시스템에 종속된 액세스 보안 비밀에 대한 참조입니다. 이 보안 비밀은 이 엔드포인트에 대한 요청에 사용됩니다. 예를 들어 S3 액세스 보안 비밀입니다.
endpoint 문자열 클러스터 백업 저장소에 액세스하는 데 사용되는 엔드포인트입니다.
type RepositoryType 클러스터 백업 저장소의 유형입니다. 예를 들어 S3 또는 Google Cloud Storage입니다. 에이전트에게 사용할 스토리지 시스템이나 API를 알려줍니다.
s3Options S3Options S3 호환 BackupRepo 리소스에 대한 액세스를 구성하는 데 사용되는 데이터입니다.
importPolicy ImportPolicy 이 백업 저장소가 읽기 전용인지 읽기-쓰기인지 여부를 결정하는 정책입니다.
force 불리언 초기화된 스토리지 버킷이 이미 다른 백업 저장소에 의해 사용된 경우 읽기-쓰기 백업 저장소가 취하는 작업을 지정합니다. True인 경우 새 백업 저장소는 기존 센티널 파일을 자체 센티널 파일로 대체하여 스토리지 버킷의 소유권을 계속 주장합니다. False인 경우 새 백업 저장소 생성이 오류와 함께 실패합니다. 기본값은 False입니다. 이 옵션은 재정의된 센티널 파일에 더 이상 백업 저장소가 없는 경우에만 사용해야 합니다. 그렇지 않으면 백업 저장소가 오류 상태가 되어 원치 않는 부작용이 발생할 수 있습니다.

ClusterBackupRepositoryStatus

ClusterBackupRepository 리소스의 관찰된 상태를 정의합니다.

표시 위치: - ClusterBackupRepository

필드 설명
sentinelEtag 문자열 백업 저장소를 소유한 센티널 파일에 연결하는 필드입니다.
reconciliationError ReconciliationError 백업 저장소의 가장 최근 조정 시도 중에 발생한 오류입니다.
reconciliationErrorMessage 문자열 조정 중에 발생했을 수 있는 오류 메시지입니다.
errorStatus ErrorStatus 관찰된 시간이 포함된 조정의 가장 최근 오류입니다.
conditions Condition 배열 클러스터 백업 저장소의 상태를 지정합니다. 지원되는 조건은 InitialImportDone, Ready, Deprecated입니다.

ClusterBackupSpec

backupv1.Backup 커스텀 리소스를 래핑하는 API를 나타냅니다. 대부분 동일하지만 선택적으로 생략되는 필드가 있습니다.

표시 위치: - ClusterBackup

필드 설명
targetCluster TargetCluster 백업할 클러스터의 이름입니다.
clusterBackupPlanName 문자열 이 백업이 생성된 클러스터 백업 계획의 이름입니다.
backupConfig ClusterBackupConfig 지정된 백업 계획에서 이 백업이 생성될 때 사용되는 구성입니다. 참조가 아닌 이 클러스터 백업이 생성된 클러스터 백업 계획에서 복사해야 합니다. 이 필드는 사용자가 설정해서는 안 되며 백업 계획 스케줄러와 ManualBackupRequest 리소스만 설정해야 합니다.
description 문자열 백업에 대한 선택적 문자열 설명입니다. 이 필드는 기능에 영향을 미치지 않습니다.
manual 불리언 클러스터 백업 리소스가 수동으로 생성되었는지 여부를 지정합니다. True인 경우 이 백업은 수동으로 생성된 것입니다. False인 경우 이 클러스터 백업은 백업 계획 일정에서 자동으로 생성된 것입니다.
retentionPolicy BackupRetentionPolicy 백업의 보관 정책입니다.

ClusterBackupStatus

클러스터 백업의 관찰된 상태를 정의합니다.

표시 위치: - ClusterBackup

필드 설명
clusterMetadata ClusterMetadata 클러스터의 메타데이터입니다.
conditions Condition 배열 클러스터 백업의 상태를 지정합니다. 지원되는 조건은 JobCreated, Succeeded입니다.
jobCreated 불리언 이 클러스터 백업에 백업 작업이 생성되었는지 여부를 지정합니다.
state BackupState 클러스터 백업의 현재 상태입니다.
stateReason 문자열 백업이 현재 상태인 이유에 대해 사람이 읽을 수 있는 설명입니다.
errorStatus ErrorStatus 관찰된 시간이 포함된 가장 최근 오류입니다.
createTime 시간 이 백업 리소스가 생성된 시점의 타임스탬프입니다. RFC 3339로 변환되거나 RFC 3339에서 변환될 수 있습니다.
updateTime 시간 이 클러스터 백업이 마지막으로 업데이트된 시점의 타임스탬프입니다. RFC 3339로 변환되거나 RFC 3339에서 변환될 수 있습니다.
resourceCount 정수 백업된 총 리소스 수입니다.
volumeCount 정수 백업된 볼륨의 총수입니다.
sizeBytes 정수 총 크기(바이트)입니다.
podCount 정수 백업된 워크로드 포드의 총수입니다.
deleteLockExpireTime 시간 삭제 잠금이 만료되는 시간입니다. create_time 및 delete_lock_days의 결합된 값에서 계산되는 출력 전용 필드이며 클러스터 백업의 delete_lock_days 필드가 업데이트되면 이에 따라 업데이트됩니다. 이 필드는 Succeeded 상태의 클러스터 백업에만 적용됩니다.
retainExpireTime 시간 클러스터 백업이 자동으로 삭제되는 시간입니다. create_time 및 retain_days의 결합된 값에서 계산되는 출력 전용 필드이며 클러스터 백업의 retain_days 필드가 업데이트되면 이에 따라 업데이트됩니다.
completeTime 시간 클러스터 백업 완료 시간입니다.

ClusterMetadata

클러스터의 메타데이터를 나타냅니다.

표시 위치: - BackupStatus

필드 설명
clusterName 문자열 백업이 생성된 소스 클러스터의 이름입니다.
k8sVersion 문자열 Kubernetes 서버 버전입니다.
platformVersion PlatformVersion PlatformVersion에 할당할 수 있는 플랫폼 버전 유형입니다. 예를 들면 GpcVersion입니다.

ClusterResourceConflictPolicy

기본 유형: string 충돌이 발생할 때 따라야 하는 네임스페이스가 없는 클러스터 리소스의 복원 동작입니다.

표시 위치: - RestoreConfig - RestorePolicies

ClusterResourceSelection

복원을 위해 네임스페이스가 아닌 리소스의 선택을 나타냅니다.

표시 위치: - RestoreConfig - RestoreResourceSelection

필드 설명
selectedGroupKinds GroupKind 배열 GroupKind 리소스 목록입니다. 네임스페이스가 없는 리소스는 목록에 지정된 GroupKind 리소스 중 하나로 포함되어야 합니다. PersistentVolume 리소스는 네임스페이스가 없지만 별도로 처리됩니다. 자세한 내용은 VolumeDataRestorePolicy를 참고하세요. 이 목록에서 PersistentVolume GroupKind을 지정해도 PersistentVolume 복원 여부에는 영향을 미치지 않습니다.

ClusterRestore

ClusterRestore API의 스키마를 정의합니다.

표시 위치: - ClusterRestoreList

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ClusterRestore
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec ClusterRestoreSpec
status ClusterRestoreStatus

ClusterRestoreConfig

ClusterRestore의 구성을 정의합니다.

표시 위치: - ClusterRestorePlanSpec - ClusterRestoreSpec

필드 설명
volumeDataRestorePolicy VolumeDataRestorePolicy 볼륨 데이터 복원에 사용할 정책입니다. 값이 지정되지 않은 경우 기본값 NO_VOLUME_DATA_RESTORATION을 제공합니다.
clusterResourceConflictPolicy ClusterResourceConflictPolicy 클러스터 범위 리소스를 복원할 때 충돌을 해결하는 정책입니다. 이 필드의 값이 CLUSTER_RESOURCE_CONFLICT_POLICY_UNSPECIFIED이고 cluster_resource_restore_scope가 지정된 경우 이 요청은 유효하지 않습니다.
namespacedResourceRestoreMode NamespacedResourceRestoreMode 네임스페이스 범위 리소스에 사용할 복원 모드입니다. 이 필드의 값이 NAMESPACED_RESOURCE_RESTORE_MODE_UNSPECIFIED이고 namespaced_resource_restore_scope이 지정된 경우 요청이 잘못되었습니다.
clusterResources ClusterResourceSelection 복원할 네임스페이스가 아닌 리소스입니다. 이 필드를 지정하지 않으면 클러스터 리소스가 복원되지 않습니다. PersistentVolume 리소스는 네임스페이스가 없지만 별도로 처리됩니다. 자세한 내용은 VolumeDataRestorePolicy 리소스를 참고하세요. 이 목록에서 PersistentVolume GroupKind을 지정해도 PersistentVolume이 복원되는지 여부는 결정되지 않습니다.
namespacedResourceAllowlist GroupKind 배열 복원할 특정 네임스페이스 리소스입니다. 정의된 경우 이 allowlist에 정의된 리소스만 복원됩니다.
namespacedResourceRestoreScope BackupScope 복원할 선택된 네임스페이스 리소스입니다. 유효한 Type와 함께 항목 중 하나를 지정해야 합니다. restoreScope에 할당할 수 있는 유효한 Type 값은 AllNamespaces, SelectedNamespaces 또는 SelectedApplications입니다.
substitutionRules SubstitutionRule 배열 백업된 Kubernetes 리소스의 대체 중에 따르는 규칙입니다. 빈 목록은 대체가 발생하지 않음을 의미합니다. 대체 규칙은 정의된 순서대로 순차적으로 적용됩니다. 규칙에 의해 이루어진 변경사항이 후속 규칙의 일치 로직에 영향을 줄 수 있으므로 순서가 중요합니다. 특정 복원 작업에는 SubstitutionRules 또는 TransformationRules 중 하나만 지정할 수 있습니다.
transformationRules TransformationRule 배열 백업된 Kubernetes 리소스의 변환 중에 따르는 규칙입니다. 빈 목록은 변환이 발생하지 않음을 의미합니다. 변환 규칙은 정의된 순서대로 순차적으로 적용됩니다. 규칙에 의해 변경된 사항이 후속 규칙의 일치 로직에 영향을 줄 수 있으므로 순서가 중요합니다. 특정 복원 작업에는 SubstitutionRules 또는 TransformationRules 중 하나만 지정할 수 있습니다.
clusterBackupRepositoryRef 문자열 복원 리소스의 저장소를 식별하는 클러스터 백업 저장소의 이름입니다. 이 필드는 읽기-쓰기 모드로 연결해야 합니다. 이 필드가 제공되지 않으면 다음 논리를 사용하여 선택됩니다. 1. 복원을 수행하는 백업이 현재 클러스터의 읽기-쓰기 저장소를 가리키는 경우 이 저장소가 선택됩니다. 2. 복원을 수행하는 백업이 읽기 전용 저장소를 가리키는 경우 클러스터의 읽기-쓰기 저장소가 선택되어 사용됩니다.

ClusterRestoreList

클러스터 복원 목록을 나타냅니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ClusterRestoreList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items ClusterRestore 배열

ClusterRestorePlan

ClusterRestorePlan API의 스키마를 정의합니다.

표시 위치: - ClusterRestorePlanList

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ClusterRestorePlan
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec ClusterRestorePlanSpec
status RestorePlanStatus

ClusterRestorePlanList

ClusterRestorePlan 리소스 목록을 나타냅니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ClusterRestorePlanList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items ClusterRestorePlan 배열

ClusterRestorePlanSpec

backupv1.RestorePlan 커스텀 리소스를 래핑하는 API를 나타냅니다. 대부분 동일하지만 선택적으로 생략되는 필드가 있습니다. 'ClusterRestorePlan'에 대해 원하는 상태를 정의합니다.

표시 위치: - ClusterRestorePlan

필드 설명
targetCluster TargetCluster 데이터가 복원될 클러스터입니다.
clusterBackupPlanName 문자열 이 ClusterRestorePlan를 사용하여 생성된 클러스터 복원의 소스로 클러스터 백업을 사용할 수 있는 클러스터 백업 계획의 이름입니다. 이 필드는 필수이며 변경할 수 없습니다.
clusterRestoreConfig ClusterRestoreConfig 이 클러스터 복원 계획의 클러스터 복원 구성입니다.
description 문자열 이 클러스터 복원 계획에 대해 사용자가 지정한 설명 문자열입니다.

ClusterRestoreSpec

backupv1.Restore 커스텀 리소스를 래핑하는 API를 나타냅니다. ClusterRestore에 대해 원하는 상태를 정의합니다.

표시 위치: - ClusterRestore

필드 설명
targetCluster TargetCluster 데이터가 복원될 클러스터입니다.
clusterBackupName 문자열 클러스터 복원과 동일한 네임스페이스에 있어야 하는 클러스터 백업의 이름입니다.
clusterRestorePlanName 문자열 이 클러스터 복원이 ClusterRestoreConfig 리소스를 상속받은 클러스터 복원 계획의 이름입니다.
clusterRestoreConfig ClusterRestoreConfig 클러스터 복원의 구성입니다.
description 문자열 클러스터 복원에 대한 설명(선택사항)입니다. 기능에는 영향을 미치지 않습니다.
filter 필터 필터를 사용하면 ClusterRestorePlan에 정의된 대략적인 범위 외에 클러스터 복원의 리소스 선택을 추가로 세부적으로 조정할 수 있습니다.

ClusterRestoreStatus

클러스터 복원의 관찰된 상태를 정의합니다.

표시 위치: - ClusterRestore

필드 설명
conditions Condition 배열 클러스터 복원의 상태를 지정합니다. 지원되는 조건은 JobCreated, Succeeded입니다.
state RestoreState 클러스터 복원의 현재 상태입니다.
stateReason 문자열 클러스터 복원이 현재 상태인 이유에 대해 사람이 읽을 수 있는 설명입니다.
errorStatus ErrorStatus 관찰된 시간이 포함된 가장 최근 오류입니다.
resourcesRestoredCount 정수 이 클러스터 복원 작업에서 복원된 리소스 수입니다.
resourcesExcludedCount 정수 이 클러스터 복원 작업에서 제외된 리소스 수입니다.
resourcesFailedCount 정수 이 클러스터 복원 작업에서 복원하지 못한 리소스 수입니다.
restoredVolumesCount 정수 이 클러스터 복원 작업에서 복원된 볼륨 수입니다.
startTime 시간 클러스터 복원 프로세스의 생성 시간입니다.
completeTime 시간 클러스터 복원 프로세스의 종료 시간입니다.

ClusterStatus

ClusterStatus에는 지정된 클러스터의 백업 저장소 생성 상태가 포함됩니다.

표시 위치: - BackupRepositoryManagerStatus

필드 설명
cluster NamespacedName
conditions Condition 배열

ClusterVolumeBackup

ClusterVolumeBackup API의 스키마를 정의합니다.

표시 위치: - ClusterVolumeBackupList

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ClusterVolumeBackup
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec ClusterVolumeBackupSpec
status ClusterVolumeBackupStatus

ClusterVolumeBackupList

ClusterVolumeBackup 리소스 목록이 포함되어 있습니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ClusterVolumeBackupList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items ClusterVolumeBackup 배열

ClusterVolumeBackupSpec

클러스터 볼륨 백업에 대해 원하는 상태를 정의합니다.

표시 위치: - ClusterVolumeBackup

필드 설명
cluster TargetCluster 이 클러스터 볼륨 백업이 데이터를 유지하는 클러스터의 이름입니다.
clusterBackupName 문자열 연결된 백업의 이름입니다. 각 클러스터 볼륨 백업은 백업과 연결되어야 합니다. 항상 동일한 네임스페이스에 있습니다.
clusterBackupPlanName 문자열 연결된 백업이 생성된 백업 계획의 이름입니다. 항상 동일한 네임스페이스에 있습니다.
sourcePVC TypedObjectReference 클러스터 볼륨 백업이 가져온 소스 영구 볼륨 신청입니다.

ClusterVolumeBackupStatus

클러스터 볼륨 백업의 관찰된 상태를 정의합니다.

표시 위치: - ClusterVolumeBackup

필드 설명
volumeBackupHandle 문자열 백업 저장소 내에서 클러스터 볼륨 백업을 고유하게 식별하는 기본 클러스터 볼륨 백업 핸들입니다. 이 핸들은 통합된 형식이 없으며 불투명 문자열로 처리됩니다.
format VolumeBackupFormat 클러스터 볼륨 백업 형식입니다. 예를 들어 PD, Portable 등이 있습니다.
storageBytes 정수 백업 스토리지에 있는 클러스터 볼륨 백업의 크기입니다. 증분 백업의 경우 이전 볼륨 백업 중 하나가 삭제되면 이 값이 동적으로 변경될 수 있습니다.
diskSizeBytes 정수 이 볼륨 백업을 복원할 수 있는 디스크의 최소 크기입니다.
state VolumeBackupState 볼륨 백업의 현재 상태입니다.
message 문자열 백업이 이 상태인 이유에 대한 세부정보를 나타내는 인간이 읽을 수 있는 메시지입니다.
completeTime 시간 이 ClusterVolumeBackup 리소스가 완료된 타임스탬프입니다(RFC 3339 텍스트 형식).
conditions Condition 배열 클러스터 볼륨 백업의 상태를 지정합니다.

ClusterVolumeRestore

backupv1.VolumeRestore 커스텀 리소스를 래핑하는 API를 나타냅니다. ClusterVolumeRestore API의 스키마를 정의합니다.

표시 위치: - ClusterVolumeRestoreList

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ClusterVolumeRestore
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec ClusterVolumeRestoreSpec
status VolumeRestoreStatus

ClusterVolumeRestoreList

ClusterVolumeRestore 리소스 목록을 나타냅니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ClusterVolumeRestoreList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items ClusterVolumeRestore 배열

ClusterVolumeRestoreSpec

클러스터 볼륨 복원에 대해 원하는 상태를 정의합니다.

표시 위치: - ClusterVolumeRestore

필드 설명
targetCluster TargetCluster 볼륨이 복원될 클러스터의 이름입니다.
clusterRestoreName 문자열 이 클러스터 볼륨 복원을 만든 클러스터 복원 리소스의 이름입니다.
clusterVolumeBackupName 문자열 복원 중인 클러스터 볼륨 백업 리소스의 이름입니다.
targetPvc NamespacedName 복원할 타겟 PersistentVolumeClaim 리소스입니다.

DeleteBackupRequest

DeleteBackupRequest API의 스키마를 정의합니다.

표시 위치: - DeleteBackupRequestList

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 DeleteBackupRequest
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec DeleteBackupRequestSpec
status DeleteBackupRequestStatus

DeleteBackupRequestList

DeleteBackupRequest 리소스 목록이 포함되어 있습니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 DeleteBackupRequestList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items DeleteBackupRequest 배열

DeleteBackupRequestSpec

DeleteBackupRequest 리소스에 대해 원하는 상태를 정의합니다.

표시되는 위치: - DeleteBackupRequest

필드 설명
backupName 문자열 삭제할 백업의 이름입니다. 백업은 DeleteBackupRequest 리소스와 동일한 네임스페이스에 있어야 합니다.

DeleteBackupRequestStatus

DeleteBackupRequest 리소스의 관찰된 상태를 정의합니다.

표시되는 위치: - DeleteBackupRequest

필드 설명
timeToExpire 시간 리소스가 만료되는 시간입니다.
statusField StatusFields 관찰된 DeleteBackupRequest 리소스 상태입니다.

DeleteClusterBackupRequest

DeleteClusterBackupRequest API의 스키마를 정의합니다.

표시되는 위치: - DeleteClusterBackupRequestList

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 DeleteClusterBackupRequest
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec DeleteClusterBackupRequestSpec
status DeleteClusterBackupRequestStatus

DeleteClusterBackupRequestList

DeleteBackupRequest 리소스 목록이 포함되어 있습니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 DeleteClusterBackupRequestList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items DeleteClusterBackupRequest array

DeleteClusterBackupRequestSpec

DeleteClusterBackupRequest 리소스에 대해 원하는 상태를 정의합니다.

표시 위치: - DeleteClusterBackupRequest

필드 설명
clusterBackupRef 문자열 삭제할 ClusterBackup 리소스의 이름입니다. ClusterBackup 리소스는 DeleteClusterBackupRequest 리소스와 동일한 네임스페이스에 있어야 합니다.

DeleteClusterBackupRequestStatus

DeleteClusterBackupRequest 리소스의 관찰된 상태를 정의합니다.

표시 위치: - DeleteClusterBackupRequest

필드 설명
timeToExpire 시간 리소스가 만료되는 시간입니다.
statusField StatusFields 관찰된 DeleteClusterBackupRequest 리소스 상태입니다.

EncryptionKey

암호화 키를 정의합니다. 미리보기에서는 Google Cloud Platform KMS만 지원됩니다.

표시 위치: - BackupConfig - RestoreConfig

필드 설명
gcpKMSEncryptionKey 문자열 Google KMS 암호화 키이며 형식은 projects/<project>/locations/<location>/keyRings/<key-ring>/cryptoKeys/<key>입니다.

필터

세분화된 복원 필터를 정의합니다.

표시 위치: - ManualRestoreRequestSpec - RestoreSpec

필드 설명
inclusionFilters ResourceSelector 배열 복원할 리소스를 선택합니다. 지정된 경우 inclusion_filters와 일치하는 리소스만 복원용으로 선택됩니다. 리소스가 inclusion_filters의 ResourceSelector와 일치하면 선택됩니다.
exclusionFilters ResourceSelector 배열 복원에서 리소스를 제외합니다. 지정된 경우 리소스가 exclusion_filters의 ResourceSelector와 일치하면 복원되지 않습니다.

ImportPolicy

기본 유형: string 이 백업 저장소가 읽기 전용인지 읽기-쓰기인지 결정하는 정책입니다.

표시 위치: - BackupRepositorySpec

ImportSubstitution

가져온 리소스에서 백업 저장소 이름을 대체하는지 여부를 나타냅니다.

표시 위치: - BackupRepositorySpec

필드 설명
substituteBRName 불리언

ManualBackupRequest

ManualBackupRequest API의 스키마를 정의합니다.

표시 위치: - ManualBackupRequestList

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ManualBackupRequest
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec ManualBackupRequestSpec
status ManualBackupRequestStatus

ManualBackupRequestList

ManualBackupRequest 리소스 목록이 포함되어 있습니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ManualBackupRequestList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items ManualBackupRequest 배열

ManualBackupRequestSpec

ManualBackupRequest 리소스에 대해 원하는 상태를 정의합니다.

표시 위치: - ManualBackupRequest

필드 설명
backupName 문자열 만들려는 수동 백업의 이름입니다.
backupPlanName 문자열 BackupConfig 리소스가 가져온 백업 계획의 이름입니다.
description 문자열 이 ManualBackupRequest 리소스에 의해 생성된 백업에 대한 사용자 지정 설명 문자열입니다.
deleteLockDays 정수 이 백업의 create_time부터 삭제가 차단되는 일수입니다. 일정에서 자동으로 생성된 백업의 경우 이 필드에 BackupPlan.RetentionPolicy.backup_delete_block_days 값이 지정됩니다. 이 필드를 지정하지 않고 백업을 생성하면 BackupPlan.RetentionPolicy.backup_delete_block_days 값이 부여됩니다. 이 필드가 BackupPlan.RetentionPolicy.backup_delete_block_days 값보다 작은 값으로 설정된 백업이 생성되면 에이전트에서 잘못된 응답이 반환됩니다. 이 필드는 0-90 내의 값이어야 합니다. 이 필드는 업데이트 요청에 의해서만 증가해야 하며, 그렇지 않으면 에이전트가 잘못된 응답을 반환합니다. 이 필드는 Succeeded 상태의 백업에만 적용됩니다. 기본값은 0입니다.
retainDays 정수 이 백업을 보관할 일수입니다. 이 기간이 지나면 백업이 자동으로 삭제됩니다. 이 필드를 지정하지 않거나 0로 설정하면 백업이 자동으로 삭제되지 않습니다. 백업 일정에서 자동으로 생성된 백업의 경우 이 필드에 BackupPlan.RetentionPolicy.backup_default_retain_days 값이 할당됩니다. 이 필드가 지정되지 않은 생성된 백업의 경우 에이전트는 BackupPlan.RetentionPolicy.backup_default_retain_days 값을 사용합니다. 이 필드가 delete_lock_days보다 작은 값으로 설정된 백업을 생성하면 상담사로부터 잘못된 응답이 발생합니다. 이 필드는 업데이트 요청에서만 증가해야 합니다. 그렇지 않으면 에이전트가 즉시 잘못된 응답을 반환합니다. 기본값은 0입니다.

ManualBackupRequestStatus

ManualBackupRequest 리소스의 관찰된 상태를 정의합니다.

표시 위치: - ManualBackupRequest

필드 설명
timeToExpire 시간 리소스가 만료되어야 하는 시간입니다.
statusField StatusFields 관찰된 ManualBackupRequest 리소스 상태입니다.
statusMessage 문자열 statusMessage는 ManualBackupRequest 리소스의 오류 메시지입니다.

ManualClusterBackupRequest

ManualClusterBackupRequest API의 스키마를 정의합니다.

표시 위치: - ManualClusterBackupRequestList

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ManualClusterBackupRequest
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec ManualClusterBackupRequestSpec
status ManualClusterBackupRequestStatus

ManualClusterBackupRequestList

ManualClusterBackupRequest 리소스 목록이 포함되어 있습니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ManualClusterBackupRequestList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items ManualClusterBackupRequest 배열

ManualClusterBackupRequestSpec

ManualClusterBackupRequest 리소스에 대해 원하는 상태를 정의합니다.

표시 위치: - ManualClusterBackupRequest

필드 설명
clusterBackupName 문자열 생성할 클러스터 백업의 이름입니다. ManualClusterBackupRequest 리소스와 동일한 네임스페이스 내에 생성됩니다.
clusterBackupPlanRef 문자열 ClusterBackupConfig 리소스가 가져온 클러스터 백업 계획의 이름입니다. 클러스터 백업 계획은 ManualClusterBackupRequest 리소스와 동일한 네임스페이스에 있어야 합니다.
description 문자열 이 ManualClusterBackupRequest 리소스에 의해 생성된 클러스터 백업에 대한 사용자 지정 설명 문자열입니다.
deleteLockDays 정수 이 백업의 create_time부터 삭제가 차단되는 일수입니다. 일정에서 자동으로 생성된 백업의 경우 이 필드에 BackupPlan.RetentionPolicy.backup_delete_block_days 값이 지정됩니다. 이 필드를 지정하지 않고 Backup을 생성하면 BackupPlan.RetentionPolicy.backup_delete_block_days 값이 부여됩니다. 이 Backup가 이 필드가 ClusterBackupPlan.RetentionPolicy.backup_delete_block_days 값보다 작은 값으로 설정된 상태로 생성되면 에이전트에서 잘못된 응답이 반환됩니다. 이 필드는 0-90 내의 값이어야 합니다. 이 필드는 업데이트 요청에 의해서만 증가해야 하며, 그렇지 않으면 에이전트가 잘못된 응답을 반환합니다. 이 필드는 Succeeded 상태의 백업에만 적용됩니다.
retainDays 정수 이 백업을 보관할 일수입니다. 이 기간이 지나면 백업이 자동으로 삭제됩니다. 이 필드를 지정하지 않거나 0로 설정하면 백업이 자동으로 삭제되지 않습니다. 백업 일정에서 자동으로 생성된 백업의 경우 이 필드에 BackupPlan.RetentionPolicy.backup_default_retain_days 값이 할당됩니다. 이 필드를 지정하지 않은 생성된 백업의 경우 에이전트는 ClusterBackupPlan.RetentionPolicy.backup_default_retain_days 값을 사용합니다. 이 필드가 delete_lock_days보다 작은 값으로 설정된 백업을 생성하면 상담사로부터 잘못된 응답이 발생합니다. 이 필드는 업데이트 요청에서만 증가해야 합니다. 그렇지 않으면 에이전트가 즉시 잘못된 응답을 반환합니다.

ManualClusterBackupRequestStatus

ManualClusterBackupRequest 리소스의 관찰된 상태를 정의합니다.

표시 위치: - ManualClusterBackupRequest

필드 설명
timeToExpire 시간 리소스가 만료되는 시간입니다.
statusField StatusFields ManualClusterBackupRequest 리소스의 관찰된 상태입니다.

ManualClusterRestoreRequest

ManualClusterRestoreRequest API의 스키마를 정의합니다.

표시 위치: - ManualClusterRestoreRequestList

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ManualClusterRestoreRequest
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec ManualClusterRestoreRequestSpec
status ManualRestoreRequestStatus

ManualClusterRestoreRequestList

ManualClusterRestoreRequest 리소스 목록을 나타냅니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ManualClusterRestoreRequestList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items ManualClusterRestoreRequest 배열

ManualClusterRestoreRequestSpec

ManualClusterRestoreRequest 리소스에 대해 원하는 상태를 정의합니다.

표시 위치: - ManualClusterRestoreRequest

필드 설명
clusterRestoreName 문자열 생성할 클러스터 복원의 이름입니다.
clusterRestorePlanName 문자열 ClusterRestoreConfig 리소스를 가져올 클러스터 복원 계획의 이름입니다.
clusterBackupName 문자열 복원 중인 클러스터 백업의 이름입니다. 클러스터 복원 계획과 클러스터 백업은 ManualClusterRestoreRequest 리소스와 동일한 네임스페이스에 있어야 합니다.
description 문자열 이 ManualClusterRestoreRequest 리소스에 의해 생성된 클러스터 복원에 대한 사용자 지정 설명 문자열입니다.
filter 필터 ClusterRestorePlan에 정의된 대략적인 범위 외에 클러스터 복원의 리소스 선택을 추가로 세부 조정하는 데 사용할 수 있는 필터입니다.

ManualRestoreRequest

ManualRestoreRequest API의 스키마를 정의합니다.

표시 위치: - ManualRestoreRequestList

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ManualRestoreRequest
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec ManualRestoreRequestSpec
status ManualRestoreRequestStatus

ManualRestoreRequestList

ManualRestoreRequest 리소스 목록이 포함되어 있습니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ManualRestoreRequestList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items ManualRestoreRequest 배열

ManualRestoreRequestSpec

ManualRestoreRequest 리소스에 대해 원하는 상태를 정의합니다.

표시되는 위치: - ManualRestoreRequest

필드 설명
restoreName 문자열 만들려는 수동 복원의 이름입니다.
restorePlanName 문자열 RestoreConfig 리소스를 가져올 복원 계획의 이름입니다.
backupName 문자열 복원 중인 백업의 이름입니다.
description 문자열 이 ManualRestoreRequest 리소스에 의해 생성된 복원에 대한 사용자 지정 설명 문자열입니다.
filter 필터 RestorePlan에 정의된 대략적인 범위를 넘어 복원의 리소스 선택을 추가로 세분화하는 데 사용할 수 있는 필터입니다.

ManualRestoreRequestStatus

ManualRestoreRequest 리소스의 관찰된 상태를 정의합니다.

표시되는 위치: - ManualRestoreRequest

필드 설명
timeToExpire 시간 리소스가 만료되어야 하는 시간입니다.
statusField StatusFields ManualRestoreRequest 리소스의 관찰된 상태입니다.

NamespacedName

특정 네임스페이스의 이름을 정의합니다.

표시 위치: - NamespacedNames - NamespacedResourceSelection - VolumeBackupSpec - VolumeRestoreSpec

필드 설명
namespace 문자열 Kubernetes의 리소스 네임스페이스입니다.
name 문자열 Kubernetes의 리소스 이름입니다.

NamespacedNames

표시 위치: - BackupScope

필드 설명
namespacedNames NamespacedName 배열 네임스페이스 이름 목록입니다.

NamespacedResourceRestoreMode

기본 유형: string 네임스페이스 리소스의 복원 동작입니다.

표시 위치: - RestoreConfig - RestorePolicies

NamespacedResourceSelection

복원할 네임스페이스 범위 리소스의 선택을 정의합니다. 다음 값 중 하나를 일치하는 Type와 함께 지정해야 합니다.

`AllNamespaces`, `SelectedNamespaces`, or `SelectedApplications`.

표시 위치: - RestoreResourceSelection

필드 설명
type NamespacedResourceSelectionType 사용할 선택 유형입니다.
allNamespaces 불리언 백업에서 모든 네임스페이스 범위 리소스를 복원할지 여부를 지정합니다. 이 필드를 지정하지 않거나 Type이 NamespacedResourceSelectionType.AllNamespaces로 설정된 상태에서 False로 설정하는 것은 유효하지 않습니다.
selectedNamespaces 문자열 배열 복원할 선택된 네임스페이스 목록입니다. NamespacedResourceSelectionType.SelectedNamespaces로 설정된 Type와 함께 값이 제공되면 지정된 목록에 포함된 원래 네임스페이스가 있는 리소스가 복원됩니다. 이 목록에 빈 문자열을 지정해도 네임스페이스가 아닌 클러스터 리소스는 복원되지 않습니다. 클러스터 리소스를 복원하려면 ClusterResourceSelection를 참고하세요.
selectedApplications NamespacedName 배열 복원할 선택된 ProtectedApplication 리소스 목록입니다. 값이 제공되고 Type이 NamespacedResourceSelectionType.SelectedApplications로 설정되면 나열된 애플리케이션 중 하나에 속하는 리소스가 복원됩니다.

NamespacedResourceSelectionType

기본 유형: string 네임스페이스 리소스 선택의 유형입니다.

표시 위치: - NamespacedResourceSelection

네임스페이스

표시 위치: - BackupScope

필드 설명
namespaces 문자열 배열 네임스페이스 목록입니다.

ObjectStorageBackupConfig

객체 스토리지의 백업을 구성합니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 ObjectStorageBackupConfig
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
source ObjectStorageEndpoint 백업할 소스 객체 스토리지입니다.
target ObjectStorageEndpoint 백업이 작성되는 대상입니다.
timestamp 불리언 각 전송을 버킷의 타임스탬프가 지정된 하위 경로에 저장할지 여부를 지정합니다. True로 설정되면 구조는 YYYY-MM-DD-hh:mm:ss입니다. 이렇게 하면 백업의 여러 시점에서 가져온 사본을 저장할 수 있습니다. 기본값은 False입니다.

ObjectStorageEndpoint

객체 스토리지 엔드포인트와 이에 액세스할 수 있는 사용자 인증 정보를 나타냅니다.

표시 위치: - ObjectStorageBackupConfig

필드 설명
endpoint 문자열 객체 스토리지에 액세스하는 데 사용되는 엔드포인트입니다. 예를 들면 https://s3.svc입니다.
bucket 문자열 참조 범위를 지정할 엔드포인트 내 버킷입니다.
secretReference SecretReference 객체 스토리지에 액세스하는 데 사용되는 S3 액세스 사용자 인증 정보에 대한 참조입니다.

PlatformVersion

플랫폼의 버전을 정의합니다.

표시 위치: - ClusterMetadata

필드 설명
gpcVersion 문자열 Google 프라이빗 클라우드 버전입니다.

ReconciliationError

기본 유형: string 백업 저장소의 가장 최근 조정 시도 중에 발생한 오류입니다.

표시 위치: - BackupRepositoryStatus

RepositoryType

기본 유형: string 쓰기 중인 엔드포인트의 유형입니다.

표시 위치: - BackupRepositorySpec

ResourceFilter

후보 리소스 목록을 필터링하여 변환 규칙을 제공하는 규칙을 정의합니다. ResourceFilter가 있는 모든 필드는 선택사항이므로 ResourceFilter 필드를 지정하지 않으면 모든 리소스가 일치합니다.

표시 위치: - TransformationRule

필드 설명
namespaces 문자열 배열 변환 규칙이 적용될 대상 네임스페이스 목록입니다. 변환 후보로 간주되려면 리소스의 원래 네임스페이스가 목록의 이름 중 하나와 일치해야 합니다. 네임스페이스가 지정되지 않은 리소스가 고려되려면 목록에 빈 문자열이 있어야 합니다. 비어 있으면 모든 네임스페이스가 고려됩니다.
groupKinds GroupKind 배열 변환 규칙이 적용될 대상 GroupKind 리소스 목록입니다. 변환 후보로 간주되려면 리소스의 원래 GroupKind 리소스가 목록에 지정된 GroupKind 리소스 중 하나와 일치해야 합니다. 비어 있으면 모든 GroupKind 리소스가 고려됩니다. 리소스가 변환 후보로 간주되려면 Namespaces 요구사항과 GroupKinds 요구사항을 모두 충족해야 합니다.
jsonPath 문자열 필터링할 타겟 리소스의 필드로 이어지는 JSON의 경로를 문자열로 표현한 것입니다. JSONPath 문서는 https://github.com/json-path/JsonPath/blob/master/README.md에서 확인할 수 있습니다. JSONPath 형식은 온라인 (예: https://jsonpath.com/)에서 테스트할 수 있습니다.

ResourceSelector

세분화된 복원 필터의 ResourceSelector를 정의합니다.

표시 위치: - 필터

필드 설명
groupKind GroupKind Kubernetes GroupKind를 사용하여 리소스를 선택합니다. 지정된 경우 제공된 GroupKind의 리소스만 선택됩니다.
name 문자열 리소스 이름을 사용하여 리소스를 선택합니다. 지정된 경우 제공된 이름의 리소스만 선택됩니다.
namespace 문자열 네임스페이스를 사용하여 리소스를 선택합니다. 이는 네임스페이스 범위 리소스에만 적용되며 클러스터 범위 리소스를 선택하는 데는 사용할 수 없습니다. 지정된 경우 제공된 네임스페이스의 리소스만 선택됩니다. 지정하지 않으면 필터가 클러스터 범위 및 네임스페이스 범위 리소스 (예: 이름 또는 라벨) 모두에 적용됩니다. 네임스페이스 내의 리소스가 복원되는 경우에만 네임스페이스 리소스 자체가 복원됩니다.
labels 객체 (키:문자열, 값:문자열) Kubernetes 라벨을 사용하여 리소스를 선택합니다. 지정된 경우 리소스에 제공된 라벨이 모두 있고 모든 라벨 값이 일치하는 경우에만 리소스가 선택됩니다.

복원

Restore API의 스키마를 정의합니다.

표시되는 위치: - RestoreList

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 Restore
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec RestoreSpec
status RestoreStatus

RestoreConfig

복원의 구성을 정의합니다.

표시 위치: - RestorePlanSpec - RestoreSpec

필드 설명
volumeDataRestorePolicy VolumeDataRestorePolicy 볼륨 데이터 복원에 사용할 정책입니다. 값이 지정되지 않은 경우 기본값 NO_VOLUME_DATA_RESTORATION을 제공합니다.
clusterResourceConflictPolicy ClusterResourceConflictPolicy 클러스터 범위 리소스를 복원할 때 충돌을 해결하는 정책입니다. 이 필드가 지정되지 않으면 요청이 유효하지 않습니다. 이 필드의 값이 CLUSTER_RESOURCE_CONFLICT_POLICY_UNSPECIFIED이고 cluster_resource_restore_scope가 지정된 경우 이 요청은 유효하지 않습니다.
namespacedResourceRestoreMode NamespacedResourceRestoreMode 네임스페이스 범위 리소스에 사용할 복원 모드입니다. 이 필드가 지정되지 않으면 요청이 유효하지 않습니다. 이 필드의 값이 NAMESPACED_RESOURCE_RESTORE_MODE_UNSPECIFIED이고 namespaced_resource_restore_scope이 지정된 경우 요청이 잘못되었습니다.
clusterResources ClusterResourceSelection 복원할 네임스페이스가 아닌 리소스입니다. 이 필드를 지정하지 않으면 클러스터 리소스가 복원되지 않습니다. PersistentVolume 리소스는 네임스페이스가 없지만 별도로 처리됩니다. 자세한 내용은 VolumeDataRestorePolicy 리소스를 참고하세요. 이 목록에서 PersistentVolume GroupKind을 지정해도 PersistentVolume이 복원되는지 여부는 결정되지 않습니다.
namespacedResourceAllowlist GroupKind 배열 복원할 특정 네임스페이스 리소스입니다. 정의된 경우 이 allowlist에 정의된 리소스만 복원됩니다.
restoreScope BackupScope 복원할 선택된 네임스페이스 리소스입니다. 유효한 Type와 함께 항목 중 하나를 지정해야 합니다. restoreScope에 할당할 수 있는 유효한 Type 값은 AllNamespaces, SelectedNamespaces 또는 SelectedApplications입니다.
substitutionRules SubstitutionRule 배열 백업된 Kubernetes 리소스의 대체 중에 따르는 규칙입니다. 빈 목록은 대체가 발생하지 않음을 의미합니다. 대체 규칙은 정의된 순서대로 순차적으로 적용됩니다. 규칙에 의해 이루어진 변경사항이 후속 규칙의 일치 로직에 영향을 줄 수 있으므로 순서가 중요합니다. 특정 복원 작업에는 SubstitutionRules 또는 TransformationRules 중 하나만 지정할 수 있습니다.
transformationRules TransformationRule 배열 백업된 Kubernetes 리소스의 변환 중에 따르는 규칙입니다. 빈 목록은 변환이 발생하지 않음을 의미합니다. 변환 규칙은 정의된 순서대로 순차적으로 적용됩니다. 규칙에 의해 변경된 사항이 후속 규칙의 일치 로직에 영향을 줄 수 있으므로 순서가 중요합니다. 특정 복원 작업에는 SubstitutionRules 또는 TransformationRules 중 하나만 지정할 수 있습니다.
backupRepository 문자열 복원 리소스의 저장소를 식별하는 백업 저장소의 T 이름입니다. 이 필드는 읽기-쓰기 모드로 연결해야 합니다. 이 백업 저장소는 이 복원이 참조하는 백업의 백업 저장소와 다를 수 있습니다. 이 필드가 제공되지 않으면 다음 논리를 사용하여 선택됩니다. 1. 복원을 수행하는 백업이 현재 클러스터의 읽기-쓰기 저장소를 가리키는 경우 이 저장소가 선택됩니다. 2. 복원을 수행하는 백업이 읽기 전용 저장소를 가리키는 경우 클러스터의 읽기-쓰기 저장소가 선택되어 사용됩니다.
encryptionKey EncryptionKey 암호화 키. 이 필드는 변경할 수 없습니다.

RestoreList

Restore 리소스 목록이 포함되어 있습니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 RestoreList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items 복원 배열

RestorePlan

RestorePlan API의 스키마를 정의합니다.

표시 위치: - RestorePlanList

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 RestorePlan
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec RestorePlanSpec
status RestorePlanStatus

RestorePlanList

RestorePlan 리소스 목록이 포함되어 있습니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 RestorePlanList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items RestorePlan 배열

RestorePlanSpec

복원 계획에 대해 원하는 상태를 정의합니다.

표시 위치: - RestorePlan

필드 설명
backupPlanName 문자열 이 복원 계획을 사용하여 생성된 복원의 소스로 백업을 사용할 수 있는 백업 계획의 이름입니다. 이 필드는 필수이며 변경할 수 없습니다.
restoreConfig RestoreConfig 이 복원 계획의 복원 구성입니다.
clusterName 문자열 이 복원 계획으로 복원된 데이터를 포함할 클러스터의 이름입니다. 기본적으로 복원 계획이 생성된 클러스터입니다.
description 문자열 이 복원 계획에 대한 사용자 지정 설명 문자열입니다.

RestorePlanStatus

복원 계획의 관찰된 상태를 정의합니다.

표시 위치: - RestorePlan

필드 설명
lastRestoreTime 시간 최근에 실행된 복원의 타임스탬프입니다.
state StatusFields 복원 계획의 현재 상태입니다.

RestoreSpec

복원에 대해 원하는 상태를 정의합니다.

표시 위치: - 복원

필드 설명
backupName 문자열 이 Restore 리소스가 복원하는 데 사용하는 백업 리소스의 전체 이름입니다.
restorePlanName 문자열 이 복원이 RestoreConfig 리소스를 상속받은 복원 계획의 이름입니다.
clusterName 문자열 이 복원으로 복원된 데이터를 포함하는 클러스터의 이름입니다. 기본적으로 복원이 생성된 클러스터입니다.
restoreConfig RestoreConfig 복원의 구성입니다.
description 문자열 백업에 대한 설명(선택사항)입니다. 기능에는 영향을 미치지 않습니다.
filter 필터 필터를 사용하면 RestorePlan에 정의된 대략적인 범위를 넘어 복원의 리소스 선택을 추가로 세분화할 수 있습니다.

RestoreState

기본 유형: string

표시 위치: - RestoreStatus

RestoreStatus

복원의 관찰된 상태를 정의합니다.

표시 위치: - 복원

필드 설명
state RestoreState 복원의 현재 상태입니다.
stateReason 문자열 복원이 현재 상태인 이유에 대해 사람이 읽을 수 있는 설명입니다.
errorStatus ErrorStatus 관찰된 시간이 포함된 가장 최근 오류입니다.
conditions Condition 배열 Conditions는 이 복원의 현재 상태에 대한 관찰 결과를 나타냅니다. 알려진 조건 유형: 성공
jobCreated 불리언 이 복원에 대해 복원 작업이 생성되었는지 여부를 지정합니다.
resourcesRestoredCount 정수 이 복원 작업에서 복원된 리소스 수입니다.
resourcesExcludedCount 정수 이 복원 작업에서 제외된 리소스 수입니다.
resourcesFailedCount 정수 이 복원 작업에서 복원하지 못한 리소스 수입니다.
restoredVolumesCount 정수 이 복원 작업에서 복원된 볼륨 수입니다.
startTime 시간 복원 프로세스의 생성 시간입니다.
completeTime 시간 복원 프로세스의 종료 시간입니다.

RetentionPolicy

이 백업 계획에 따라 생성된 백업을 자동으로 삭제할 시점, 계획 수준 최소 백업 보관 일수, 보관할 계획 수준 최소 백업 수, 정책 업데이트를 허용하지 않는 잠금을 결정하는 정책을 정의합니다.

표시 위치: - BackupPlanSpec

필드 설명
backupDeleteLockDays 정수 이 백업 계획에 따라 생성된 백업의 삭제가 차단되는 기간(일수)입니다. 기본값은 0입니다. 이 필드는 0-90 사이의 정수 값이어야 합니다. 이 백업 계획에 따라 생성된 백업은 백업의 create_time 및 backup_delete_lock_days의 합계에 도달할 때까지 삭제할 수 없습니다. 이 백업 계획 필드를 업데이트해도 이 필드에 속한 기존 백업에는 영향을 미치지 않습니다. 업데이트가 완료된 후 생성된 백업은 새 값을 자동으로 상속합니다.
backupRetainDays 정수 서비스에서 백업을 삭제하는 경과 일수입니다. 지정된 경우 이 백업 계획에 따라 생성된 백업은 create_time와 backup_retain_days의 합계에 도달하면 자동으로 삭제됩니다. 지정하지 않으면 이 백업 계획에 따라 생성된 백업은 자동 삭제되지 않습니다. 이 필드를 업데이트해도 기존 백업에는 영향을 미치지 않습니다. 업데이트가 완료된 후 생성된 백업은 새 값을 자동으로 상속합니다. 생성 또는 업데이트 시 backup_retain_days 값이 backup_delete_lock_days보다 작으면 유효하지 않은 것으로 간주되어 요청이 즉시 거부됩니다.
locked 불리언 이 백업 계획의 보관 정책이 잠겨 있는지 여부를 지정합니다. True로 설정하면 locked 필드 자체를 포함하여 이 정책에 대한 추가 업데이트가 허용되지 않습니다. 기본값은 False입니다.
numBackupsToRetain 정수 보관할 백업 수입니다. 지정된 경우 create_time 및 backup_delete_lock_days are automatically deleted after the total number of backups under this backup plan reaches the value ofnum_backups_to_retain'의 결합된 값에 도달한 백업 계획의 가장 오래된 백업입니다. 지정되지 않은 경우 이 백업 계획에 따라 생성된 백업은 'backup_retain_days'에 따라 자동 삭제될 수도 있고 그렇지 않을 수도 있습니다. 이 필드를 업데이트하면 백업 계획의 기존 백업에 영향을 미칩니다. num_backups_to_retain은 backup_delete_lock_days 내에 생성할 수 있는 백업 수 이상이어야 합니다.

S3Options

백업 저장소의 S3 엔드포인트 호출 옵션을 정의합니다.

표시 위치: - BackupRepositorySpec

필드 설명
bucket 문자열 백업을 업로드할 엔드포인트 내의 버킷입니다.
region 문자열 특정 엔드포인트의 리전입니다. 형식은 스토리지 시스템에 따라 다릅니다.
forcePathStyle 불리언 객체에 대해 경로 스타일 URL을 강제할지 여부를 지정합니다. 예를 들어 https://.s3.amazonaws.com/ 대신 https://s3.amazonaws.com//를 사용합니다.
serverSideEncryption 문자열 객체를 저장할 때 사용되는 서버 측 암호화 알고리즘입니다. 예를 들어 AES256 oraws:kms`입니다.
kmsKeyId 문자열 서버 측 암호화에서 KMS를 사용하는 경우 객체 스토리지에 사용할 KMS 키 ID입니다.

일정

크론 일정을 정의하는 내부 메시지 유형을 나타냅니다.

표시 위치: - BackupPlanSpec

필드 설명
cronSchedule 문자열 작업이 실행되는 크론 문자열 일정입니다.
paused 불리언 예약된 작업이 비활성 상태인지 활성 상태인지 지정합니다. True로 설정하면 예약된 작업이 비활성 상태가 됩니다. 기본값은 True입니다.
maxConcurrency 정수 백업 계획에 동시에 존재할 수 있는 활성 예약 백업의 최대 개수를 지정합니다. 지정된 경우 이 백업 계획의 예약된 백업이 특정 시점에 활성 상태일 수 있는 최대 개수입니다. 지정하지 않으면 기본값은 2입니다.

주

기본 유형: string 백업 계획의 현재 상태를 지정하는 값입니다.

표시 위치: - BackupPlanStatus

SubstitutionRule

대체 규칙을 정의합니다.

표시 위치: - RestoreConfig

필드 설명
target SubstitutionTarget 리소스가 대체 후보인지, 제공된 JSONPath 값과 일치하는 필드가 있는지 확인하는 일치 기준입니다.
originValuePattern 문자열 제공된 Target 값에서 일치하는 JSON 값에 적용되는 정규 표현식 패턴 문자열입니다. 지정하지 않으면 지정된 NewValue 값을 사용하여 항상 원래 값이 대체됩니다. 빈 문자열은 적법한 정규식 패턴이며 다른 문자열과 마찬가지로 처리됩니다.
newValue 문자열 대체할 원하는 값(문자열 형식)입니다.

SubstitutionTarget

대체할 타겟 후보의 규칙을 정의합니다.

표시 위치: - SubstitutionRule

필드 설명
namespaces 문자열 배열 대체 규칙이 적용되는 대상 네임스페이스 목록입니다. 리소스의 원래 네임스페이스는 대체 후보로 간주되려면 목록의 이름 중 하나와 일치해야 합니다. 네임스페이스가 지정되지 않은 리소스를 고려하려면 빈 문자열을 제공해야 합니다. 비어 있으면 모든 네임스페이스가 고려됩니다.
groupKinds GroupKind 배열 대체 규칙이 적용되는 대상 GroupKind 리소스 목록입니다. 리소스의 원래 GroupKind 리소스는 대체 후보로 간주되려면 목록에 지정된 GroupKind 리소스 중 하나와 일치해야 합니다. 비어 있으면 모든 GroupKind 리소스가 고려됩니다. 리소스가 대체 후보로 간주되려면 네임스페이스 요구사항과 GroupKind 요구사항을 모두 충족해야 합니다.
jsonPath 문자열 대체를 위해 JSON 형식인 타겟 리소스의 필드로 이어지는 JSON 경로의 문자열 표현입니다.

TargetCluster

데이터가 백업되거나 복원될 클러스터를 나타냅니다.

표시 위치: - ClusterBackupPlanSpec - ClusterBackupSpec - ClusterRestorePlanSpec - ClusterRestoreSpec - ClusterVolumeBackupSpec - ClusterVolumeRestoreSpec

필드 설명
targetClusterType TargetClusterType 클러스터 유형
targetClusterName TypedLocalObjectReference UserCluster의 경우 이름은 clusters.cluster.gdc.goog 그룹 종류 아래 동일한 네임스페이스 내의 GDC 클러스터를 나타냅니다. 관리 API의 경우 이 필드를 비워 두어야 합니다.

TargetClusterType

기본 유형: string

표시 위치: - TargetCluster

TransformationRule

jsonPatch를 활용하는 변환 규칙을 정의합니다.

표시 위치: - RestoreConfig

필드 설명
fieldActions TransformationRuleAction 배열 JSON 패치 RFC에 따라 후보 리소스에 대해 실행할 작업 목록입니다.
resourceFilter ResourceFilter 리소스가 변환 후보인지 여부를 확인하는 일치 기준입니다. 빈 resourceFilter 값은 모든 리소스와 일치합니다.

TransformationRuleAction

사용자가 리소스를 변환하는 과정에서 수행하고자 하는 작업을 나타냅니다.

표시 위치: - TransformationRule

필드 설명
op TransformationRuleOperation 복원 작업 시 리소스를 변환하는 과정에서 사용자가 수행하려는 작업의 유형입니다. 유효한 작업 목록은 https://www.rfc-editor.org/rfc/rfc6902#section-4.4에서 확인할 수 있습니다.
from 문자열 이동 및 복사 작업의 타겟 리소스에 있는 필드로 이어지는 JSON 내 경로의 JSON 패치 표현입니다.
path 문자열 일부 작업의 경우 대상 리소스의 필드로 이어지는 JSON 내 경로의 JSON 패치 표현입니다.
value 문자열 변환에 사용할 문자열 형식의 원하는 값입니다.

TransformationRuleOperation

기본 유형: string 변환 규칙의 의도된 작업입니다.

표시 위치: - TransformationRuleAction

VMBackupJobList

백업 목록을 포함합니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 VMBackupJobList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items VMBackupJob 배열

VMBackupJobSpec

백업에 대해 원하는 상태를 정의합니다.

표시 위치: - VMBackupJob

필드 설명
backupRef NamespacedName VM 백업 작업과 관련된 컨트롤 플레인 백업 이름입니다. 이름은 변경할 수 없습니다.
vmRef NamespacedName 이 CR이 백업하는 VM의 참조입니다. 백업이 디스크 백업인 경우 이 참조는 nil일 수 있습니다.
vmDiskRefs VMDisk 배열 이 CR이 백업하는 VM 디스크 목록
volumeBackupRefs object (keys:string, values:VolumeBackup) 이 백업 아래의 볼륨 백업 이름과 VolumeBackup 구조체의 매핑입니다. 이 데이터는 VMBackupJob에 삽입되며 클러스터에는 없습니다.
description 문자열 백업에 대한 선택적 문자열 설명입니다. 이 필드는 기능에 영향을 미치지 않습니다.
manual 불리언 백업 리소스가 수동으로 생성되었는지 여부를 지정합니다. True인 경우 이 백업이 수동으로 생성된 것입니다. False인 경우 이 백업이 백업 계획 일정에서 자동으로 생성된 것입니다.
deleteLockDays 정수 이 백업의 create_time부터 삭제가 차단되는 일수입니다. 백업 일정에서 자동으로 생성된 백업의 경우 이 필드는 BackupPlan.RetentionPolicy.backup_delete_block_days 값으로 설정됩니다. 이 필드를 지정하지 않고 수동으로 생성된 백업의 경우 서비스에서 BackupPlan.RetentionPolicy.backup_delete_block_days 값을 할당합니다. 이 필드의 값이 BackupPlan.RetentionPolicy.backup_delete_block_days 값보다 작은 백업이 생성되면 서비스에서 잘못된 응답이 반환됩니다. 이 필드는 0-90 사이의 정수 값이어야 합니다. 이 필드는 업데이트 요청에 의해서만 증가해야 하며, 그렇지 않으면 서비스에서 잘못된 응답을 반환합니다. 이 필드는 Succeeded 상태의 백업에만 적용됩니다. 기본값은 0입니다.
retainDays 정수 이 백업을 보관할 일수입니다. 이 기간이 지나면 백업이 자동으로 삭제됩니다. 이는 백업의 create_time에서 계산됩니다. 이 필드를 지정하지 않거나 0로 설정하면 백업이 자동으로 삭제되지 않습니다. 백업 일정에서 자동으로 생성된 백업의 경우 이 필드에 BackupPlan.RetentionPolicy.backup_retain_days 값이 할당됩니다. 이 필드를 지정하지 않고 수동으로 생성된 백업의 경우 서비스에서 BackupPlan.RetentionPolicy.backup_retain_days 값을 할당합니다. 이 필드의 값이 delete_lock_days 값보다 작은 백업이 생성되면 서비스에서 잘못된 응답이 반환됩니다. 이 필드는 업데이트 요청에 의해서만 증가해야 하며, 그렇지 않으면 서비스에서 잘못된 응답을 반환합니다. 기본값은 0입니다.

VMBackupJobStatus

백업의 관찰된 상태를 정의합니다.

표시 위치: - VMBackupJob

필드 설명
state VMBackupJobState 백업의 현재 상태입니다.
reason 문자열 백업이 현재 상태인 이유에 대해 사람이 읽을 수 있는 설명입니다.
errorStatus ErrorStatus 관찰된 시간이 포함된 가장 최근 오류입니다.
conditions Condition 배열 Conditions는 이 VMBackupJob의 현재 상태에 대한 관찰 결과를 나타냅니다. 알려진 조건 유형: 성공
createTime 시간 이 VMBackupJob 리소스가 생성된 시점의 타임스탬프입니다. RFC 3339로 변환되거나 RFC 3339에서 변환될 수 있습니다.
snapshotTime 시간 VMBackupJob 리소스의 모든 디스크가 스냅샷된 시간입니다. RFC 3339로 변환되거나 RFC 3339에서 변환될 수 있습니다.
updateTime 시간 이 VMBackupJob이 마지막으로 업데이트된 시점의 타임스탬프입니다. RFC 3339로 변환되거나 RFC 3339에서 변환될 수 있습니다.
volumeCount 정수 백업된 볼륨의 총수입니다.
retryCount 정수 이 VM/VM 디스크를 백업하는 데 필요한 총 재시도 횟수
deleteLockExpireTime 시간 삭제 잠금이 만료되는 시간입니다. create_time 및 delete_lock_days의 결합된 값에서 계산되는 출력 전용 필드이며 백업의 delete_lock_days 필드가 업데이트되면 이에 따라 업데이트됩니다. 이 필드는 Succeeded 상태의 백업에만 적용됩니다.
retainExpireTime 시간 백업이 자동으로 삭제되는 시간입니다. create_time 및 retain_days의 결합된 값에서 계산되는 출력 전용 필드이며 백업의 retain_days 필드가 업데이트되면 이에 따라 업데이트됩니다.
completeTime 시간 백업 완료 시간입니다.

VMDisk

표시 위치: - VMBackupJobSpec

필드 설명
namespace 문자열 VM 디스크가 있는 네임스페이스
name 문자열 VM 디스크 이름
pvcName 문자열 기본 PVC의 이름
uid UID 이 필드는 PVC의 UID를 사용하여 이 특정 VMBackupJob을 가져오는 데 사용되는 PVC의 UID입니다.
sizeBytes 정수 총 크기(바이트)입니다.

VolumeBackup

VolumeBackup API의 스키마를 정의합니다.

표시 위치: - VMBackupJobSpec - VolumeBackupList

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 VolumeBackup
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec VolumeBackupSpec
status VolumeBackupStatus

VolumeBackupFormat

기본 유형: string 볼륨 백업 형식을 지정하는 enum입니다.

표시 위치: - VolumeBackupStatus

VolumeBackupList

VolumeBackup 리소스 목록이 포함되어 있습니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 VolumeBackupList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items VolumeBackup 배열

VolumeBackupSpec

볼륨 백업에 대해 원하는 상태를 정의합니다.

표시 위치: - VolumeBackup

필드 설명
clusterName 문자열 이 볼륨 백업이 데이터를 유지하는 클러스터의 이름입니다. 기본적으로 이 볼륨 백업이 생성된 클러스터입니다.
backupName 문자열 연결된 백업의 이름입니다. 각 볼륨 백업은 백업과 연결되어야 합니다.
backupPlanName 문자열 연결된 백업이 생성된 백업 계획의 이름입니다.
sourcePVC NamespacedName 볼륨 백업이 가져온 소스 영구 볼륨 클레임입니다.
volumeBackupHandle 문자열 볼륨 백업 저장소 내에서 볼륨 백업을 고유하게 식별하는 기본 볼륨 백업 핸들입니다. 이 핸들은 통합된 형식이 없으며 불투명 문자열로 처리됩니다. 지원 중단됨: 대신 상태 필드를 사용하세요.

VolumeBackupState

기본 유형: string 볼륨 백업의 현재 상태를 제안하는 열거형입니다.

표시 위치: - VolumeBackupStatus

VolumeBackupStatus

관찰된 볼륨 백업 상태를 정의합니다.

표시 위치: - VolumeBackup

필드 설명
volumeBackupHandle 문자열 볼륨 백업 저장소 내에서 볼륨 백업을 고유하게 식별하는 기본 볼륨 백업 핸들입니다. 이 핸들은 통합된 형식이 없으며 불투명 문자열로 처리됩니다.
format VolumeBackupFormat 볼륨 백업 형식입니다. 예를 들어 PD, Portable 등이 있습니다.
storageBytes 정수 백업 스토리지에 있는 볼륨 백업의 크기입니다. 증분 백업의 경우 이전 볼륨 백업 중 하나가 삭제되면 이 값이 동적으로 변경될 수 있습니다.
diskSizeBytes 정수 이 볼륨 백업을 복원할 수 있는 디스크의 최소 크기입니다.
state VolumeBackupState 볼륨 백업의 현재 상태입니다.
message 문자열 백업이 이 상태인 이유에 대한 세부정보를 나타내는 인간이 읽을 수 있는 메시지입니다.
completeTime 시간 이 VolumeBackup 리소스가 완료된 타임스탬프입니다(RFC 3339 텍스트 형식).
errorStatus ErrorStatus 관찰된 시간이 포함된 가장 최근 오류입니다.
conditions Condition 배열 Conditions는 이 VolumeBackup의 현재 상태에 대한 관찰 결과를 나타냅니다.

VolumeDataRestorePolicy

기본 유형: string 다양한 볼륨 데이터 복원 정책입니다.

표시 위치: - RestoreConfig - RestorePolicies

VolumeRestore

VolumeRestore API의 스키마를 정의합니다.

표시 위치: - VolumeRestoreList

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 VolumeRestore
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec VolumeRestoreSpec
status VolumeRestoreStatus

VolumeRestoreList

VolumeRestore 리소스 목록이 포함되어 있습니다.

필드 설명
apiVersion 문자열 backup.gdc.goog/v1
kind 문자열 VolumeRestoreList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items VolumeRestore 배열

VolumeRestoreSpec

볼륨 복원의 원하는 상태를 정의합니다.

표시 위치: - VolumeRestore

필드 설명
clusterName 문자열 이 볼륨 복원의 데이터가 포함된 클러스터의 이름입니다. 기본적으로 이 볼륨 복원이 생성된 클러스터입니다.
restoreName 문자열 이 볼륨 복원을 만든 복원 리소스의 이름입니다.
volumeBackupName 문자열 복원할 볼륨 백업 리소스의 이름입니다.
targetPvc NamespacedName 복원할 타겟 PersistentVolumeClaim 리소스입니다.

VolumeRestoreStatus

볼륨 복원의 관찰된 상태를 정의합니다.

표시 위치: - VolumeRestore

필드 설명
volumeBackupHandle 문자열 볼륨 백업 저장소 내에서 볼륨 백업을 고유하게 식별하는 기본 볼륨 백업 핸들입니다. 이 핸들은 통합된 형식이 없으며 불투명 문자열로 처리됩니다.
state VolumeRestoreState 볼륨 복원의 현재 상태입니다.
stateMessage 문자열 현재 상태에 대한 인간이 읽을 수 있는 설명입니다.
conditions Condition 배열 Conditions는 이 볼륨 복원의 현재 상태에 대한 관찰 결과를 나타냅니다. 알려진 조건 유형: Ready
completeTime 시간 볼륨 복원 프로세스의 종료 시간입니다.

VolumeStrategy

기본 유형: string 볼륨을 백업할 때 사용할 절충안입니다.

표시 위치: - BackupConfig