KRM API virtualmachine.gdc.goog/v1

virtualmachine.gdc.goog/v1

包含 virtualmachine.gdc.goog v1 API 组的 API 架构定义。

AccessManagementConfig

指定了客机环境中的 AccessManagement 功能配置。

来源： - GuestEnvironment

字段	说明
enable 布尔值	指定是否在虚拟机的 guest 环境中启用 AccessManagement 功能。enable如需了解该字段的默认值，请参阅 GuestEnvironment 字段说明。

计算

指定虚拟机的 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 布尔值	指定相应磁盘是否为 VirtualMachine 的启动设备。必须正好有一个标记为 boot 的磁盘。
autoDelete 布尔值	指定在删除 VirtualMachine 时是否应删除相应磁盘。AutoDelete 仅在磁盘连接到 VirtualMachine 时适用。当 .spec.disks 中不再引用 VirtualMachineDisk 生命周期时，该生命周期会与 VirtualMachine 解耦。
virtualMachineDiskRef LocalObjectReference	指同一 namespace 中的 VirtualMachineDisk。

DiskReplicationStatus

显示在： - VirtualMachineDiskStatus

字段	说明
role ReplicationRole	相应磁盘在复制关系中的角色。有效值为“primary”和“secondary”。
primaryDisk ReplicatedDiskInfo	此磁盘所复制自的主磁盘（如果此磁盘是辅助磁盘）。对于主磁盘，此值为 nil。
secondaryDisk ReplicatedDiskInfo	相应磁盘正在复制到的辅助磁盘（如果相应磁盘是主磁盘）。对于辅助磁盘，此值为 nil。
volumeReplicationRelationship 字符串	管理复制的卷复制关系对象的名称。
conditions 条件数组	复制状态的最新观测结果。
errorStatus ErrorStatus	复制期间发生的任何错误的列表。

DiskSource

定义磁盘的来源。指定一个受支持的来源，用于填充磁盘。

显示在： - VirtualMachineDiskSpec

字段	说明
image ImageDiskSource	表示磁盘是通过磁盘映像创建的。

FilterSpec

定义精细恢复过滤器。

来源： - VirtualMachineRestoreRequestSpec

字段	说明
targetedVirtualMachines VirtualMachineResourceConfig 数组	需要恢复的虚拟机集。这些虚拟机应是 VirtualMachineBackup 资源的一部分，该资源在同一 VirtualMachineRestoreRequest 中提供。
targetedVirtualMachineDisks VirtualMachineResourceConfig 数组	需要恢复的 VMDisk 的集合。这些 VMDisk 应该是 VirtualMachineBackup 资源的一部分，该资源在同一 VirtualMachineRestoreRequest 中提供。
virtualMachineDiskOptions VirtualMachineDiskFilterOptions	指定用于恢复磁盘的过滤条件选项。指定此字段不会恢复 VirtualMachines，只会根据 VirtualMachineDiskFilterOptions 中所选的字段恢复 VirtualMachineDisks。如果指定了 TargetedVirtualMachines 或 TargetedVirtualMachineDisks，则不应指定此字段。

固件

指定启动时的虚拟机初始化选项。

显示在： - VirtualMachineSpec

字段	说明
type 字符串	指定是通过 UEFI 还是 BIOS 启动。默认为 bios。 已弃用：请改用 ShieldConfig.BootType。
enableSecureBoot 布尔值	启用或停用启动加载程序证书验证。这有助于阻止加载修改过或恶意的代码。如果 type 为 uefi，则默认值为 true。如果 type 设置为 bios，则默认值为 false，并且无法修改，因为 BIOS 不支持启动加载程序证书验证。已弃用：请改用 ShieldConfig.EnableSecureBoot。

GCSReference

表示要从中存储映像的 GCS 来源。

显示在： - VirtualMachineImageSpec

字段	说明
url 字符串	GCS 对象的网址。

GuestEnvironment

指定 guest 环境配置。

显示在： - VirtualMachineSpec

字段	说明
accessManagement AccessManagementConfig	指定访问权限管理配置。

IPAddress

来源： - NetworkInterfaceSpec

字段	说明
address 字符串	IP 地址。在 GDC 连接模式下，地址可能包含子网掩码。如果未添加子网掩码，则默认采用 /32。例如，1.2.3.4 将被视为 1.2.3.4/32。或者，输入也可以是 1.2.3.4/24。在 GDC 气隙环境中，地址可能不包含子网掩码。子网信息是从 Subnet 对象中检索的。
managed 布尔值	与此 IP 地址关联的子网的生命周期是否应由 GDC 气隙环境中的系统进行管理。在互联 GDC 中未使用。如果为 true（默认值），系统会自动为此 IP 创建子网，并在删除虚拟机时删除该子网。如果为 false，则用户必须已创建子网，并且该子网必须处于就绪状态。

ImageDestinationReference

指向上传图片内容的目标位置。 只能指定一个目的地。 仅在 GDC Connected 部署中受支持。 如果指定的 ImageSourceReference 为 GCS，则此字段为必填字段。

来源： - VirtualMachineImageImportSpec

字段	说明
gcs ImageGCSDestinationReference	已填充到 GCS 的图片的存储桶详细信息。

ImageDiskSource

图片来源的参考。

来源： - DiskSource

字段	说明
name 字符串	VirtualMachineImage API 对象的名称。
namespace 字符串	VirtualMachineImage API 对象的命名空间。对于黄金映像，请使用 vm-system。对于当前项目中的映像，请将此值设置为空或使用当前的 namespace 值。

ImageGCSDestinationReference

表示要将映像导入到的 GCS 目标位置。

来源： - ImageDestinationReference

字段	说明
bucketName 字符串	用于存储相应映像的 GCS 存储分区名称。

ImageGCSSourceReference

表示要从中导入映像的 GCS 来源。

来源： - ImageSourceReference

字段	说明
bucketName 字符串	用于存储相应映像的 GCS 存储分区名称。
objectName 字符串	相应存储桶中图片的名称。

ImageMetadataInput

VirtualMachineImage 的规范。

来源： - VirtualMachineImageImportSpec

字段	说明
name 字符串	映像名称，例如 ubuntu-20.04-server-cloudimg。
operatingSystem OSName	相应映像所属操作系统的名称，例如 ubuntu-2004。
minimumDiskSize 数量	可应用映像的磁盘的最小大小。此属性仅指定根据此映像创建的未来磁盘的建议大小。它并不代表图片本身的尺寸。如果图片是从对象存储空间导入的，则此字段为必填字段。

ImageObjectStorageSourceReference

表示要从中导入映像的对象存储来源。

来源： - ImageSourceReference

字段	说明
bucketRef LocalObjectReference	包含相应映像的 Bucket 自定义资源的名称。Bucket 自定义资源必须与此对象位于同一命名空间中。
objectName 字符串	相应存储桶中图片的名称。

ImagePrepareOptions

表示图片准备的选项。

来源： - VirtualMachineImageImportSpec

字段	说明
installGuestEnvironment 布尔值	指定是否安装 GDC 气隙式访客环境。默认值为 true。

ImageSourceReference

指向填充图片内容的资源。 只能指定一个来源。

来源： - VirtualMachineImageImportSpec

字段	说明
diskRef LocalObjectReference	当图片从现有 VirtualMachineDisk 填充时指定。
objectStorage ImageObjectStorageSourceReference	从对象存储空间填充的图片的存储桶详细信息。
gcs ImageGCSSourceReference	从 GCS 填充的图片的存储桶详细信息。

NetworkInterfaceSpec

指定网络接口配置。 在 GDC 连接模式下，只能指定 Network 和 IPAddresses。 在 GDC 气隙环境中，必须指定 Network、Subnet 或 IPAddresses 之一。您可以选择性地同时指定子网和 IPAddresses。

来源： - NetworkSpec

字段	说明
network 字符串	接口所连接的网络。在 GDC 气隙环境中，有效值为：default、multicast。
subnet 字符串	接口在经过网闸隔离的 GDC 中连接到的子网。在互联 GDC 中未使用。如果未指定，则默认为指定网络的默认子网。
subnetNamespace 字符串	接口在 GDC 气隙环境中连接到的子网的命名空间。在互联 GDC 中未使用。如果未指定，则默认为与 VirtualMachine 相同的命名空间。
ipAddresses IPAddress 数组	要分配给接口的 IP 地址。系统只会为接口分配第一个 IP 地址。在 GDC 气隙环境中，如果未指定 IP 地址，系统会动态分配一个。在 GDC 连接模式下，如果网络配置为使用外部 DHCP 服务器，则此字段可用于指定静态地址（可选）。如果网络未配置为使用外部 DHCP 服务器，则此字段为必需字段。

NetworkInterfaceStatus

NetworkInterfaceStatus 是 NetworkInterface 资源的状态。

来源： - NetworkStatus

字段	说明
name 字符串	“名称”表示虚拟机内公开的网络接口的名称，例如“eth0”“eth1”。
ipAddresses 字符串数组	IpAddresses 是分配给 NetworkInterface 的 IP 地址。
macAddress 字符串	MacAddress 是分配给 NetworkInterface 的 MAC 地址。

NetworkPerformanceSpec

来源： - NetworkSpec

字段	说明
highThroughputMode 布尔值	是否为 GDC 气隙中的虚拟机的所有接口启用了高吞吐量优化。在互联 GDC 中未使用。如果为 true，则使用多队列等功能来提高网络性能。默认值为 false。

NetworkSpec

指定网络配置。

显示在： - VirtualMachineSpec

字段	说明
interfaces NetworkInterfaceSpec 数组	连接到虚拟机的网络接口。如果未指定任何单播接口，系统会自动添加 default 接口。启用多播的组织中的用户可以添加 multicast 接口。在虚拟机内设置默认路由时，系统会将指定的第一个接口视为默认接口。
performanceSpec NetworkPerformanceSpec	指定高性能网络配置。

NetworkStatus

NetworkStatus 是虚拟机的网络状态。

来源： - VirtualMachineStatus

字段	说明
interfaces NetworkInterfaceStatus 数组

OSName

基础类型： string 可使用的有效操作系统列表。

来源： - ImageMetadataInput - OperatingSystemSpec

OperatingSystemSpec

包含映像的操作系统信息。

显示在： - VirtualMachineImageSpec

字段	说明
name OSName	相应映像所属的操作系统名称，例如“windows-2016”。

ReplicatedDiskInfo

来源： - DiskReplicationStatus

字段	说明
name 字符串	VirtualMachineDisk 实例的名称。
zone 字符串	VirtualMachineDisk 实例的可用区。

SSHSpec

存储用于建立连接的 SSH 凭据。

来源： - VirtualMachineAccessRequestSpec

字段	说明
key 字符串	指定要为 SSH 访问权限编程的公钥。
ttl 时长	指定相应密钥的有效时长，以小时、分钟和秒为单位。默认值为 24h0m0s。

ServicePort

ServicePort 包含有关服务端口的信息。

显示在： - VirtualMachineExternalAccessSpec

字段	说明
name 字符串	相应端口在服务中的名称。
protocol 协议	相应端口的 IP 协议。支持“TCP”“UDP”和“SCTP”。
port 整数	将由此服务公开的端口。

ShieldConfig

指定虚拟机的安全相关配置。

显示在： - VirtualMachineSpec

字段	说明
bootType 字符串	指定是通过 UEFI 还是 BIOS 启动。默认值为 bios。
enableSecureBoot 布尔值	启用或停用启动加载程序证书验证。这有助于阻止加载修改过或恶意的代码。如果 bootType 为 uefi，则默认值为 true。如果 bootType 设置为 bios，则默认值为 false，并且无法修改，因为 BIOS 不支持启动加载程序证书验证。
enableVtpm 布尔值	是否模拟 VTPM 设备。默认值为 false。

StartupScript

为虚拟机定义启动脚本。 支持将启动脚本指定为纯文本字符串或 Kubernetes Secret。如果指定了 script 字段，则不应提供 scriptSecretRef 字段，反之亦然。

显示在： - VirtualMachineSpec

字段	说明
name 字符串	指定脚本的名称。必须与正则表达式 [\w][\w\-.]* 匹配，且不得超过 255 个字符。如果为 Windows 虚拟机指定脚本，则名称必须包含“-”，后跟脚本扩展名作为后缀。例如，为名为 hello-world 的 PowerShell 脚本使用名称 hello-world-ps1。
script 字符串	指定包含脚本的纯文本字符串。脚本内容大小必须小于 2048 字节。
scriptSecretRef LocalObjectReference	引用包含脚本的 Kubernetes Secret。ScriptSecretRef 名称必须与 Kubernetes Secret 的名称一致。

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

表示对虚拟机的访问请求。

来源： - 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 字符串	指定要访问的虚拟机的名称。
user 字符串	指定用于访问虚拟机的用户名。
ssh SSHSpec	保存用于访问虚拟机的 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 布尔值	反映了 VirtualMachine 如何挂接此磁盘。当所有挂接的虚拟机的 autoDelete 都设置为 true 且所有虚拟机都被删除时，该磁盘会被删除。如果至少有一个虚拟机的 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 必须与此虚拟机备份方案位于同一 namespace 中。
backupConfig VirtualMachineBackupConfig	定义备份的配置和范围。
backupSchedule 时间安排	相应虚拟机备份方案下的预定备份创建。时间表是一个可变字段，可在创建后进行修改。默认情况下，虚拟机备份方案将处于暂停状态
retentionPolicy RetentionPolicy	根据此方案创建的备份的生命周期。默认情况下，备份可以随时删除，无需锁定期限；备份不会根据自动时间表删除，并且可以修改保留政策

VirtualMachineBackupPlanStatus

定义观察到的 VirtualMachineBackupPlan 状态。

显示在： - VirtualMachineBackupPlan

字段	说明
backupPlan 字符串	此 VirtualMachineBackupPlan 管理的底层备份方案的名称，用于 GDC 气隙组织 v1 架构。
backupPlanStatus BackupPlanStatus	底层备份方案的嵌入式状态。
configBackupPlan 字符串	此 VirtualMachineBackupPlan 管理的基础配置备份方案的名称。此处的配置是指 GDC 气隙组织 v2 架构中使用的虚拟机和虚拟机磁盘。
volumeBackupPlan 字符串	此 VirtualMachineBackupPlan 管理的底层卷备份方案的名称，用于 GDC 气隙组织 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，则重复使用该 VirtualMachineBackupPlan。VirtualMachineBackupPlanTemplate 必须与相应请求位于同一 namespace 中。只能指定 VirtualMachineBackupPlanTemplate 或 VirtualMachineBackupPlan 中的一项。
virtualMachineBackupPlan 字符串	如果提供了此字段，则应省略此请求用于临时请求的虚拟机备份方案（具有备份范围 VirtualMachine 和 VirtualMachineDisk 字段）VirtualMachineBackupPlan 必须与此请求位于同一 namespace 中。
virtualMachine 字符串	正在备份的 VirtualMachine。此参数与 VirtualMachineBackupPlanTemplate 搭配使用，可在不存在 VirtualMachineBackupPlan 的情况下自动生成一个。只能指定 VirtualMachine 或 VirtualMachineDisk 中的一项。指定 virtualMachine 时，备份策略始终为 ProvisionerSpecific。
virtualMachineDisk 字符串	要备份的 VirtualMachineDisk。此参数与 VirtualMachineBackupPlanTemplate 结合使用，可在不存在 VirtualMachineBackupPlan 的情况下自动生成一个。当指定要备份 virtualMachineDisk 时，备份策略为 SnapshotOnly。只能指定 VirtualMachine 或 VirtualMachineDisk 中的一项。
virtualMachineBackupName 字符串	要创建的 VirtualMachineBackup 的名称。备份始终在与请求相同的命名空间中创建。

VirtualMachineBackupRequestStatus

定义观察到的 VirtualMachineBackupRequest 状态。

显示在： - VirtualMachineBackupRequest

字段	说明
timeToExpire 时间	相应临时资源将被删除的时间。
statusField StatusFields	描述 VirtualMachineBackupRequest 的观测状态

VirtualMachineBackupScope

定义 VirtualMachineBackupPlan 要捕获的资源范围。

来源： - VirtualMachineBackupConfig

字段	说明
selectedVirtualMachines VirtualMachineResourceConfig 数组	指定要捕获的 VirtualMachineBackupPlan 所对应的虚拟机。
selectedVirtualMachineDisks VirtualMachineResourceConfig 数组	指定要捕获的相应 VirtualMachineBackupPlan 的磁盘。
vmResourceLabelSelector 对象（键：字符串，值：字符串）	指定用于选择与备份方案位于同一命名空间中的一个或多个虚拟机或虚拟机磁盘资源的标签

VirtualMachineBackupSpec

定义 VirtualMachineBackup 的期望状态。

显示在： - VirtualMachineBackup

字段	说明
virtualMachineBackupPlan 字符串	创建相应 VirtualMachineBackup 所依据的 VirtualMachineBackupPlan 的名称。此 VirtualMachineBackupPlan 与 VirtualMachineBackupPlan 位于同一 namespace 中。
backupConfig VirtualMachineBackupConfig	定义备份的配置和范围。

VirtualMachineBackupStatus

定义观察到的 VirtualMachineBackup 的状态。

显示在： - VirtualMachineBackup

字段	说明
backup 字符串	相应 VirtualMachineBackup 所引用的底层备份的名称。备份必须与此虚拟机备份位于同一 namespace 中，且用于 GDC 气隙式组织 v1 架构。
backupStatus BackupStatus	VirtualMachineBackup 引用的底层备份的状态，用于 GDC 气隙组织 v1 架构。
configBackup 字符串	相应 VirtualMachineBackup 所引用的底层配置备份的名称。配置是指虚拟机和虚拟机磁盘。配置备份必须与此虚拟机备份位于同一 namespace 中，用于 GDC 气隙组织 v2 架构。
configBackupStatus BackupStatus	GDC 气隙组织 v2 架构中使用的相应配置备份的状态，VirtualMachineBackup 引用了该配置备份。
volumeBackup 字符串	相应 VirtualMachineBackup 所引用的底层卷备份的名称。卷备份必须与此虚拟机备份位于同一 namespace 中，并且在 GDC 气隙式组织 v2 架构中使用。
volumeBackupStatus BackupStatus	相应卷备份（此 VirtualMachineBackup 所引用）的状态，用于 GDC 气隙组织 v2 架构。
backedUpVirtualMachines 字符串数组	列出此备份中包含的所有虚拟机的名称。
backedUpVirtualMachineDisks 字符串数组	列出此备份中包含的所有虚拟机磁盘的名称。如果此备份是磁盘快照，则这是您提供的虚拟机磁盘的列表。如果这是虚拟机备份，则为备份该虚拟机的磁盘列表。

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 布尔值	指定需要恢复 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 已连接的情况下，支持的类型为：Standard。

VirtualMachineDiskStatus

定义观察到的 VirtualMachineDisk 状态。

显示在： - VirtualMachineDisk

字段	说明
phase VirtualMachineDiskPhase	磁盘的当前阶段。
progress VirtualMachineDiskProgress	进度是磁盘配置的当前进度。值介于 0 到 100（含）之间，如果不可用，则为 N/A。
size 数量	磁盘的当前大小。
conditions 条件数组	VirtualMachineDisk 状态的最新观测结果。
virtualMachineAttachments VirtualMachineAttachment 数组	附加了 VirtualMachineDisk 的 VirtualMachine 实例的列表。
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 布尔值	指定虚拟机是否可访问外部 VRF。
ports ServicePort 数组	VirtualMachine 入口服务公开的端口列表。

VirtualMachineExternalAccessStatus

定义 VirtualMachineExternalAccess 对象的观测状态。

来源： - VirtualMachineExternalAccess

字段	说明
ingressIP 字符串	IngressIP 指定 VirtualMachine 入站流量服务上的 IP 地址。
egressIP 字符串	EgressIP 指定虚拟机使用的出站 NAT 上的 IP 地址。
conditions 条件数组	观测状态的详细信息。
errors VMMError 数组	在协调此资源期间发生的任何错误的列表。

VirtualMachineImage

表示可在虚拟机上使用的磁盘映像。

显示在： - VirtualMachineImageList

字段	说明
apiVersion 字符串	virtualmachine.gdc.goog/v1
kind 字符串	VirtualMachineImage
metadata ObjectMeta	如需了解 metadata 的字段，请参阅 Kubernetes API 文档。
spec VirtualMachineImageSpec
status VirtualMachineImageStatus

VirtualMachineImageImport

表示用于导入和转换包含数据的虚拟机资源的操作；例如，用于导入和转换“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 布尔值	指定是否准备此映像以进行 GDC 气隙部署，例如通过某个值来安装必需的软件包。如果未指定，则仅当映像来自对象存储时才会进行准备。
prepareOptions ImagePrepareOptions	以下是图片准备方面的选项。仅当 prepareImage 为 true 时有效。

VirtualMachineImageImportStatus

提供映像导入状态。

显示在： - VirtualMachineImageImport

字段	说明
conditions 条件数组	提供导入进度的 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 条件数组	虚拟机映像的条件。
errors VMMError 数组	在协调此资源期间发生的任何错误的列表。
storageLocation 字符串	相应虚拟机映像的存储可用区。

VirtualMachineList

包含 VirtualMachine 对象的列表。

字段	说明
apiVersion 字符串	virtualmachine.gdc.goog/v1
kind 字符串	VirtualMachineList
metadata ListMeta	如需了解 metadata 的字段，请参阅 Kubernetes API 文档。
items VirtualMachine 数组

VirtualMachinePasswordResetRequest

表示针对给定虚拟机的密码重置请求。

来源： - 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 字符串	要请求重置密码的虚拟机的名称。此字段是不可变的，创建密码重置请求后无法更新。
user 字符串	要为指定虚拟机重置密码的用户的名称。此字段是不可变的，创建密码重置请求后无法更新。
publicKey 字符串	用于加密虚拟机的新密码的公钥。此字段是不可变的，创建密码重置请求后无法更新。

VirtualMachinePasswordResetRequestState

底层类型： string 定义 VirtualMachinePasswordResetRequest 资源的状态。

来源： - VirtualMachinePasswordResetRequestStatus

VirtualMachinePasswordResetRequestStatus

描述 VirtualMachinePasswordResetRequest 资源的状态。

来源： - VirtualMachinePasswordResetRequest

字段	说明
state VirtualMachinePasswordResetRequestState	VirtualMachinePasswordResetRequest 资源的状态。
reason 字符串	资源当前状态的原因。
message 字符串	一个字段，用于提供有关当前状态的其他信息。
processedAt 时间	一个字段，用于指定处理请求的时间。
encryptedPassword 字符串	使用请求中提供的公钥加密并使用 base64 编码的新密码。如需解密密码，请使用 base64 对字符串进行解码，然后使用 RSA 解密对结果进行解密。
errors VMMError 数组	在协调此资源期间发生的任何错误的列表。

VirtualMachineProvisionTime

跟踪虚拟机的预配时间。

来源： - VirtualMachineStatus

字段	说明
initProvisionTime 时长	首次虚拟机配置所用的时间。即从创建对象到虚拟机处于运行状态所用的时间。
lastProvisionTime 时长	最近一次虚拟机配置所用的时间。如果虚拟机仅配置一次，则可以等于 InitProvisionTime。

VirtualMachineResourceConfig

指定虚拟机资源以及用于备份该资源的其他参数。

显示在： - 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 字符串	要恢复的虚拟机备份的名称。VirtualMachineBackup 与此 VirtualMachineRestoreRequest 位于同一 namespace 中。
restoreName 字符串	所创建的 VirtualMachineRestore 资源的名称。
restoredResourceName 字符串	由 VirtualMachineBackup 恢复的资源的前缀。恢复的资源的名称将为前缀 + 备份资源的名称。
restoredResourceDescription 字符串	为新创建的资源提供的说明。
filter FilterSpec	可在恢复期间用于优化虚拟机资源选择的过滤器。

VirtualMachineRestoreRequestStatus

定义观察到的 VirtualMachineRestoreRequest 状态。

来源： - VirtualMachineRestoreRequest

字段	说明
timeToExpire 时间	相应临时资源将被删除的时间。
statusField StatusFields	描述 VirtualMachineRestoreRequest 的观测状态。

VirtualMachineRestoreSpec

定义 VirtualMachineRestore 的期望状态。

来源： - VirtualMachineRestore

字段	说明
virtualMachineBackup 字符串	相应 VirtualMachineRestore 正在恢复的虚拟机备份的名称。VirtualMachineBackup 与此 VirtualMachineRestore 位于同一 namespace 中。
targetVirtualMachines 字符串数组	底层恢复成功时创建的所有虚拟机的列表。
targetVirtualMachineDisks 字符串数组	所有虚拟机磁盘的列表。在底层恢复成功时创建。

VirtualMachineRestoreStatus

定义观察到的 VirtualMachineRestore 状态。

来源： - VirtualMachineRestore

字段	说明
restore 字符串	相应 VirtualMachineRestore 所引用的底层恢复的名称。恢复必须与此虚拟机备份位于同一 namespace 中，用于 GDC 气隙组织 v1 架构。
restoreStatus RestoreStatus	相应 VirtualMachineRestore 所引用的底层恢复的状态。用于 GDC 网闸隔离配置组织 v1 架构。
configRestore 字符串	相应 VirtualMachineRestore 所引用的底层配置恢复的名称。配置是指虚拟机和虚拟机磁盘。配置恢复必须与此虚拟机恢复位于同一 namespace 中，用于 GDC 气隙组织 v2 架构。
configRestoreStatus RestoreStatus	此 VirtualMachineRestore 引用的底层配置恢复的状态，用于 GDC 气隙组织 v2 架构。
volumeRestore 字符串	相应 VirtualMachineRestore 所引用的底层卷恢复的名称。卷恢复必须与此虚拟机恢复位于同一 namespace 中，用于 GDC 气隙组织 v2 架构。
volumeRestoreStatus RestoreStatus	GDC 气隙组织 v2 架构中使用的此 VirtualMachineRestore 所引用的底层卷恢复的状态。

VirtualMachineSpec

定义虚拟机的规范。

显示在： - VirtualMachine

字段	说明
runningState VirtualMachineRunningState	指示虚拟机的请求运行状态。默认值为 Running。
disks DiskAttachment 数组	指定附加到此虚拟机的磁盘列表。必须只有一个启动磁盘。对磁盘附件的更改需要重新启动才能生效。
compute 计算	指定虚拟机的 CPU 和内存。CPU 和内存可以直接定义，也可以通过 VirtualMachineType 定义。对计算的更改需要重新启动才能生效。当虚拟机处于 Unknown 状态时，计算资源不可变。
startupScripts StartupScript 数组	指定虚拟机的启动脚本列表。Linux 虚拟机必须安装 cloud-init，StartupScripts 才能生效。系统会根据每个启动脚本的名称按字母顺序执行这些脚本。在 Windows 虚拟机中，脚本类型会影响执行顺序。脚本按 ps1、bat、cmd 的顺序执行。如果两个脚本属于同一类型，则会按名称的字母顺序执行。
guestEnvironment GuestEnvironment	指定虚拟机的 guest 环境配置。如果该字段为 nil，则 AccessManagement 中的 enable 字段默认为 true。否则，结构中每个子功能的非 nil 配置会覆盖相应子功能的默认配置。
firmware Firmware	指定启动时的虚拟机初始化选项。
shieldConfig ShieldConfig	指定虚拟机的安全相关配置。
network NetworkSpec	指定网络配置。

VirtualMachineStatus

包含虚拟机的观测状态。

显示在： - VirtualMachine

字段	说明
state VirtualMachineState	虚拟机的观测状态。
reason VirtualMachineStateReason	虚拟机处于观测状态的原因。如果适用，则填充。
message 字符串	有关虚拟机状态的其他详细信息。
network NetworkStatus	虚拟机网络的状态。
conditions 条件数组	观测状态的详细信息。
stateTransitionTime object（键：VirtualMachineState，值：Time）	每种状态的上次转换时间。
provisionTime VirtualMachineProvisionTime	预配虚拟机所用的时间。
errors VMMError 数组	在协调此资源期间发生的任何错误的列表。

VirtualMachineType

定义虚拟机的 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 布尔值	指定底层硬件是否支持给定的虚拟机类型