Virtual Machine Templates - Update

Reference

Služba:: Azure Arc enabled SCVMM

Verze rozhraní API:: 2024-06-01

Implementuje metodu VirtualMachineTemplate PATCH.
Aktualizuje prostředek VirtualMachineTemplate.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string uuid	ID cílového předplatného. Hodnota musí být UUID.
virtualMachineTemplateName	path	True	string	Název VirtualMachineTemplate. Vzor regulárního výrazu: `[a-zA-Z0-9-_\.]`
api-version	query	True	string	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Typ	Description
tags	object	Značky prostředků

Odpovědi

Name	Typ	Description
200 OK	VirtualMachineTemplate	Operace Azure byla úspěšně dokončena.
202 Accepted		Žádost o aktualizaci prostředků byla přijata. Hlavičky Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Name

Typ

Description

200 OK

VirtualMachineTemplate

Operace Azure byla úspěšně dokončena.

202 Accepted

Žádost o aktualizaci prostředků byla přijata.

Hlavičky

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

VirtualMachineTemplates_Update_MaximumSet

VirtualMachineTemplates_Update_MinimumSet

VirtualMachineTemplates_Update_MaximumSet

Ukázkový požadavek

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

Ukázková odpověď

Stavový kó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"
  }
}

Stavový kód:: 202

location: https://contoso.com/operationstatus

VirtualMachineTemplates_Update_MinimumSet

Ukázkový požadavek

HTTP

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

{}

Ukázková odpověď

Stavový kód:: 200

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

Stavový kód:: 202

location: https://contoso.com/operationstatus

Definice

Name	Description
AllocationMethod	Metoda přidělování síťových adres.
createdByType	Typ identity, která prostředek vytvořila.
CreateDiffDisk	Vytvoření rozdílu disku
DynamicMemoryEnabled	Povolená dynamická paměť.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
ExtendedLocation	Rozšířené umístění.
IsCustomizable	Přizpůsobitelný.
IsHighlyAvailable	Vysoce dostupné.
LimitCpuForMigration	Omezte procesor pro migraci.
NetworkInterface	Model síťového rozhraní
OsType	Typ operačního systému virtuálního počítače
ProvisioningState	Stav zřizování prostředku.
StorageQosPolicyDetails	Definice StorageQoSPolicyDetails.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
VirtualDisk	Model virtuálního disku
VirtualMachineTemplate	Definice prostředku VirtualMachineTemplates.
VirtualMachineTemplateTagsUpdate	Typ použitý k aktualizaci značek v prostředcích VirtualMachineTemplate.

AllocationMethod

Metoda přidělování síťových adres.

Name	Typ	Description
Dynamic	string	Dynamicky přidělená adresa
Static	string	Staticky přidělená adresa

createdByType

Typ identity, která prostředek vytvořila.

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CreateDiffDisk

Vytvoření rozdílu disku

Name	Typ	Description
false	string	Zakažte vytvoření rozdílu disku.
true	string	Povolte vytvoření rozdílu disku.

DynamicMemoryEnabled

Povolená dynamická paměť.

Name	Typ	Description
false	string	Zakažte dynamickou paměť.
true	string	Povolte dynamickou paměť.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

ExtendedLocation

Rozšířené umístění.

Name	Typ	Description
name	string	Název rozšířeného umístění.
type	string	Typ rozšířeného umístění.

IsCustomizable

Přizpůsobitelný.

Name	Typ	Description
false	string	Zakažte přizpůsobitelné.
true	string	Povolit přizpůsobitelné.

IsHighlyAvailable

Vysoce dostupné.

Name	Typ	Description
false	string	Zakažte vysokou dostupnost.
true	string	Povolte vysokou dostupnost.

LimitCpuForMigration

Omezte procesor pro migraci.

Name	Typ	Description
false	string	Zakažte omezení procesoru pro migraci.
true	string	Povolte omezení procesoru pro migraci.

NetworkInterface

Model síťového rozhraní

Name	Typ	Description
displayName	string	Získá zobrazovaný název síťového rozhraní, jak je znázorněno v nástroji vmmServer. Toto je záložní popisek síťové karty, pokud název není nastavený.
ipv4AddressType	AllocationMethod	Získá nebo nastaví typ adresy ipv4.
ipv4Addresses	string[]	Získá ipv4 adresy síťové karty.
ipv6AddressType	AllocationMethod	Získá nebo nastaví typ adresy ipv6.
ipv6Addresses	string[]	Získá ipv6 adresy síťové karty.
macAddress	string	Získá nebo nastaví adresu MAC síťové karty.
macAddressType	AllocationMethod	Získá nebo nastaví typ adresy mac.
name	string	Získá nebo nastaví název síťového rozhraní.
networkName	string	Získá název virtuální sítě vmmServer, ke které je síťová karta připojena.
nicId	string	Získá nebo nastaví ID síťové karty.
virtualNetworkId	string	Získá nebo nastaví ID ARM prostředku Microsoft.ScVmm/virtualNetwork pro připojení síťové karty.

OsType

Typ operačního systému virtuálního počítače

Name	Typ	Description
Linux	string	Operační systém Linux.
Other	string	Jiný operační systém.
Windows	string	Operační systém Windows.

ProvisioningState

Stav zřizování prostředku.

Name	Typ	Description
Accepted	string	Prostředek byl přijat.
Canceled	string	Vytvoření prostředku bylo zrušeno.
Created	string	Prostředek byl vytvořen.
Deleting	string	Prostředek se odstraňuje.
Failed	string	Vytvoření prostředku se nezdařilo.
Provisioning	string	Prostředek se zřizuje.
Succeeded	string	Prostředek byl vytvořen.
Updating	string	Prostředek se aktualizuje.

StorageQosPolicyDetails

Definice StorageQoSPolicyDetails.

Name	Typ	Description
id	string	ID zásady QoS.
name	string	Název zásady.

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

VirtualDisk

Model virtuálního disku

Name	Typ	Description
bus	integer	Získá nebo nastaví diskovou sběrnici.
busType	string	Získá nebo nastaví typ sběrnice disku.
createDiffDisk	CreateDiffDisk	Získá nebo nastaví hodnotu označující rozdílový disk.
diskId	string	Získá nebo nastaví ID disku.
diskSizeGB	integer	Získá nebo nastaví celkovou velikost disku.
displayName	string	Získá zobrazovaný název virtuálního disku, jak je znázorněno na vmmServer. Toto je záložní popisek disku, pokud název není nastavený.
lun	integer	Získá nebo nastaví logickou jednotku disku.
maxDiskSizeGB	integer	Získá maximální velikost disku.
name	string	Získá nebo nastaví název disku.
storageQoSPolicy	StorageQosPolicyDetails	Zásady QoS disku.
templateDiskId	string	Získá nebo nastaví ID disku v šabloně.
vhdFormatType	string	Získá typ formátu virtuálního pevného disku.
vhdType	string	Získá nebo nastaví typ virtuálního pevného disku.
volumeType	string	Získá typ svazku disku.

VirtualMachineTemplate

Definice prostředku VirtualMachineTemplates.

Name	Typ	Description
extendedLocation	ExtendedLocation	Rozšířené umístění.
id	string	Plně kvalifikované ID prostředku pro prostředek. Například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Geografické umístění, ve kterém se nachází zdroj
name	string	Název prostředku
properties.computerName	string	Získá název počítače.
properties.cpuCount	integer	Získá požadovaný počet virtuálních procesorů pro virtuální počítač.
properties.disks	VirtualDisk[]	Získá disky šablony.
properties.dynamicMemoryEnabled	DynamicMemoryEnabled	Získá hodnotu označující, zda povolit dynamickou paměť, nebo ne.
properties.dynamicMemoryMaxMB	integer	Získá maximální dynamickou paměť pro virtuální počítač.
properties.dynamicMemoryMinMB	integer	Získá minimální dynamickou paměť pro virtuální počítač.
properties.generation	integer	Získá generaci virtuálního počítače.
properties.inventoryItemId	string	Získá nebo nastaví ID položky inventáře pro prostředek.
properties.isCustomizable	IsCustomizable	Získá hodnotu určující, zda je šablona virtuálního počítače přizpůsobitelná nebo ne.
properties.isHighlyAvailable	IsHighlyAvailable	Získá vysoce dostupnou vlastnost.
properties.limitCpuForMigration	LimitCpuForMigration	Získá hodnotu určující, zda povolit režim kompatibility procesoru pro migraci virtuálních počítačů za provozu.
properties.memoryMB	integer	MemoryMB je požadovaná velikost paměti virtuálního počítače v MB.
properties.networkInterfaces	NetworkInterface[]	Získá síťová rozhraní šablony.
properties.osName	string	Získá název operačního systému.
properties.osType	OsType	Získá typ operačního systému.
properties.provisioningState	ProvisioningState	Stav zřizování prostředku
properties.uuid	string	Jedinečné ID šablony virtuálního počítače
properties.vmmServerId	string	ID ARM prostředku vmmServer, ve kterém se tento prostředek nachází.
systemData	systemData	Metadata Azure Resource Manageru obsahující informace createdBy a modifiedBy
tags	object	Značky prostředků
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

VirtualMachineTemplateTagsUpdate

Typ použitý k aktualizaci značek v prostředcích VirtualMachineTemplate.

Name	Typ	Description
tags	object	Značky prostředků

Sdílet prostřednictvím

Virtual Machine Templates - Update

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

VirtualMachineTemplates_Update_MaximumSet

Ukázkový požadavek

Ukázková odpověď

VirtualMachineTemplates_Update_MinimumSet

Ukázkový požadavek

Ukázková odpověď

Definice

AllocationMethod

createdByType

CreateDiffDisk

DynamicMemoryEnabled

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

IsCustomizable

IsHighlyAvailable

LimitCpuForMigration

NetworkInterface

OsType

ProvisioningState

StorageQosPolicyDetails

systemData

VirtualDisk

VirtualMachineTemplate

VirtualMachineTemplateTagsUpdate

Další materiály