Sdílet prostřednictvím


Virtual Machine Image Templates - Get

Získání informací o šabloně image virtuálního počítače

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
imageTemplateName
path True

string

Název šablony image

Vzor regulárního výrazu: ^[A-Za-z0-9-_.]{1,64}$

resourceGroupName
path True

string

Název skupiny prostředků.

subscriptionId
path True

string

Přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného tvoří součást identifikátoru URI pro každé volání služby.

api-version
query True

string

Verze rozhraní API klienta.

Odpovědi

Name Typ Description
200 OK

ImageTemplate

OK

Other Status Codes

CloudError

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

Retrieve an Image Template.

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
CloudError

Chybová odpověď ze služby Azure VM Image Builder.

CloudErrorBody

Chybová odpověď ze služby Azure VM Image Builder.

createdByType

Typ identity, která prostředek vytvořila.

DistributeVersionerLatest

Vygeneruje číslo verze, které bude nejnovější na základě existujících čísel verzí.

DistributeVersionerSource

Vygeneruje číslo verze na základě čísla verze zdrojové image.

ImageTemplate

Šablona image je prostředek ARM spravovaný poskytovatelem Microsoft.VirtualMachineImages.

ImageTemplateFileCustomizer

Nahrává soubory do virtuálních počítačů (Linux, Windows). Odpovídá zřizovacímu sadě souborů packeru.

ImageTemplateFileValidator

Nahraje soubory potřebné k ověření do virtuálních počítačů (Linux, Windows). Odpovídá zřizovacímu modulu souborů Packeru.

ImageTemplateIdentity

Identita pro šablonu obrázku

ImageTemplateLastRunStatus

Popisuje nejnovější stav spuštění šablony image.

ImageTemplateManagedImageDistributor

Distribuujte jako image spravovaného disku.

ImageTemplateManagedImageSource

Popisuje zdroj image, který je spravovanou image v předplatném zákazníka. Tato image se musí nacházet ve stejném předplatném a oblasti jako šablona Image Builderu.

ImageTemplatePlatformImageSource

Popisuje zdroj imagí z Azure Gallery Images.

ImageTemplatePowerShellCustomizer

Spustí zadaný PowerShell na virtuálním počítači (Windows). Odpovídá zřizovacímu nástroji PowerShellu packer. Je možné zadat přesně jednu z vlastností scriptUri nebo inline.

ImageTemplatePowerShellValidator

Spustí zadaný skript PowerShellu během fáze ověřování (Windows). Odpovídá zřizovacímu modulu PowerShellu Packer. Je možné zadat právě jednu z hodnot scriptUri nebo inline.

ImageTemplateRestartCustomizer

Restartuje virtuální počítač a počká, až se vrátí do režimu online (Windows). Odpovídá zřizovacímu programu windows-restartu packeru.

ImageTemplateSharedImageDistributor

Distribuce přes Azure Compute Gallery

ImageTemplateSharedImageVersionSource

Popisuje zdroj image, který je verzí image v Galerii výpočetních prostředků Azure nebo v přímé sdílené galerii.

ImageTemplateShellCustomizer

Spustí skript prostředí během fáze přizpůsobení (Linux). Odpovídá zřizovacímu nástroji prostředí Packer. Je možné zadat přesně jednu z vlastností scriptUri nebo inline.

ImageTemplateShellValidator

Spustí zadaný skript prostředí během fáze ověřování (Linux). Odpovídá zřizovacímu modulu prostředí Packer. Je možné zadat právě jednu z hodnot scriptUri nebo inline.

ImageTemplateVhdDistributor

Distribuce prostřednictvím virtuálního pevného disku v účtu úložiště

ImageTemplateVmProfile

Popisuje virtuální počítače používané k sestavení a ověřování imagí.

ImageTemplateWindowsUpdateCustomizer

Nainstaluje windows Aktualizace. Odpovídá packeru služba Windows Update Provisioner (https://github.com/rgl/packer-provisioner-windows-update)

Optimize

Určuje optimalizaci, která se má provést u image.

PlatformImagePurchasePlan

Kupte si konfiguraci plánu pro image platformy.

ProvisioningError

Popisuje chybu, ke které došlo při vytváření nebo aktualizaci šablony image.

ProvisioningErrorCode

Kód chyby selhání zřizování

ProvisioningState

Stav zřizování prostředku

ResourceIdentityType

Typ identity použité pro šablonu obrázku. Typ None odebere ze šablony obrázku všechny identity.

RunState

Stav posledního spuštění

RunSubState

Dílčí stav posledního spuštění

SharedImageStorageAccountType

Určuje typ účtu úložiště, který se má použít k uložení verze image Azure Compute Gallery.

systemData

Metadata týkající se vytvoření a poslední změny prostředku

TargetRegion

Popisuje informace o cílové oblasti.

UserAssignedIdentity

Vlastnosti identity přiřazené uživatelem

Validate

Možnosti konfigurace a seznam ověření, která se mají na výsledné imagi provést.

VirtualNetworkConfig

Virtual Network konfiguraci.

VmBoot

Optimalizace se použije u image pro rychlejší spouštění virtuálního počítače.

VMBootOptimizationState

Povolením tohoto pole se zkrátí doba spouštění virtuálního počítače optimalizací konečného přizpůsobeného výstupu image.

CloudError

Chybová odpověď ze služby Azure VM Image Builder.

Name Typ Description
error

CloudErrorBody

Podrobnosti o chybě

CloudErrorBody

Chybová odpověď ze služby Azure VM Image Builder.

Name Typ Description
code

string

Identifikátor chyby. Kódy jsou invariantní a mají být využívány programově.

details

CloudErrorBody[]

Seznam dalších podrobností o chybě

message

string

Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.

target

string

Cíl konkrétní chyby. Například název vlastnosti v chybě.

createdByType

Typ identity, která prostředek vytvořila.

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

DistributeVersionerLatest

Vygeneruje číslo verze, které bude nejnovější na základě existujících čísel verzí.

Name Typ Default value Description
major

integer

-1

Hlavní verze pro vygenerované číslo verze. Zjistěte, co je "nejnovější" na základě verzí, u které je tato hodnota hlavní verze. Hodnota -1 se rovná ponechání nenasazení.

scheme string:

Latest

Schéma číslování verzí, které se má použít.

DistributeVersionerSource

Vygeneruje číslo verze na základě čísla verze zdrojové image.

Name Typ Description
scheme string:

Source

Schéma číslování verzí, které se má použít.

ImageTemplate

Šablona image je prostředek ARM spravovaný poskytovatelem Microsoft.VirtualMachineImages.

Name Typ Default value Description
id

string

Plně kvalifikované ID prostředku. Příklad – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

ImageTemplateIdentity

Identita šablony image, pokud je nakonfigurovaná.

location

string

Geografické umístění, ve kterém se nachází prostředek

name

string

Název prostředku

properties.buildTimeoutInMinutes

integer

0

Maximální doba čekání při vytváření šablony image (zahrnuje všechna přizpůsobení, optimalizaci, ověření a distribuce). Pokud chcete použít výchozí hodnotu (4 hodiny), vynechat nebo zadat hodnotu 0.

properties.customize ImageTemplateCustomizer[]:

Určuje vlastnosti použité k popisu kroků přizpůsobení obrázku, jako je zdroj obrázku atd.

properties.distribute ImageTemplateDistributor[]:

Distribuce cílí na místo, kam má výstup image přejít.

properties.exactStagingResourceGroup

string

ID přípravné skupiny prostředků ve stejném předplatném jako šablona image, která se použije k sestavení image. Toto pole jen pro čtení se liší od stagingResourceGroup pouze v případě, že hodnota zadaná v poli stagingResourceGroup je prázdná.

properties.lastRunStatus

ImageTemplateLastRunStatus

Stav spuštění, který se právě spouští nebo byl naposledy proveden.

properties.optimize

Optimize

Určuje optimalizaci, která se má provést u image.

properties.provisioningError

ProvisioningError

Chyba zřizování, pokud existuje

properties.provisioningState

ProvisioningState

Stav zřizování prostředku

properties.source ImageTemplateSource:

Určuje vlastnosti použité k popisu zdrojové image.

properties.stagingResourceGroup

string

ID přípravné skupiny prostředků ve stejném předplatném jako šablona image, která se použije k sestavení image. Pokud je toto pole prázdné, vytvoří se skupina prostředků s náhodným názvem. Pokud skupina prostředků zadaná v tomto poli neexistuje, vytvoří se se stejným názvem. Pokud zadaná skupina prostředků existuje, musí být prázdná a ve stejné oblasti jako šablona obrázku. Vytvořená skupina prostředků se během odstraňování šablony odstraní, pokud je toto pole prázdné nebo zadaná skupina prostředků neexistuje, ale pokud zadaná skupina prostředků existuje, prostředky vytvořené ve skupině prostředků se odstraní během odstraňování šablony a samotná skupina prostředků zůstane zachována.

properties.validate

Validate

Možnosti konfigurace a seznam ověření, která se mají na výsledné imagi provést.

properties.vmProfile

ImageTemplateVmProfile

Popisuje, jak je virtuální počítač nastavený pro vytváření imagí.

systemData

systemData

Azure Resource Manager metadata obsahující informace createdBy a modifiedBy.

tags

object

Značky prostředků.

type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

ImageTemplateFileCustomizer

Nahrává soubory do virtuálních počítačů (Linux, Windows). Odpovídá zřizovacímu sadě souborů packeru.

Name Typ Description
destination

string

Absolutní cesta k souboru (s již vytvořenými vnořenými adresářovými strukturami), do kterého se soubor (z sourceUri) nahraje ve virtuálním počítači.

name

string

Popisný název, který poskytuje kontext k tomu, co tento krok přizpůsobení dělá

sha256Checksum

string

Sha256 kontrolní součet souboru zadaného v poli sourceUri výše

sourceUri

string

Identifikátor URI souboru, který se má nahrát pro přizpůsobení virtuálního počítače. Může to být odkaz na GitHub, identifikátor URI SAS pro Azure Storage atd.

type string:

File

Typ nástroje pro přizpůsobení, který chcete použít na obrázku. Například "Shell" může být úpravce prostředí.

ImageTemplateFileValidator

Nahraje soubory potřebné k ověření do virtuálních počítačů (Linux, Windows). Odpovídá zřizovacímu modulu souborů Packeru.

Name Typ Description
destination

string

Absolutní cesta k souboru (s již vytvořenými vnořenými adresářovými strukturami), kam se soubor (z identifikátoru sourceURI) nahraje ve virtuálním počítači.

name

string

Popisný název, který poskytuje kontext k tomu, co tento krok ověření dělá

sha256Checksum

string

SHA256 – kontrolní součet souboru zadaného v poli sourceUri výše

sourceUri

string

Identifikátor URI souboru, který se nahraje do virtuálního počítače k ověření. Může to být odkaz na GitHub, identifikátor URI služby Azure Storage (autorizovaný nebo SAS) atd.

type string:

File

Typ ověření, který chcete u obrázku použít. Například "Shell" může být ověření prostředí.

ImageTemplateIdentity

Identita pro šablonu obrázku

Name Typ Description
type

ResourceIdentityType

Typ identity použité pro šablonu obrázku. Typ None odebere ze šablony obrázku všechny identity.

userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned identity
Sada identit přiřazených uživatelem přidružených k prostředku. Klíče slovníku userAssignedIdentities budou ID prostředků ARM ve formátu /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Hodnoty slovníku můžou být prázdné objekty ({}) v požadavcích.

ImageTemplateLastRunStatus

Popisuje nejnovější stav spuštění šablony image.

Name Typ Description
endTime

string

Koncový čas posledního spuštění (UTC)

message

string

Podrobné informace o stavu posledního spuštění

runState

RunState

Stav posledního spuštění

runSubState

RunSubState

Dílčí stav posledního spuštění

startTime

string

Čas zahájení posledního spuštění (UTC)

ImageTemplateManagedImageDistributor

Distribuujte jako image spravovaného disku.

Name Typ Description
artifactTags

object

Značky, které se použijí na artefakt, jakmile ho distributor vytvoří nebo aktualizuje.

imageId

string

ID prostředku image spravovaného disku

location

string

Umístění Azure pro image by se mělo shodovat, pokud už image existuje.

runOutputName

string

Název, který se má použít pro přidružený RunOutput.

type string:

ManagedImage

Typ distribuce.

ImageTemplateManagedImageSource

Popisuje zdroj image, který je spravovanou image v předplatném zákazníka. Tato image se musí nacházet ve stejném předplatném a oblasti jako šablona Image Builderu.

Name Typ Description
imageId

string

ID prostředku ARM spravované image v předplatném zákazníka

type string:

ManagedImage

Určuje typ zdrojové image, se kterou chcete začít.

ImageTemplatePlatformImageSource

Popisuje zdroj imagí z Azure Gallery Images.

Name Typ Description
exactVersion

string

Verze image z imagí v galerii Azure. Toto pole jen pro čtení se liší od "version" pouze v případě, že hodnota zadaná v poli version je "latest".

offer

string

Image offer from the Azure Gallery Images.

planInfo

PlatformImagePurchasePlan

Volitelná konfigurace plánu nákupu pro image platformy

publisher

string

Image Publisher in Azure Gallery Images.

sku

string

SKU image z imagí z galerie Azure.

type string:

PlatformImage

Určuje typ zdrojové image, se kterou chcete začít.

version

string

Verze image z imagí v galerii Azure. Pokud je zde zadána "nejnovější", verze se vyhodnotí při sestavení image, ne při odeslání šablony.

ImageTemplatePowerShellCustomizer

Spustí zadaný PowerShell na virtuálním počítači (Windows). Odpovídá zřizovacímu nástroji PowerShellu packer. Je možné zadat přesně jednu z vlastností scriptUri nebo inline.

Name Typ Default value Description
inline

string[]

Pole příkazů PowerShellu ke spuštění

name

string

Popisný název, který poskytuje kontext k tomu, co tento krok přizpůsobení dělá

runAsSystem

boolean

False

Pokud je zadaný, skript PowerShellu se spustí se zvýšenými oprávněními pomocí uživatele místního systému. Může být true, pouze pokud je výše uvedené pole runElevated nastaveno na hodnotu true.

runElevated

boolean

False

Pokud je zadaný, skript PowerShellu se spustí se zvýšenými oprávněními.

scriptUri

string

Identifikátor URI skriptu PowerShellu, který se má spustit pro přizpůsobení. Může to být odkaz na GitHub, identifikátor URI SAS pro Azure Storage atd.

sha256Checksum

string

Kontrolní součet SHA256 skriptu power shellu zadaného v poli scriptUri výše

type string:

PowerShell

Typ nástroje pro přizpůsobení, který chcete použít na obrázku. Například "Shell" může být úpravce prostředí.

validExitCodes

integer[]

Platné ukončovací kódy pro skript PowerShellu [Výchozí: 0]

ImageTemplatePowerShellValidator

Spustí zadaný skript PowerShellu během fáze ověřování (Windows). Odpovídá zřizovacímu modulu PowerShellu Packer. Je možné zadat právě jednu z hodnot scriptUri nebo inline.

Name Typ Default value Description
inline

string[]

Pole příkazů PowerShellu ke spuštění

name

string

Popisný název, který poskytuje kontext k tomu, co tento krok ověření dělá

runAsSystem

boolean

False

Pokud je zadaný, skript PowerShellu se spustí se zvýšenými oprávněními pomocí uživatele místního systému. Může mít hodnotu true, pouze pokud je výše uvedené pole runElevated nastaveno na hodnotu true.

runElevated

boolean

False

Pokud je zadaný, skript PowerShellu se spustí se zvýšenými oprávněními.

scriptUri

string

Identifikátor URI skriptu PowerShellu, který se má spustit pro ověření. Může to být odkaz na GitHub, identifikátor URI služby Azure Storage atd.

sha256Checksum

string

SHA256 – kontrolní součet skriptu Power Shellu zadaného v poli scriptUri výše

type string:

PowerShell

Typ ověření, který chcete u obrázku použít. Například "Shell" může být ověření prostředí.

validExitCodes

integer[]

Platné ukončovací kódy pro skript PowerShellu [Výchozí: 0]

ImageTemplateRestartCustomizer

Restartuje virtuální počítač a počká, až se vrátí do režimu online (Windows). Odpovídá zřizovacímu programu windows-restartu packeru.

Name Typ Description
name

string

Popisný název, který poskytuje kontext k tomu, co tento krok přizpůsobení dělá

restartCheckCommand

string

Příkaz ke kontrole, jestli restartování proběhlo úspěšně [Výchozí: '']

restartCommand

string

Příkaz pro spuštění restartování [Default: 'shutdown /r /f /t 0 /c "packer restart"']

restartTimeout

string

Časový limit restartování zadaný jako řetězec velikosti a jednotky, např. 5m (5 minut) nebo 2 h (2 hodiny) [Výchozí hodnota: 5m]

type string:

WindowsRestart

Typ nástroje pro přizpůsobení, který chcete použít na obrázku. Například "Shell" může být úpravce prostředí.

ImageTemplateSharedImageDistributor

Distribuce přes Azure Compute Gallery

Name Typ Default value Description
artifactTags

object

Značky, které se použijí na artefakt, jakmile ho distributor vytvoří nebo aktualizuje.

excludeFromLatest

boolean

False

Příznak označující, jestli má být vytvořená verze image vyloučena z nejnovější verze. Nepoužívejte výchozí hodnotu (false).

galleryImageId

string

ID prostředku image Azure Compute Gallery

replicationRegions

string[]

[Zastaralé] Seznam oblastí, do kterých se image replikuje. Tento seznam lze zadat pouze v případě, že cílové oblasti nejsou zadané. Toto pole je zastaralé – místo toho použijte targetRegions.

runOutputName

string

Název, který se má použít pro přidružený RunOutput.

storageAccountType

SharedImageStorageAccountType

[Zastaralé] Typ účtu úložiště, který se má použít k uložení sdílené image. Nepoužívejte výchozí (Standard_LRS). Toto pole lze zadat pouze v případě, že je zadána oblast replikace. Toto pole je zastaralé – místo toho použijte targetRegions.

targetRegions

TargetRegion[]

Cílové oblasti, do kterých se bude replikovat distribuovaná verze image. Tento objekt nahrazuje replikaciRegions a lze ho zadat pouze v případě, že není zadána replikaceRegions.

type string:

SharedImage

Typ distribuce.

versioning DistributeVersioner:

Popisuje, jak vygenerovat nové číslo verze x.y.z pro distribuci.

ImageTemplateSharedImageVersionSource

Popisuje zdroj image, který je verzí image v Galerii výpočetních prostředků Azure nebo v přímé sdílené galerii.

Name Typ Description
exactVersion

string

Přesné ID prostředku ARM verze image Toto pole jen pro čtení se liší od ID verze image v imageVersionId pouze v případě, že název verze zadaný v poli imageVersionId je "latest".

imageVersionId

string

ID prostředku ARM verze image. Pokud je název verze image "nejnovější", vyhodnocuje se verze při sestavení image.

type string:

SharedImageVersion

Určuje typ zdrojové image, se kterou chcete začít.

ImageTemplateShellCustomizer

Spustí skript prostředí během fáze přizpůsobení (Linux). Odpovídá zřizovacímu nástroji prostředí Packer. Je možné zadat přesně jednu z vlastností scriptUri nebo inline.

Name Typ Description
inline

string[]

Pole příkazů prostředí ke spuštění

name

string

Popisný název, který poskytuje kontext k tomu, co tento krok přizpůsobení dělá

scriptUri

string

Identifikátor URI skriptu prostředí, který se má spustit pro přizpůsobení. Může to být odkaz na GitHub, identifikátor URI SAS pro Azure Storage atd.

sha256Checksum

string

Kontrolní součet SHA256 skriptu prostředí zadaného v poli scriptUri

type string:

Shell

Typ nástroje pro přizpůsobení, který chcete použít na obrázku. Například "Shell" může být úpravce prostředí.

ImageTemplateShellValidator

Spustí zadaný skript prostředí během fáze ověřování (Linux). Odpovídá zřizovacímu modulu prostředí Packer. Je možné zadat právě jednu z hodnot scriptUri nebo inline.

Name Typ Description
inline

string[]

Pole příkazů prostředí ke spuštění

name

string

Popisný název, který poskytuje kontext k tomu, co tento krok ověření dělá

scriptUri

string

Identifikátor URI skriptu prostředí, který se má spustit pro ověření. Může to být odkaz na GitHub, identifikátor URI služby Azure Storage atd.

sha256Checksum

string

SHA256 – kontrolní součet skriptu prostředí zadaného v poli scriptUri

type string:

Shell

Typ ověření, který chcete u obrázku použít. Například "Shell" může být ověření prostředí.

ImageTemplateVhdDistributor

Distribuce prostřednictvím virtuálního pevného disku v účtu úložiště

Name Typ Description
artifactTags

object

Značky, které se použijí na artefakt, jakmile ho distributor vytvoří nebo aktualizuje.

runOutputName

string

Název, který se má použít pro přidružený RunOutput.

type string:

VHD

Typ distribuce.

uri

string

Volitelný identifikátor URI služby Azure Storage pro distribuovaný objekt blob VHD Nepoužívejte výchozí (prázdný řetězec), v takovém případě by se virtuální pevný disk publikoval do účtu úložiště v pracovní skupině prostředků.

ImageTemplateVmProfile

Popisuje virtuální počítače používané k sestavení a ověřování imagí.

Name Typ Default value Description
osDiskSizeGB

integer

0

Velikost disku s operačním systémem v GB. Pokud chcete použít výchozí velikost disku s operačním systémem Azure, vynecháte nebo zadejte hodnotu 0.

userAssignedIdentities

string[]

Volitelné pole ID prostředků spravovaných identit přiřazených uživatelem, které se mají nakonfigurovat na virtuálním počítači sestavení a ověřovacím virtuálním počítači. To může zahrnovat identitu šablony obrázku.

vmSize

string

Velikost virtuálního počítače použitého k sestavení, přizpůsobení a zachycení imagí Vynechat nebo zadat prázdný řetězec pro použití výchozího nastavení (Standard_D1_v2 pro image Gen1 a Standard_D2ds_v4 pro image Gen2).

vnetConfig

VirtualNetworkConfig

Volitelná konfigurace virtuální sítě, která se má použít k nasazení virtuálního počítače sestavení a ověření virtuálního počítače v systému. Pokud není potřeba použít žádnou konkrétní virtuální síť, vynecháte ji.

ImageTemplateWindowsUpdateCustomizer

Nainstaluje windows Aktualizace. Odpovídá packeru služba Windows Update Provisioner (https://github.com/rgl/packer-provisioner-windows-update)

Name Typ Default value Description
filters

string[]

Pole filtrů pro výběr aktualizací, které chcete použít. Vynechání nebo zadání prázdného pole pro použití výchozího (bez filtru) Příklady a podrobný popis tohoto pole najdete na výše uvedeném odkazu.

name

string

Popisný název, který poskytuje kontext k tomu, co tento krok přizpůsobení dělá

searchCriteria

string

Kritéria pro vyhledávání aktualizací Vynecháte nebo zadejte prázdný řetězec, aby se použil výchozí (hledat vše). Příklady a podrobný popis tohoto pole najdete na výše uvedeném odkazu.

type string:

WindowsUpdate

Typ nástroje pro přizpůsobení, který chcete použít na obrázku. Například "Shell" může být úpravce prostředí.

updateLimit

integer

0

Maximální počet aktualizací, které se mají použít najednou. Vynechání nebo zadání hodnoty 0 pro použití výchozí hodnoty (1000)

Optimize

Určuje optimalizaci, která se má provést u image.

Name Typ Description
vmBoot

VmBoot

Optimalizace se použije u image pro rychlejší spouštění virtuálního počítače.

PlatformImagePurchasePlan

Kupte si konfiguraci plánu pro image platformy.

Name Typ Description
planName

string

Název nákupního plánu.

planProduct

string

Produkt nákupního plánu.

planPublisher

string

Vydavatel nákupního plánu.

ProvisioningError

Popisuje chybu, ke které došlo při vytváření nebo aktualizaci šablony image.

Name Typ Description
message

string

Podrobná chybová zpráva o selhání zřizování

provisioningErrorCode

ProvisioningErrorCode

Kód chyby selhání zřizování

ProvisioningErrorCode

Kód chyby selhání zřizování

Name Typ Description
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

Stav zřizování prostředku

Name Typ Description
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

ResourceIdentityType

Typ identity použité pro šablonu obrázku. Typ None odebere ze šablony obrázku všechny identity.

Name Typ Description
None

string

UserAssigned

string

RunState

Stav posledního spuštění

Name Typ Description
Canceled

string

Canceling

string

Failed

string

PartiallySucceeded

string

Running

string

Succeeded

string

RunSubState

Dílčí stav posledního spuštění

Name Typ Description
Building

string

Customizing

string

Distributing

string

Optimizing

string

Queued

string

Validating

string

SharedImageStorageAccountType

Určuje typ účtu úložiště, který se má použít k uložení verze image Azure Compute Gallery.

Name Typ Description
Premium_LRS

string

Standard_LRS

string

Standard_ZRS

string

systemData

Metadata týkající se vytvoření a poslední změny prostředku

Name Typ Description
createdAt

string

Časové razítko vytvoření prostředku (UTC)

createdBy

string

Identita, která prostředek vytvořila.

createdByType

createdByType

Typ identity, která vytvořila prostředek.

lastModifiedAt

string

Časové razítko poslední změny prostředku (UTC)

lastModifiedBy

string

Identita, která naposledy změnila prostředek.

lastModifiedByType

createdByType

Typ identity, která naposledy změnila prostředek.

TargetRegion

Popisuje informace o cílové oblasti.

Name Typ Default value Description
name

string

Název oblasti.

replicaCount

integer

1

Počet replik verze image, která se má v této oblasti vytvořit. Nepoužívejte výchozí hodnotu (1).

storageAccountType

SharedImageStorageAccountType

Určuje typ účtu úložiště, který se má použít k uložení image v této oblasti. Nepoužívejte výchozí hodnotu (Standard_LRS).

UserAssignedIdentity

Vlastnosti identity přiřazené uživatelem

Name Typ Description
clientId

string

ID klienta přiřazené identity.

principalId

string

ID objektu zabezpečení přiřazené identity.

Validate

Možnosti konfigurace a seznam ověření, která se mají na výsledné imagi provést.

Name Typ Default value Description
continueDistributeOnFailure

boolean

False

Pokud se ověření nezdaří a toto pole je nastavené na false, výstupní image se nebudou distribuovat. Toto je výchozí chování. Pokud se ověření nezdaří a toto pole je nastavené na hodnotu true, budou výstupní image i nadále distribuovány. Tuto možnost používejte opatrně, protože může vést k distribuci špatných obrázků pro použití. V obou případech (pravda nebo nepravda) se spuštění kompletní image hlásí jako neúspěšné v případě selhání ověření. [Poznámka: Toto pole nemá v případě úspěšného ověření žádný vliv.]

inVMValidations ImageTemplateInVMValidator[]:

Seznam ověření, která se mají provést

sourceValidationOnly

boolean

False

Pokud je toto pole nastaveno na hodnotu true, obrázek zadaný v části zdroj se přímo ověří. Nespustí se žádné samostatné sestavení, které by vygenerovalo a pak ověřilo přizpůsobenou image.

VirtualNetworkConfig

Virtual Network konfiguraci.

Name Typ Description
proxyVmSize

string

Velikost proxy virtuálního počítače, který slouží k předávání provozu do virtuálního počítače sestavení a ověření virtuálního počítače. Vynechání nebo zadání prázdného řetězce pro použití výchozího (Standard_A1_v2)

subnetId

string

ID prostředku existující podsítě.

VmBoot

Optimalizace se použije u image pro rychlejší spouštění virtuálního počítače.

Name Typ Description
state

VMBootOptimizationState

Povolením tohoto pole se doba spouštění virtuálního počítače zlepší optimalizací konečného přizpůsobeného výstupu image.

VMBootOptimizationState

Povolením tohoto pole se zkrátí doba spouštění virtuálního počítače optimalizací konečného přizpůsobeného výstupu image.

Name Typ Description
Disabled

string

Enabled

string