Virtual Machine Templates - Get

Riferimento

Servizio:: Azure Arc enabled SCVMM

Versione API:: 2024-06-01

Ottiene un oggetto VirtualMachineTemplate.
Implementa il metodo GET VirtualMachineTemplate.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string	Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.
subscriptionId	path	True	string uuid	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
virtualMachineTemplateName	path	True	string	Nome di VirtualMachineTemplate. Criterio di espressione regolare: `[a-zA-Z0-9-_\.]`
api-version	query	True	string	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	VirtualMachineTemplate	Operazione di Azure completata correttamente.
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

VirtualMachineTemplates_Get_MaximumSet

VirtualMachineTemplates_Get_MinimumSet

VirtualMachineTemplates_Get_MaximumSet

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 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

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 200

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

Definizioni

Nome	Descrizione
AllocationMethod	Metodo di allocazione degli indirizzi di rete.
createdByType	Tipo di identità che ha creato la risorsa.
CreateDiffDisk	Creare un disco diff.
DynamicMemoryEnabled	Memoria dinamica abilitata.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
ExtendedLocation	Posizione estesa.
IsCustomizable	Personalizzabile.
IsHighlyAvailable	Disponibilità elevata.
LimitCpuForMigration	Limitare la CPU per la migrazione.
NetworkInterface	Modello di interfaccia di rete
OsType	Tipo di sistema operativo macchina virtuale.
ProvisioningState	Stato di provisioning della risorsa.
StorageQosPolicyDetails	Definizione StorageQoSPolicyDetails.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
VirtualDisk	Modello di disco virtuale
VirtualMachineTemplate	Definizione della risorsa VirtualMachineTemplates.

AllocationMethod

Metodo di allocazione degli indirizzi di rete.

Nome	Tipo	Descrizione
Dynamic	string	Indirizzo allocato in modo dinamico.
Static	string	Indirizzo allocato in modo statico.

createdByType

Tipo di identità che ha creato la risorsa.

Nome	Tipo	Descrizione
Application	string
Key	string
ManagedIdentity	string
User	string

CreateDiffDisk

Creare un disco diff.

Nome	Tipo	Descrizione
false	string	Disabilitare la creazione del disco diff.
true	string	Abilitare la creazione del disco diff.

DynamicMemoryEnabled

Memoria dinamica abilitata.

Nome	Tipo	Descrizione
false	string	Disabilitare la memoria dinamica.
true	string	Abilitare la memoria dinamica.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ExtendedLocation

Posizione estesa.

Nome	Tipo	Descrizione
name	string	Nome della posizione estesa.
type	string	Tipo di posizione estesa.

IsCustomizable

Personalizzabile.

Nome	Tipo	Descrizione
false	string	Disabilita personalizzabile.
true	string	Abilitare personalizzabili.

IsHighlyAvailable

Disponibilità elevata.

Nome	Tipo	Descrizione
false	string	Disabilitare la disponibilità elevata.
true	string	Abilitare la disponibilità elevata.

LimitCpuForMigration

Limitare la CPU per la migrazione.

Nome	Tipo	Descrizione
false	string	Disabilitare il limite di CPU per la migrazione.
true	string	Abilitare il limite della CPU per la migrazione.

NetworkInterface

Modello di interfaccia di rete

Nome	Tipo	Descrizione
displayName	string	Ottiene il nome visualizzato dell'interfaccia di rete, come illustrato in vmmServer. Si tratta dell'etichetta di fallback per una scheda di interfaccia di rete quando il nome non è impostato.
ipv4AddressType	AllocationMethod	Ottiene o imposta il tipo di indirizzo ipv4.
ipv4Addresses	string[]	Ottiene gli indirizzi ipv4 della scheda di interfaccia di rete.
ipv6AddressType	AllocationMethod	Ottiene o imposta il tipo di indirizzo ipv6.
ipv6Addresses	string[]	Ottiene gli indirizzi ipv6 della scheda di interfaccia di rete.
macAddress	string	Ottiene o imposta l'indirizzo MAC della scheda di interfaccia di rete.
macAddressType	AllocationMethod	Ottiene o imposta il tipo di indirizzo mac.
name	string	Ottiene o imposta il nome dell'interfaccia di rete.
networkName	string	Ottiene il nome della rete virtuale in vmmServer a cui è connessa la scheda di interfaccia di rete.
nicId	string	Ottiene o imposta l'ID scheda di interfaccia di rete.
virtualNetworkId	string	Ottiene o imposta l'ID ARM della risorsa Microsoft.ScVmm/virtualNetwork per connettere la scheda di interfaccia di rete.

OsType

Tipo di sistema operativo macchina virtuale.

Nome	Tipo	Descrizione
Linux	string	Sistema operativo Linux.
Other	string	Altro sistema operativo.
Windows	string	Sistema operativo Windows.

ProvisioningState

Stato di provisioning della risorsa.

Nome	Tipo	Descrizione
Accepted	string	La risorsa è stata accettata.
Canceled	string	La creazione della risorsa è stata annullata.
Created	string	La risorsa è stata creata.
Deleting	string	La risorsa viene eliminata.
Failed	string	Creazione della risorsa non riuscita.
Provisioning	string	La risorsa è il provisioning.
Succeeded	string	La risorsa è stata creata.
Updating	string	La risorsa viene aggiornata.

StorageQosPolicyDetails

Definizione StorageQoSPolicyDetails.

Nome	Tipo	Descrizione
id	string	ID dei criteri QoS.
name	string	Nome del criterio.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

VirtualDisk

Modello di disco virtuale

Nome	Tipo	Descrizione
bus	integer	Ottiene o imposta il bus del disco.
busType	string	Ottiene o imposta il tipo di bus del disco.
createDiffDisk	CreateDiffDisk	Ottiene o imposta un valore che indica il disco diff.
diskId	string	Ottiene o imposta l'ID disco.
diskSizeGB	integer	Ottiene o imposta le dimensioni totali del disco.
displayName	string	Ottiene il nome visualizzato del disco virtuale, come illustrato in vmmServer. Si tratta dell'etichetta di fallback per un disco quando il nome non è impostato.
lun	integer	Ottiene o imposta il lun del disco.
maxDiskSizeGB	integer	Ottiene la dimensione massima del disco.
name	string	Ottiene o imposta il nome del disco.
storageQoSPolicy	StorageQosPolicyDetails	Criteri QoS per il disco.
templateDiskId	string	Ottiene o imposta l'ID disco nel modello.
vhdFormatType	string	Ottiene il tipo di formato vhd del disco.
vhdType	string	Ottiene o imposta il tipo di disco rigido virtuale del disco.
volumeType	string	Ottiene il tipo di volume del disco.

VirtualMachineTemplate

Definizione della risorsa VirtualMachineTemplates.

Nome	Tipo	Descrizione
extendedLocation	ExtendedLocation	Posizione estesa.
id	string	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Posizione geografica in cui risiede la risorsa
name	string	Nome della risorsa
properties.computerName	string	Ottiene il nome del computer.
properties.cpuCount	integer	Ottiene il numero desiderato di vCPU per la macchina virtuale.
properties.disks	VirtualDisk[]	Ottiene i dischi del modello.
properties.dynamicMemoryEnabled	DynamicMemoryEnabled	Ottiene un valore che indica se abilitare o meno la memoria dinamica.
properties.dynamicMemoryMaxMB	integer	Ottiene la memoria dinamica massima per la macchina virtuale.
properties.dynamicMemoryMinMB	integer	Ottiene la quantità minima di memoria dinamica per la macchina virtuale.
properties.generation	integer	Ottiene la generazione per la macchina virtuale.
properties.inventoryItemId	string	Ottiene o imposta l'ID dell'elemento di inventario per la risorsa.
properties.isCustomizable	IsCustomizable	Ottiene un valore che indica se il modello di macchina virtuale è personalizzabile o meno.
properties.isHighlyAvailable	IsHighlyAvailable	Ottiene una proprietà a disponibilità elevata.
properties.limitCpuForMigration	LimitCpuForMigration	Ottiene un valore che indica se abilitare la modalità di compatibilità del processore per la migrazione in tempo reale delle macchine virtuali.
properties.memoryMB	integer	MemoryMB è la dimensione desiderata della memoria di una macchina virtuale, in MB.
properties.networkInterfaces	NetworkInterface[]	Ottiene le interfacce di rete del modello.
properties.osName	string	Ottiene il nome del sistema operativo.
properties.osType	OsType	Ottiene il tipo del sistema operativo.
properties.provisioningState	ProvisioningState	Stato di provisioning della risorsa.
properties.uuid	string	ID univoco del modello di macchina virtuale.
properties.vmmServerId	string	ID ARM della risorsa vmmServer in cui risiede questa risorsa.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
tags	object	Tag di risorsa.
type	string	Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

Condividi tramite

Virtual Machine Templates - Get

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

VirtualMachineTemplates_Get_MaximumSet

Esempio di richiesta

Risposta di esempio

VirtualMachineTemplates_Get_MinimumSet

Esempio di richiesta

Risposta di esempio

Definizioni

AllocationMethod

createdByType

CreateDiffDisk

DynamicMemoryEnabled

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

IsCustomizable

IsHighlyAvailable

LimitCpuForMigration

NetworkInterface

OsType

ProvisioningState

StorageQosPolicyDetails

systemData

VirtualDisk

VirtualMachineTemplate

Risorse aggiuntive