KRM API backup.gdc.goog/v1

backup.gdc.goog/v1

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，建立的 BackupRepository 會是「ReadWrite」。如果叢集是在 ReadOnlyClusters 清單中建立，則為「ReadOnly」。這個欄位無法變更。
readWriteCluster NamespacedName	ReadWriteCluster 會指定單一叢集 (baremetal.cluster.gke.io/Cluster)，該叢集有權使用 BackupRepositorySpec 欄位中的資料建立 ReadWrite 備份存放區。ReadWrite 存放區可用於排定/建立備份、備份方案和還原作業，且實際上由建立該存放區的叢集擁有。注意：最多只能有一個 k8s 叢集將 BackupRepository 設為 ReadWrite。這個欄位可變更。
readOnlyClusters NamespacedName 陣列	ReadOnlyClusters 會指定叢集清單 (baremetal.cluster.gke.io/Cluster)，這些叢集有權使用 BackupRepositorySpec 欄位中的資料，建立 ReadOnly 備份存放區。ReadOnly 存放區只能用於匯入及查看備份。您無法在這個存放區中建立新的備份/資源，但還原作業可以參考唯讀備份。用於從其他叢集匯入備份，以進行跨叢集還原。BackupRepository 可做為 ReadOnly 使用的次數沒有限制。這個欄位可變更。

BackupRepositoryManagerStatus

BackupRepositoryManagerStatus 定義 BackupRepositoryManager 的觀察狀態

顯示位置： - BackupRepositoryManager

欄位	說明
backupCount 整數	BackupCount 是指 BackupRepositorySpec 指向的儲存空間 bucket 內建立的備份總數。
backupPlanCount 整數	BackupPlanCount 是指 BackupRepositorySpec 指向的儲存空間值區內建立的備份方案總數。
restoreCount 整數	RestoreCount 是指 BackupRepositorySpec 指向的儲存空間值區內建立的還原總數。
restorePlanCount 整數	RestorePlanCount 是指在 BackupRepositorySpec 指向的儲存空間值區中建立的還原方案總數。
clusterStatuses ClusterStatus 陣列	ClusterStatuses 包含在每個叢集中建立所需備份存放區的目前狀態。清單會包含 ReadOnlyClusters 清單中指定的所有叢集項目，以及 ReadWriteCluster。如果叢集中的備份儲存空間成功建立，ClusterStatuses 陣列中的項目會將「Ready」條件設為「True」，否則會設為「False」。
conditions 條件	條件會指出備份存放區管理工具及其建立的備份存放區是否處於健康狀態。
errorStatus ErrorStatus	包括與觀察時間對帳時發生的最新錯誤。

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 的值，服務會傳回無效的回應。這個欄位只能透過更新要求增加，否則服務會傳回無效的回應。

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。
clusterBackupRepositoryName 字串	ClusterBackupRepositoryRef 資源的名稱，用於識別這個 ClusterBackupPlan 資源的次要儲存空間。
includeVolumeData boolean	指出是否備份磁碟區資料。如未設定，預設值為 false。
includeSecrets boolean	指出是否備份密碼。如未設定，預設值為 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 boolean	指出方案是否已停用。將這個欄位設為「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 boolean	指定讀寫備份存放區的動作，如果初始化時使用的儲存空間值區已由其他備份存放區聲明擁有，則會採取這個動作。如果 True，新的備份儲存庫仍會取代現有的 Sentinel 檔案，並使用自己的 Sentinel 檔案，聲明擁有儲存空間值區。如果 False，建立新備份存放區的作業會失敗並顯示錯誤。預設值為 False。只有在覆寫的信號檔案不再有備份存放區時，才必須使用這項功能，否則備份存放區會進入錯誤狀態，可能導致不良的副作用。

ClusterBackupRepositoryStatus

定義 ClusterBackupRepository 資源的觀察狀態。

顯示位置： - ClusterBackupRepository

欄位	說明
sentinelEtag 字串	這個欄位會將備份存放區連結至其擁有的 Sentinel 檔案。
reconciliationError ReconciliationError	備份存放區最近一次嘗試對帳時發生的錯誤。
reconciliationErrorMessage 字串	對帳期間可能發生的錯誤訊息。
errorStatus ErrorStatus	包括與觀察時間對帳時發生的最新錯誤。
conditions Condition 陣列	指定叢集備份存放區的狀態。支援的條件包括 InitialImportDone。

ClusterBackupSpec

代表包裝 backupv1.Backup 自訂資源的 API。兩者大致相同，但部分欄位會選擇性省略。

顯示位置： - ClusterBackup

欄位	說明
targetCluster TargetCluster	要備份的叢集名稱。
clusterBackupPlanName 字串	建立這個備份的叢集備份方案名稱。
backupConfig ClusterBackupConfig	從指定備份方案產生這項備份時使用的設定。這項資訊必須從產生叢集備份的叢集備份方案複製，而非參考。使用者不得設定這個欄位，只能由備份方案排程器和 ManualBackupRequest 資源設定。
description 字串	備份的選用字串說明。這個欄位不會影響功能。
manual boolean	指出叢集備份資源是否為手動建立。如果為 True，表示這項備份是手動建立；如果為 False，表示這項叢集備份是根據備份方案排程自動建立。
retentionPolicy BackupRetentionPolicy	備份的保留政策。

ClusterBackupStatus

定義叢集備份的觀察狀態。

顯示位置： - ClusterBackup

欄位	說明
clusterMetadata ClusterMetadata	叢集中繼資料。
conditions Condition 陣列	指定叢集備份的狀態。支援的條件包括 JobCreated。
jobCreated boolean	指出是否已為這個叢集備份建立備份作業。
state BackupState	叢集備份的目前狀態。
stateReason 字串	使用者可理解的說明，指出備份作業目前處於這種狀態的原因。
errorStatus ErrorStatus	最近發生的錯誤，包括觀察到的時間。
createTime 時間	建立這項備份資源的時間戳記。這項設定可轉換為 RFC 3339，反之亦然。
updateTime 時間	上次更新這個叢集備份的時間戳記。這項設定可轉換為 RFC 3339，反之亦然。
resourceCount 整數	備份的資源總數。
volumeCount 整數	備份的磁碟區總數。
sizeBytes 整數	總大小 (以位元組為單位)。
podCount 整數	備份的工作負載 Pod 總數。
deleteLockExpireTime 時間	刪除鎖定到期時間。這是僅供輸出的欄位，由 create_time 和 delete_lock_days 的合併值計算而來，且會在叢集備份的 delete_lock_days 欄位更新時一併更新。請注意，這個欄位僅適用於 Succeeded 狀態的叢集備份。
retainExpireTime 時間	叢集備份自動刪除的時間。這是唯有輸出內容的欄位，由 create_time 和 retain_days 的合併值計算而來，且會在叢集備份的 retain_days 欄位更新時一併更新。
completeTime 時間	叢集備份完成時間。

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。
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 的文字格式。

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 資源。

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 陣列

DeleteClusterBackupRequestSpec

定義 DeleteClusterBackupRequest 資源的所需狀態。

出現位置： - DeleteClusterBackupRequest

欄位	說明
clusterBackupRef 字串	要刪除的 ClusterBackup 資源名稱。請注意，ClusterBackup 資源必須與 DeleteClusterBackupRequest 資源位於相同命名空間。

DeleteClusterBackupRequestStatus

定義 DeleteClusterBackupRequest 資源的觀察狀態。

出現位置： - DeleteClusterBackupRequest

欄位	說明
timeToExpire 時間	資源到期時間。
statusField StatusFields	DeleteClusterBackupRequest 資源的觀察狀態。

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 中定義的粗略範圍。

TargetCluster

代表要備份或還原資料的叢集。

顯示於： - ClusterBackupPlanSpec - ClusterBackupSpec - ClusterRestorePlanSpec - ClusterRestoreSpec - ClusterVolumeBackupSpec - ClusterVolumeRestoreSpec

欄位	說明
targetClusterType TargetClusterType	叢集類型
targetClusterName TypedLocalObjectReference	如果是 UserCluster，名稱是指 clusters.cluster.gdc.goog Group Kind 底下相同命名空間內的 GDC 叢集。如果是 Management API，請將這個欄位留空。

TargetClusterType

基礎類型： string

顯示位置： - TargetCluster