KRM API virtualmachine.gdc.goog/v1

virtualmachine.gdc.goog/v1

包含 virtualmachine.gdc.goog v1 API 群組的 API 結構定義。

AccessManagementConfig

指定訪客環境中的 AccessManagement 功能設定。

出現位置： - GuestEnvironment

欄位	說明
enable boolean	指定是否要在 VM 的訪客環境中enableAccessManagement這項功能。如要瞭解欄位的預設值，請參閱 GuestEnvironment 欄位說明。

運算

指定 VM 的 CPU 和記憶體屬性。您必須只指定 vcpus 和 memory，或只指定 VirtualMachineType。

指定 vcpus 但未指定 memory，或反過來，都會建立無效的組合。指定 virtualMachineType，同時指定 vcpus 或 memory，或兩者皆指定，也會建立無效組合。

出現位置： - VirtualMachineSpec

欄位	說明
virtualMachineType 字串	指定參照 VirtualMachineType 的名稱。參照必須使用預先定義的名稱或黃金 VirtualMachineType 名稱。
vcpus 整數	指定執行個體可用的 VCPU 數量。將 vcpus 指定為整數。這個值必須是 2 的倍數，最小值為 2，最大值為 128。
memory 數量	指定執行個體可用的實體記憶體量。記憶體必須至少為 1Gi，最多可達 (含) 400Gi。

DiskAttachment

代表 VirtualMachine 與 VirtualMachineDisk 之間的附件關係。

出現位置： - VirtualMachineSpec

欄位	說明
boot boolean	指定這個磁碟是否為 VirtualMachine 的開機裝置。只能有一個標示為 boot 的磁碟。
autoDelete boolean	指定是否要在刪除 VirtualMachine 時刪除磁碟。AutoDelete 僅在磁碟連接至 VirtualMachine 時適用。如果 .spec.disks 不再參照 VirtualMachineDisk，該生命週期就會與 VirtualMachine 解除連結。
virtualMachineDiskRef LocalObjectReference	參照同一個 namespace 中的 VirtualMachineDisk。

DiskReplicationStatus

出現位置： - VirtualMachineDiskStatus

欄位	說明
role ReplicationRole	這個磁碟在複製關係中的角色。有效值為「primary」和「secondary」。
primaryDisk ReplicatedDiskInfo	如果這個磁碟是次要磁碟，則為複製來源的主要磁碟。主要磁碟會是空值。
secondaryDisk ReplicatedDiskInfo	這個磁碟要複製到的次要磁碟 (如果這個磁碟是主要磁碟)。次要磁碟則為空值。
volumeReplicationRelationship 字串	管理複寫作業的磁碟區複寫關係物件名稱。
conditions Condition 陣列	複寫狀態的最新觀察結果。
errorStatus ErrorStatus	列出複製期間發生的所有錯誤。

DiskSource

定義磁碟的來源。指定要用來填入磁碟的支援來源，且只能指定一個。

出現位置： - VirtualMachineDiskSpec

欄位	說明
image ImageDiskSource	表示磁碟是從磁碟映像檔建立。

FilterSpec

定義精細還原篩選器。

出現位置： - VirtualMachineRestoreRequestSpec

欄位	說明
targetedVirtualMachines VirtualMachineResourceConfig 陣列	需要還原的 VM 集合。這些 VM 應屬於同一個 VirtualMachineRestoreRequest 中提供的 VirtualMachineBackup 資源。
targetedVirtualMachineDisks VirtualMachineResourceConfig 陣列	需要還原的 VMDisk 集合。這些 VMDisk 應屬於同一個 VirtualMachineRestoreRequest 中提供的 VirtualMachineBackup 資源。
virtualMachineDiskOptions VirtualMachineDiskFilterOptions	指定還原磁碟的篩選器選項。指定這個欄位不會還原 VirtualMachines，只會根據 VirtualMachineDiskFilterOptions 中選取的欄位還原 VirtualMachineDisks。如果指定 TargetedVirtualMachines 或 TargetedVirtualMachineDisks 其中之一，則不應指定這個欄位。

韌體

指定開機時的 VM 初始化選項。

出現位置： - VirtualMachineSpec

欄位	說明
type 字串	指定要透過 UEFI 或 BIOS 啟動。預設值為 bios。已淘汰：請改用 ShieldConfig.BootType。
enableSecureBoot boolean	啟用或停用系統啟動載入程式憑證驗證。這有助於防止載入經過修改或惡意的程式碼。如果 type 為 uefi，則預設值為 true。如果 type 設為 bios，預設值為 false，且無法修改，因為 BIOS 無法驗證開機載入程式憑證。已淘汰：請改用 ShieldConfig.EnableSecureBoot。

GCSReference

代表要儲存映像檔的 GCS 來源。

出現位置： - VirtualMachineImageSpec

欄位	說明
url 字串	GCS 物件的網址。

GuestEnvironment

指定訪客環境設定。

出現位置： - VirtualMachineSpec

欄位	說明
accessManagement AccessManagementConfig	指定存取權管理設定。

IPAddress

顯示於： - NetworkInterfaceSpec

欄位	說明
address 字串	IP 位址。在 GDC 連線中，位址可能包含子網路遮罩。如未加入子網路遮罩，系統會預設為 /32。舉例來說，1.2.3.4 會視為 1.2.3.4/32。或者，輸入內容也可以是 1.2.3.4/24。在 GDC airgapped 中，位址可能不包含子網路遮罩。子網路資訊是從 Subnet 物件擷取而來。
managed boolean	與這個 IP 位址相關聯的子網路生命週期是否應由 GDC airgapped 系統管理。在 GDC connected 中未使用。如果為 true (預設值)，系統會自動為這個 IP 建立子網路，並在刪除 VM 時刪除子網路。如果為 false，使用者必須已建立子網路，且子網路必須處於就緒狀態。

ImageDestinationReference

上傳圖片內容的目標位置。 只能指定一個目的地。僅支援 GDC Connected 部署作業。 如果指定的 ImageSourceReference 為 GCS，則此欄位為必填欄位。

出現位置： - VirtualMachineImageImportSpec

欄位	說明
gcs ImageGCSDestinationReference	圖片的 bucket 詳細資料 (已填入 GCS)。

ImageDiskSource

圖片來源的參照。

顯示位置： - DiskSource

欄位	說明
name 字串	VirtualMachineImage API 物件的名稱。
namespace 字串	VirtualMachineImage API 物件的命名空間。如要使用黃金圖片，請使用 vm-system。如果是目前專案中的圖片，請將此值設為空白，或使用目前的 namespace 值。

ImageGCSDestinationReference

代表要匯入圖片的 GCS 目的地。

顯示於： - ImageDestinationReference

欄位	說明
bucketName 字串	儲存這個映像檔的 GCS Bucket 名稱。

ImageGCSSourceReference

代表要從中匯入映像檔的 GCS 來源。

顯示於： - ImageSourceReference

欄位	說明
bucketName 字串	儲存這個映像檔的 GCS Bucket 名稱。
objectName 字串	值區中的圖片名稱。

ImageMetadataInput

VirtualMachineImage 的規格。

出現位置： - VirtualMachineImageImportSpec

欄位	說明
name 字串	圖片名稱，例如 ubuntu-20.04-server-cloudimg。
operatingSystem OSName	這個映像檔所屬的 OS 名稱，例如 ubuntu-2004。
minimumDiskSize 數量	可套用映像檔的磁碟大小下限。這只會指定從這個映像檔建立的未來磁碟建議大小。這並非圖片本身的尺寸，如果圖片是從物件儲存空間匯入，則此為必填欄位。

ImageObjectStorageSourceReference

代表要從中匯入圖片的物件儲存空間來源。

顯示於： - ImageSourceReference

欄位	說明
bucketRef LocalObjectReference	儲存這張圖片的Bucket自訂資源名稱。Bucket 自訂資源必須與這個物件位於相同命名空間。
objectName 字串	值區中的圖片名稱。

ImagePrepareOptions

代表圖片準備作業的選項。

出現位置： - VirtualMachineImageImportSpec

欄位	說明
installGuestEnvironment boolean	指出是否要安裝 GDC 無網路連線的訪客環境。預設值為 true。

ImageSourceReference

指向用於填入圖片內容的資源。 只能指定一個來源。

出現位置： - VirtualMachineImageImportSpec

欄位	說明
diskRef LocalObjectReference	指定從現有 VirtualMachineDisk 填入圖片的時間。
objectStorage ImageObjectStorageSourceReference	從物件儲存空間填入的圖片值區詳細資料。
gcs ImageGCSSourceReference	從 gcs 填入的圖片值區詳細資料。

NetworkInterfaceSpec

指定網路介面設定。 在 GDC 連線中，只能指定網路和 IPAddresses。 在 GDC 氣隙環境中，必須指定「網路」、「子網路」或「IPAddresses」其中一項。您可以選擇同時指定子網路和 IP 位址。

顯示於： - NetworkSpec

欄位	說明
network 字串	介面連線的網路。在 GDC airgapped 中，有效值為：default、multicast。
subnet 字串	介面在 GDC 氣隙隔離環境中連線的子網路。在 GDC connected 中未使用。如未指定，則預設為指定網路的預設子網路。
subnetNamespace 字串	介面在 GDC 氣隙中連線的子網路命名空間。在 GDC connected 中未使用。如果未指定，預設為與 VirtualMachine 相同的命名空間。
ipAddresses IPAddress 陣列	要指派給介面的 IP 位址。系統只會將第一個 IP 位址指派給介面。在 GDC airgapped 中，如果未指定 IP 位址，系統會動態分配。在 GDC 連線中，如果網路設定為使用外部 DHCP 伺服器，這個欄位可選擇性地用於指定靜態位址。如果網路未設定為使用外部 DHCP 伺服器，則必須填寫這個欄位。

NetworkInterfaceStatus

NetworkInterfaceStatus 是 NetworkInterface 資源的狀態。

顯示位置： - NetworkStatus

欄位	說明
name 字串	名稱是指 VM 內公開的網路介面名稱，例如「eth0」、「eth1」。
ipAddresses 字串陣列	IpAddresses 是指派給 NetworkInterface 的 IP 位址。
macAddress 字串	MacAddress 是指派給 NetworkInterface 的 MAC 位址。

NetworkPerformanceSpec

顯示於： - NetworkSpec

欄位	說明
highThroughputMode boolean	是否為 GDC 氣隙 VM 中的所有介面啟用高輸送量最佳化功能。在 GDC connected 中未使用。如果為 true，系統會使用多佇列等功能提升網路效能。預設值為 false。

NetworkSpec

指定網路設定。

出現位置： - VirtualMachineSpec

欄位	說明
interfaces NetworkInterfaceSpec 陣列	連結至 VM 的網路介面。如果未指定任何單點傳播介面，系統會自動新增 default 介面。啟用多點播送的機構使用者可以新增 multicast 介面。在 VM 內設定預設路徑時，系統會將指定的第一個介面視為預設介面。
performanceSpec NetworkPerformanceSpec	指定高效能網路的設定。

NetworkStatus

NetworkStatus 是虛擬機器的網路狀態。

出現位置： - VirtualMachineStatus

欄位	說明
interfaces NetworkInterfaceStatus 陣列

OSName

基本類型： string 可使用的有效作業系統清單。

顯示於： - ImageMetadataInput - OperatingSystemSpec

OperatingSystemSpec

包含映像檔的作業系統資訊。

出現位置： - VirtualMachineImageSpec

欄位	說明
name OSName	這個映像檔所屬的 OS 名稱，例如「windows-2016」。

ReplicatedDiskInfo

顯示於： - DiskReplicationStatus

欄位	說明
name 字串	VirtualMachineDisk 執行個體的名稱。
zone 字串	VirtualMachineDisk 執行個體的可用區。

SSHSpec

儲存用於建立連線的 SSH 憑證。

顯示於： - VirtualMachineAccessRequestSpec

欄位	說明
key 字串	指定要為安全殼層存取權設定的公開金鑰。
ttl 時間長度	指定金鑰的有效時間長度，以小時、分鐘和秒為單位。預設值為 24h0m0s。

ServicePort

ServicePort 包含服務通訊埠的相關資訊。

出現位置： - VirtualMachineExternalAccessSpec

欄位	說明
name 字串	服務中這個通訊埠的名稱。
protocol 通訊協定	這個通訊埠的 IP 通訊協定。支援「TCP」、「UDP」和「SCTP」。
port 整數	這項服務公開的通訊埠。

ShieldConfig

指定 VM 的安全性相關設定。

出現位置： - VirtualMachineSpec

欄位	說明
bootType 字串	指定要透過 UEFI 或 BIOS 啟動。預設值為 bios。
enableSecureBoot boolean	啟用或停用系統啟動載入程式憑證驗證。這有助於防止載入經過修改或惡意的程式碼。如果 bootType 為 uefi，則預設值為 true。如果 bootType 設為 bios，預設值為 false，且無法修改，因為 BIOS 無法進行開機載入程式憑證驗證。
enableVtpm boolean	是否要模擬 VTPM 裝置。預設值為 false。

StartupScript

定義 VM 的開機指令碼。 支援以純文字字串或 Kubernetes 密鑰形式指定啟動指令碼。如果指定 script 欄位，則不應提供 scriptSecretRef 欄位，反之亦然。

出現位置： - VirtualMachineSpec

欄位	說明
name 字串	指定指令碼名稱。必須符合 [\w][\w\-.]* 正規運算式，且不得超過 255 個字元。如要為 Windows VM 指定指令碼，名稱必須包含「-」，後面加上指令碼副檔名做為後置字串。舉例來說，如果 Powershell 指令碼名為 hello-world，請使用 hello-world-ps1 這個名稱。
script 字串	指定包含指令碼的純文字字串。指令碼內容大小必須小於 2048 個位元組。
scriptSecretRef LocalObjectReference	參照內含指令碼的 Kubernetes Secret。ScriptSecretRef 名稱必須與 Kubernetes 密鑰名稱相符。

VMMError

所有 VMM 錯誤的包裝函式，包括錯誤代碼。

顯示於： - VirtualMachineAccessRequestStatus - VirtualMachineDiskStatus - VirtualMachineExternalAccessStatus - VirtualMachineImageImportStatus - VirtualMachineImageStatus - VirtualMachinePasswordResetRequestStatus - VirtualMachineStatus

欄位	說明
code 字串	錯誤代碼。其中包含字母前置字元，後面接著四位數的數字代碼。
message 字串	使用者可理解的錯誤訊息。

VirtualMachine

代表虛擬機器的設定和狀態。

顯示位置： - VirtualMachineList

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachine
metadata ObjectMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
spec VirtualMachineSpec
status VirtualMachineStatus

VirtualMachineAccessRequest

代表 VM 的存取要求。

出現位置： - VirtualMachineAccessRequestList

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineAccessRequest
metadata ObjectMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
spec VirtualMachineAccessRequestSpec
status VirtualMachineAccessRequestStatus

VirtualMachineAccessRequestList

包含 VirtualMachineAccessRequest 物件清單。

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineAccessRequestList
metadata ListMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
items VirtualMachineAccessRequest 陣列

VirtualMachineAccessRequestSpec

定義 VirtualMachineAccessRequest 規格。

出現位置： - VirtualMachineAccessRequest

欄位	說明
vm 字串	指定要存取的 VM 名稱。
user 字串	指定存取 VM 的使用者名稱。
ssh SSHSpec	保存用於存取 VM 的 SSH 憑證。

VirtualMachineAccessRequestState

基礎類型：string VirtualMachineAccessRequest 的狀態。

出現位置： - VirtualMachineAccessRequestStatus

VirtualMachineAccessRequestStatus

說明 VirtualMachineAccessRequest 的狀態。

出現位置： - VirtualMachineAccessRequest

欄位	說明
state VirtualMachineAccessRequestState	指定 VirtualMachineAccessRequest 的狀態。
reason 字串	指出目前狀態的原因。
message 字串	提供目前狀態的額外背景資訊。
processedAt 時間	指定處理要求的時間。
errors VMMError 陣列	資源對帳期間發生的任何錯誤清單。

VirtualMachineAttachment

內含此 VirtualMachineDisk 所附加的 VirtualMachine 相關資訊，以及附加方式。

出現位置： - VirtualMachineDiskStatus

欄位	說明
nameRef LocalObjectReference	附加 VirtualMachine 的名稱。
uid UID	附加 VirtualMachine 的 UID。
autoDelete boolean	反映 VirtualMachine 如何附加這個磁碟。當所有附加的 VM 都將 autoDelete 設為 true，且所有 VM 都已刪除時，系統就會刪除磁碟。如果至少有一個 VM 將 autoDelete 設為 false，系統就不會刪除磁碟。

VirtualMachineBackup

VirtualMachineBackups API 的結構定義。

出現位置： - VirtualMachineBackupList

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineBackup
metadata ObjectMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
spec VirtualMachineBackupSpec
status VirtualMachineBackupStatus

VirtualMachineBackupConfig

包含執行備份的設定詳細資料，包括範圍、位置和磁碟區備份策略。

出現位置： - VirtualMachineBackupPlanSpec - VirtualMachineBackupSpec

欄位	說明
backupRepository 字串	識別這個 VirtualMachineBackupPlan 的次要儲存位置。這個欄位僅供內部使用。只能透過 VirtualMachineBackupPlanTemplate 提供備份存放區
backupScope VirtualMachineBackupScope	指定此 VirtualMachineBackupPlan 涵蓋的資源。
volumeStrategy VolumeStrategy	宣告用於備份磁碟區的策略；例如，使用本機快照，而非遠端或供應商專屬備份。

VirtualMachineBackupList

包含 VirtualMachineBackup 清單。

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineBackupList
metadata ListMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
items VirtualMachineBackup 陣列

VirtualMachineBackupPlan

VirtualMachineBackupPlans API 的結構定義。

顯示位置： - VirtualMachineBackupPlanList

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineBackupPlan
metadata ObjectMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
spec VirtualMachineBackupPlanSpec
status VirtualMachineBackupPlanStatus

VirtualMachineBackupPlanList

包含 VirtualMachineBackupPlan 清單。

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineBackupPlanList
metadata ListMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
items VirtualMachineBackupPlan 陣列

VirtualMachineBackupPlanSpec

定義 VirtualMachineBackupPlan，其中提供建立基礎 BackupPlan 資源和執行備份的 ProtectedApplication 指令。

顯示於： - VirtualMachineBackupPlan

欄位	說明
virtualMachineBackupPlanTemplate 字串	VirtualMachineBackupPlanTemplate 必須與這項 VM 備份方案位於相同 namespace。
backupConfig VirtualMachineBackupConfig	定義備份的設定和範圍。
backupSchedule 時間表	根據這個 VM 備份方案排定建立的備份。排程是可變動的欄位，建立後可以編輯。根據預設，VM 備份方案會暫停
retentionPolicy RetentionPolicy	依據這項方案建立的備份生命週期。根據預設，備份可刪除，且沒有任何鎖定期間。根據預設，備份不會依據自動排程刪除，且保留政策可修改。

VirtualMachineBackupPlanStatus

定義 VirtualMachineBackupPlan 的觀察狀態。

顯示於： - VirtualMachineBackupPlan

欄位	說明
backupPlan 字串	這個 VirtualMachineBackupPlan 管理的基礎備份方案名稱，用於 GDC 氣隙 Org v1 架構。
backupPlanStatus BackupPlanStatus	基礎備份方案的內嵌狀態。
configBackupPlan 字串	這個 VirtualMachineBackupPlan 管理的基礎設定備份方案名稱。此處的「設定」是指 VM 和 VM 磁碟，用於 GDC 零間隙 Org v2 架構。
volumeBackupPlan 字串	這個 VirtualMachineBackupPlan 管理的基礎磁碟區備份計畫名稱，用於 GDC 零間隙 Org v2 架構。
lastBackupTime 時間	最近一次執行備份作業的時間戳記。這個欄位用於排定下次備份時間
nextBackupTime 時間	下次排定備份作業的時間戳記。這個欄位用於排定下次備份時間
lastReconcileTime 時間	這項資源上次對帳的時間戳記。
errorMessage 字串	ErrorMessage 包含上次對帳嘗試期間發生的錯誤訊息。這個欄位為選填，只有在發生錯誤時才會填入資料。

VirtualMachineBackupPlanTemplate

VirtualMachineBackupPlanTemplates API 結構定義。

出現位置： - VirtualMachineBackupPlanTemplateList

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineBackupPlanTemplate
metadata ObjectMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
spec VirtualMachineBackupPlanTemplateSpec
status VirtualMachineBackupPlanTemplateStatus

VirtualMachineBackupPlanTemplateList

包含 VirtualMachineBackupPlanTemplate 清單。

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineBackupPlanTemplateList
metadata ListMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
items VirtualMachineBackupPlanTemplate 陣列

VirtualMachineBackupPlanTemplateSpec

定義 VirtualMachineBackupPlans 用於衍生通用參數的範本。

出現位置： - VirtualMachineBackupPlanTemplate

欄位	說明
backupRepository 字串	BackupRepository 資源的名稱。

VirtualMachineBackupRequest

VirtualMachineBackupRequests API 的結構定義。

出現位置： - VirtualMachineBackupRequestList

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineBackupRequest
metadata ObjectMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
spec VirtualMachineBackupRequestSpec
status VirtualMachineBackupRequestStatus

VirtualMachineBackupRequestList

包含 VirtualMachineBackupRequest 清單。

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineBackupRequestList
metadata ListMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
items VirtualMachineBackupRequest 陣列

VirtualMachineBackupRequestSpec

定義 VirtualMachineBackupRequest 的所需狀態。

出現位置： - VirtualMachineBackupRequest

欄位	說明
virtualMachineBackupPlanTemplate 字串	用來產生 VirtualMachineBackupPlan 的 VirtualMachineBackupPlanTemplate 資源名稱。如果已有透過這個範本建立的 VirtualMachineBackupPlan，系統會重複使用。VirtualMachineBackupPlanTemplate 必須與此要求位於相同 namespace。請只指定一個 VirtualMachineBackupPlanTemplate 或 VirtualMachineBackupPlan。
virtualMachineBackupPlan 字串	如果提供這個欄位，則這項要求用於臨時要求的虛擬機器備份計畫應省略備份範圍 VirtualMachine 和 VirtualMachineDisk 欄位。VirtualMachineBackupPlan 必須與這項要求位於相同的 namespace。
virtualMachine 字串	要備份的 VirtualMachine。這項設定會與 VirtualMachineBackupPlanTemplate 搭配使用，在沒有 VirtualMachineBackupPlan 時自動產生 VirtualMachineBackupPlan。請只指定一個 VirtualMachine 或 VirtualMachineDisk。如果指定 virtualMachine，備份策略一律為 ProvisionerSpecific。
virtualMachineDisk 字串	正在備份的 VirtualMachineDisk。這項功能會與 VirtualMachineBackupPlanTemplate 搭配使用，在沒有 VirtualMachineBackupPlan 時自動產生 VirtualMachineBackupPlan。如果指定要備份 virtualMachineDisk，備份策略為 SnapshotOnly。請只指定一個 VirtualMachine 或 VirtualMachineDisk。
virtualMachineBackupName 字串	要建立的 VirtualMachineBackup 名稱。備份作業一律會在與要求相同的命名空間中建立。

VirtualMachineBackupRequestStatus

定義 VirtualMachineBackupRequest 的觀察狀態。

出現位置： - VirtualMachineBackupRequest

欄位	說明
timeToExpire 時間	何時會刪除這項暫時性資源。
statusField StatusFields	說明 VirtualMachineBackupRequest 的觀察狀態

VirtualMachineBackupScope

定義 VirtualMachineBackupPlan 要擷取的資源範圍。

出現位置： - VirtualMachineBackupConfig

欄位	說明
selectedVirtualMachines VirtualMachineResourceConfig 陣列	指定要擷取 VirtualMachineBackupPlan 的 VM。
selectedVirtualMachineDisks VirtualMachineResourceConfig 陣列	指定要擷取這個 VirtualMachineBackupPlan 的磁碟。
vmResourceLabelSelector 物件 (鍵：字串，值：字串)	指定標籤，在與備份方案相同的命名空間中選取一或多個 VM 或 VM 磁碟資源

VirtualMachineBackupSpec

定義 VirtualMachineBackup 的所需狀態。

出現位置： - VirtualMachineBackup

欄位	說明
virtualMachineBackupPlan 字串	建立這個 VirtualMachineBackup 的 VirtualMachineBackupPlan 名稱。這個 VirtualMachineBackupPlan 與 VirtualMachineBackupPlan 位於同一個 namespace。
backupConfig VirtualMachineBackupConfig	定義備份的設定和範圍。

VirtualMachineBackupStatus

定義 VirtualMachineBackup 的觀察狀態。

出現位置： - VirtualMachineBackup

欄位	說明
backup 字串	這個 VirtualMachineBackup 參照的基礎備份名稱。備份必須與這個 VM 備份位於相同的 namespace，用於 GDC 氣隙式機構 v1 架構。
backupStatus BackupStatus	這個 VirtualMachineBackup 參照的基礎備份狀態，用於 GDC 氣隙隔離 Org v1 架構。
configBackup 字串	VirtualMachineBackup 參照的基礎設定備份名稱。設定參照 VM 和 VM 磁碟。設定備份必須與這個 VM 備份位於相同的 namespace，並用於 GDC 無網路連線的 Org v2 架構。
configBackupStatus BackupStatus	這個 VirtualMachineBackup 參照的基礎設定備份狀態，用於 GDC 離線 Org v2 架構。
volumeBackup 字串	這個 VirtualMachineBackup 參照的基礎磁碟區備份名稱。磁碟區備份必須與這個 VM 備份位於相同的 namespace，用於 GDC 氣隙式機構 v2 架構。
volumeBackupStatus BackupStatus	VirtualMachineBackup 參照的基礎磁碟區備份狀態，適用於 GDC 氣隙隔離 Org v2 架構。
backedUpVirtualMachines 字串陣列	列出這個備份中包含的所有 VM 名稱。
backedUpVirtualMachineDisks 字串陣列	列出這個備份中包含的所有 VM 磁碟名稱。如果這是磁碟快照備份，則為您提供的 VM 磁碟清單。如果是 VM 備份，則為支援該 VM 的磁碟清單。

VirtualMachineDeleteBackupRequest

VirtualMachineDeleteBackupRequests API 的結構定義。

出現位置： - VirtualMachineDeleteBackupRequestList

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineDeleteBackupRequest
metadata ObjectMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
spec VirtualMachineDeleteBackupRequestSpec
status VirtualMachineDeleteBackupRequestStatus

VirtualMachineDeleteBackupRequestList

包含 VirtualMachineDeleteBackupRequest 清單。

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineDeleteBackupRequestList
metadata ListMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
items VirtualMachineDeleteBackupRequest 陣列

VirtualMachineDeleteBackupRequestSpec

定義 VirtualMachineDeleteBackupRequest 的所需狀態。

出現位置： - VirtualMachineDeleteBackupRequest

欄位	說明
virtualMachineBackupRef LocalObjectReference	要刪除的 VirtualMachineBackup 名稱。這項要求一律會在與備份相同的 namespace 中建立。

VirtualMachineDeleteBackupRequestStatus

定義 VirtualMachineDeleteBackupRequest 的觀察狀態。

出現位置： - VirtualMachineDeleteBackupRequest

欄位	說明
timeToExpire 時間	定義刪除這項暫時性資源的時間。
statusField StatusFields	說明 VirtualMachineDeleteBackupRequest 的觀察狀態。

VirtualMachineDisk

virtualmachinedisks API 的結構定義。

出現位置： - VirtualMachineDiskList

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineDisk
metadata ObjectMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
spec VirtualMachineDiskSpec
status VirtualMachineDiskStatus

VirtualMachineDiskFilterOptions

指定還原磁碟的篩選器選項。

顯示於： - FilterSpec

欄位	說明
allDisks boolean	指定要還原 VirtualMachineBackup 中的所有磁碟。

VirtualMachineDiskList

包含 VirtualMachineDisk 清單。

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineDiskList
metadata ListMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
items VirtualMachineDisk 陣列

VirtualMachineDiskSpec

定義 VirtualMachineDisk 的所需狀態。

出現位置： - VirtualMachineDisk

欄位	說明
source DiskSource	指定要從哪個來源填入磁碟內容。如果省略這個欄位，系統會佈建空白磁碟。
size 數量	指定磁碟大小，例如 5GiB、600MiB 等。空白磁碟必須指定大小。如果是其他來源的磁碟，大小取決於來源。如果是圖片來源，大小為選用屬性，系統會推斷大小相當於 Image.spec.minimumDiskSize。如果指定大小，則必須大於 Image.spec.minimumDiskSize。
type DiskType	指定磁碟類型。預設值為 Standard。在 GDC 實體隔離方案中，支援的類型為：Standard、Local。在 GDC connected 中，支援的類型為：Standard。

VirtualMachineDiskStatus

定義 VirtualMachineDisk 的觀察狀態。

出現位置： - VirtualMachineDisk

欄位	說明
phase VirtualMachineDiskPhase	磁碟的目前階段。
progress VirtualMachineDiskProgress	進度是磁碟佈建的目前進度。介於 0 到 100 之間 (含 0 和 100) 的值，如果無法取得則為 N/A。
size 數量	磁碟目前的大小。
conditions Condition 陣列	VirtualMachineDisk 狀態的最新觀察結果。
virtualMachineAttachments VirtualMachineAttachment 陣列	VirtualMachine 所連結的 VirtualMachineDisk 執行個體清單。
replicationStatus DiskReplicationStatus	磁碟複製狀態。
provisionTime 時間長度	佈建 VirtualMachineDisk 並達到 Ready 狀態所需的時間。佈建 VirtualMachineDisk 並達到 Ready 狀態所需的時間。例如下載圖片所花費的時間等。
errors VMMError 陣列	資源對帳期間發生的任何錯誤清單。

VirtualMachineExternalAccess

代表虛擬機器的外部 VRF 存取要求。

出現位置： - VirtualMachineExternalAccessList

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineExternalAccess
metadata ObjectMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
spec VirtualMachineExternalAccessSpec
status VirtualMachineExternalAccessStatus

VirtualMachineExternalAccessList

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineExternalAccessList
metadata ListMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
items VirtualMachineExternalAccess 陣列

VirtualMachineExternalAccessSpec

定義 VirtualMachineExternalAccess 物件的規格。

出現位置： - VirtualMachineExternalAccess

欄位	說明
enabled boolean	指定 VirtualMachine 是否可存取外部 VRF。
ports ServicePort 陣列	VirtualMachine 進入服務公開的通訊埠清單。

VirtualMachineExternalAccessStatus

定義 VirtualMachineExternalAccess 物件的觀察狀態。

出現位置： - VirtualMachineExternalAccess

欄位	說明
ingressIP 字串	IngressIP 會指定 VirtualMachine Ingress 服務的 IP 位址。
egressIP 字串	EgressIP 會指定 VirtualMachine 使用的輸出 NAT IP 位址。
conditions Condition 陣列	觀察到的狀態詳細資料。
errors VMMError 陣列	資源對帳期間發生的任何錯誤清單。

VirtualMachineImage

代表可用於虛擬機器的磁碟映像檔。

顯示位置： - VirtualMachineImageList

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineImage
metadata ObjectMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
spec VirtualMachineImageSpec
status VirtualMachineImageStatus

VirtualMachineImageImport

代表匯入及轉換含有資料的 VM 資源作業，例如匯入及轉換「VirtualMachineDiskinto aVirtualMachineImage」。

顯示於： - VirtualMachineImageImportList

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineImageImport
metadata ObjectMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
spec VirtualMachineImageImportSpec
status VirtualMachineImageImportStatus

VirtualMachineImageImportList

VirtualMachineImageImport 物件的清單。

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineImageImportList
metadata ListMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
items VirtualMachineImageImport 陣列

VirtualMachineImageImportSpec

指定要建立的圖片來源和中繼資料。

出現位置： - VirtualMachineImageImport

欄位	說明
source ImageSourceReference	指內容的匯入來源資源。來源必須來自相同命名空間。
destination ImageDestinationReference	指內容匯入的資源。僅支援 GDC Connected 部署作業。如果指定的 ImageSourceReference 為 GCS，則此欄位為必填欄位。
imageMetadata ImageMetadataInput	指定要建立的 VirtualMachineImage 屬性。
prepareImage boolean	指定是否要準備此映像檔，以用於 GDC 無網路連線部署作業，例如安裝必要套件。如未指定，只有在映像檔來自物件儲存空間時，才會進行準備作業。
prepareOptions ImagePrepareOptions	以下是圖片準備作業的選項。只有在 prepareImage 為 true 時，這項設定才有效。

VirtualMachineImageImportStatus

提供圖片匯入狀態。

出現位置： - VirtualMachineImageImport

欄位	說明
conditions Condition 陣列	提供匯入進度的 Ready 狀態。
imageName 字串	成功建立後，請參閱 VirtualMachineImage。圖片與圖片匯入作業位於相同命名空間。
errors VMMError 陣列	資源對帳期間發生的任何錯誤清單。

VirtualMachineImageList

包含 VirtualMachineImage 物件清單。

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineImageList
metadata ListMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
items VirtualMachineImage 陣列

VirtualMachineImageSpec

定義虛擬機器映像檔的規格。

出現位置： - VirtualMachineImage

欄位	說明
operatingSystem OperatingSystemSpec	作業系統詳細資料。
minimumDiskSize 數量	可套用映像檔的磁碟最小大小。這項設定只會指定從這個映像檔建立的未來磁碟建議大小。這並非圖片本身的大小。
gcs GCSReference	這是指儲存圖片的 GCS 資源。

VirtualMachineImageStatus

包含 VirtualMachineImage 物件的觀察狀態。

出現位置： - VirtualMachineImage

欄位	說明
conditions Condition 陣列	虛擬機器映像檔的條件。
errors VMMError 陣列	資源對帳期間發生的任何錯誤清單。
storageLocation 字串	儲存這個虛擬機器映像檔的區域。

VirtualMachineList

包含 VirtualMachine 物件清單。

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineList
metadata ListMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
items VirtualMachine 陣列

VirtualMachinePasswordResetRequest

代表特定 VM 的密碼重設要求。

顯示於： - VirtualMachinePasswordResetRequestList

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachinePasswordResetRequest
metadata ObjectMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
spec VirtualMachinePasswordResetRequestSpec
status VirtualMachinePasswordResetRequestStatus

VirtualMachinePasswordResetRequestList

包含 VirtualMachinePasswordResetRequest 資源清單。

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachinePasswordResetRequestList
metadata ListMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
items VirtualMachinePasswordResetRequest 陣列

VirtualMachinePasswordResetRequestSpec

定義 VirtualMachinePasswordResetRequest 規格。

出現位置： - VirtualMachinePasswordResetRequest

欄位	說明
vmName 字串	要要求重設密碼的 VM 名稱。這個欄位不可變動，建立密碼重設要求後就無法更新。
user 字串	要為指定 VM 重設密碼的使用者名稱。這個欄位不可變動，建立密碼重設要求後就無法更新。
publicKey 字串	用於加密 VM 新密碼的公開金鑰。這個欄位不可變動，建立密碼重設要求後就無法更新。

VirtualMachinePasswordResetRequestState

基礎型別： string 定義 VirtualMachinePasswordResetRequest 資源的狀態。

出現位置： - VirtualMachinePasswordResetRequestStatus

VirtualMachinePasswordResetRequestStatus

說明 VirtualMachinePasswordResetRequest 資源的狀態。

出現位置： - VirtualMachinePasswordResetRequest

欄位	說明
state VirtualMachinePasswordResetRequestState	VirtualMachinePasswordResetRequest 資源的狀態。
reason 字串	資源目前狀態的原因。
message 字串	提供目前狀態額外資訊的欄位。
processedAt 時間	指定要求處理時間的欄位。
encryptedPassword 字串	使用要求中提供的公開金鑰加密，並以 Base64 編碼的新密碼。如要解密密碼，請使用 Base64 解碼字串，然後使用 RSA 解密結果。
errors VMMError 陣列	資源對帳期間發生的任何錯誤清單。

VirtualMachineProvisionTime

追蹤 VirtualMachine 的佈建時間。

出現位置： - VirtualMachineStatus

欄位	說明
initProvisionTime 時間長度	佈建第一個 VM 所需的時間，也就是從建立物件到 VM 處於執行狀態所需的時間。
lastProvisionTime 時間長度	最近一次佈建 VM 所花的時間。如果 VM 只佈建一次，則可等於 InitProvisionTime。

VirtualMachineResourceConfig

指定 VM 資源和備份該資源的其他參數。

顯示於： - FilterSpec - VirtualMachineBackupScope

欄位	說明
resourceName 字串	要備份的資源名稱。必須與方案位於相同namespace。

VirtualMachineRestore

VirtualMachineRestores API 的架構。

出現位置： - VirtualMachineRestoreList

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineRestore
metadata ObjectMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
spec VirtualMachineRestoreSpec
status VirtualMachineRestoreStatus

VirtualMachineRestoreList

包含 VirtualMachineRestore 清單。

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineRestoreList
metadata ListMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
items VirtualMachineRestore 陣列

VirtualMachineRestoreRequest

VirtualMachineRestoreRequests API 的架構。

顯示於： - VirtualMachineRestoreRequestList

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineRestoreRequest
metadata ObjectMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
spec VirtualMachineRestoreRequestSpec
status VirtualMachineRestoreRequestStatus

VirtualMachineRestoreRequestList

包含 VirtualMachineRestoreRequest 清單。

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineRestoreRequestList
metadata ListMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
items VirtualMachineRestoreRequest 陣列

VirtualMachineRestoreRequestSpec

定義 VirtualMachineRestoreRequest 的所需狀態。

出現位置： - VirtualMachineRestoreRequest

欄位	說明
virtualMachineBackup 字串	要還原的 VM 備份名稱。VirtualMachineBackup 與這個 VirtualMachineRestoreRequest 位於同一個 namespace。
restoreName 字串	為建立的 VirtualMachineRestore 資源命名。
restoredResourceName 字串	還原資源時，VirtualMachineBackup 會為資源加上前置字串。還原的資源名稱會是前置字串 + 備份資源名稱。
restoredResourceDescription 字串	新建立資源的說明。
filter FilterSpec	還原期間可用於縮小 VM 資源選取範圍的篩選器。

VirtualMachineRestoreRequestStatus

定義 VirtualMachineRestoreRequest 的觀察狀態。

出現位置： - VirtualMachineRestoreRequest

欄位	說明
timeToExpire 時間	何時會刪除這項暫時性資源。
statusField StatusFields	說明 VirtualMachineRestoreRequest 的觀察狀態。

VirtualMachineRestoreSpec

定義 VirtualMachineRestore 的所需狀態。

出現位置： - VirtualMachineRestore

欄位	說明
virtualMachineBackup 字串	這個 VirtualMachineRestore 正在還原的 VM 備份名稱。VirtualMachineBackup 與這個 VirtualMachineRestore 位於同一個 namespace。
targetVirtualMachines 字串陣列	基礎還原作業成功時建立的所有 VM 清單。
targetVirtualMachineDisks 字串陣列	還原作業成功後建立的所有 VM 磁碟清單。

VirtualMachineRestoreStatus

定義 VirtualMachineRestore 的觀察狀態。

出現位置： - VirtualMachineRestore

欄位	說明
restore 字串	VirtualMachineRestore 參照的基礎還原作業名稱。還原作業必須在與這個 VM 備份檔相同的 namespace 中進行，且用於 GDC 無網路連線的機構 v1 架構。
restoreStatus RestoreStatus	這個 VirtualMachineRestore 參照的基礎還原作業狀態。用於 GDC 實體隔離機構 v1 架構。
configRestore 字串	VirtualMachineRestore 參照的基礎設定還原名稱。設定參照 VM 和 VM 磁碟。設定還原作業必須與這個 VM 還原作業位於相同的 namespace，用於 GDC 無網路連線的 Org v2 架構。
configRestoreStatus RestoreStatus	VirtualMachineRestore 參照的基礎設定還原狀態，用於 GDC 無網路連線 Org v2 架構。
volumeRestore 字串	VirtualMachineRestore 參照的基礎磁碟區還原作業名稱。磁碟區還原作業必須與這個 VM 還原作業位於相同的 namespace，並用於 GDC 無網路連線的 Org v2 架構。
volumeRestoreStatus RestoreStatus	此 VirtualMachineRestore 參照的基礎磁碟區還原狀態，用於 GDC 氣隙 Org v2 架構。

VirtualMachineSpec

定義虛擬機器的規格。

出現位置： - VirtualMachine

欄位	說明
runningState VirtualMachineRunningState	指出 VirtualMachine 的要求執行狀態。預設值為「Running」。
disks DiskAttachment 陣列	指定附加至這個 VM 的磁碟清單。只能有一個開機磁碟。磁碟附件變更需要重新啟動才能生效。
compute 運算	指定 VM 的 CPU 和記憶體。CPU 和記憶體可以直接定義，也可以透過 VirtualMachineType 定義。變更 Compute 設定後，必須重新啟動裝置才會生效。VM 處於 Unknown 狀態時，運算資源無法變更。
startupScripts StartupScript 陣列	指定 VM 的開機指令碼清單。Linux VM 必須安裝 cloud-init，StartupScripts 才會生效。系統會按照每個啟動指令碼的名稱，依字母順序執行指令碼。在 Windows VM 中，指令碼類型會影響執行順序。系統會依序執行 ps1、bat 和 cmd 指令碼。如果兩個指令碼屬於相同類型，系統會依名稱的字母順序執行。
guestEnvironment GuestEnvironment	指定 VM 的客體環境設定。如果該欄位為空值，則 AccessManagement 中的 enable 欄位預設為 true。否則，結構中每個子功能的非空值設定都會覆寫子功能的預設設定。
firmware Firmware	指定開機時的 VM 初始化選項。
shieldConfig ShieldConfig	指定 VM 的安全性相關設定。
network NetworkSpec	指定網路設定。

VirtualMachineStatus

包含虛擬機器的觀察狀態。

出現位置： - VirtualMachine

欄位	說明
state VirtualMachineState	虛擬機器的觀察狀態。
reason VirtualMachineStateReason	VM 處於觀察狀態的原因。如果觀察到的狀態適用，則會填入。
message 字串	VM 狀態的其他詳細資料。
network NetworkStatus	VM 網路的狀態。
conditions Condition 陣列	觀察到的狀態詳細資料。
stateTransitionTime 物件 (鍵：VirtualMachineState，值：Time)	每個狀態的上次轉換時間。
provisionTime VirtualMachineProvisionTime	佈建 VM 所需的時間。
errors VMMError 陣列	資源對帳期間發生的任何錯誤清單。

VirtualMachineType

定義 VM 的 CPU 和記憶體資源。

出現位置： - VirtualMachineTypeList

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineType
metadata ObjectMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
spec VirtualMachineTypeSpec
status VirtualMachineTypeStatus

VirtualMachineTypeList

VirtualMachineTypeList 包含 VirtualMachineType 清單。

欄位	說明
apiVersion 字串	virtualmachine.gdc.goog/v1
kind 字串	VirtualMachineTypeList
metadata ListMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
items VirtualMachineType 陣列

VirtualMachineTypeSpec

定義 VirtualMachineType 的設定。

出現位置： - VirtualMachineType

欄位	說明
vcpus 整數	指定執行個體可用的 VCPU 數量。請將 vcpus 指定為介於 2 至 128 之間的整數，且必須是 2 的倍數。
memory 數量	指定執行個體可用的實體記憶體量。memory 的值必須介於 1G 到 400G 之間 (含首尾)。

VirtualMachineTypeStatus

出現位置： - VirtualMachineType

欄位	說明
supported boolean	指定基礎硬體是否支援指定的 vmtype