Virtual Machine Instances - Update

參考

服務:: Azure Arc enabled SCVMM

API 版本:: 2024-06-01

更新虛擬機。
更新虛擬機實例的作業。

PATCH https://management.azure.com/{resourceUri}/providers/Microsoft.ScVmm/virtualMachineInstances/default?api-version=2024-06-01

URI 參數

名稱	位於	必要	類型	Description
resourceUri	path	True	string	資源的完整 Azure Resource Manager 標識碼。
api-version	query	True	string	要用於這項作業的 API 版本。

要求本文

名稱	類型	Description
properties.availabilitySets	AvailabilitySetListItem[]	vm 中的可用性設定組。
properties.hardwareProfile	HardwareProfileUpdate	硬體屬性。
properties.infrastructureProfile	InfrastructureProfileUpdate	取得基礎結構配置檔。
properties.networkProfile	NetworkProfileUpdate	網路屬性。
properties.storageProfile	StorageProfileUpdate	記憶體屬性。

回應

名稱	類型	Description
200 OK	VirtualMachineInstance	Azure 作業已順利完成。
202 Accepted		已接受資源更新要求。標題 Location: string Retry-After: integer
Other Status Codes	ErrorResponse	未預期的錯誤回應。

名稱

類型

Description

200 OK

VirtualMachineInstance

Azure 作業已順利完成。

202 Accepted

已接受資源更新要求。

標題

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

未預期的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

VirtualMachineInstances_Update_MaximumSet

VirtualMachineInstances_Update_MinimumSet

VirtualMachineInstances_Update_MaximumSet

範例要求

HTTP

PATCH https://management.azure.com/gtgclehcbsyave/providers/Microsoft.ScVmm/virtualMachineInstances/default?api-version=2024-06-01

{
  "properties": {
    "availabilitySets": [
      {
        "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/availabilitySets/availabilitySetResourceName",
        "name": "lwbhaseo"
      }
    ],
    "hardwareProfile": {
      "memoryMB": 5,
      "cpuCount": 22,
      "limitCpuForMigration": "true",
      "dynamicMemoryEnabled": "true",
      "dynamicMemoryMaxMB": 2,
      "dynamicMemoryMinMB": 30
    },
    "networkProfile": {
      "networkInterfaces": [
        {
          "name": "kvofzqulbjlbtt",
          "macAddress": "oaeqqegt",
          "virtualNetworkId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualNetworks/virtualNetworkName",
          "ipv4AddressType": "Dynamic",
          "ipv6AddressType": "Dynamic",
          "macAddressType": "Dynamic",
          "nicId": "roxpsvlo"
        }
      ]
    },
    "storageProfile": {
      "disks": [
        {
          "name": "fgnckfymwdsqnfxkdvexuaobe",
          "diskId": "ltdrwcfjklpsimhzqyh",
          "diskSizeGB": 30,
          "bus": 8,
          "lun": 10,
          "busType": "zu",
          "vhdType": "cnbeeeylrvopigdynvgpkfp",
          "storageQoSPolicy": {
            "name": "ceiyfrflu",
            "id": "o"
          }
        }
      ]
    },
    "infrastructureProfile": {
      "checkpointType": "jkbpzjxpeegackhsvikrnlnwqz"
    }
  }
}

範例回覆

狀態碼:: 200

{
  "properties": {
    "availabilitySets": [
      {
        "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/availabilitySets/availabilitySetResourceName",
        "name": "lwbhaseo"
      }
    ],
    "osProfile": {
      "computerName": "uuxpcxuxcufllc",
      "osType": "Windows",
      "osSku": "cxqnjxgkts",
      "osVersion": "djt"
    },
    "hardwareProfile": {
      "memoryMB": 5,
      "cpuCount": 22,
      "limitCpuForMigration": "true",
      "dynamicMemoryEnabled": "true",
      "dynamicMemoryMaxMB": 2,
      "dynamicMemoryMinMB": 30,
      "isHighlyAvailable": "true"
    },
    "networkProfile": {
      "networkInterfaces": [
        {
          "name": "kvofzqulbjlbtt",
          "displayName": "yoayfd",
          "ipv4Addresses": [
            "eeunirpkpqazzxhsqonkxcfuks"
          ],
          "ipv6Addresses": [
            "pk"
          ],
          "macAddress": "oaeqqegt",
          "virtualNetworkId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualNetworks/virtualNetworkName",
          "networkName": "lqbm",
          "ipv4AddressType": "Dynamic",
          "ipv6AddressType": "Dynamic",
          "macAddressType": "Dynamic",
          "nicId": "roxpsvlo"
        }
      ]
    },
    "storageProfile": {
      "disks": [
        {
          "name": "fgnckfymwdsqnfxkdvexuaobe",
          "displayName": "fgladknawlgjodo",
          "diskId": "ltdrwcfjklpsimhzqyh",
          "diskSizeGB": 30,
          "maxDiskSizeGB": 18,
          "bus": 8,
          "lun": 10,
          "busType": "zu",
          "vhdType": "cnbeeeylrvopigdynvgpkfp",
          "volumeType": "ckkymkuekzzqhexyjueruzlfemoeln",
          "vhdFormatType": "vbcrrmhgahznifudvhxfagwoplcb",
          "templateDiskId": "lcdwrokpyvekqccclf",
          "storageQoSPolicy": {
            "name": "ceiyfrflu",
            "id": "o"
          },
          "createDiffDisk": "true"
        }
      ]
    },
    "infrastructureProfile": {
      "inventoryItemId": "ihkkqmg",
      "vmmServerId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/vmmServers/vmmServerName",
      "cloudId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/clouds/cloudResourceName",
      "templateId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualMachineTemplates/virtualMachineTemplateName",
      "vmName": "qovpayfydhcvfrhe",
      "uuid": "hrpw",
      "lastRestoredVMCheckpoint": {
        "parentCheckpointID": "hqhhzikoxunuqguouw",
        "checkpointID": "wsqmrje",
        "name": "keqn",
        "description": "qurzfrgyflrh"
      },
      "checkpointType": "jkbpzjxpeegackhsvikrnlnwqz",
      "generation": 28,
      "biosGuid": "xixivxifyql",
      "checkpoints": [
        {
          "parentCheckpointID": "hqhhzikoxunuqguouw",
          "checkpointID": "wsqmrje",
          "name": "keqn",
          "description": "kz"
        }
      ]
    },
    "powerState": "dbqyxewvrbqcifpwfvxyllwyaffmvm",
    "provisioningState": "Succeeded"
  },
  "extendedLocation": {
    "type": "customLocation",
    "name": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ExtendedLocation/customLocations/customLocationName"
  },
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualMachineInstances/default",
  "name": "uuqpsdoiyvedvqtrwop",
  "type": "zculorteltpvthtzgnpgdpoe",
  "systemData": {
    "createdBy": "p",
    "createdByType": "User",
    "createdAt": "2024-01-29T22:28:00.094Z",
    "lastModifiedBy": "goxcwpyyqlxndquly",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-01-29T22:28:00.095Z"
  }
}

狀態碼:: 202

location: https://contoso.com/operationstatus

VirtualMachineInstances_Update_MinimumSet

範例要求

HTTP

PATCH https://management.azure.com/gtgclehcbsyave/providers/Microsoft.ScVmm/virtualMachineInstances/default?api-version=2024-06-01

{}

範例回覆

狀態碼:: 200

{
  "extendedLocation": {}
}

狀態碼:: 202

location: https://contoso.com/operationstatus

定義

名稱	Description
AllocationMethod	網路位址配置方法。
AvailabilitySetListItem	可用性設定組模型
Checkpoint	定義資源屬性。
createdByType	建立資源的身分識別類型。
CreateDiffDisk	建立差異磁碟。
DynamicMemoryEnabled	已啟用易失記憶體。
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
ExtendedLocation	擴充位置。
HardwareProfile	定義資源屬性。
HardwareProfileUpdate	定義資源更新屬性。
InfrastructureProfile	指定虛擬機實例的 vmmServer 基礎結構特定設定。
InfrastructureProfileUpdate	指定虛擬機實例的 vmmServer 基礎結構特定更新設定。
IsHighlyAvailable	高可用性。
LimitCpuForMigration	限制移轉的CPU。
NetworkInterface	網路介面模型
NetworkInterfaceUpdate	網路介面更新模型
NetworkProfile	定義資源屬性。
NetworkProfileUpdate	定義資源更新屬性。
OsProfileForVmInstance	定義資源屬性。
OsType	虛擬機器作業系統類型。
ProvisioningState	資源的布建狀態。
StorageProfile	定義資源屬性。
StorageProfileUpdate	定義資源更新屬性。
StorageQosPolicyDetails	StorageQoSPolicyDetails 定義。
systemData	與建立和上次修改資源相關的元數據。
VirtualDisk	虛擬磁碟模型
VirtualDiskUpdate	虛擬磁碟更新模型
VirtualMachineInstance	定義 virtualMachineInstance。
VirtualMachineInstanceUpdate	用於 VirtualMachineInstance 更新作業的類型。

AllocationMethod

網路位址配置方法。

名稱	類型	Description
Dynamic	string	動態配置的位址。
Static	string	靜態配置位址。

AvailabilitySetListItem

可用性設定組模型

名稱	類型	Description
id	string	取得 microsoft.scvmm/availabilitySets 資源的 ARM 標識符。
name	string	取得或設定可用性設定組的名稱。

Checkpoint

定義資源屬性。

名稱	類型	Description
checkpointID	string	取得檢查點的標識碼。
description	string	取得檢查點的描述。
name	string	取得檢查點的名稱。
parentCheckpointID	string	取得檢查點父系的標識碼。

createdByType

建立資源的身分識別類型。

名稱	類型	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CreateDiffDisk

建立差異磁碟。

名稱	類型	Description
false	string	停用建立差異磁碟。
true	string	啟用建立差異磁碟。

DynamicMemoryEnabled

已啟用易失記憶體。

名稱	類型	Description
false	string	停用易失記憶體。
true	string	啟用易失記憶體。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳細數據。
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

ExtendedLocation

擴充位置。

名稱	類型	Description
name	string	擴充位置名稱。
type	string	擴充位置類型。

HardwareProfile

定義資源屬性。

名稱	類型	Description
cpuCount	integer	取得或設定 vm 的 vCPU 數目。
dynamicMemoryEnabled	DynamicMemoryEnabled	取得或設定值，指出是否啟用易失記憶體。
dynamicMemoryMaxMB	integer	取得或設定 vm 的最大動態記憶體。
dynamicMemoryMinMB	integer	取得或設定 vm 的最小動態記憶體。
isHighlyAvailable	IsHighlyAvailable	取得高可用性屬性。
limitCpuForMigration	LimitCpuForMigration	取得或設定值，指出是否要啟用 VM 實時移轉的處理器相容性模式。
memoryMB	integer	MemoryMB 是虛擬機記憶體的大小，以 MB 為單位。

HardwareProfileUpdate

定義資源更新屬性。

名稱	類型	Description
cpuCount	integer	取得或設定 vm 的 vCPU 數目。
dynamicMemoryEnabled	DynamicMemoryEnabled	取得或設定值，指出是否啟用易失記憶體。
dynamicMemoryMaxMB	integer	取得或設定 vm 的最大動態記憶體。
dynamicMemoryMinMB	integer	取得或設定 vm 的最小動態記憶體。
limitCpuForMigration	LimitCpuForMigration	取得或設定值，指出是否要啟用 VM 實時移轉的處理器相容性模式。
memoryMB	integer	MemoryMB 是虛擬機記憶體的大小，以 MB 為單位。

InfrastructureProfile

指定虛擬機實例的 vmmServer 基礎結構特定設定。

名稱	類型	Description
biosGuid	string	取得或設定 vm 的 bios guid。
checkpointType	string	VM 支援的檢查點類型。
checkpoints	Checkpoint[]	VM 中的檢查點。
cloudId	string	要用於部署 VM 的雲端資源的 ARM 識別碼。
generation	integer	取得或設定 VM 的產生。
inventoryItemId	string	取得或設定資源的清查項目標識碼。
lastRestoredVMCheckpoint	Checkpoint	VM 中上次還原的檢查點。
templateId	string	要用於部署 VM 的範本資源的 ARM 識別碼。
uuid	string	虛擬機的唯一標識碼。
vmName	string	VMName 是 SCVmm 伺服器上的 VM 名稱。
vmmServerId	string	此資源所在的 vmmServer 資源的 ARM 識別符。

InfrastructureProfileUpdate

指定虛擬機實例的 vmmServer 基礎結構特定更新設定。

名稱	類型	Description
checkpointType	string	VM 支援的檢查點類型。

IsHighlyAvailable

高可用性。

名稱	類型	Description
false	string	停用高可用性。
true	string	啟用高可用性。

LimitCpuForMigration

限制移轉的CPU。

名稱	類型	Description
false	string	停用移轉的CPU限制。
true	string	啟用移轉的CPU限制。

NetworkInterface

網路介面模型

名稱	類型	Description
displayName	string	取得網路介面的顯示名稱，如 vmmServer 所示。未設定名稱時，這是 NIC 的後援標籤。
ipv4AddressType	AllocationMethod	取得或設定 ipv4 位址類型。
ipv4Addresses	string[]	取得 nic ipv4 位址。
ipv6AddressType	AllocationMethod	取得或設定 ipv6 位址類型。
ipv6Addresses	string[]	取得 nic ipv6 位址。
macAddress	string	取得或設定 nic MAC 位址。
macAddressType	AllocationMethod	取得或設定mac位址類型。
name	string	取得或設定網路介面的名稱。
networkName	string	取得 vmmServer 中 nic 所連接的虛擬網路名稱。
nicId	string	取得或設定 nic 識別碼。
virtualNetworkId	string	取得或設定 Microsoft.ScVmm/virtualNetwork 資源的 ARM 識別符，以連線 nic。

NetworkInterfaceUpdate

網路介面更新模型

名稱	類型	Description
ipv4AddressType	AllocationMethod	取得或設定 ipv4 位址類型。
ipv6AddressType	AllocationMethod	取得或設定 ipv6 位址類型。
macAddress	string	取得或設定 nic MAC 位址。
macAddressType	AllocationMethod	取得或設定mac位址類型。
name	string	取得或設定網路介面的名稱。
nicId	string	取得或設定 nic 識別碼。
virtualNetworkId	string	取得或設定 Microsoft.ScVmm/virtualNetwork 資源的 ARM 識別符，以連線 nic。

NetworkProfile

定義資源屬性。

名稱	類型	Description
networkInterfaces	NetworkInterface[]	取得或設定與虛擬機相關聯的網路介面清單。

NetworkProfileUpdate

定義資源更新屬性。

名稱	類型	Description
networkInterfaces	NetworkInterfaceUpdate[]	取得或設定與虛擬機相關聯的網路介面清單。

OsProfileForVmInstance

定義資源屬性。

名稱	類型	Description
adminPassword	string	虛擬機的管理員密碼。
computerName	string	取得或設定計算機名稱。
domainName	string	取得或設定功能變數名稱。
domainPassword	string	VM 必須加入之網域的密碼。
domainUsername	string	取得或設定網域用戶名稱。
osSku	string	取得os sku。
osType	OsType	取得os的類型。
osVersion	string	取得os版本。
productKey	string	取得或設定產品金鑰。輸入格式 xxxxx-xxxxx-xxxxx-xxxxx-xxxxx
runOnceCommands	string	取得或設定在建立時要執行一次的命令，並以分號分隔。
timezone	integer	取得或設定時區的索引值。
workgroup	string	取得或設定工作組。

OsType

虛擬機器作業系統類型。

名稱	類型	Description
Linux	string	Linux 作業系統。
Other	string	其他作業系統。
Windows	string	Windows 作業系統。

ProvisioningState

資源的布建狀態。

名稱	類型	Description
Accepted	string	已接受資源。
Canceled	string	已取消資源建立。
Created	string	資源已建立。
Deleting	string	正在刪除資源。
Failed	string	資源建立失敗。
Provisioning	string	資源正在布建。
Succeeded	string	已建立資源。
Updating	string	資源正在更新。

StorageProfile

定義資源屬性。

名稱	類型	Description
disks	VirtualDisk[]	取得或設定與虛擬機相關聯的虛擬磁碟清單。

StorageProfileUpdate

定義資源更新屬性。

名稱	類型	Description
disks	VirtualDiskUpdate[]	取得或設定與虛擬機相關聯的虛擬磁碟清單。

StorageQosPolicyDetails

StorageQoSPolicyDetails 定義。

名稱	類型	Description
id	string	QoS 原則的標識碼。
name	string	原則的名稱。

systemData

與建立和上次修改資源相關的元數據。

名稱	類型	Description
createdAt	string	資源建立的時間戳（UTC）。
createdBy	string	建立資源的身分識別。
createdByType	createdByType	建立資源的身分識別類型。
lastModifiedAt	string	上次修改的資源時間戳（UTC）
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。

VirtualDisk

虛擬磁碟模型

名稱	類型	Description
bus	integer	取得或設定磁碟總線。
busType	string	取得或設定磁碟總線類型。
createDiffDisk	CreateDiffDisk	取得或設定值，指出差異磁碟。
diskId	string	取得或設定磁碟標識碼。
diskSizeGB	integer	取得或設定磁碟總大小。
displayName	string	取得虛擬磁碟的顯示名稱，如 vmmServer 所示。未設定名稱時，這是磁碟的後援標籤。
lun	integer	取得或設定磁碟 lun。
maxDiskSizeGB	integer	取得磁碟大小上限。
name	string	取得或設定磁碟的名稱。
storageQoSPolicy	StorageQosPolicyDetails	磁碟的 QoS 原則。
templateDiskId	string	取得或設定範本中的磁碟標識碼。
vhdFormatType	string	取得磁碟 vhd 格式類型。
vhdType	string	取得或設定磁碟 vhd 類型。
volumeType	string	取得磁碟區類型。

VirtualDiskUpdate

虛擬磁碟更新模型

名稱	類型	Description
bus	integer	取得或設定磁碟總線。
busType	string	取得或設定磁碟總線類型。
diskId	string	取得或設定磁碟標識碼。
diskSizeGB	integer	取得或設定磁碟總大小。
lun	integer	取得或設定磁碟 lun。
name	string	取得或設定磁碟的名稱。
storageQoSPolicy	StorageQosPolicyDetails	磁碟的 QoS 原則。
vhdType	string	取得或設定磁碟 vhd 類型。

VirtualMachineInstance

定義 virtualMachineInstance。

名稱	類型	Description
extendedLocation	ExtendedLocation	取得或設定擴充位置。
id	string	資源的完整資源標識碼。例如 “/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
name	string	資源的名稱
properties.availabilitySets	AvailabilitySetListItem[]	vm 中的可用性設定組。
properties.hardwareProfile	HardwareProfile	硬體屬性。
properties.infrastructureProfile	InfrastructureProfile	取得基礎結構配置檔。
properties.networkProfile	NetworkProfile	網路屬性。
properties.osProfile	OsProfileForVmInstance	OS 屬性。
properties.powerState	string	取得虛擬機的電源狀態。
properties.provisioningState	ProvisioningState	資源布建狀態。
properties.storageProfile	StorageProfile	記憶體屬性。
systemData	systemData	包含 createdBy 和 modifiedBy 資訊的 Azure Resource Manager 元數據。
type	string	資源的型別。例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

VirtualMachineInstanceUpdate

用於 VirtualMachineInstance 更新作業的類型。

名稱	類型	Description
properties.availabilitySets	AvailabilitySetListItem[]	vm 中的可用性設定組。
properties.hardwareProfile	HardwareProfileUpdate	硬體屬性。
properties.infrastructureProfile	InfrastructureProfileUpdate	取得基礎結構配置檔。
properties.networkProfile	NetworkProfileUpdate	網路屬性。
properties.storageProfile	StorageProfileUpdate	記憶體屬性。

共用方式為

Virtual Machine Instances - Update

URI 參數

要求本文

回應

安全性

azure_auth

範圍

範例

VirtualMachineInstances_Update_MaximumSet

範例要求

範例回覆

VirtualMachineInstances_Update_MinimumSet

範例要求

範例回覆

定義

AllocationMethod

AvailabilitySetListItem

Checkpoint

createdByType

CreateDiffDisk

DynamicMemoryEnabled

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

HardwareProfile

HardwareProfileUpdate

InfrastructureProfile

InfrastructureProfileUpdate

IsHighlyAvailable

LimitCpuForMigration

NetworkInterface

NetworkInterfaceUpdate

NetworkProfile

NetworkProfileUpdate

OsProfileForVmInstance

OsType

ProvisioningState

StorageProfile

StorageProfileUpdate

StorageQosPolicyDetails

systemData

VirtualDisk

VirtualDiskUpdate

VirtualMachineInstance

VirtualMachineInstanceUpdate

其他資源