Condividi tramite


Virtual Machine Image Templates - Get

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

Nome del modello di immagine

Criterio di espressione regolare: ^[A-Za-z0-9-_.]{1,64}$

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

OK

Other Status Codes

CloudError

Risposta di errore che descrive perché 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

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

Risposta di esempio

{
  "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 di macchine virtuali di Azure.

CloudErrorBody

Risposta di errore dal servizio Image Builder di macchine virtuali 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 del 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 dalle immagini della raccolta di Azure.

ImageTemplatePowerShellCustomizer

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

ImageTemplatePowerShellValidator

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

ImageTemplateRestartCustomizer

Riavvia una macchina virtuale e attende che torni online (Windows). Corrisponde al provisioner di riavvio di Windows 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 dei valori '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 Windows Aggiornamenti. 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à usato per il modello di immagine. Il tipo "Nessuno" 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 da usare per archiviare la versione dell'immagine di Raccolta di calcolo di Azure in.

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

Rete virtuale configurazione.

VmBoot

L'ottimizzazione viene applicata all'immagine per un avvio più rapido della macchina virtuale.

VMBootOptimizationState

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

CloudError

Risposta di errore dal servizio Image Builder di macchine virtuali di Azure.

Nome Tipo Descrizione
error

CloudErrorBody

Dettagli sull'errore.

CloudErrorBody

Risposta di errore dal servizio Image Builder di macchine virtuali 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, che deve essere adatto per la visualizzazione in un'interfaccia utente.

target

string

Destinazione dell'errore specifico. Ad esempio, il nome della proprietà in errore.

createdByType

Tipo di identità che ha creato la risorsa.

Nome Tipo Descrizione
Application

string

Key

string

ManagedIdentity

string

User

string

DistributeVersionerLatest

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

Nome Tipo Valore predefinito Descrizione
major

integer

-1

Versione principale per il numero di versione generato. Determinare l'elemento "più recente" 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

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

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

Nome Tipo Valore predefinito Descrizione
id

string

ID di 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

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[]:

Specifica le proprietà usate per descrivere i passaggi di personalizzazione dell'immagine, ad esempio Origine immagine e così via

properties.distribute ImageTemplateDistributor[]:

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 presente

properties.provisioningState

ProvisioningState

Stato di provisioning della risorsa

properties.source ImageTemplateSource:

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 verranno eliminate 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

Descrive come viene configurata la macchina virtuale per la compilazione di immagini

systemData

systemData

Azure Resource Manager metadati contenenti le informazioni createdBy e modifiedBy.

tags

object

Tag delle risorse.

type

string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ImageTemplateFileCustomizer

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 la personalizzazione della macchina virtuale. Può trattarsi di un collegamento github, di 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 personalizzatore della shell

ImageTemplateFileValidator

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

Nome Tipo Descrizione
destination

string

Percorso assoluto di un file (con strutture di directory nidificate già create) in cui il file (da sourceUri) verrà caricato nella macchina virtuale

name

string

Nome descrittivo per fornire il contesto su ciò che fa 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ò essere un collegamento github, l'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 convalida della shell

ImageTemplateIdentity

Identità per il modello di immagine.

Nome Tipo Descrizione
type

ResourceIdentityType

Tipo di identità usato per il modello di immagine. Il tipo "Nessuno" 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

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

Nome Tipo Descrizione
endTime

string

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

Ora di inizio dell'ultima esecuzione (UTC)

ImageTemplateManagedImageDistributor

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

Nome da utilizzare per l'oggetto RunOutput associato.

type string:

ManagedImage

Tipo di distribuzione.

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.

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

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

Nome Tipo Descrizione
exactVersion

string

Versione dell'immagine dalle 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 dalle 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 dalle immagini della raccolta di Azure.

type string:

PlatformImage

Specifica il tipo di immagine di origine da cui iniziare.

version

string

Versione dell'immagine dalle 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

Esegue l'oggetto PowerShell specificato nella macchina virtuale (Windows). Corrisponde al provisioner powershell di Packer. È possibile specificare esattamente uno dei valori '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 del 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ò trattarsi di un collegamento github, di 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 personalizzatore della shell

validExitCodes

integer[]

Codici di uscita validi per lo script di PowerShell. [Impostazione predefinita: 0]

ImageTemplatePowerShellValidator

Esegue lo script di PowerShell specificato durante la fase di convalida (Windows). Corrisponde al provisioner di 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 il contesto su ciò che fa questo passaggio di convalida

runAsSystem

boolean

False

Se specificato, lo script di PowerShell verrà eseguito con privilegi elevati usando l'utente del sistema locale. Può essere true solo quando il campo runElevated sopra è 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, l'URI di Archiviazione di Azure e così via

sha256Checksum

string

CHECKSUM SHA256 dello script di Power Shell fornito nel campo scriptUri precedente

type string:

PowerShell

Tipo di convalida da usare nell'immagine. Ad esempio, "Shell" può essere convalida della shell

validExitCodes

integer[]

Codici di uscita validi per lo script di PowerShell. [Impostazione predefinita: 0]

ImageTemplateRestartCustomizer

Riavvia una macchina virtuale e attende che torni online (Windows). Corrisponde al provisioner di riavvio di Windows 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 [Predefinito: 'shutdown /r /f /t 0 /c "packer restart"']

restartTimeout

string

Timeout del 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 personalizzatore della shell

ImageTemplateSharedImageDistributor

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

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:

Viene descritto come generare un nuovo numero di versione x.y.z per la distribuzione.

ImageTemplateSharedImageVersionSource

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 della risorsa ARM esatta della versione dell'immagine. Questo campo readonly 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

Esegue uno script della shell durante la fase di personalizzazione (Linux). Corrisponde al provisioner della shell packer. È possibile specificare esattamente uno dei valori '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ò trattarsi di un collegamento github, di 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 personalizzatore della shell

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'.

Nome Tipo Descrizione
inline

string[]

Matrice di comandi della shell da eseguire

name

string

Nome descrittivo per fornire il contesto su ciò che fa questo passaggio di convalida

scriptUri

string

URI dello script della shell da eseguire per la convalida. Può essere un collegamento github, l'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 convalida della shell

ImageTemplateVhdDistributor

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

Nome da utilizzare per l'oggetto RunOutput associato.

type string:

VHD

Tipo di distribuzione.

uri

string

URI di Archiviazione di Azure facoltativo per il BLOB VHD distribuito. Omettere di usare la stringa predefinita (stringa vuota) nel qual caso il disco rigido virtuale verrebbe pubblicato nell'account di archiviazione nel gruppo di risorse di staging.

ImageTemplateVmProfile

Descrive le macchine virtuali usate per compilare e convalidare le immagini

Nome Tipo Valore predefinito Descrizione
osDiskSizeGB

integer

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 vm di convalida in . Omettere se non è necessario usare alcuna rete virtuale specifica.

ImageTemplateWindowsUpdateCustomizer

Installa Windows Aggiornamenti. 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 (eseguire ricerche in tutti). 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 personalizzatore della shell

updateLimit

integer

0

Numero massimo di aggiornamenti da applicare alla volta. Omettere o specificare 0 per usare il valore predefinito (1000)

Optimize

Specifica l'ottimizzazione da eseguire sull'immagine.

Nome Tipo Descrizione
vmBoot

VmBoot

L'ottimizzazione viene applicata all'immagine per un avvio più rapido della macchina virtuale.

PlatformImagePurchasePlan

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

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

Codice di errore dell'errore di provisioning

Nome Tipo Descrizione
BadCustomizerType

string

BadDistributeType

string

BadManagedImageSource

string

BadPIRSource

string

BadSharedImageDistribute

string

BadSharedImageVersionSource

string

BadSourceType

string

BadStagingResourceGroup

string

BadValidatorType

string

NoCustomizerScript

string

NoValidatorScript

string

Other

string

ServerError

string

UnsupportedCustomizerType

string

UnsupportedValidatorType

string

ProvisioningState

Stato di provisioning della risorsa

Nome Tipo Descrizione
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

ResourceIdentityType

Tipo di identità usato per il modello di immagine. Il tipo "Nessuno" rimuoverà le identità dal modello di immagine.

Nome Tipo Descrizione
None

string

UserAssigned

string

RunState

Stato dell'ultima esecuzione

Nome Tipo Descrizione
Canceled

string

Canceling

string

Failed

string

PartiallySucceeded

string

Running

string

Succeeded

string

RunSubState

Stato secondario dell'ultima esecuzione

Nome Tipo Descrizione
Building

string

Customizing

string

Distributing

string

Optimizing

string

Queued

string

Validating

string

SharedImageStorageAccountType

Specifica il tipo di account di archiviazione da usare per archiviare la versione dell'immagine di Raccolta di calcolo di Azure in.

Nome Tipo Descrizione
Premium_LRS

string

Standard_LRS

string

Standard_ZRS

string

systemData

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

Nome Tipo Descrizione
createdAt

string

Timestamp della creazione di risorse (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.

TargetRegion

Descrive le informazioni sull'area di destinazione.

Nome Tipo Valore predefinito Descrizione
name

string

Il nome dell'area.

replicaCount

integer

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

Proprietà di identità assegnate dall'utente

Nome Tipo Descrizione
clientId

string

ID client dell'identità assegnata.

principalId

string

ID principale dell'identità assegnata.

Validate

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

Nome Tipo Valore predefinito Descrizione
continueDistributeOnFailure

boolean

False

Se la convalida non riesce e questo campo è impostato su false, le immagini di output non verranno distribuite. Questo è il 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 effetto se la convalida riesce.]

inVMValidations ImageTemplateInVMValidator[]:

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

Rete virtuale configurazione.

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

L'ottimizzazione viene applicata all'immagine per un avvio più rapido della macchina virtuale.

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

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

Nome Tipo Descrizione
Disabled

string

Enabled

string