Virtual Machine Templates - Update

Referens

Tjänst:: Azure Arc enabled SCVMM

API-version:: 2024-06-01

Implementerar metoden VirtualMachineTemplate PATCH.
Uppdaterar VirtualMachineTemplate-resursen.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
resourceGroupName	path	True	string	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string uuid	ID för målprenumerationen. Värdet måste vara ett UUID.
virtualMachineTemplateName	path	True	string	Namnet på VirtualMachineTemplate. Reguljärt uttrycksmönster: `[a-zA-Z0-9-_\.]`
api-version	query	True	string	DEN API-version som ska användas för den här åtgärden.

Begärandetext

Name	Typ	Description
tags	object	Resurstaggar.

Svar

Name	Typ	Description
200 OK	VirtualMachineTemplate	Azure-åtgärden har slutförts.
202 Accepted		Begäran om resursuppdatering har godkänts. Sidhuvuden Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Name

Typ

Description

200 OK

VirtualMachineTemplate

Azure-åtgärden har slutförts.

202 Accepted

Begäran om resursuppdatering har godkänts.

Sidhuvuden

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

VirtualMachineTemplates_Update_MaximumSet

VirtualMachineTemplates_Update_MinimumSet

VirtualMachineTemplates_Update_MaximumSet

Exempelbegäran

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

Exempelsvar

Statuskod:: 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"
  }
}

Statuskod:: 202

location: https://contoso.com/operationstatus

VirtualMachineTemplates_Update_MinimumSet

Exempelbegäran

HTTP

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

{}

Exempelsvar

Statuskod:: 200

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

Statuskod:: 202

location: https://contoso.com/operationstatus

Definitioner

Name	Description
AllocationMethod	Allokeringsmetod för nätverksadresser.
createdByType	Den typ av identitet som skapade resursen.
CreateDiffDisk	Skapa en diffdisk.
DynamicMemoryEnabled	Dynamiskt minne aktiverat.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
ExtendedLocation	Den utökade platsen.
IsCustomizable	Anpassningsbara.
IsHighlyAvailable	Hög tillgänglighet.
LimitCpuForMigration	Begränsa CPU för migrering.
NetworkInterface	Nätverksgränssnittsmodell
OsType	Typ av operativsystem för virtuella datorer.
ProvisioningState	Resursens etableringstillstånd.
StorageQosPolicyDetails	Definitionen StorageQoSPolicyDetails.
systemData	Metadata som rör skapande och senaste ändring av resursen.
VirtualDisk	Virtuell diskmodell
VirtualMachineTemplate	Resursdefinitionen VirtualMachineTemplates.
VirtualMachineTemplateTagsUpdate	Den typ som används för att uppdatera taggar i VirtualMachineTemplate-resurser.

AllocationMethod

Allokeringsmetod för nätverksadresser.

Name	Typ	Description
Dynamic	string	Dynamiskt allokerad adress.
Static	string	Statiskt allokerad adress.

createdByType

Den typ av identitet som skapade resursen.

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CreateDiffDisk

Skapa en diffdisk.

Name	Typ	Description
false	string	Inaktivera skapa diff-disk.
true	string	Aktivera skapa diff-disk.

DynamicMemoryEnabled

Dynamiskt minne aktiverat.

Name	Typ	Description
false	string	Inaktivera dynamiskt minne.
true	string	Aktivera dynamiskt minne.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

ExtendedLocation

Den utökade platsen.

Name	Typ	Description
name	string	Namnet på den utökade platsen.
type	string	Den utökade platstypen.

IsCustomizable

Anpassningsbara.

Name	Typ	Description
false	string	Inaktivera anpassningsbar.
true	string	Aktivera anpassningsbar.

IsHighlyAvailable

Hög tillgänglighet.

Name	Typ	Description
false	string	Inaktivera hög tillgänglighet.
true	string	Aktivera hög tillgänglighet.

LimitCpuForMigration

Begränsa CPU för migrering.

Name	Typ	Description
false	string	Inaktivera gräns-CPU för migrering.
true	string	Aktivera gräns-CPU för migrering.

NetworkInterface

Nätverksgränssnittsmodell

Name	Typ	Description
displayName	string	Hämtar visningsnamnet för nätverksgränssnittet enligt vmmServer. Det här är reservetiketten för ett nätverkskort när namnet inte har angetts.
ipv4AddressType	AllocationMethod	Hämtar eller anger ipv4-adresstypen.
ipv4Addresses	string[]	Hämtar nic ipv4-adresserna.
ipv6AddressType	AllocationMethod	Hämtar eller anger ipv6-adresstypen.
ipv6Addresses	string[]	Hämtar nic ipv6-adresserna.
macAddress	string	Hämtar eller anger nic MAC-adressen.
macAddressType	AllocationMethod	Hämtar eller anger mac-adresstypen.
name	string	Hämtar eller anger namnet på nätverksgränssnittet.
networkName	string	Hämtar namnet på det virtuella nätverket i vmmServer som nätverkskortet är anslutet till.
nicId	string	Hämtar eller anger nic-ID:t.
virtualNetworkId	string	Hämtar eller anger ARM-ID:t för Microsoft.ScVmm/virtualNetwork-resursen för att ansluta nätverkskortet.

OsType

Typ av operativsystem för virtuella datorer.

Name	Typ	Description
Linux	string	Linux-operativsystem.
Other	string	Annat operativsystem.
Windows	string	Windows-operativsystem.

ProvisioningState

Resursens etableringstillstånd.

Name	Typ	Description
Accepted	string	Resursen har godkänts.
Canceled	string	Resursskapandet avbröts.
Created	string	Resursen skapades.
Deleting	string	Resursen tas bort.
Failed	string	Det gick inte att skapa resurser.
Provisioning	string	Resursen etableras.
Succeeded	string	Resursen har skapats.
Updating	string	Resursen uppdateras.

StorageQosPolicyDetails

Definitionen StorageQoSPolicyDetails.

Name	Typ	Description
id	string	ID för QoS-principen.
name	string	Namnet på principen.

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

VirtualDisk

Virtuell diskmodell

Name	Typ	Description
bus	integer	Hämtar eller ställer in diskbussen.
busType	string	Hämtar eller anger diskbusstypen.
createDiffDisk	CreateDiffDisk	Hämtar eller anger ett värde som anger en diffdisk.
diskId	string	Hämtar eller ställer in disk-ID:t.
diskSizeGB	integer	Hämtar eller anger diskens totala storlek.
displayName	string	Hämtar visningsnamnet för den virtuella disken enligt vmmServer. Det här är återställningsetiketten för en disk när namnet inte har angetts.
lun	integer	Hämtar eller ställer in diskens lun.
maxDiskSizeGB	integer	Hämtar maximal diskstorlek.
name	string	Hämtar eller anger namnet på disken.
storageQoSPolicy	StorageQosPolicyDetails	QoS-principen för disken.
templateDiskId	string	Hämtar eller ställer in disk-ID:t i mallen.
vhdFormatType	string	Hämtar formattypen disk-vhd.
vhdType	string	Hämtar eller anger diskens vhd-typ.
volumeType	string	Hämtar diskvolymtypen.

VirtualMachineTemplate

Resursdefinitionen VirtualMachineTemplates.

Name	Typ	Description
extendedLocation	ExtendedLocation	Den utökade platsen.
id	string	Fullständigt kvalificerat resurs-ID för resursen. Till exempel "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Den geo-plats där resursen finns
name	string	Namnet på resursen
properties.computerName	string	Hämtar datornamn.
properties.cpuCount	integer	Hämtar önskat antal vCPU:er för den virtuella datorn.
properties.disks	VirtualDisk[]	Hämtar mallens diskar.
properties.dynamicMemoryEnabled	DynamicMemoryEnabled	Hämtar ett värde som anger om dynamiskt minne ska aktiveras eller inte.
properties.dynamicMemoryMaxMB	integer	Hämtar maximalt dynamiskt minne för den virtuella datorn.
properties.dynamicMemoryMinMB	integer	Hämtar det minsta dynamiska minnet för den virtuella datorn.
properties.generation	integer	Hämtar genereringen för den virtuella datorn.
properties.inventoryItemId	string	Hämtar eller anger lagerartikel-ID för resursen.
properties.isCustomizable	IsCustomizable	Hämtar ett värde som anger om vm-mallen är anpassningsbar eller inte.
properties.isHighlyAvailable	IsHighlyAvailable	Hämtar egenskap med hög tillgänglighet.
properties.limitCpuForMigration	LimitCpuForMigration	Hämtar ett värde som anger om processorkompatibilitetsläget ska aktiveras för direktmigrering av virtuella datorer.
properties.memoryMB	integer	MemoryMB är den önskade storleken på en virtuell dators minne i MB.
properties.networkInterfaces	NetworkInterface[]	Hämtar mallens nätverksgränssnitt.
properties.osName	string	Hämtar os-namn.
properties.osType	OsType	Hämtar operativsystemets typ.
properties.provisioningState	ProvisioningState	Etableringstillstånd för resursen.
properties.uuid	string	Unikt ID för mallen för den virtuella datorn.
properties.vmmServerId	string	ARM-ID för vmmServer-resursen där den här resursen finns.
systemData	systemData	Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
tags	object	Resurstaggar.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

VirtualMachineTemplateTagsUpdate

Den typ som används för att uppdatera taggar i VirtualMachineTemplate-resurser.

Name	Typ	Description
tags	object	Resurstaggar.

Dela via

Virtual Machine Templates - Update

URI-parametrar

Begärandetext

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

VirtualMachineTemplates_Update_MaximumSet

Exempelbegäran

Exempelsvar

VirtualMachineTemplates_Update_MinimumSet

Exempelbegäran

Exempelsvar

Definitioner

AllocationMethod

createdByType

CreateDiffDisk

DynamicMemoryEnabled

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

IsCustomizable

IsHighlyAvailable

LimitCpuForMigration

NetworkInterface

OsType

ProvisioningState

StorageQosPolicyDetails

systemData

VirtualDisk

VirtualMachineTemplate

VirtualMachineTemplateTagsUpdate

Ytterligare resurser