Virtual Machine Templates - Update

Usługa:

Azure Arc enabled SCVMM

Wersja interfejsu API:

2024-06-01

Implementuje metodę VIRTUALMachineTemplate PATCH.
Aktualizuje zasób VirtualMachineTemplate.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
resourceGroupName	path	True	string	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string uuid	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
virtualMachineTemplateName	path	True	string	Nazwa maszyny wirtualnej VirtualMachineTemplate. Wzorzec wyrażenia regularnego: [a-zA-Z0-9-_\.]
api-version	query	True	string	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Typ	Opis
tags	object	Tagi zasobów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	VirtualMachineTemplate	Operacja platformy Azure została ukończona pomyślnie.
202 Accepted		Zaakceptowano żądanie aktualizacji zasobów. Nagłówki Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

VirtualMachineTemplates_Update_MaximumSet

VirtualMachineTemplates_Update_MinimumSet

VirtualMachineTemplates_Update_MaximumSet

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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

Kod stanu:

202

location: https://contoso.com/operationstatus

VirtualMachineTemplates_Update_MinimumSet

Przykładowe żądanie

HTTP

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

{}

Przykładowa odpowiedź

Kod stanu:

200

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

Kod stanu:

202

location: https://contoso.com/operationstatus

Definicje

Nazwa	Opis
AllocationMethod	Metoda alokacji adresów sieciowych.
createdByType	Typ tożsamości, która utworzyła zasób.
CreateDiffDisk	Utwórz dysk różnicowy.
DynamicMemoryEnabled	Włączono pamięć dynamiczną.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
ExtendedLocation	Lokalizacja rozszerzona.
IsCustomizable	Konfigurowalny.
IsHighlyAvailable	Wysoka dostępność.
LimitCpuForMigration	Ogranicz użycie procesora CPU do migracji.
NetworkInterface	Model interfejsu sieciowego
OsType	Typ systemu operacyjnego maszyny wirtualnej.
ProvisioningState	Stan aprowizacji zasobu.
StorageQosPolicyDetails	Definicja StorageQoSPolicyDetails.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
VirtualDisk	Model dysku wirtualnego
VirtualMachineTemplate	Definicja zasobu VirtualMachineTemplates.
VirtualMachineTemplateTagsUpdate	Typ używany do aktualizowania tagów w zasobach VirtualMachineTemplate.

AllocationMethod

Metoda alokacji adresów sieciowych.

Nazwa	Typ	Opis
Dynamic	string	Adres przydzielany dynamicznie.
Static	string	Statycznie przydzielony adres.

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa	Typ	Opis
Application	string
Key	string
ManagedIdentity	string
User	string

CreateDiffDisk

Utwórz dysk różnicowy.

Nazwa	Typ	Opis
false	string	Wyłącz dysk różnicowy tworzenia.
true	string	Włącz tworzenie dysku różnicowego.

DynamicMemoryEnabled

Włączono pamięć dynamiczną.

Nazwa	Typ	Opis
false	string	Wyłącz pamięć dynamiczną.
true	string	Włącz pamięć dynamiczną.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

ExtendedLocation

Lokalizacja rozszerzona.

Nazwa	Typ	Opis
name	string	Nazwa lokalizacji rozszerzonej.
type	string	Typ lokalizacji rozszerzonej.

IsCustomizable

Konfigurowalny.

Nazwa	Typ	Opis
false	string	Wyłącz możliwość dostosowywania.
true	string	Włącz możliwość dostosowywania.

IsHighlyAvailable

Wysoka dostępność.

Nazwa	Typ	Opis
false	string	Wyłącz wysoką dostępność.
true	string	Włącz wysoką dostępność.

LimitCpuForMigration

Ogranicz użycie procesora CPU do migracji.

Nazwa	Typ	Opis
false	string	Wyłącz limit procesora CPU na potrzeby migracji.
true	string	Włącz limit procesora CPU na potrzeby migracji.

NetworkInterface

Model interfejsu sieciowego

Nazwa	Typ	Opis
displayName	string	Pobiera nazwę wyświetlaną interfejsu sieciowego, jak pokazano na serwerze vmmServer. Jest to etykieta rezerwowa dla karty sieciowej, gdy nazwa nie jest ustawiona.
ipv4AddressType	AllocationMethod	Pobiera lub ustawia typ adresu ipv4.
ipv4Addresses	string[]	Pobiera adresy ipv4 karty sieciowej.
ipv6AddressType	AllocationMethod	Pobiera lub ustawia typ adresu ipv6.
ipv6Addresses	string[]	Pobiera adresy ipv6 karty sieciowej.
macAddress	string	Pobiera lub ustawia adres MAC karty sieciowej.
macAddressType	AllocationMethod	Pobiera lub ustawia typ adresu mac.
name	string	Pobiera lub ustawia nazwę interfejsu sieciowego.
networkName	string	Pobiera nazwę sieci wirtualnej w programie vmmServer, z którą jest połączona karta sieciowa.
nicId	string	Pobiera lub ustawia identyfikator karty sieciowej.
virtualNetworkId	string	Pobiera lub ustawia identyfikator ARM zasobu Microsoft.ScVmm/virtualNetwork w celu połączenia karty sieciowej.

OsType

Typ systemu operacyjnego maszyny wirtualnej.

Nazwa	Typ	Opis
Linux	string	System operacyjny Linux.
Other	string	Inny system operacyjny.
Windows	string	System operacyjny Windows.

ProvisioningState

Stan aprowizacji zasobu.

Nazwa	Typ	Opis
Accepted	string	Zasób został zaakceptowany.
Canceled	string	Tworzenie zasobów zostało anulowane.
Created	string	Zasób został utworzony.
Deleting	string	Zasób jest usuwany.
Failed	string	Tworzenie zasobu nie powiodło się.
Provisioning	string	Zasób aprowizacji.
Succeeded	string	Zasób został utworzony.
Updating	string	Zasób jest aktualizowany.

StorageQosPolicyDetails

Definicja StorageQoSPolicyDetails.

Nazwa	Typ	Opis
id	string	Identyfikator zasad QoS.
name	string	Nazwa zasad.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string	Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

VirtualDisk

Model dysku wirtualnego

Nazwa	Typ	Opis
bus	integer	Pobiera lub ustawia magistralę dysków.
busType	string	Pobiera lub ustawia typ magistrali dysku.
createDiffDisk	CreateDiffDisk	Pobiera lub ustawia wartość wskazującą różnicę dysku.
diskId	string	Pobiera lub ustawia identyfikator dysku.
diskSizeGB	integer	Pobiera lub ustawia całkowity rozmiar dysku.
displayName	string	Pobiera nazwę wyświetlaną dysku wirtualnego, jak pokazano na serwerze vmmServer. Jest to etykieta rezerwowa dysku, gdy nazwa nie jest ustawiona.
lun	integer	Pobiera lub ustawia numer lun dysku.
maxDiskSizeGB	integer	Pobiera maksymalny rozmiar dysku.
name	string	Pobiera lub ustawia nazwę dysku.
storageQoSPolicy	StorageQosPolicyDetails	Zasady QoS dla dysku.
templateDiskId	string	Pobiera lub ustawia identyfikator dysku w szablonie.
vhdFormatType	string	Pobiera typ formatu dysku vhd.
vhdType	string	Pobiera lub ustawia typ dysku vhd.
volumeType	string	Pobiera typ woluminu dysku.

VirtualMachineTemplate

Definicja zasobu VirtualMachineTemplates.

Nazwa	Typ	Opis
extendedLocation	ExtendedLocation	Lokalizacja rozszerzona.
id	string	W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Lokalizacja geograficzna, w której znajduje się zasób
name	string	Nazwa zasobu
properties.computerName	string	Pobiera nazwę komputera.
properties.cpuCount	integer	Pobiera żądaną liczbę procesorów wirtualnych dla maszyny wirtualnej.
properties.disks	VirtualDisk[]	Pobiera dyski szablonu.
properties.dynamicMemoryEnabled	DynamicMemoryEnabled	Pobiera wartość wskazującą, czy włączyć pamięć dynamiczną, czy nie.
properties.dynamicMemoryMaxMB	integer	Pobiera maksymalną pamięć dynamiczną dla maszyny wirtualnej.
properties.dynamicMemoryMinMB	integer	Pobiera minimalną pamięć dynamiczną dla maszyny wirtualnej.
properties.generation	integer	Pobiera generację maszyny wirtualnej.
properties.inventoryItemId	string	Pobiera lub ustawia identyfikator elementu spisu dla zasobu.
properties.isCustomizable	IsCustomizable	Pobiera wartość wskazującą, czy szablon maszyny wirtualnej można dostosowywać, czy nie.
properties.isHighlyAvailable	IsHighlyAvailable	Pobiera właściwość o wysokiej dostępności.
properties.limitCpuForMigration	LimitCpuForMigration	Pobiera wartość wskazującą, czy włączyć tryb zgodności procesora na potrzeby migracji na żywo maszyn wirtualnych.
properties.memoryMB	integer	PamięćMB jest żądanym rozmiarem pamięci maszyny wirtualnej w MB.
properties.networkInterfaces	NetworkInterface[]	Pobiera interfejsy sieciowe szablonu.
properties.osName	string	Pobiera nazwę systemu operacyjnego.
properties.osType	OsType	Pobiera typ systemu operacyjnego.
properties.provisioningState	ProvisioningState	Stan aprowizacji zasobu.
properties.uuid	string	Unikatowy identyfikator szablonu maszyny wirtualnej.
properties.vmmServerId	string	Identyfikator usługi ARM zasobu vmmServer, w którym znajduje się ten zasób.
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy.
tags	object	Tagi zasobów.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

VirtualMachineTemplateTagsUpdate

Typ używany do aktualizowania tagów w zasobach VirtualMachineTemplate.

Nazwa	Typ	Opis
tags	object	Tagi zasobów.