Virtual Machine Templates - Update

參考

服務:: Azure Arc enabled SCVMM

API 版本:: 2024-06-01

實作 VirtualMachineTemplate PATCH 方法。
更新 VirtualMachineTemplate 資源。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachineTemplates/{virtualMachineTemplateName}?api-version=2024-06-01

URI 參數

名稱	位於	必要	類型	Description
resourceGroupName	path	True	string	資源群組的名稱。名稱不區分大小寫。
subscriptionId	path	True	string uuid	目標訂用帳戶的標識碼。此值必須是 UUID。
virtualMachineTemplateName	path	True	string	VirtualMachineTemplate 的名稱。 Regex 模式: `[a-zA-Z0-9-_\.]`
api-version	query	True	string	要用於這項作業的 API 版本。

要求本文

名稱	類型	Description
tags	object	資源標籤。

回應

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

名稱

類型

Description

200 OK

VirtualMachineTemplate

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	模擬您的用戶帳戶

範例

VirtualMachineTemplates_Update_MaximumSet

VirtualMachineTemplates_Update_MinimumSet

VirtualMachineTemplates_Update_MaximumSet

範例要求

HTTP

PATCH https://management.azure.com/subscriptions/79332E5A-630B-480F-A266-A941C015AB19/resourceGroups/rgscvmm/providers/Microsoft.ScVmm/virtualMachineTemplates/g?api-version=2024-06-01

{
  "tags": {
    "key6634": "wwfhrg"
  }
}

範例回覆

狀態碼:: 200

{
  "properties": {
    "inventoryItemId": "qjrykoogccwlgkd",
    "uuid": "12345678-1234-1234-1234-12345678abcd",
    "vmmServerId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/vmmServers/vmmServerName",
    "osType": "Windows",
    "osName": "qcbolnbisklo",
    "computerName": "asxghqngsojdsdptpirbz",
    "memoryMB": 24,
    "cpuCount": 23,
    "limitCpuForMigration": "true",
    "dynamicMemoryEnabled": "true",
    "isCustomizable": "true",
    "dynamicMemoryMaxMB": 21,
    "dynamicMemoryMinMB": 21,
    "isHighlyAvailable": "true",
    "generation": 16,
    "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"
      }
    ],
    "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"
      }
    ],
    "provisioningState": "Succeeded"
  },
  "extendedLocation": {
    "type": "customLocation",
    "name": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ExtendedLocation/customLocations/customLocationName"
  },
  "tags": {
    "key9494": "kkbmfpwhmvlobm"
  },
  "location": "ayxsyduviotylbojh",
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualMachineTemplates/virtualMachineTemplateName",
  "name": "ioeuwaznkaayvhpqbnrwbr",
  "type": "egfzqiscydkyddksvsjujdlee",
  "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

VirtualMachineTemplates_Update_MinimumSet

範例要求

HTTP

PATCH https://management.azure.com/subscriptions/79332E5A-630B-480F-A266-A941C015AB19/resourceGroups/rgscvmm/providers/Microsoft.ScVmm/virtualMachineTemplates/-?api-version=2024-06-01

{}

範例回覆

狀態碼:: 200

{
  "extendedLocation": {},
  "location": "ayxsyduviotylbojh"
}

狀態碼:: 202

location: https://contoso.com/operationstatus

定義

名稱	Description
AllocationMethod	網路位址配置方法。
createdByType	建立資源的身分識別類型。
CreateDiffDisk	建立差異磁碟。
DynamicMemoryEnabled	已啟用易失記憶體。
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
ExtendedLocation	擴充位置。
IsCustomizable	定製。
IsHighlyAvailable	高可用性。
LimitCpuForMigration	限制移轉的CPU。
NetworkInterface	網路介面模型
OsType	虛擬機器作業系統類型。
ProvisioningState	資源的布建狀態。
StorageQosPolicyDetails	StorageQoSPolicyDetails 定義。
systemData	與建立和上次修改資源相關的元數據。
VirtualDisk	虛擬磁碟模型
VirtualMachineTemplate	VirtualMachineTemplates 資源定義。
VirtualMachineTemplateTagsUpdate	用於更新 VirtualMachineTemplate 資源中標記的類型。

AllocationMethod

網路位址配置方法。

名稱	類型	Description
Dynamic	string	動態配置的位址。
Static	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	擴充位置類型。

IsCustomizable

定製。

名稱	類型	Description
false	string	停用可自定義。
true	string	啟用可自定義。

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。

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	資源正在更新。

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	取得磁碟區類型。

VirtualMachineTemplate

VirtualMachineTemplates 資源定義。

名稱	類型	Description
extendedLocation	ExtendedLocation	擴充位置。
id	string	資源的完整資源標識碼。例如 “/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
location	string	資源所在的地理位置
name	string	資源的名稱
properties.computerName	string	取得計算機名稱。
properties.cpuCount	integer	取得 vm 所需的 vCPU 數目。
properties.disks	VirtualDisk[]	取得範本的磁碟。
properties.dynamicMemoryEnabled	DynamicMemoryEnabled	取得值，指出是否啟用易失記憶體。
properties.dynamicMemoryMaxMB	integer	取得 VM 的最大動態記憶體。
properties.dynamicMemoryMinMB	integer	取得 vm 的最小動態記憶體。
properties.generation	integer	取得 VM 的產生。
properties.inventoryItemId	string	取得或設定資源的清查項目標識碼。
properties.isCustomizable	IsCustomizable	取得值，指出 VM 範本是否可自定義。
properties.isHighlyAvailable	IsHighlyAvailable	取得高可用性屬性。
properties.limitCpuForMigration	LimitCpuForMigration	取得值，指出是否要啟用 VM 實時移轉的處理器相容性模式。
properties.memoryMB	integer	MemoryMB 是虛擬機記憶體所需的大小，以 MB 為單位。
properties.networkInterfaces	NetworkInterface[]	取得範本的網路介面。
properties.osName	string	取得 os 名稱。
properties.osType	OsType	取得os的類型。
properties.provisioningState	ProvisioningState	資源布建狀態。
properties.uuid	string	虛擬機範本的唯一標識碼。
properties.vmmServerId	string	此資源所在的 vmmServer 資源的 ARM 識別符。
systemData	systemData	包含 createdBy 和 modifiedBy 資訊的 Azure Resource Manager 元數據。
tags	object	資源標籤。
type	string	資源的型別。例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

VirtualMachineTemplateTagsUpdate

用於更新 VirtualMachineTemplate 資源中標記的類型。

名稱	類型	Description
tags	object	資源標籤。

共用方式為

Virtual Machine Templates - Update

URI 參數

要求本文

回應

安全性

azure_auth

範圍

範例

VirtualMachineTemplates_Update_MaximumSet

範例要求

範例回覆

VirtualMachineTemplates_Update_MinimumSet

範例要求

範例回覆

定義

AllocationMethod

createdByType

CreateDiffDisk

DynamicMemoryEnabled

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

IsCustomizable

IsHighlyAvailable

LimitCpuForMigration

NetworkInterface

OsType

ProvisioningState

StorageQosPolicyDetails

systemData

VirtualDisk

VirtualMachineTemplate

VirtualMachineTemplateTagsUpdate

其他資源