Virtual Machine Templates - Create Or Update

Referencia

Szolgáltatás:: Azure Arc enabled SCVMM

API-verzió:: 2025-03-13

VirtualMachineTemplates PUT metódust implementál.
Az ScVmm virtuálisgép-sablont Azure-beli virtuálisgép-sablon-erőforrásként készíti el.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachineTemplates/{virtualMachineTemplateName}?api-version=2025-03-13

URI-paraméterek

Name	In	Kötelező	Típus	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string (uuid)	A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.
virtualMachineTemplateName	path	True	string minLength: 1 maxLength: 54 pattern: [a-zA-Z0-9-_\.]	A VirtualMachineTemplate neve.
api-version	query	True	string minLength: 1	A művelethez használni kívánt API-verzió.

Kérelem törzse

Name	Kötelező	Típus	Description
extendedLocation	True	ExtendedLocation	A kiterjesztett hely.
location	True	string	Az a földrajzi hely, ahol az erőforrás él
properties.inventoryItemId		string	Lekéri vagy beállítja az erőforrás készletelem-azonosítóját.
properties.uuid		string pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$	A virtuálisgép-sablon egyedi azonosítója.
properties.vmmServerId		string (arm-id)	Annak a vmmServer-erőforrásnak az ARM-azonosítója, amelyben ez az erőforrás található.
tags		object	Erőforráscímkék.

Válaszok

Name	Típus	Description
200 OK	VirtualMachineTemplate	A VirtualMachineTemplate erőforrás frissítési művelete sikeres volt
201 Created	VirtualMachineTemplate	A VirtualMachineTemplate erőforrás létrehozási művelete sikeres volt Fejlécek Retry-After: integer
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Name

Típus

Description

200 OK

VirtualMachineTemplate

A VirtualMachineTemplate erőforrás frissítési művelete sikeres volt

201 Created

VirtualMachineTemplate

A VirtualMachineTemplate erőforrás létrehozási művelete sikeres volt

Fejlécek

Retry-After: integer

Other Status Codes

ErrorResponse

Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

VirtualMachineTemplates_CreateOrUpdate_MaximumSet

VirtualMachineTemplates_CreateOrUpdate_MinimumSet

VirtualMachineTemplates_CreateOrUpdate_MaximumSet

Mintakérelem

HTTP

PUT https://management.azure.com/subscriptions/79332E5A-630B-480F-A266-A941C015AB19/resourceGroups/rgscvmm/providers/Microsoft.ScVmm/virtualMachineTemplates/6?api-version=2025-03-13

{
  "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",
    "limitCpuForMigration": "true",
    "dynamicMemoryEnabled": "true",
    "isCustomizable": "true",
    "isHighlyAvailable": "true"
  },
  "extendedLocation": {
    "type": "customLocation",
    "name": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ExtendedLocation/customLocations/customLocationName"
  },
  "tags": {
    "key9494": "kkbmfpwhmvlobm"
  },
  "location": "ayxsyduviotylbojh"
}

Mintaválasz

Állapotkód:: 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"
  }
}

Állapotkód:: 201

Azure-AsyncOperation: https://contoso.com/operationstatus

{
  "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"
  }
}

VirtualMachineTemplates_CreateOrUpdate_MinimumSet

Mintakérelem

HTTP

PUT https://management.azure.com/subscriptions/79332E5A-630B-480F-A266-A941C015AB19/resourceGroups/rgscvmm/providers/Microsoft.ScVmm/virtualMachineTemplates/P?api-version=2025-03-13

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

Mintaválasz

Állapotkód:: 200

{
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualMachineTemplates/virtualMachineTemplateName",
  "extendedLocation": {},
  "location": "ayxsyduviotylbojh"
}

Állapotkód:: 201

Azure-AsyncOperation: https://contoso.com/operationstatus

{
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualMachineTemplates/virtualMachineTemplateName",
  "extendedLocation": {},
  "location": "ayxsyduviotylbojh"
}

Definíciók

Name	Description
AllocationMethod	Hálózati címfoglalási módszer.
createdByType	Az erőforrást létrehozó identitás típusa.
CreateDiffDisk	Hozzon létre egy diff lemezt.
DynamicMemoryEnabled	A dinamikus memória engedélyezve van.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
ExtendedLocation	A kiterjesztett hely.
IsCustomizable	Testreszabható.
IsHighlyAvailable	Magas rendelkezésre állás.
LimitCpuForMigration	A migrálás processzorhasználatának korlátozása.
NetworkInterface	Hálózati adapter modellje
OsType	Virtuálisgép-operációs rendszer típusa.
ProvisioningState	Az erőforrás kiépítési állapota.
StorageQosPolicyDetails	A StorageQoSPolicyDetails definíciója.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
VirtualDisk	Virtuálislemez-modell
VirtualMachineTemplate	A VirtualMachineTemplates erőforrásdefiníció.

AllocationMethod

Enumerálás

Hálózati címfoglalási módszer.

Érték	Description
Dynamic	Dinamikusan lefoglalt cím.
Static	Statikusan lefoglalt cím.

createdByType

Enumerálás

Az erőforrást létrehozó identitás típusa.

Érték	Description
Application
Key
ManagedIdentity
User

CreateDiffDisk

Enumerálás

Hozzon létre egy diff lemezt.

Érték	Description
false	Tiltsa le a difflemez létrehozását.
true	Engedélyezze a difflemez létrehozását.

DynamicMemoryEnabled

Enumerálás

A dinamikus memória engedélyezve van.

Érték	Description
false	Dinamikus memória letiltása.
true	Dinamikus memória engedélyezése.

ErrorAdditionalInfo

Objektum

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Objektum

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Objektum

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

ExtendedLocation

Objektum

A kiterjesztett hely.

Name	Típus	Description
name	string (arm-id)	A kiterjesztett hely neve.
type	string	A kiterjesztett hely típusa.

IsCustomizable

Enumerálás

Testreszabható.

Érték	Description
false	Tiltsa le a testreszabhatót.
true	Testre szabható engedélyezése.

IsHighlyAvailable

Enumerálás

Magas rendelkezésre állás.

Érték	Description
false	A magas rendelkezésre állás letiltása.
true	Magas rendelkezésre állás engedélyezése.

LimitCpuForMigration

Enumerálás

A migrálás processzorhasználatának korlátozása.

Érték	Description
false	Tiltsa le a processzorkorlátot a migráláshoz.
true	Engedélyezze a processzorkorlátot a migráláshoz.

NetworkInterface

Objektum

Hálózati adapter modellje

Name	Típus	Description
displayName	string	Lekéri a hálózati adapter megjelenítendő nevét a vmmServerben látható módon. Ez egy hálózati adapter tartalék címkéje, ha a név nincs beállítva.
ipv4AddressType	AllocationMethod	Lekéri vagy beállítja az ipv4-címtípust.
ipv4Addresses	string[]	Lekéri a hálózati adapter ipv4-címeit.
ipv6AddressType	AllocationMethod	Lekéri vagy beállítja az ipv6-cím típusát.
ipv6Addresses	string[]	Lekéri a hálózati ipv6-címeket.
macAddress	string	Lekéri vagy beállítja a hálózati adapter MAC-címét.
macAddressType	AllocationMethod	Lekéri vagy beállítja a mac-cím típusát.
name	string	Lekéri vagy beállítja a hálózati adapter nevét.
networkName	string	Lekéri annak a virtuális hálózatnak a nevét a vmmServerben, amelyhez a hálózati adapter csatlakozik.
nicId	string	Lekéri vagy beállítja a hálózati adapter azonosítóját.
virtualNetworkId	string (arm-id)	Lekéri vagy beállítja a Microsoft.ScVmm/virtualNetwork erőforrás ARM-azonosítóját a hálózati adapter csatlakoztatásához.

OsType

Enumerálás

Virtuálisgép-operációs rendszer típusa.

Érték	Description
Linux	Linux operációs rendszer.
Other	Egyéb operációs rendszer.
Windows	Windows operációs rendszer.

ProvisioningState

Enumerálás

Az erőforrás kiépítési állapota.

Érték	Description
Accepted	Az erőforrást elfogadták.
Canceled	Az erőforrás létrehozása megszakadt.
Created	Az erőforrás létrejött.
Deleting	Az erőforrás törlése folyamatban van.
Failed	Az erőforrás létrehozása nem sikerült.
Provisioning	Az erőforrás kiépítésre kerül.
Succeeded	Az erőforrás létrejött.
Updating	Az erőforrás frissül.

StorageQosPolicyDetails

Objektum

A StorageQoSPolicyDetails definíciója.

Name	Típus	Description
id	string	A QoS-szabályzat azonosítója.
name	string	A szabályzat neve.

systemData

Objektum

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.

VirtualDisk

Objektum

Virtuálislemez-modell

Name	Típus	Description
bus	integer (int32)	Lekéri vagy beállítja a lemezbuszt.
busType	string	Lekéri vagy beállítja a lemezbusz típusát.
createDiffDisk	CreateDiffDisk	Lekéri vagy beállítja a lemezt jelző értéket.
diskId	string	Lekéri vagy beállítja a lemezazonosítót.
diskSizeGB	integer (int32)	Lekéri vagy beállítja a lemez teljes méretét.
displayName	string	Lekéri a virtuális lemez megjelenítendő nevét a vmmServerben látható módon. Ez egy lemez tartalék címkéje, ha a név nincs beállítva.
lun	integer (int32)	Lekéri vagy beállítja a lemezt.
maxDiskSizeGB	integer (int32)	A maximális lemezméretet kapja meg.
name	string	Lekéri vagy beállítja a lemez nevét.
storageQoSPolicy	StorageQosPolicyDetails	A lemez QoS-szabályzata.
templateDiskId	string	Lekéri vagy beállítja a lemezazonosítót a sablonban.
vhdFormatType	string	Lekéri a lemez vhd formátumtípusát.
vhdType	string	Lekéri vagy beállítja a lemez vhd-típusát.
volumeType	string	Lekéri a lemezkötet típusát.

VirtualMachineTemplate

Objektum

A VirtualMachineTemplates erőforrásdefiníció.

Name	Típus	Description
extendedLocation	ExtendedLocation	A kiterjesztett hely.
id	string (arm-id)	Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Az a földrajzi hely, ahol az erőforrás él
name	string	Az erőforrás neve
properties.computerName	string	Lekéri a számítógép nevét.
properties.cpuCount	integer (int32)	Lekéri a virtuális géphez szükséges vCPU-k kívánt számát.
properties.disks	VirtualDisk[]	Lekéri a sablon lemezeit.
properties.dynamicMemoryEnabled	DynamicMemoryEnabled	Beolvas egy értéket, amely jelzi, hogy engedélyezve van-e a dinamikus memória.
properties.dynamicMemoryMaxMB	integer (int32)	Lekéri a virtuális gép maximális dinamikus memóriáját.
properties.dynamicMemoryMinMB	integer (int32)	Lekéri a virtuális gép minimális dinamikus memóriáját.
properties.generation	integer (int32)	Lekéri a virtuális gép generációt.
properties.inventoryItemId	string	Lekéri vagy beállítja az erőforrás készletelem-azonosítóját.
properties.isCustomizable	IsCustomizable	Beolvas egy értéket, amely jelzi, hogy a virtuálisgép-sablon testreszabható-e vagy sem.
properties.isHighlyAvailable	IsHighlyAvailable	Magas rendelkezésre állású tulajdonságot kap.
properties.limitCpuForMigration	LimitCpuForMigration	Értéket kap, amely jelzi, hogy engedélyezi-e a processzorkompatibilitási módot a virtuális gépek élő áttelepítéséhez.
properties.memoryMB	integer (int32)	A Memóriamb a virtuális gép memóriájának kívánt mérete MB-ban.
properties.networkInterfaces	NetworkInterface[]	Lekéri a sablon hálózati adaptereit.
properties.osName	string	Lekéri az operációs rendszer nevét.
properties.osType	OsType	Lekéri az operációs rendszer típusát.
properties.provisioningState	ProvisioningState	Az erőforrás kiépítési állapota.
properties.uuid	string pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$	A virtuálisgép-sablon egyedi azonosítója.
properties.vmmServerId	string (arm-id)	Annak a vmmServer-erőforrásnak az ARM-azonosítója, amelyben ez az erőforrás található.
systemData	systemData	A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.
tags	object	Erőforráscímkék.
type	string	Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

Megosztás a következőn keresztül:

Virtual Machine Templates - Create Or Update

URI-paraméterek

Kérelem törzse

Válaszok

Biztonság

azure_auth

Hatókörök

Példák

VirtualMachineTemplates_CreateOrUpdate_MaximumSet

Mintakérelem

Mintaválasz

VirtualMachineTemplates_CreateOrUpdate_MinimumSet

Mintakérelem

Mintaválasz

Definíciók

AllocationMethod

createdByType

CreateDiffDisk

DynamicMemoryEnabled

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

IsCustomizable

IsHighlyAvailable

LimitCpuForMigration

NetworkInterface

OsType

ProvisioningState

StorageQosPolicyDetails

systemData

VirtualDisk

VirtualMachineTemplate