Virtual Machine Image Templates - Get

Servizio:: Image Builder

Versione API:: 2022-07-01

Ottenere informazioni su un modello di immagine di macchina virtuale

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}?api-version=2022-07-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
imageTemplateName	path	True	string pattern: ^[A-Za-z0-9-_.]{1,64}$	Nome del modello di immagine
resourceGroupName	path	True	string	Nome del gruppo di risorse.
subscriptionId	path	True	string	Credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata al servizio.
api-version	query	True	string	Versione dell'API client.

Risposte

Nome	Tipo	Descrizione
200 OK	ImageTemplate	Va bene
Other Status Codes	CloudError	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

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

Retrieve an Image Template.

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate?api-version=2022-07-01

Risposta di esempio

Codice di stato:: 200

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate",
  "name": "myImageTemplate",
  "location": "westus",
  "type": "Microsoft.VirtualMachineImages/imageTemplates",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity_1": {
        "clientId": "00000000-0000-0000-0000-000000000000",
        "principalId": "00000000-0000-0000-0000-000000000000"
      }
    }
  },
  "properties": {
    "source": {
      "type": "ManagedImage",
      "imageId": "/subscriptions/{subscription-id}/resourceGroups/source_rg/providers/Microsoft.Compute/images/source_image"
    },
    "customize": [
      {
        "type": "Shell",
        "name": "Shell Customizer Example",
        "scriptUri": "https://example.com/path/to/script.sh"
      }
    ],
    "distribute": [
      {
        "type": "ManagedImage",
        "location": "1_location",
        "runOutputName": "image_it_pir_1",
        "imageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/image_it_1",
        "artifactTags": {
          "tagName": "value"
        }
      }
    ],
    "vmProfile": {
      "vmSize": "Standard_D2s_v3",
      "osDiskSizeGB": 64
    }
  }
}

Definizioni

Nome	Descrizione
CloudError	Risposta di errore dal servizio Image Builder della macchina virtuale di Azure.
CloudErrorBody	Risposta di errore dal servizio Image Builder della macchina virtuale di Azure.
createdByType	Tipo di identità che ha creato la risorsa.
DistributeVersionerLatest	Genera il numero di versione che verrà aggiornato in base ai numeri di versione esistenti.
DistributeVersionerSource	Genera il numero di versione in base al numero di versione dell'immagine di origine
ImageTemplate	Il modello di immagine è una risorsa arm gestita dal provider Microsoft.VirtualMachineImages
ImageTemplateFileCustomizer	Carica i file nelle macchine virtuali (Linux, Windows). Corrisponde al provisioner di file packer
ImageTemplateFileValidator	Carica i file necessari per la convalida nelle macchine virtuali (Linux, Windows). Corrisponde al provisioner di file packer
ImageTemplateIdentity	Identità per il modello di immagine.
ImageTemplateLastRunStatus	Descrive lo stato più recente dell'esecuzione di un modello di immagine
ImageTemplateManagedImageDistributor	Distribuire come immagine del disco gestito.
ImageTemplateManagedImageSource	Descrive un'origine immagine che è un'immagine gestita nella sottoscrizione del cliente. Questa immagine deve trovarsi nella stessa sottoscrizione e nella stessa area del modello di Image Builder.
ImageTemplatePlatformImageSource	Descrive un'origine immagine da immagini della raccolta di Azure.
ImageTemplatePowerShellCustomizer	Esegue l'oggetto PowerShell specificato nella macchina virtuale (Windows). Corrisponde al provisioner powershell packer. È possibile specificare esattamente uno di "scriptUri" o "inline".
ImageTemplatePowerShellValidator	Esegue lo script di PowerShell specificato durante la fase di convalida (Windows). Corrisponde al provisioner powershell packer. È possibile specificare esattamente uno di "scriptUri" o "inline".
ImageTemplateRestartCustomizer	Riavvia una macchina virtuale e attende che torni online (Windows). Corrisponde al provisioner windows-restart packer
ImageTemplateSharedImageDistributor	Distribuire tramite La raccolta di calcolo di Azure.
ImageTemplateSharedImageVersionSource	Descrive un'origine immagine che rappresenta una versione dell'immagine in una raccolta di calcolo di Azure o in una raccolta condivisa diretta.
ImageTemplateShellCustomizer	Esegue uno script della shell durante la fase di personalizzazione (Linux). Corrisponde al provisioner della shell Packer. È possibile specificare esattamente uno di "scriptUri" o "inline".
ImageTemplateShellValidator	Esegue lo script della shell specificato durante la fase di convalida (Linux). Corrisponde al provisioner della shell Packer. È possibile specificare esattamente uno di "scriptUri" o "inline".
ImageTemplateVhdDistributor	Distribuire tramite disco rigido virtuale in un account di archiviazione.
ImageTemplateVmProfile	Descrive le macchine virtuali usate per compilare e convalidare le immagini
ImageTemplateWindowsUpdateCustomizer	Installa gli aggiornamenti di Windows. Corrisponde a Packer Windows Update Provisioner (https://github.com/rgl/packer-provisioner-windows-update)
Optimize	Specifica l'ottimizzazione da eseguire sull'immagine.
PlatformImagePurchasePlan	Configurazione del piano di acquisto per l'immagine della piattaforma.
ProvisioningError	Descrive l'errore che si è verificato durante la creazione o l'aggiornamento di un modello di immagine
ProvisioningErrorCode	Codice di errore dell'errore di provisioning
ProvisioningState	Stato di provisioning della risorsa
ResourceIdentityType	Tipo di identità usata per il modello di immagine. Il tipo 'None' rimuoverà le identità dal modello di immagine.
RunState	Stato dell'ultima esecuzione
RunSubState	Stato secondario dell'ultima esecuzione
SharedImageStorageAccountType	Specifica il tipo di account di archiviazione in cui archiviare la versione dell'immagine della raccolta di calcolo di Azure.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
TargetRegion	Descrive le informazioni sull'area di destinazione.
UserAssignedIdentity	Proprietà di identità assegnate dall'utente
Validate	Opzioni di configurazione e elenco di convalide da eseguire sull'immagine risultante.
VirtualNetworkConfig	Configurazione della rete virtuale.
VmBoot	L'ottimizzazione viene applicata all'immagine per un avvio di macchina virtuale più veloce.
VMBootOptimizationState	L'abilitazione di questo campo migliorerà il tempo di avvio della macchina virtuale ottimizzando l'output finale dell'immagine personalizzata.

CloudError

Object

Risposta di errore dal servizio Image Builder della macchina virtuale di Azure.

Nome	Tipo	Descrizione
error	CloudErrorBody	Dettagli sull'errore.

CloudErrorBody

Object

Risposta di errore dal servizio Image Builder della macchina virtuale di Azure.

Nome	Tipo	Descrizione
code	string	Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.
details	CloudErrorBody[]	Elenco di dettagli aggiuntivi sull'errore.
message	string	Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.
target	string	Destinazione dell'errore specifico. Ad esempio, il nome della proprietà in errore.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

DistributeVersionerLatest

Object

Genera il numero di versione che verrà aggiornato in base ai numeri di versione esistenti.

Nome	Tipo	Valore predefinito	Descrizione
major	integer (int32) minimum: -1	-1	Versione principale per il numero di versione generato. Determinare che cos'è "latest" in base alle versioni con questo valore come versione principale. -1 equivale a lasciarlo non impostato.
scheme	string: Latest		Schema di numerazione delle versioni da usare.

DistributeVersionerSource

Object

Genera il numero di versione in base al numero di versione dell'immagine di origine

Nome	Tipo	Descrizione
scheme	string: Source	Schema di numerazione delle versioni da usare.

ImageTemplate

Object

Il modello di immagine è una risorsa arm gestita dal provider Microsoft.VirtualMachineImages

Nome	Tipo	Valore predefinito	Descrizione
id	string		ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ImageTemplateIdentity		Identità del modello di immagine, se configurata.
location	string		Posizione geografica in cui risiede la risorsa
name	string		Nome della risorsa
properties.buildTimeoutInMinutes	integer (int32) minimum: 0 maximum: 960	0	Durata massima di attesa durante la compilazione del modello di immagine (include tutte le personalizzazioni, l'ottimizzazione, le convalide e le distribuzioni). Omettere o specificare 0 per usare il valore predefinito (4 ore).
properties.customize	ImageTemplateCustomizer[]: ImageTemplateFileCustomizer[] ImageTemplatePowerShellCustomizer[] ImageTemplateRestartCustomizer[] ImageTemplateShellCustomizer[] ImageTemplateWindowsUpdateCustomizer[]		Specifica le proprietà usate per descrivere i passaggi di personalizzazione dell'immagine, ad esempio Origine immagine e così via
properties.distribute	ImageTemplateDistributor[]: ImageTemplateManagedImageDistributor[] ImageTemplateSharedImageDistributor[] ImageTemplateVhdDistributor[]		Le destinazioni di distribuzione in cui l'output dell'immagine deve passare.
properties.exactStagingResourceGroup	string		ID del gruppo di risorse di staging nella stessa sottoscrizione del modello di immagine che verrà usato per compilare l'immagine. Questo campo di sola lettura è diverso da 'stagingResourceGroup' solo se il valore specificato nel campo 'stagingResourceGroup' è vuoto.
properties.lastRunStatus	ImageTemplateLastRunStatus		Stato di 'run' attualmente in esecuzione o ultima esecuzione.
properties.optimize	Optimize		Specifica l'ottimizzazione da eseguire sull'immagine.
properties.provisioningError	ProvisioningError		Errore di provisioning, se disponibile
properties.provisioningState	ProvisioningState		Stato di provisioning della risorsa
properties.source	ImageTemplateSource: ImageTemplateManagedImageSource ImageTemplatePlatformImageSource ImageTemplateSharedImageVersionSource		Specifica le proprietà utilizzate per descrivere l'immagine di origine.
properties.stagingResourceGroup	string		ID del gruppo di risorse di staging nella stessa sottoscrizione del modello di immagine che verrà usato per compilare l'immagine. Se questo campo è vuoto, verrà creato un gruppo di risorse con un nome casuale. Se il gruppo di risorse specificato in questo campo non esiste, verrà creato con lo stesso nome. Se il gruppo di risorse specificato esiste, deve essere vuoto e nella stessa area del modello di immagine. Il gruppo di risorse creato verrà eliminato durante l'eliminazione del modello se questo campo è vuoto o il gruppo di risorse specificato non esiste, ma se il gruppo di risorse specificato esiste le risorse create nel gruppo di risorse verrà eliminato durante l'eliminazione del modello e il gruppo di risorse stesso rimarrà.
properties.validate	Validate		Opzioni di configurazione e elenco di convalide da eseguire sull'immagine risultante.
properties.vmProfile	ImageTemplateVmProfile		Viene descritto come viene configurata la macchina virtuale per la compilazione di immagini
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"

ImageTemplateFileCustomizer

Object

Carica i file nelle macchine virtuali (Linux, Windows). Corrisponde al provisioner di file packer

Nome	Tipo	Descrizione
destination	string	Percorso assoluto di un file (con strutture di directory annidate già create) in cui il file (da sourceUri) verrà caricato nella macchina virtuale
name	string	Nome descrittivo per fornire contesto sulle operazioni eseguite da questo passaggio di personalizzazione
sha256Checksum	string	Checksum SHA256 del file fornito nel campo sourceUri precedente
sourceUri	string	URI del file da caricare per personalizzare la macchina virtuale. Può essere un collegamento github, un URI di firma di accesso condiviso per Archiviazione di Azure e così via
type	string: File	Tipo di strumento di personalizzazione da usare nell'immagine. Ad esempio, "Shell" può essere un addetto alla personalizzazione della shell

ImageTemplateFileValidator

Object

Carica i file necessari per la convalida nelle macchine virtuali (Linux, Windows). Corrisponde al provisioner di file packer

Nome	Tipo	Descrizione
destination	string	Percorso assoluto di un file (con strutture di directory annidate già create) in cui il file (da sourceUri) verrà caricato nella macchina virtuale
name	string	Nome descrittivo per fornire contesto sulle operazioni eseguite da questo passaggio di convalida
sha256Checksum	string	Checksum SHA256 del file fornito nel campo sourceUri precedente
sourceUri	string	URI del file da caricare nella macchina virtuale per la convalida. Può trattarsi di un collegamento github, un URI di Archiviazione di Azure (autorizzato o sas) e così via
type	string: File	Tipo di convalida da usare nell'immagine. Ad esempio, "Shell" può essere la convalida della shell

ImageTemplateIdentity

Object

Identità per il modello di immagine.

Nome	Tipo	Descrizione
type	ResourceIdentityType	Tipo di identità usata per il modello di immagine. Il tipo 'None' rimuoverà le identità dal modello di immagine.
userAssignedIdentities	<string, UserAssignedIdentity>	identità User-Assigned Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.

ImageTemplateLastRunStatus

Object

Descrive lo stato più recente dell'esecuzione di un modello di immagine

Nome	Tipo	Descrizione
endTime	string (date-time)	Ora di fine dell'ultima esecuzione (UTC)
message	string	Informazioni dettagliate sull'ultimo stato di esecuzione
runState	RunState	Stato dell'ultima esecuzione
runSubState	RunSubState	Stato secondario dell'ultima esecuzione
startTime	string (date-time)	Ora di inizio dell'ultima esecuzione (UTC)

ImageTemplateManagedImageDistributor

Object

Distribuire come immagine del disco gestito.

Nome	Tipo	Descrizione
artifactTags	object	Tag che verranno applicati all'artefatto dopo che è stato creato/aggiornato dal server di distribuzione.
imageId	string	ID risorsa dell'immagine del disco gestito
location	string	La posizione di Azure per l'immagine deve corrispondere se l'immagine esiste già
runOutputName	string pattern: ^[A-Za-z0-9-_.]{1,64}$	Nome da utilizzare per l'oggetto RunOutput associato.
type	string: ManagedImage	Tipo di distribuzione.

ImageTemplateManagedImageSource

Object

Descrive un'origine immagine che è un'immagine gestita nella sottoscrizione del cliente. Questa immagine deve trovarsi nella stessa sottoscrizione e nella stessa area del modello di Image Builder.

Nome	Tipo	Descrizione
imageId	string	ID risorsa ARM dell'immagine gestita nella sottoscrizione del cliente
type	string: ManagedImage	Specifica il tipo di immagine di origine da cui iniziare.

ImageTemplatePlatformImageSource

Object

Descrive un'origine immagine da immagini della raccolta di Azure.

Nome	Tipo	Descrizione
exactVersion	string	Versione dell'immagine dalla immagini della raccolta di Azure. Questo campo di sola lettura è diverso da 'version', solo se il valore specificato nel campo 'version' è 'latest'.
offer	string	Offerta di immagine dalla immagini della raccolta di Azure.
planInfo	PlatformImagePurchasePlan	Configurazione facoltativa del piano di acquisto per l'immagine della piattaforma.
publisher	string	Image Publisher nelle immagini della raccolta di Azure.
sku	string	Sku dell'immagine dall'immagini della raccolta di Azure.
type	string: PlatformImage	Specifica il tipo di immagine di origine da cui iniziare.
version	string	Versione dell'immagine dalla immagini della raccolta di Azure. Se in questo caso viene specificato "latest", la versione viene valutata quando viene eseguita la compilazione dell'immagine, non quando viene inviato il modello.

ImageTemplatePowerShellCustomizer

Object

Esegue l'oggetto PowerShell specificato nella macchina virtuale (Windows). Corrisponde al provisioner powershell packer. È possibile specificare esattamente uno di "scriptUri" o "inline".

Nome	Tipo	Valore predefinito	Descrizione
inline	string[]		Matrice di comandi di PowerShell da eseguire
name	string		Nome descrittivo per fornire contesto sulle operazioni eseguite da questo passaggio di personalizzazione
runAsSystem	boolean	False	Se specificato, lo script di PowerShell verrà eseguito con privilegi elevati usando l'utente sistema locale. Può essere true solo quando il campo runElevated precedente è impostato su true.
runElevated	boolean	False	Se specificato, lo script di PowerShell verrà eseguito con privilegi elevati
scriptUri	string		URI dello script di PowerShell da eseguire per la personalizzazione. Può essere un collegamento github, un URI di firma di accesso condiviso per Archiviazione di Azure e così via
sha256Checksum	string		Checksum SHA256 dello script power shell fornito nel campo scriptUri precedente
type	string: PowerShell		Tipo di strumento di personalizzazione da usare nell'immagine. Ad esempio, "Shell" può essere un addetto alla personalizzazione della shell
validExitCodes	integer[] (int32)		Codici di uscita validi per lo script di PowerShell. [Impostazione predefinita: 0]

ImageTemplatePowerShellValidator

Object

Esegue lo script di PowerShell specificato durante la fase di convalida (Windows). Corrisponde al provisioner powershell packer. È possibile specificare esattamente uno di "scriptUri" o "inline".

Nome	Tipo	Valore predefinito	Descrizione
inline	string[]		Matrice di comandi di PowerShell da eseguire
name	string		Nome descrittivo per fornire contesto sulle operazioni eseguite da questo passaggio di convalida
runAsSystem	boolean	False	Se specificato, lo script di PowerShell verrà eseguito con privilegi elevati usando l'utente sistema locale. Può essere true solo quando il campo runElevated precedente è impostato su true.
runElevated	boolean	False	Se specificato, lo script di PowerShell verrà eseguito con privilegi elevati
scriptUri	string		URI dello script di PowerShell da eseguire per la convalida. Può essere un collegamento github, un URI di Archiviazione di Azure e così via
sha256Checksum	string		Checksum SHA256 dello script power shell fornito nel campo scriptUri precedente
type	string: PowerShell		Tipo di convalida da usare nell'immagine. Ad esempio, "Shell" può essere la convalida della shell
validExitCodes	integer[] (int32)		Codici di uscita validi per lo script di PowerShell. [Impostazione predefinita: 0]

ImageTemplateRestartCustomizer

Object

Riavvia una macchina virtuale e attende che torni online (Windows). Corrisponde al provisioner windows-restart packer

Nome	Tipo	Descrizione
name	string	Nome descrittivo per fornire contesto sulle operazioni eseguite da questo passaggio di personalizzazione
restartCheckCommand	string	Comando per verificare se il riavvio è riuscito [Impostazione predefinita: '']
restartCommand	string	Comando per eseguire il riavvio [Impostazione predefinita: 'shutdown /r /f /t 0 /c "packer restart"']
restartTimeout	string	Timeout di riavvio specificato come stringa di grandezza e unità, ad esempio '5m' (5 minuti) o '2h' (2 ore) [Impostazione predefinita: '5m']
type	string: WindowsRestart	Tipo di strumento di personalizzazione da usare nell'immagine. Ad esempio, "Shell" può essere un addetto alla personalizzazione della shell

ImageTemplateSharedImageDistributor

Object

Distribuire tramite La raccolta di calcolo di Azure.

Nome	Tipo	Valore predefinito	Descrizione
artifactTags	object		Tag che verranno applicati all'artefatto dopo che è stato creato/aggiornato dal server di distribuzione.
excludeFromLatest	boolean	False	Flag che indica se la versione dell'immagine creata deve essere esclusa dalla versione più recente. Omettere di usare il valore predefinito (false).
galleryImageId	string		ID risorsa dell'immagine della raccolta di calcolo di Azure
replicationRegions	string[]		[Deprecato] Elenco di aree in cui verrà replicata l'immagine. Questo elenco può essere specificato solo se targetRegions non è specificato. Questo campo è deprecato: usare invece targetRegions.
runOutputName	string pattern: ^[A-Za-z0-9-_.]{1,64}$		Nome da utilizzare per l'oggetto RunOutput associato.
storageAccountType	SharedImageStorageAccountType		[Deprecato] Tipo di account di archiviazione da usare per archiviare l'immagine condivisa. Omettere di usare il valore predefinito (Standard_LRS). Questo campo può essere specificato solo se si specifica replicationRegions. Questo campo è deprecato: usare invece targetRegions.
targetRegions	TargetRegion[]		Le aree di destinazione in cui verrà replicata la versione dell'immagine distribuita. Questo oggetto sostituisce replicationRegions e può essere specificato solo se replicationRegions non è specificato.
type	string: SharedImage		Tipo di distribuzione.
versioning	DistributeVersioner: DistributeVersionerLatest DistributeVersionerSource		Viene descritto come generare il nuovo numero di versione x.y.z per la distribuzione.

ImageTemplateSharedImageVersionSource

Object

Descrive un'origine immagine che rappresenta una versione dell'immagine in una raccolta di calcolo di Azure o in una raccolta condivisa diretta.

Nome	Tipo	Descrizione
exactVersion	string	ID risorsa ARM esatto della versione dell'immagine. Questo campo di sola lettura differisce dall'ID versione dell'immagine in 'imageVersionId' solo se il nome della versione specificato nel campo 'imageVersionId' è 'latest'.
imageVersionId	string	ID risorsa ARM della versione dell'immagine. Quando il nome della versione dell'immagine è 'latest', la versione viene valutata quando viene eseguita la compilazione dell'immagine.
type	string: SharedImageVersion	Specifica il tipo di immagine di origine da cui iniziare.

ImageTemplateShellCustomizer

Object

Esegue uno script della shell durante la fase di personalizzazione (Linux). Corrisponde al provisioner della shell Packer. È possibile specificare esattamente uno di "scriptUri" o "inline".

Nome	Tipo	Descrizione
inline	string[]	Matrice di comandi della shell da eseguire
name	string	Nome descrittivo per fornire contesto sulle operazioni eseguite da questo passaggio di personalizzazione
scriptUri	string	URI dello script della shell da eseguire per la personalizzazione. Può essere un collegamento github, un URI di firma di accesso condiviso per Archiviazione di Azure e così via
sha256Checksum	string	Checksum SHA256 dello script della shell fornito nel campo scriptUri
type	string: Shell	Tipo di strumento di personalizzazione da usare nell'immagine. Ad esempio, "Shell" può essere un addetto alla personalizzazione della shell

ImageTemplateShellValidator

Object

Esegue lo script della shell specificato durante la fase di convalida (Linux). Corrisponde al provisioner della shell Packer. È possibile specificare esattamente uno di "scriptUri" o "inline".

Nome	Tipo	Descrizione
inline	string[]	Matrice di comandi della shell da eseguire
name	string	Nome descrittivo per fornire contesto sulle operazioni eseguite da questo passaggio di convalida
scriptUri	string	URI dello script della shell da eseguire per la convalida. Può essere un collegamento github, un URI di Archiviazione di Azure e così via
sha256Checksum	string	Checksum SHA256 dello script della shell fornito nel campo scriptUri
type	string: Shell	Tipo di convalida da usare nell'immagine. Ad esempio, "Shell" può essere la convalida della shell

ImageTemplateVhdDistributor

Object

Distribuire tramite disco rigido virtuale in un account di archiviazione.

Nome	Tipo	Descrizione
artifactTags	object	Tag che verranno applicati all'artefatto dopo che è stato creato/aggiornato dal server di distribuzione.
runOutputName	string pattern: ^[A-Za-z0-9-_.]{1,64}$	Nome da utilizzare per l'oggetto RunOutput associato.
type	string: VHD	Tipo di distribuzione.
uri	string	URI facoltativo di Archiviazione di Azure per il BLOB VHD distribuito. Omettere di usare la stringa predefinita (stringa vuota), nel qual caso il disco rigido virtuale verrà pubblicato nell'account di archiviazione nel gruppo di risorse di staging.

ImageTemplateVmProfile

Object

Descrive le macchine virtuali usate per compilare e convalidare le immagini

Nome	Tipo	Valore predefinito	Descrizione
osDiskSizeGB	integer (int32) minimum: 0	0	Dimensioni del disco del sistema operativo in GB. Omettere o specificare 0 per usare le dimensioni predefinite del disco del sistema operativo di Azure.
userAssignedIdentities	string[]		Matrice facoltativa di ID risorsa di identità gestite assegnate dall'utente da configurare nella macchina virtuale di compilazione e nella macchina virtuale di convalida. Ciò può includere l'identità del modello di immagine.
vmSize	string		Dimensioni della macchina virtuale usata per compilare, personalizzare e acquisire immagini. Omettere o specificare una stringa vuota per usare il valore predefinito (Standard_D1_v2 per le immagini Gen1 e Standard_D2ds_v4 per le immagini Gen2).
vnetConfig	VirtualNetworkConfig		Configurazione facoltativa della rete virtuale da usare per distribuire la macchina virtuale di compilazione e la macchina virtuale di convalida in . Omettere se non è necessario usare una rete virtuale specifica.

ImageTemplateWindowsUpdateCustomizer

Object

Installa gli aggiornamenti di Windows. Corrisponde a Packer Windows Update Provisioner (https://github.com/rgl/packer-provisioner-windows-update)

Nome	Tipo	Valore predefinito	Descrizione
filters	string[]		Matrice di filtri per selezionare gli aggiornamenti da applicare. Omettere o specificare una matrice vuota per usare il valore predefinito (nessun filtro). Fare riferimento al collegamento precedente per esempi e descrizione dettagliata di questo campo.
name	string		Nome descrittivo per fornire contesto sulle operazioni eseguite da questo passaggio di personalizzazione
searchCriteria	string		Criteri per la ricerca degli aggiornamenti. Omettere o specificare una stringa vuota per usare il valore predefinito (cerca tutto). Fare riferimento al collegamento precedente per esempi e descrizione dettagliata di questo campo.
type	string: WindowsUpdate		Tipo di strumento di personalizzazione da usare nell'immagine. Ad esempio, "Shell" può essere un addetto alla personalizzazione della shell
updateLimit	integer (int32) minimum: 0	0	Numero massimo di aggiornamenti da applicare alla volta. Omettere o specificare 0 per usare il valore predefinito (1000)

Optimize

Object

Specifica l'ottimizzazione da eseguire sull'immagine.

Nome	Tipo	Descrizione
vmBoot	VmBoot	L'ottimizzazione viene applicata all'immagine per un avvio di macchina virtuale più veloce.

PlatformImagePurchasePlan

Object

Configurazione del piano di acquisto per l'immagine della piattaforma.

Nome	Tipo	Descrizione
planName	string	Nome del piano di acquisto.
planProduct	string	Prodotto del piano di acquisto.
planPublisher	string	Autore del piano di acquisto.

ProvisioningError

Object

Descrive l'errore che si è verificato durante la creazione o l'aggiornamento di un modello di immagine

Nome	Tipo	Descrizione
message	string	Messaggio di errore dettagliato sull'errore di provisioning
provisioningErrorCode	ProvisioningErrorCode	Codice di errore dell'errore di provisioning

ProvisioningErrorCode

Enumerazione

Codice di errore dell'errore di provisioning

Valore	Descrizione
BadSourceType
BadPIRSource
BadManagedImageSource
BadSharedImageVersionSource
BadCustomizerType
UnsupportedCustomizerType
NoCustomizerScript
BadValidatorType
UnsupportedValidatorType
NoValidatorScript
BadDistributeType
BadSharedImageDistribute
BadStagingResourceGroup
ServerError
Other

ProvisioningState

Enumerazione

Stato di provisioning della risorsa

Valore	Descrizione
Creating
Updating
Succeeded
Failed
Deleting
Canceled

ResourceIdentityType

Enumerazione

Tipo di identità usata per il modello di immagine. Il tipo 'None' rimuoverà le identità dal modello di immagine.

Valore	Descrizione
UserAssigned
None

RunState

Enumerazione

Stato dell'ultima esecuzione

Valore	Descrizione
Running
Canceling
Succeeded
PartiallySucceeded
Failed
Canceled

RunSubState

Enumerazione

Stato secondario dell'ultima esecuzione

Valore	Descrizione
Queued
Building
Customizing
Optimizing
Validating
Distributing

SharedImageStorageAccountType

Enumerazione

Specifica il tipo di account di archiviazione in cui archiviare la versione dell'immagine della raccolta di calcolo di Azure.

Valore	Descrizione
Standard_LRS
Standard_ZRS
Premium_LRS

systemData

Object

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

Nome	Tipo	Descrizione
createdAt	string (date-time)	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 (date-time)	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.

TargetRegion

Object

Descrive le informazioni sull'area di destinazione.

Nome	Tipo	Valore predefinito	Descrizione
name	string		Nome dell'area.
replicaCount	integer (int32) minimum: 1	1	Numero di repliche della versione dell'immagine da creare in questa area. Omettere di usare il valore predefinito (1).
storageAccountType	SharedImageStorageAccountType		Specifica il tipo di account di archiviazione da usare per archiviare l'immagine in questa area. Omettere di usare il valore predefinito (Standard_LRS).

UserAssignedIdentity

Object

Proprietà di identità assegnate dall'utente

Nome	Tipo	Descrizione
clientId	string	ID client dell'identità assegnata.
principalId	string	ID entità dell'identità assegnata.

Validate

Object

Opzioni di configurazione e elenco di convalide da eseguire sull'immagine risultante.

Nome	Tipo	Valore predefinito	Descrizione
continueDistributeOnFailure	boolean	False	Se la convalida ha esito negativo e questo campo è impostato su false, le immagini di output non verranno distribuite. Si tratta del comportamento predefinito. Se la convalida ha esito negativo e questo campo è impostato su true, le immagini di output verranno comunque distribuite. Usare questa opzione con cautela perché potrebbe causare la distribuzione di immagini non dannose per l'uso. In entrambi i casi (true o false), l'esecuzione dell'immagine end-to-end verrà segnalata come non riuscita in caso di errore di convalida. [Nota: questo campo non ha alcun effetto se la convalida ha esito positivo.]
inVMValidations	ImageTemplateInVMValidator[]: ImageTemplateFileValidator[] ImageTemplatePowerShellValidator[] ImageTemplateShellValidator[]		Elenco delle convalide da eseguire.
sourceValidationOnly	boolean	False	Se questo campo è impostato su true, l'immagine specificata nella sezione 'source' verrà convalidata direttamente. Non verrà eseguita alcuna compilazione separata per generare e quindi convalidare un'immagine personalizzata.

VirtualNetworkConfig

Object

Configurazione della rete virtuale.

Nome	Tipo	Descrizione
proxyVmSize	string	Dimensioni della macchina virtuale proxy usata per passare il traffico alla macchina virtuale di compilazione e convalida. Omettere o specificare una stringa vuota per usare il valore predefinito (Standard_A1_v2).
subnetId	string	ID risorsa di una subnet preesistente.

VmBoot

Object

L'ottimizzazione viene applicata all'immagine per un avvio di macchina virtuale più veloce.

Nome	Tipo	Descrizione
state	VMBootOptimizationState	L'abilitazione di questo campo migliorerà il tempo di avvio della macchina virtuale ottimizzando l'output finale dell'immagine personalizzata.

VMBootOptimizationState

Enumerazione

L'abilitazione di questo campo migliorerà il tempo di avvio della macchina virtuale ottimizzando l'output finale dell'immagine personalizzata.

Valore	Descrizione
Enabled
Disabled

Condividi tramite

Virtual Machine Image Templates - Get

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Retrieve an Image Template.

Esempio di richiesta

Risposta di esempio

Definizioni

CloudError

CloudErrorBody

createdByType

DistributeVersionerLatest

DistributeVersionerSource

ImageTemplate

ImageTemplateFileCustomizer

ImageTemplateFileValidator

ImageTemplateIdentity

ImageTemplateLastRunStatus

ImageTemplateManagedImageDistributor

ImageTemplateManagedImageSource

ImageTemplatePlatformImageSource

ImageTemplatePowerShellCustomizer

ImageTemplatePowerShellValidator

ImageTemplateRestartCustomizer

ImageTemplateSharedImageDistributor

ImageTemplateSharedImageVersionSource

ImageTemplateShellCustomizer

ImageTemplateShellValidator

ImageTemplateVhdDistributor

ImageTemplateVmProfile

ImageTemplateWindowsUpdateCustomizer

Optimize

PlatformImagePurchasePlan

ProvisioningError

ProvisioningErrorCode

ProvisioningState

ResourceIdentityType

RunState

RunSubState

SharedImageStorageAccountType

systemData

TargetRegion

UserAssignedIdentity

Validate

VirtualNetworkConfig

VmBoot

VMBootOptimizationState