Virtual Machine Templates - Get

Odwołanie

Usługa:: Azure Arc enabled SCVMM

Wersja interfejsu API:: 2024-06-01

Pobiera element VirtualMachineTemplate.
Implementuje metodę GET VirtualMachineTemplate.

GET 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 minLength: 1 maxLength: 90	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 minLength: 1 maxLength: 54 pattern: [a-zA-Z0-9-_\.]	Nazwa maszyny wirtualnej VirtualMachineTemplate.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	VirtualMachineTemplate	Operacja platformy Azure została ukończona pomyślnie.
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_Get_MaximumSet

VirtualMachineTemplates_Get_MinimumSet

VirtualMachineTemplates_Get_MaximumSet

Przykładowe żądanie

HTTP

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

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

VirtualMachineTemplates_Get_MinimumSet

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:: 200

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

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.

AllocationMethod

Wyliczanie

Metoda alokacji adresów sieciowych.

Wartość	Opis
Dynamic	Adres przydzielany dynamicznie.
Static	Statycznie przydzielony adres.

createdByType

Wyliczanie

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

Wartość	Opis
Application
Key
ManagedIdentity
User

CreateDiffDisk

Wyliczanie

Utwórz dysk różnicowy.

Wartość	Opis
false	Wyłącz dysk różnicowy tworzenia.
true	Włącz tworzenie dysku różnicowego.

DynamicMemoryEnabled

Wyliczanie

Włączono pamięć dynamiczną.

Wartość	Opis
false	Wyłącz pamięć dynamiczną.
true	Włącz pamięć dynamiczną.

ErrorAdditionalInfo

Objekt

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

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

ErrorDetail

Objekt

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

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

ExtendedLocation

Objekt

Lokalizacja rozszerzona.

Nazwa	Typ	Opis
name	string (arm-id)	Nazwa lokalizacji rozszerzonej.
type	string	Typ lokalizacji rozszerzonej.

IsCustomizable

Wyliczanie

Konfigurowalny.

Wartość	Opis
false	Wyłącz możliwość dostosowywania.
true	Włącz możliwość dostosowywania.

IsHighlyAvailable

Wyliczanie

Wysoka dostępność.

Wartość	Opis
false	Wyłącz wysoką dostępność.
true	Włącz wysoką dostępność.

LimitCpuForMigration

Wyliczanie

Ogranicz użycie procesora CPU do migracji.

Wartość	Opis
false	Wyłącz limit procesora CPU na potrzeby migracji.
true	Włącz limit procesora CPU na potrzeby migracji.

NetworkInterface

Objekt

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 (arm-id)	Pobiera lub ustawia identyfikator ARM zasobu Microsoft.ScVmm/virtualNetwork w celu połączenia karty sieciowej.

OsType

Wyliczanie

Typ systemu operacyjnego maszyny wirtualnej.

Wartość	Opis
Linux	System operacyjny Linux.
Other	Inny system operacyjny.
Windows	System operacyjny Windows.

ProvisioningState

Wyliczanie

Stan aprowizacji zasobu.

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

StorageQosPolicyDetails

Objekt

Definicja StorageQoSPolicyDetails.

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

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	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 (date-time)	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

Objekt

Model dysku wirtualnego

Nazwa	Typ	Opis
bus	integer (int32)	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 (int32)	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 (int32)	Pobiera lub ustawia numer lun dysku.
maxDiskSizeGB	integer (int32)	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

Objekt

Definicja zasobu VirtualMachineTemplates.

Nazwa	Typ	Opis
extendedLocation	ExtendedLocation	Lokalizacja rozszerzona.
id	string (arm-id)	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 (int32)	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 (int32)	Pobiera maksymalną pamięć dynamiczną dla maszyny wirtualnej.
properties.dynamicMemoryMinMB	integer (int32)	Pobiera minimalną pamięć dynamiczną dla maszyny wirtualnej.
properties.generation	integer (int32)	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 (int32)	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 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}$	Unikatowy identyfikator szablonu maszyny wirtualnej.
properties.vmmServerId	string (arm-id)	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"

Udostępnij za pośrednictwem

Virtual Machine Templates - Get

Parametry identyfikatora URI

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresy

Przykłady

VirtualMachineTemplates_Get_MaximumSet

Przykładowe żądanie

Przykładowa odpowiedź

VirtualMachineTemplates_Get_MinimumSet

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

AllocationMethod

createdByType

CreateDiffDisk

DynamicMemoryEnabled

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

IsCustomizable

IsHighlyAvailable

LimitCpuForMigration

NetworkInterface

OsType

ProvisioningState

StorageQosPolicyDetails

systemData

VirtualDisk

VirtualMachineTemplate

Dodatkowe zasoby