Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Определение ресурса Bicep
Тип ресурса imageTemplates можно развернуть с помощью операций, целевых:
- группы ресурсов - см. команды развертывания групп ресурсов
Для получения списка изменённых свойств в каждой версии API см. журнал изменений.
Примеры использования
Проверенные модули Azure
Следующие Azure Проверенные модули могут использоваться для развертывания этого типа ресурсов.
| Module | Description |
|---|---|
| шаблон изображения виртуальной машины | Модуль ресурсов AVM для шаблона образа виртуальной машины |
Примеры быстрого запуска Azure
Следующие шаблоны Azure Quickstart содержат Bicep образцов для развертывания этого типа ресурсов.
| Bicep-файл | Description |
|---|---|
| Azure Конструктор изображений с Azure Windows Baseline | Создаёт среду Azure Image Builder и Windows Server образ с использованием последних Windows обновлений и Azure Windows базовой линии. |
| Конфигурация сервиса Dev Box | Этот шаблон создаст все ресурсы администратора Dev Box согласно руководству быстрого запуска Dev Box (/azure/dev-box/quickstart-create-dev-box). Вы можете просмотреть все созданные ресурсы или напрямую перейти к DevPortal.microsoft.com для создания первого поля разработки. |
Формат ресурса
Создать Microsoft. Ресурс VirtualMachineImages/imageTemplates добавьте следующий Bicep в ваш шаблон.
resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2025-10-01' = {
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
additionalDataDisks: [
{
sizeGB: int
}
]
autoRun: {
state: 'string'
}
buildTimeoutInMinutes: int
customize: [
{
name: 'string'
type: 'string'
// For remaining properties, see ImageTemplateCustomizer objects
}
]
distribute: [
{
artifactTags: {
{customized property}: 'string'
}
runOutputName: 'string'
type: 'string'
// For remaining properties, see ImageTemplateDistributor objects
}
]
errorHandling: {
onCustomizerError: 'string'
onValidationError: 'string'
}
managedResourceTags: {
{customized property}: 'string'
}
optimize: {
vmBoot: {
state: 'string'
}
workload: {
scriptUri: 'string'
sha256Checksum: 'string'
state: 'string'
}
}
source: {
type: 'string'
// For remaining properties, see ImageTemplateSource objects
}
stagingResourceGroup: 'string'
validate: {
continueDistributeOnFailure: bool
inVMValidations: [
{
name: 'string'
type: 'string'
// For remaining properties, see ImageTemplateInVMValidator objects
}
]
sourceValidationOnly: bool
}
vmProfile: {
osDiskSizeGB: int
userAssignedIdentities: [
'string'
]
vmSize: 'string'
vnetConfig: {
containerInstanceSubnetId: 'string'
proxyVmSize: 'string'
subnetId: 'string'
}
}
}
tags: {
{customized property}: 'string'
}
}
Объекты ImageTemplateSource
Задайте свойство type , чтобы указать тип объекта.
Для ManagedImage используйте:
{
imageId: 'string'
type: 'ManagedImage'
}
Для PlatformImage используйте:
{
offer: 'string'
planInfo: {
planName: 'string'
planProduct: 'string'
planPublisher: 'string'
}
publisher: 'string'
sku: 'string'
type: 'PlatformImage'
version: 'string'
}
Для SharedImageVersion используйте:
{
imageVersionId: 'string'
type: 'SharedImageVersion'
}
Объекты ImageTemplateDistributor
Задайте свойство type , чтобы указать тип объекта.
Для ManagedImage используйте:
{
imageId: 'string'
location: 'string'
type: 'ManagedImage'
}
Для SharedImage используйте:
{
excludeFromLatest: bool
galleryImageId: 'string'
replicationMode: 'string'
replicationRegions: [
'string'
]
storageAccountType: 'string'
targetRegions: [
{
name: 'string'
replicaCount: int
storageAccountType: 'string'
}
]
type: 'SharedImage'
versioning: {
scheme: 'string'
// For remaining properties, see DistributeVersioner objects
}
}
Для VHD используйте:
{
type: 'VHD'
uri: 'string'
}
Объекты ImageTemplateInVMValidator
Задайте свойство type , чтобы указать тип объекта.
Для файла используйте:
{
destination: 'string'
sha256Checksum: 'string'
sourceUri: 'string'
type: 'File'
}
Для PowerShell используйте:
{
inline: [
'string'
]
runAsSystem: bool
runElevated: bool
scriptUri: 'string'
sha256Checksum: 'string'
type: 'PowerShell'
validExitCodes: [
int
]
}
Для Shell используйте:
{
inline: [
'string'
]
scriptUri: 'string'
sha256Checksum: 'string'
type: 'Shell'
}
Объекты DistributeVersioner
Задайте свойство scheme , чтобы указать тип объекта.
В качестве последней версии используйте:
{
major: int
scheme: 'Latest'
}
Для Source используйте:
{
scheme: 'Source'
}
Объекты ImageTemplateCustomizer
Задайте свойство type , чтобы указать тип объекта.
Для файла используйте:
{
destination: 'string'
sha256Checksum: 'string'
sourceUri: 'string'
type: 'File'
}
Для PowerShell используйте:
{
inline: [
'string'
]
runAsSystem: bool
runElevated: bool
scriptUri: 'string'
sha256Checksum: 'string'
type: 'PowerShell'
validExitCodes: [
int
]
}
Для Shell используйте:
{
inline: [
'string'
]
scriptUri: 'string'
sha256Checksum: 'string'
type: 'Shell'
}
Для WindowsRestart используйте:
{
restartCheckCommand: 'string'
restartCommand: 'string'
restartTimeout: 'string'
type: 'WindowsRestart'
}
Для WindowsUpdate используйте:
{
filters: [
'string'
]
searchCriteria: 'string'
type: 'WindowsUpdate'
updateLimit: int
}
Значения свойств
Microsoft. VirtualMachineImages/imageTemplates
| Name | Description | Value |
|---|---|---|
| identity | Удостоверение шаблона изображения, если оно настроено. | ImageTemplateIdentity (обязательно) |
| location | Географическое расположение, в котором находится ресурс | строка (обязательно) |
| name | имя ресурса. | string Constraints: Pattern = ^[A-Za-z0-9-_.]{1,64}$ (обязательно) |
| properties | Свойства шаблона изображения | ImageTemplateProperties |
| tags | Теги ресурсов | Словарь имен и значений тегов. См. теги в шаблонах |
DataDisk
| Name | Description | Value |
|---|---|---|
| sizeGB | Размер диска данных в ГБ. | int Constraints: Минимальное значение = 0 |
DistributeVersioner
| Name | Description | Value |
|---|---|---|
| scheme | Установите значение "Последний" для типа DistributeVersionerLatest. Установите значение 'Source' для типа DistributeVersionerSource. | 'Latest' Source (обязательный) |
DistributeVersionerLatest
| Name | Description | Value |
|---|---|---|
| major | Основная версия для созданного номера версии. Определите, что такое "последняя" на основе версий с этим значением в качестве основной версии. -1 эквивалентен выходу из него без набора. | int Constraints: Минимальное значение = -1 |
| scheme | Используемая схема нумерирования версий. | "Последнее" (обязательно) |
DistributeVersionerSource
| Name | Description | Value |
|---|---|---|
| scheme | Используемая схема нумерирования версий. | Source (обязательный) |
ImageTemplateAutoRun
| Name | Description | Value |
|---|---|---|
| state | Включение этого поля приведет к активации автоматической сборки на основе создания шаблона образа или обновления. | 'Disabled' 'Enabled' |
ImageTemplateCustomizer
| Name | Description | Value |
|---|---|---|
| name | Понятное имя для предоставления контекста по этому шагу настройки | string |
| type | Установите значение "File" для типа ImageTemplateFileCustomizer. Установите значение 'PowerShell' для типа ImageTemplatePowerShellCustomizer. Установите значение 'Shell' для типа ImageTemplateShellCustomizer. Установите значение 'WindowsRestart' для типа ImageTemplateRestartCustomizer. Установите значение 'WindowsUpdate' для типа ImageTemplateWindowsUpdateCustomizer. | 'File' 'PowerShell' 'Shell' 'WindowsRestart' 'WindowsUpdate' (обязательно) |
ImageTemplateDistributor
| Name | Description | Value |
|---|---|---|
| artifactTags | Теги, которые будут применены к артефакту после его создания или обновления распространителем. | ImageTemplateDistributorArtifactTags |
| runOutputName | Имя, используемое для связанного runOutput. | string Constraints: Pattern = ^[A-Za-z0-9-_.]{1,64}$ (обязательно) |
| type | Установите значение "ManagedImage" для типа ImageTemplateManagedImageDistributor. Установите значение 'SharedImage' для типа ImageTemplateSharedImageDistributor. Установите значение "VHD" для типа ImageTemplateVhdDistributor. | 'ManagedImage' 'SharedImage' VHD (обязательно) |
ImageTemplateDistributorArtifactTags
| Name | Description | Value |
|---|
ImageTemplateFileCustomizer
| Name | Description | Value |
|---|---|---|
| destination | Абсолютный путь к файлу (с уже созданными вложенными структурами каталогов), в котором файл (из sourceUri) будет отправлен в виртуальную машину. | string |
| sha256Checksum | Контрольная сумма SHA256 файла, предоставленного в поле sourceUri выше | string |
| sourceUri | URI файла, который необходимо отправить для настройки виртуальной машины. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее | string |
| type | Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки | "Файл" (обязательный) |
ImageTemplateFileValidator
| Name | Description | Value |
|---|---|---|
| destination | Абсолютный путь к файлу (с уже созданными вложенными структурами каталогов), в котором файл (из sourceUri) будет отправлен в виртуальную машину. | string |
| sha256Checksum | Контрольная сумма SHA256 файла, предоставленного в поле sourceUri выше | string |
| sourceUri | URI файла, который необходимо отправить на виртуальную машину для проверки. Это может быть ссылка на github, служба хранилища Azure URI (авторизованный или SAS) и так далее | string |
| type | Тип проверки, которую вы хотите использовать на изображении. Например, "Shell" может быть проверкой оболочки | "Файл" (обязательный) |
ImageTemplateIdentity
| Name | Description | Value |
|---|---|---|
| type | Тип удостоверения, используемого для шаблона изображения. Тип "Нет" приведет к удалению удостоверений из шаблона образа. | 'None' 'UserAssigned' |
| userAssignedIdentities | Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в виде: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах. | ImageTemplateIdentityUserAssignedIdentities |
ImageTemplateIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ImageTemplateInVMValidator
| Name | Description | Value |
|---|---|---|
| name | Понятное имя для предоставления контекста по этому шагу проверки | string |
| type | Установите значение 'File' для типа ImageTemplateFileValidator. Установите значение 'PowerShell' для типа ImageTemplatePowerShellValidator. Установите значение 'Shell' для типа ImageTemplateShellValidator. | 'File' 'PowerShell' «Ракушка» (обязательно) |
ImageTemplateManagedImageDistributor
| Name | Description | Value |
|---|---|---|
| imageId | Идентификатор ресурса образа управляемого диска | строка (обязательно) |
| location | Azure местоположение для изображения должно совпадать, если изображение уже существует | строка (обязательно) |
| type | Тип распределения. | 'ManagedImage' (обязательно) |
ImageTemplateManagedImageSource
| Name | Description | Value |
|---|---|---|
| imageId | Идентификатор ресурса ARM управляемого образа в подписке клиента | строка (обязательно) |
| type | Указывает тип исходного образа, с которого вы хотите начать. | 'ManagedImage' (обязательно) |
ImageTemplatePlatformImageSource
| Name | Description | Value |
|---|---|---|
| offer | Предложение изображения из галереи Azure Images. | string |
| planInfo | Необязательной конфигурации плана покупки для образа платформы. | PlatformImagePurchasePlan |
| publisher | Изображение Publisher в Azure Галерейные изображения. | string |
| sku | Изображение из галереи Azure Images. | string |
| type | Указывает тип исходного образа, с которого вы хотите начать. | 'PlatformImage' (обязательно) |
| version | Версия изображения из галереи Azure Images. Если здесь указана последняя версия, версия вычисляется при выполнении сборки образа, а не при отправке шаблона. | string |
ImageTemplatePowerShellCustomizer
| Name | Description | Value |
|---|---|---|
| inline | Массив команд PowerShell для выполнения | string[] |
| runAsSystem | Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями с помощью локального пользователя системы. Значение true может быть только в том случае, если указанное выше поле runElevated имеет значение true. | bool |
| runElevated | Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями | bool |
| scriptUri | URI скрипта PowerShell для настройки. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее | string |
| sha256Checksum | Контрольная сумма SHA256 скрипта Power Shell, предоставленного в поле scriptUri выше | string |
| type | Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки | 'PowerShell' (обязательно) |
| validExitCodes | Допустимые коды выхода для скрипта PowerShell. [По умолчанию: 0] | int[] |
ImageTemplatePowerShellValidator
| Name | Description | Value |
|---|---|---|
| inline | Массив команд PowerShell для выполнения | string[] |
| runAsSystem | Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями с помощью локального пользователя системы. Значение true может быть только в том случае, если указанное выше поле runElevated имеет значение true. | bool |
| runElevated | Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями | bool |
| scriptUri | URI скрипта PowerShell для проверки. Это может быть ссылка на github, служба хранилища Azure URI и так далее | string |
| sha256Checksum | Контрольная сумма SHA256 скрипта Power Shell, предоставленного в поле scriptUri выше | string |
| type | Тип проверки, которую вы хотите использовать на изображении. Например, "Shell" может быть проверкой оболочки | 'PowerShell' (обязательно) |
| validExitCodes | Допустимые коды выхода для скрипта PowerShell. [По умолчанию: 0] | int[] |
ImageTemplateProperties
| Name | Description | Value |
|---|---|---|
| дополнительные данныеDataDisks | Опциональный массив дополнительных дисков данных, которые должны быть добавлены к образу. | DataDisk[] |
| autoRun | Указывает, следует ли автоматически запускать шаблон образа при создании или обновлении шаблона. | ImageTemplateAutoRun |
| buildTimeoutInMinutes | Максимальная длительность ожидания при создании шаблона образа (включает все настройки, оптимизацию, проверку и дистрибутивы). Опустить или указать значение 0, чтобы использовать значение по умолчанию (4 часа). | int Constraints: Минимальное значение = 0 Максимальное значение = 960 |
| customize | Указывает свойства, используемые для описания шагов настройки изображения, таких как источник изображения и т. д. | ImageTemplateCustomizer[] |
| distribute | Целевые объекты распределения, в которых выходные данные изображения должны перейти. | ImageTemplateDistributor[] (обязательно) |
| errorHandling | Параметры обработки ошибок при сбое сборки | ImageTemplatePropertiesErrorHandling |
| managedResourceTags | Теги, которые будут применяться к группе ресурсов и /или ресурсам, созданным службой. | ImageTemplatePropertiesManagedResourceTags |
| optimize | Указывает оптимизацию, выполняемую на изображении. | ImageTemplatePropertiesOptimize |
| source | Указывает свойства, используемые для описания исходного образа. | ImageTemplateSource (обязательно) |
| stagingResourceGroup | Идентификатор промежуточной группы ресурсов в той же подписке, что и шаблон образа, который будет использоваться для сборки образа. Если это поле пусто, будет создана группа ресурсов со случайным именем. Если группа ресурсов, указанная в этом поле, не существует, она будет создана с тем же именем. Если указанная группа ресурсов существует, она должна быть пустой и в том же регионе, что и шаблон изображения. Созданная группа ресурсов будет удалена во время удаления шаблона, если это поле пусто или указанная группа ресурсов не существует, но если указанная группа ресурсов существует, ресурсы, созданные в группе ресурсов, будут удалены во время удаления шаблона, и сама группа ресурсов останется. | string |
| validate | Параметры конфигурации и список проверок, выполняемых на результирующем изображении. | ImageTemplatePropertiesValidate |
| vmProfile | Описание настройки виртуальной машины для создания образов | ImageTemplateVmProfile |
ImageTemplatePropertiesErrorHandling
| Name | Description | Value |
|---|---|---|
| onCustomizerError | Если имеется ошибка настройщика, и это поле имеет значение "очистка", виртуальная машина сборки и связанные сетевые ресурсы будут удалены. Это поведение по умолчанию. Если имеется ошибка настройщика, и это поле имеет значение "прерывание", виртуальная машина сборки будет сохранена. | 'abort' 'cleanup' |
| onValidationError | Если имеется ошибка проверки, и это поле имеет значение "очистка", виртуальная машина сборки и связанные сетевые ресурсы будут удалены. Это поведение по умолчанию. Если имеется ошибка проверки, и это поле имеет значение "прерывание", виртуальная машина сборки будет сохранена. | 'abort' 'cleanup' |
ImageTemplatePropertiesManagedResourceTags
| Name | Description | Value |
|---|
ImageTemplatePropertiesOptimize
| Name | Description | Value |
|---|---|---|
| vmBoot | Оптимизация применяется к образу для ускорения загрузки виртуальной машины. | ImageTemplatePropertiesOptimizeVmBoot |
| Рабочая нагрузка | Оптимизация применяется к изображению для конкретных рабочих нагрузок. | ImageTemplatePropertiesOptimizeWorkload |
ImageTemplatePropertiesOptimizeVmBoot
| Name | Description | Value |
|---|---|---|
| state | Включение этого поля улучшит время загрузки виртуальной машины, оптимизируя окончательные настраиваемые выходные данные образа. | 'Disabled' 'Enabled' |
ImageTemplatePropertiesOptimizeWorkload
| Name | Description | Value |
|---|---|---|
| scriptUri | URI скрипта для запуска для оптимизации рабочей нагрузки. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее | string |
| sha256Checksum | Контрольная сумма SHA256 скрипта, предоставленная в поле scriptUri | string |
| state | Включение этого поля оптимизирует изображения виртуальных машин под конкретные рабочие нагрузки. | 'Disabled' 'Enabled' |
ImageTemplatePropertiesValidate
| Name | Description | Value |
|---|---|---|
| continueDistributeOnFailure | Если проверка завершается ошибкой, и это поле имеет значение false, выходные образы не будут распространяться. Это поведение по умолчанию. Если проверка завершается ошибкой, и это поле имеет значение true, выходные образы по-прежнему будут распределены. Используйте этот параметр с осторожностью, так как это может привести к распространению плохих образов для использования. В любом случае (true или false), выполнение конечного образа будет сообщаться о сбое при сбое проверки. [Примечание. Это поле не влияет на успешное выполнение проверки.] | bool |
| inVMValidations | Список выполняемых проверок. | ImageTemplateInVMValidator[] |
| sourceValidationOnly | Если для этого поля задано значение true, то изображение, указанное в разделе "источник", будет проверено напрямую. Отдельная сборка не будет выполняться для создания и проверки настраиваемого образа. | bool |
ImageTemplateRestartCustomizer
| Name | Description | Value |
|---|---|---|
| restartCheckCommand | Команда для проверки успешности перезапуска [по умолчанию: '' | string |
| restartCommand | Команда для выполнения перезапуска [по умолчанию: "завершение работы /r /f /t 0 /c"packer restart"] | string |
| restartTimeout | Время ожидания перезапуска, указанное в виде строки величины и единицы, например "5 м" (5 минут) или "2h" (2 часа) [по умолчанию: "5 млн" ] | string |
| type | Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки | 'WindowsRestart' (обязательно) |
ImageTemplateSharedImageDistributor
| Name | Description | Value |
|---|---|---|
| excludeFromLatest | Флаг, указывающий, следует ли исключить созданную версию образа из последней версии. Не следует использовать значение по умолчанию (false). | bool |
| galleryImageId | Resource Id изображения Azure Compute Gallery | строка (обязательно) |
| replicationMode | Описывает режим репликации для распространения в Azure Compute Gallery. Опусти использование стандартного режима (Full). | Full "Неглубокий" |
| replicationRegions | [Не рекомендуется] Список регионов, в которые будет реплицирован образ. Этот список можно указать только в том случае, если targetRegions не указан. Это поле устарело. Вместо этого используйте targetRegions. | string[] |
| storageAccountType | [Устарело] Тип аккаунта Storage для хранения общего изображения. Не следует использовать значение по умолчанию (Standard_LRS). Это поле можно указать только в том случае, если указан параметр replicationRegions. Это поле устарело. Вместо этого используйте targetRegions. | 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
| targetRegions | Целевые регионы, в которых будет реплицироваться распределенная версия образа. Этот объект заменяет replicationRegions и может быть указан только в том случае, если репликацияRegions не указана. | TargetRegion[] |
| type | Тип распределения. | 'SharedImage' (обязательно) |
| versioning | Описывает создание нового номера версии x.y.z для распространения. | DistributeVersioner |
ImageTemplateSharedImageVersionSource
| Name | Description | Value |
|---|---|---|
| imageVersionId | Идентификатор ресурса ARM версии образа. Если имя версии образа является "последней", версия вычисляется при сборке образа. | строка (обязательно) |
| type | Указывает тип исходного образа, с которого вы хотите начать. | 'SharedImageVersion' (обязательно) |
ImageTemplateShellCustomizer
| Name | Description | Value |
|---|---|---|
| inline | Массив команд оболочки для выполнения | string[] |
| scriptUri | URI скрипта оболочки для настройки. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее | string |
| sha256Checksum | Контрольная сумма SHA256 скрипта оболочки, указанная в поле scriptUri | string |
| type | Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки | «Ракушка» (обязательно) |
ImageTemplateShellValidator
| Name | Description | Value |
|---|---|---|
| inline | Массив команд оболочки для выполнения | string[] |
| scriptUri | Универсальный код ресурса (URI) скрипта оболочки для проверки. Это может быть ссылка на github, служба хранилища Azure URI и так далее | string |
| sha256Checksum | Контрольная сумма SHA256 скрипта оболочки, указанная в поле scriptUri | string |
| type | Тип проверки, которую вы хотите использовать на изображении. Например, "Shell" может быть проверкой оболочки | «Ракушка» (обязательно) |
ImageTemplateSource
| Name | Description | Value |
|---|---|---|
| type | Установите значение "ManagedImage" для типа ImageTemplateManagedImageSource. Установите значение 'PlatformImage' для типа ImageTemplatePlatformImageSource. Установите значение 'SharedImageVersion' для типа ImageTemplateSharedImageVersionSource. | 'ManagedImage' 'PlatformImage' 'SharedImageVersion' (обязательно) |
ImageTemplateVhdDistributor
| Name | Description | Value |
|---|---|---|
| type | Тип распределения. | VHD (обязательно) |
| uri | Опциональный служба хранилища Azure URI для распределённого VHD-blob. Опустите использование по умолчанию (пустой строки), в таком случае VHD будет опубликован в аккаунт storage в группе staging ресурсов. | string |
ImageTemplateVmProfile
| Name | Description | Value |
|---|---|---|
| osDiskSizeGB | Размер диска ОС в ГБ. Опустите или укажите 0, чтобы использовать стандартный размер диска Azure. | int Constraints: Минимальное значение = 0 |
| userAssignedIdentities | Необязательный массив идентификаторов ресурсов назначенных пользователем управляемых удостоверений для настройки на виртуальной машине сборки и на виртуальной машине проверки. Это может включать удостоверение шаблона изображения. | string[] |
| vmSize | Размер виртуальной машины, используемой для создания, настройки и записи образов. Опустить или указать пустую строку, чтобы использовать значение по умолчанию (Standard_D1_v2 для образов 1-го поколения и Standard_D2ds_v4 для образов 2-го поколения). | string |
| vnetConfig | Опциональная конфигурация virtual network для развертывания сборки и валидационной виртуальной машины. Опустите, если не требуется использовать конкретную virtual network. | VirtualNetworkConfig |
ImageTemplateWindowsUpdateCustomizer
| Name | Description | Value |
|---|---|---|
| filters | Массив фильтров для выбора обновлений для применения. Опустите или укажите пустой массив для использования по умолчанию (без фильтра). См. приведенную выше ссылку на примеры и подробное описание этого поля. | string[] |
| searchCriteria | Критерии поиска обновлений. Опустить или указать пустую строку, чтобы использовать значение по умолчанию (выполните поиск всех). См. приведенную выше ссылку на примеры и подробное описание этого поля. | string |
| type | Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки | 'WindowsUpdate' (обязательно) |
| updateLimit | Максимальное количество обновлений, применяемых за раз. Опустить или указать 0, чтобы использовать значение по умолчанию (1000) | int Constraints: Минимальное значение = 0 |
PlatformImagePurchasePlan
| Name | Description | Value |
|---|---|---|
| planName | Имя плана покупки. | строка (обязательно) |
| planProduct | Продукт плана покупки. | строка (обязательно) |
| planPublisher | Издатель плана покупки. | строка (обязательно) |
TargetRegion
| Name | Description | Value |
|---|---|---|
| name | Имя региона. | строка (обязательно) |
| replicaCount | Количество реплик версии образа, создаваемых в этом регионе. Не следует использовать значение по умолчанию (1). | int Constraints: Минимальное значение = 1 |
| storageAccountType | Указывает тип аккаунта storage, который используется для хранения изображения в этой области. Не следует использовать значение по умолчанию (Standard_LRS). | 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
TrackedResourceTags
| Name | Description | Value |
|---|
UserAssignedIdentity
| Name | Description | Value |
|---|
VirtualNetworkConfig
| Name | Description | Value |
|---|---|---|
| containerInstanceSubnetId | Идентификатор ресурса уже существующей подсети, на которой будет развернут экземпляр Azure Container для изолированных сборок. Это поле может быть указано только если также указана subnetId и должно находиться на той же виртуальная сеть, что и подсеть, указанная в subnetId. |
string |
| proxyVmSize | Размер виртуальной машины прокси-сервера, используемой для передачи трафика на виртуальную машину сборки и проверку виртуальной машины. Это не должно быть указано, если containerInstanceSubnetId он указан, так как в этом случае виртуальная машина прокси-сервера не развертывается. Опустить или указать пустую строку, чтобы использовать значение по умолчанию (Standard_A1_v2). |
string |
| subnetId | Идентификатор ресурса предварительно существующей подсети, в которой будет развернута виртуальная машина сборки и проверка виртуальной машины. | string |
Определение ресурса шаблона ARM
Тип ресурса imageTemplates можно развернуть с помощью операций, целевых:
- Группы ресурсов — см. команды развертывания групп ресурсов Для списка изменённых свойств в каждой версии API см. журнал изменений.
Примеры использования
Шаблоны быстрого запуска Azure
Следующие Azure шаблоны быстрого запуска развёртают этот тип ресурса.
| Template | Description |
|---|---|
|
Azure Конструктор изображений с Azure Windows Baseline |
Создаёт среду Azure Image Builder и Windows Server образ с использованием последних Windows обновлений и Azure Windows базовой линии. |
|
Конфигурация сервиса Dev Box |
Этот шаблон создаст все ресурсы администратора Dev Box согласно руководству быстрого запуска Dev Box (/azure/dev-box/quickstart-create-dev-box). Вы можете просмотреть все созданные ресурсы или напрямую перейти к DevPortal.microsoft.com для создания первого поля разработки. |
Формат ресурса
Создать Microsoft. Ресурс VirtualMachineImages/imageTemplates, добавьте следующий JSON в ваш шаблон.
{
"type": "Microsoft.VirtualMachineImages/imageTemplates",
"apiVersion": "2025-10-01",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"additionalDataDisks": [
{
"sizeGB": "int"
}
],
"autoRun": {
"state": "string"
},
"buildTimeoutInMinutes": "int",
"customize": [ {
"name": "string",
"type": "string"
// For remaining properties, see ImageTemplateCustomizer objects
} ],
"distribute": [ {
"artifactTags": {
"{customized property}": "string"
},
"runOutputName": "string",
"type": "string"
// For remaining properties, see ImageTemplateDistributor objects
} ],
"errorHandling": {
"onCustomizerError": "string",
"onValidationError": "string"
},
"managedResourceTags": {
"{customized property}": "string"
},
"optimize": {
"vmBoot": {
"state": "string"
},
"workload": {
"scriptUri": "string",
"sha256Checksum": "string",
"state": "string"
}
},
"source": {
"type": "string"
// For remaining properties, see ImageTemplateSource objects
},
"stagingResourceGroup": "string",
"validate": {
"continueDistributeOnFailure": "bool",
"inVMValidations": [ {
"name": "string",
"type": "string"
// For remaining properties, see ImageTemplateInVMValidator objects
} ],
"sourceValidationOnly": "bool"
},
"vmProfile": {
"osDiskSizeGB": "int",
"userAssignedIdentities": [ "string" ],
"vmSize": "string",
"vnetConfig": {
"containerInstanceSubnetId": "string",
"proxyVmSize": "string",
"subnetId": "string"
}
}
},
"tags": {
"{customized property}": "string"
}
}
Объекты ImageTemplateSource
Задайте свойство type , чтобы указать тип объекта.
Для ManagedImage используйте:
{
"imageId": "string",
"type": "ManagedImage"
}
Для PlatformImage используйте:
{
"offer": "string",
"planInfo": {
"planName": "string",
"planProduct": "string",
"planPublisher": "string"
},
"publisher": "string",
"sku": "string",
"type": "PlatformImage",
"version": "string"
}
Для SharedImageVersion используйте:
{
"imageVersionId": "string",
"type": "SharedImageVersion"
}
Объекты ImageTemplateDistributor
Задайте свойство type , чтобы указать тип объекта.
Для ManagedImage используйте:
{
"imageId": "string",
"location": "string",
"type": "ManagedImage"
}
Для SharedImage используйте:
{
"excludeFromLatest": "bool",
"galleryImageId": "string",
"replicationMode": "string",
"replicationRegions": [ "string" ],
"storageAccountType": "string",
"targetRegions": [
{
"name": "string",
"replicaCount": "int",
"storageAccountType": "string"
}
],
"type": "SharedImage",
"versioning": {
"scheme": "string"
// For remaining properties, see DistributeVersioner objects
}
}
Для VHD используйте:
{
"type": "VHD",
"uri": "string"
}
Объекты ImageTemplateInVMValidator
Задайте свойство type , чтобы указать тип объекта.
Для файла используйте:
{
"destination": "string",
"sha256Checksum": "string",
"sourceUri": "string",
"type": "File"
}
Для PowerShell используйте:
{
"inline": [ "string" ],
"runAsSystem": "bool",
"runElevated": "bool",
"scriptUri": "string",
"sha256Checksum": "string",
"type": "PowerShell",
"validExitCodes": [ "int" ]
}
Для Shell используйте:
{
"inline": [ "string" ],
"scriptUri": "string",
"sha256Checksum": "string",
"type": "Shell"
}
Объекты DistributeVersioner
Задайте свойство scheme , чтобы указать тип объекта.
В качестве последней версии используйте:
{
"major": "int",
"scheme": "Latest"
}
Для Source используйте:
{
"scheme": "Source"
}
Объекты ImageTemplateCustomizer
Задайте свойство type , чтобы указать тип объекта.
Для файла используйте:
{
"destination": "string",
"sha256Checksum": "string",
"sourceUri": "string",
"type": "File"
}
Для PowerShell используйте:
{
"inline": [ "string" ],
"runAsSystem": "bool",
"runElevated": "bool",
"scriptUri": "string",
"sha256Checksum": "string",
"type": "PowerShell",
"validExitCodes": [ "int" ]
}
Для Shell используйте:
{
"inline": [ "string" ],
"scriptUri": "string",
"sha256Checksum": "string",
"type": "Shell"
}
Для WindowsRestart используйте:
{
"restartCheckCommand": "string",
"restartCommand": "string",
"restartTimeout": "string",
"type": "WindowsRestart"
}
Для WindowsUpdate используйте:
{
"filters": [ "string" ],
"searchCriteria": "string",
"type": "WindowsUpdate",
"updateLimit": "int"
}
Значения свойств
Microsoft. VirtualMachineImages/imageTemplates
| Name | Description | Value |
|---|---|---|
| apiVersion | Версия API | '2025-10-01' |
| identity | Удостоверение шаблона изображения, если оно настроено. | ImageTemplateIdentity (обязательно) |
| location | Географическое расположение, в котором находится ресурс | строка (обязательно) |
| name | имя ресурса. | string Constraints: Pattern = ^[A-Za-z0-9-_.]{1,64}$ (обязательно) |
| properties | Свойства шаблона изображения | ImageTemplateProperties |
| tags | Теги ресурсов | Словарь имен и значений тегов. См. теги в шаблонах |
| type | Тип ресурса | 'Microsoft. VirtualMachineImages/imageTemplates' |
DataDisk
| Name | Description | Value |
|---|---|---|
| sizeGB | Размер диска данных в ГБ. | int Constraints: Минимальное значение = 0 |
DistributeVersioner
| Name | Description | Value |
|---|---|---|
| scheme | Установите значение "Последний" для типа DistributeVersionerLatest. Установите значение 'Source' для типа DistributeVersionerSource. | 'Latest' Source (обязательный) |
DistributeVersionerLatest
| Name | Description | Value |
|---|---|---|
| major | Основная версия для созданного номера версии. Определите, что такое "последняя" на основе версий с этим значением в качестве основной версии. -1 эквивалентен выходу из него без набора. | int Constraints: Минимальное значение = -1 |
| scheme | Используемая схема нумерирования версий. | "Последнее" (обязательно) |
DistributeVersionerSource
| Name | Description | Value |
|---|---|---|
| scheme | Используемая схема нумерирования версий. | Source (обязательный) |
ImageTemplateAutoRun
| Name | Description | Value |
|---|---|---|
| state | Включение этого поля приведет к активации автоматической сборки на основе создания шаблона образа или обновления. | 'Disabled' 'Enabled' |
ImageTemplateCustomizer
| Name | Description | Value |
|---|---|---|
| name | Понятное имя для предоставления контекста по этому шагу настройки | string |
| type | Установите значение "File" для типа ImageTemplateFileCustomizer. Установите значение 'PowerShell' для типа ImageTemplatePowerShellCustomizer. Установите значение 'Shell' для типа ImageTemplateShellCustomizer. Установите значение 'WindowsRestart' для типа ImageTemplateRestartCustomizer. Установите значение 'WindowsUpdate' для типа ImageTemplateWindowsUpdateCustomizer. | 'File' 'PowerShell' 'Shell' 'WindowsRestart' 'WindowsUpdate' (обязательно) |
ImageTemplateDistributor
| Name | Description | Value |
|---|---|---|
| artifactTags | Теги, которые будут применены к артефакту после его создания или обновления распространителем. | ImageTemplateDistributorArtifactTags |
| runOutputName | Имя, используемое для связанного runOutput. | string Constraints: Pattern = ^[A-Za-z0-9-_.]{1,64}$ (обязательно) |
| type | Установите значение "ManagedImage" для типа ImageTemplateManagedImageDistributor. Установите значение 'SharedImage' для типа ImageTemplateSharedImageDistributor. Установите значение "VHD" для типа ImageTemplateVhdDistributor. | 'ManagedImage' 'SharedImage' VHD (обязательно) |
ImageTemplateDistributorArtifactTags
| Name | Description | Value |
|---|
ImageTemplateFileCustomizer
| Name | Description | Value |
|---|---|---|
| destination | Абсолютный путь к файлу (с уже созданными вложенными структурами каталогов), в котором файл (из sourceUri) будет отправлен в виртуальную машину. | string |
| sha256Checksum | Контрольная сумма SHA256 файла, предоставленного в поле sourceUri выше | string |
| sourceUri | URI файла, который необходимо отправить для настройки виртуальной машины. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее | string |
| type | Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки | "Файл" (обязательный) |
ImageTemplateFileValidator
| Name | Description | Value |
|---|---|---|
| destination | Абсолютный путь к файлу (с уже созданными вложенными структурами каталогов), в котором файл (из sourceUri) будет отправлен в виртуальную машину. | string |
| sha256Checksum | Контрольная сумма SHA256 файла, предоставленного в поле sourceUri выше | string |
| sourceUri | URI файла, который необходимо отправить на виртуальную машину для проверки. Это может быть ссылка на github, служба хранилища Azure URI (авторизованный или SAS) и так далее | string |
| type | Тип проверки, которую вы хотите использовать на изображении. Например, "Shell" может быть проверкой оболочки | "Файл" (обязательный) |
ImageTemplateIdentity
| Name | Description | Value |
|---|---|---|
| type | Тип удостоверения, используемого для шаблона изображения. Тип "Нет" приведет к удалению удостоверений из шаблона образа. | 'None' 'UserAssigned' |
| userAssignedIdentities | Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в виде: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах. | ImageTemplateIdentityUserAssignedIdentities |
ImageTemplateIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ImageTemplateInVMValidator
| Name | Description | Value |
|---|---|---|
| name | Понятное имя для предоставления контекста по этому шагу проверки | string |
| type | Установите значение 'File' для типа ImageTemplateFileValidator. Установите значение 'PowerShell' для типа ImageTemplatePowerShellValidator. Установите значение 'Shell' для типа ImageTemplateShellValidator. | 'File' 'PowerShell' «Ракушка» (обязательно) |
ImageTemplateManagedImageDistributor
| Name | Description | Value |
|---|---|---|
| imageId | Идентификатор ресурса образа управляемого диска | строка (обязательно) |
| location | Azure местоположение для изображения должно совпадать, если изображение уже существует | строка (обязательно) |
| type | Тип распределения. | 'ManagedImage' (обязательно) |
ImageTemplateManagedImageSource
| Name | Description | Value |
|---|---|---|
| imageId | Идентификатор ресурса ARM управляемого образа в подписке клиента | строка (обязательно) |
| type | Указывает тип исходного образа, с которого вы хотите начать. | 'ManagedImage' (обязательно) |
ImageTemplatePlatformImageSource
| Name | Description | Value |
|---|---|---|
| offer | Предложение изображения из галереи Azure Images. | string |
| planInfo | Необязательной конфигурации плана покупки для образа платформы. | PlatformImagePurchasePlan |
| publisher | Изображение Publisher в Azure Галерейные изображения. | string |
| sku | Изображение из галереи Azure Images. | string |
| type | Указывает тип исходного образа, с которого вы хотите начать. | 'PlatformImage' (обязательно) |
| version | Версия изображения из галереи Azure Images. Если здесь указана последняя версия, версия вычисляется при выполнении сборки образа, а не при отправке шаблона. | string |
ImageTemplatePowerShellCustomizer
| Name | Description | Value |
|---|---|---|
| inline | Массив команд PowerShell для выполнения | string[] |
| runAsSystem | Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями с помощью локального пользователя системы. Значение true может быть только в том случае, если указанное выше поле runElevated имеет значение true. | bool |
| runElevated | Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями | bool |
| scriptUri | URI скрипта PowerShell для настройки. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее | string |
| sha256Checksum | Контрольная сумма SHA256 скрипта Power Shell, предоставленного в поле scriptUri выше | string |
| type | Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки | 'PowerShell' (обязательно) |
| validExitCodes | Допустимые коды выхода для скрипта PowerShell. [По умолчанию: 0] | int[] |
ImageTemplatePowerShellValidator
| Name | Description | Value |
|---|---|---|
| inline | Массив команд PowerShell для выполнения | string[] |
| runAsSystem | Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями с помощью локального пользователя системы. Значение true может быть только в том случае, если указанное выше поле runElevated имеет значение true. | bool |
| runElevated | Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями | bool |
| scriptUri | URI скрипта PowerShell для проверки. Это может быть ссылка на github, служба хранилища Azure URI и так далее | string |
| sha256Checksum | Контрольная сумма SHA256 скрипта Power Shell, предоставленного в поле scriptUri выше | string |
| type | Тип проверки, которую вы хотите использовать на изображении. Например, "Shell" может быть проверкой оболочки | 'PowerShell' (обязательно) |
| validExitCodes | Допустимые коды выхода для скрипта PowerShell. [По умолчанию: 0] | int[] |
ImageTemplateProperties
| Name | Description | Value |
|---|---|---|
| дополнительные данныеDataDisks | Опциональный массив дополнительных дисков данных, которые должны быть добавлены к образу. | DataDisk[] |
| autoRun | Указывает, следует ли автоматически запускать шаблон образа при создании или обновлении шаблона. | ImageTemplateAutoRun |
| buildTimeoutInMinutes | Максимальная длительность ожидания при создании шаблона образа (включает все настройки, оптимизацию, проверку и дистрибутивы). Опустить или указать значение 0, чтобы использовать значение по умолчанию (4 часа). | int Constraints: Минимальное значение = 0 Максимальное значение = 960 |
| customize | Указывает свойства, используемые для описания шагов настройки изображения, таких как источник изображения и т. д. | ImageTemplateCustomizer[] |
| distribute | Целевые объекты распределения, в которых выходные данные изображения должны перейти. | ImageTemplateDistributor[] (обязательно) |
| errorHandling | Параметры обработки ошибок при сбое сборки | ImageTemplatePropertiesErrorHandling |
| managedResourceTags | Теги, которые будут применяться к группе ресурсов и /или ресурсам, созданным службой. | ImageTemplatePropertiesManagedResourceTags |
| optimize | Указывает оптимизацию, выполняемую на изображении. | ImageTemplatePropertiesOptimize |
| source | Указывает свойства, используемые для описания исходного образа. | ImageTemplateSource (обязательно) |
| stagingResourceGroup | Идентификатор промежуточной группы ресурсов в той же подписке, что и шаблон образа, который будет использоваться для сборки образа. Если это поле пусто, будет создана группа ресурсов со случайным именем. Если группа ресурсов, указанная в этом поле, не существует, она будет создана с тем же именем. Если указанная группа ресурсов существует, она должна быть пустой и в том же регионе, что и шаблон изображения. Созданная группа ресурсов будет удалена во время удаления шаблона, если это поле пусто или указанная группа ресурсов не существует, но если указанная группа ресурсов существует, ресурсы, созданные в группе ресурсов, будут удалены во время удаления шаблона, и сама группа ресурсов останется. | string |
| validate | Параметры конфигурации и список проверок, выполняемых на результирующем изображении. | ImageTemplatePropertiesValidate |
| vmProfile | Описание настройки виртуальной машины для создания образов | ImageTemplateVmProfile |
ImageTemplatePropertiesErrorHandling
| Name | Description | Value |
|---|---|---|
| onCustomizerError | Если имеется ошибка настройщика, и это поле имеет значение "очистка", виртуальная машина сборки и связанные сетевые ресурсы будут удалены. Это поведение по умолчанию. Если имеется ошибка настройщика, и это поле имеет значение "прерывание", виртуальная машина сборки будет сохранена. | 'abort' 'cleanup' |
| onValidationError | Если имеется ошибка проверки, и это поле имеет значение "очистка", виртуальная машина сборки и связанные сетевые ресурсы будут удалены. Это поведение по умолчанию. Если имеется ошибка проверки, и это поле имеет значение "прерывание", виртуальная машина сборки будет сохранена. | 'abort' 'cleanup' |
ImageTemplatePropertiesManagedResourceTags
| Name | Description | Value |
|---|
ImageTemplatePropertiesOptimize
| Name | Description | Value |
|---|---|---|
| vmBoot | Оптимизация применяется к образу для ускорения загрузки виртуальной машины. | ImageTemplatePropertiesOptimizeVmBoot |
| Рабочая нагрузка | Оптимизация применяется к изображению для конкретных рабочих нагрузок. | ImageTemplatePropertiesOptimizeWorkload |
ImageTemplatePropertiesOptimizeVmBoot
| Name | Description | Value |
|---|---|---|
| state | Включение этого поля улучшит время загрузки виртуальной машины, оптимизируя окончательные настраиваемые выходные данные образа. | 'Disabled' 'Enabled' |
ImageTemplatePropertiesOptimizeWorkload
| Name | Description | Value |
|---|---|---|
| scriptUri | URI скрипта для запуска для оптимизации рабочей нагрузки. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее | string |
| sha256Checksum | Контрольная сумма SHA256 скрипта, предоставленная в поле scriptUri | string |
| state | Включение этого поля оптимизирует изображения виртуальных машин под конкретные рабочие нагрузки. | 'Disabled' 'Enabled' |
ImageTemplatePropertiesValidate
| Name | Description | Value |
|---|---|---|
| continueDistributeOnFailure | Если проверка завершается ошибкой, и это поле имеет значение false, выходные образы не будут распространяться. Это поведение по умолчанию. Если проверка завершается ошибкой, и это поле имеет значение true, выходные образы по-прежнему будут распределены. Используйте этот параметр с осторожностью, так как это может привести к распространению плохих образов для использования. В любом случае (true или false), выполнение конечного образа будет сообщаться о сбое при сбое проверки. [Примечание. Это поле не влияет на успешное выполнение проверки.] | bool |
| inVMValidations | Список выполняемых проверок. | ImageTemplateInVMValidator[] |
| sourceValidationOnly | Если для этого поля задано значение true, то изображение, указанное в разделе "источник", будет проверено напрямую. Отдельная сборка не будет выполняться для создания и проверки настраиваемого образа. | bool |
ImageTemplateRestartCustomizer
| Name | Description | Value |
|---|---|---|
| restartCheckCommand | Команда для проверки успешности перезапуска [по умолчанию: '' | string |
| restartCommand | Команда для выполнения перезапуска [по умолчанию: "завершение работы /r /f /t 0 /c"packer restart"] | string |
| restartTimeout | Время ожидания перезапуска, указанное в виде строки величины и единицы, например "5 м" (5 минут) или "2h" (2 часа) [по умолчанию: "5 млн" ] | string |
| type | Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки | 'WindowsRestart' (обязательно) |
ImageTemplateSharedImageDistributor
| Name | Description | Value |
|---|---|---|
| excludeFromLatest | Флаг, указывающий, следует ли исключить созданную версию образа из последней версии. Не следует использовать значение по умолчанию (false). | bool |
| galleryImageId | Resource Id изображения Azure Compute Gallery | строка (обязательно) |
| replicationMode | Описывает режим репликации для распространения в Azure Compute Gallery. Опусти использование стандартного режима (Full). | Full "Неглубокий" |
| replicationRegions | [Не рекомендуется] Список регионов, в которые будет реплицирован образ. Этот список можно указать только в том случае, если targetRegions не указан. Это поле устарело. Вместо этого используйте targetRegions. | string[] |
| storageAccountType | [Устарело] Тип аккаунта Storage для хранения общего изображения. Не следует использовать значение по умолчанию (Standard_LRS). Это поле можно указать только в том случае, если указан параметр replicationRegions. Это поле устарело. Вместо этого используйте targetRegions. | 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
| targetRegions | Целевые регионы, в которых будет реплицироваться распределенная версия образа. Этот объект заменяет replicationRegions и может быть указан только в том случае, если репликацияRegions не указана. | TargetRegion[] |
| type | Тип распределения. | 'SharedImage' (обязательно) |
| versioning | Описывает создание нового номера версии x.y.z для распространения. | DistributeVersioner |
ImageTemplateSharedImageVersionSource
| Name | Description | Value |
|---|---|---|
| imageVersionId | Идентификатор ресурса ARM версии образа. Если имя версии образа является "последней", версия вычисляется при сборке образа. | строка (обязательно) |
| type | Указывает тип исходного образа, с которого вы хотите начать. | 'SharedImageVersion' (обязательно) |
ImageTemplateShellCustomizer
| Name | Description | Value |
|---|---|---|
| inline | Массив команд оболочки для выполнения | string[] |
| scriptUri | URI скрипта оболочки для настройки. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее | string |
| sha256Checksum | Контрольная сумма SHA256 скрипта оболочки, указанная в поле scriptUri | string |
| type | Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки | «Ракушка» (обязательно) |
ImageTemplateShellValidator
| Name | Description | Value |
|---|---|---|
| inline | Массив команд оболочки для выполнения | string[] |
| scriptUri | Универсальный код ресурса (URI) скрипта оболочки для проверки. Это может быть ссылка на github, служба хранилища Azure URI и так далее | string |
| sha256Checksum | Контрольная сумма SHA256 скрипта оболочки, указанная в поле scriptUri | string |
| type | Тип проверки, которую вы хотите использовать на изображении. Например, "Shell" может быть проверкой оболочки | «Ракушка» (обязательно) |
ImageTemplateSource
| Name | Description | Value |
|---|---|---|
| type | Установите значение "ManagedImage" для типа ImageTemplateManagedImageSource. Установите значение 'PlatformImage' для типа ImageTemplatePlatformImageSource. Установите значение 'SharedImageVersion' для типа ImageTemplateSharedImageVersionSource. | 'ManagedImage' 'PlatformImage' 'SharedImageVersion' (обязательно) |
ImageTemplateVhdDistributor
| Name | Description | Value |
|---|---|---|
| type | Тип распределения. | VHD (обязательно) |
| uri | Опциональный служба хранилища Azure URI для распределённого VHD-blob. Опустите использование по умолчанию (пустой строки), в таком случае VHD будет опубликован в аккаунт storage в группе staging ресурсов. | string |
ImageTemplateVmProfile
| Name | Description | Value |
|---|---|---|
| osDiskSizeGB | Размер диска ОС в ГБ. Опустите или укажите 0, чтобы использовать стандартный размер диска Azure. | int Constraints: Минимальное значение = 0 |
| userAssignedIdentities | Необязательный массив идентификаторов ресурсов назначенных пользователем управляемых удостоверений для настройки на виртуальной машине сборки и на виртуальной машине проверки. Это может включать удостоверение шаблона изображения. | string[] |
| vmSize | Размер виртуальной машины, используемой для создания, настройки и записи образов. Опустить или указать пустую строку, чтобы использовать значение по умолчанию (Standard_D1_v2 для образов 1-го поколения и Standard_D2ds_v4 для образов 2-го поколения). | string |
| vnetConfig | Опциональная конфигурация virtual network для развертывания сборки и валидационной виртуальной машины. Опустите, если не требуется использовать конкретную virtual network. | VirtualNetworkConfig |
ImageTemplateWindowsUpdateCustomizer
| Name | Description | Value |
|---|---|---|
| filters | Массив фильтров для выбора обновлений для применения. Опустите или укажите пустой массив для использования по умолчанию (без фильтра). См. приведенную выше ссылку на примеры и подробное описание этого поля. | string[] |
| searchCriteria | Критерии поиска обновлений. Опустить или указать пустую строку, чтобы использовать значение по умолчанию (выполните поиск всех). См. приведенную выше ссылку на примеры и подробное описание этого поля. | string |
| type | Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки | 'WindowsUpdate' (обязательно) |
| updateLimit | Максимальное количество обновлений, применяемых за раз. Опустить или указать 0, чтобы использовать значение по умолчанию (1000) | int Constraints: Минимальное значение = 0 |
PlatformImagePurchasePlan
| Name | Description | Value |
|---|---|---|
| planName | Имя плана покупки. | строка (обязательно) |
| planProduct | Продукт плана покупки. | строка (обязательно) |
| planPublisher | Издатель плана покупки. | строка (обязательно) |
TargetRegion
| Name | Description | Value |
|---|---|---|
| name | Имя региона. | строка (обязательно) |
| replicaCount | Количество реплик версии образа, создаваемых в этом регионе. Не следует использовать значение по умолчанию (1). | int Constraints: Минимальное значение = 1 |
| storageAccountType | Указывает тип аккаунта storage, который используется для хранения изображения в этой области. Не следует использовать значение по умолчанию (Standard_LRS). | 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
TrackedResourceTags
| Name | Description | Value |
|---|
UserAssignedIdentity
| Name | Description | Value |
|---|
VirtualNetworkConfig
| Name | Description | Value |
|---|---|---|
| containerInstanceSubnetId | Идентификатор ресурса уже существующей подсети, на которой будет развернут экземпляр Azure Container для изолированных сборок. Это поле может быть указано только если также указана subnetId и должно находиться на той же виртуальная сеть, что и подсеть, указанная в subnetId. |
string |
| proxyVmSize | Размер виртуальной машины прокси-сервера, используемой для передачи трафика на виртуальную машину сборки и проверку виртуальной машины. Это не должно быть указано, если containerInstanceSubnetId он указан, так как в этом случае виртуальная машина прокси-сервера не развертывается. Опустить или указать пустую строку, чтобы использовать значение по умолчанию (Standard_A1_v2). |
string |
| subnetId | Идентификатор ресурса предварительно существующей подсети, в которой будет развернута виртуальная машина сборки и проверка виртуальной машины. | string |
Определение ресурса Terraform (поставщик AzAPI)
Тип ресурса imageTemplates можно развернуть с помощью операций, целевых:
- Группы ресурсов Список изменённых свойств в каждой версии API см. журнал изменений.
Формат ресурса
Создать Microsoft. Ресурс VirtualMachineImages/imageTemplates, добавьте следующий Terraform в ваш шаблон.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.VirtualMachineImages/imageTemplates@2025-10-01"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
additionalDataDisks = [
{
sizeGB = int
}
]
autoRun = {
state = "string"
}
buildTimeoutInMinutes = int
customize = [
{
name = "string"
type = "string"
// For remaining properties, see ImageTemplateCustomizer objects
}
]
distribute = [
{
artifactTags = {
{customized property} = "string"
}
runOutputName = "string"
type = "string"
// For remaining properties, see ImageTemplateDistributor objects
}
]
errorHandling = {
onCustomizerError = "string"
onValidationError = "string"
}
managedResourceTags = {
{customized property} = "string"
}
optimize = {
vmBoot = {
state = "string"
}
workload = {
scriptUri = "string"
sha256Checksum = "string"
state = "string"
}
}
source = {
type = "string"
// For remaining properties, see ImageTemplateSource objects
}
stagingResourceGroup = "string"
validate = {
continueDistributeOnFailure = bool
inVMValidations = [
{
name = "string"
type = "string"
// For remaining properties, see ImageTemplateInVMValidator objects
}
]
sourceValidationOnly = bool
}
vmProfile = {
osDiskSizeGB = int
userAssignedIdentities = [
"string"
]
vmSize = "string"
vnetConfig = {
containerInstanceSubnetId = "string"
proxyVmSize = "string"
subnetId = "string"
}
}
}
}
}
Объекты ImageTemplateSource
Задайте свойство type , чтобы указать тип объекта.
Для ManagedImage используйте:
{
imageId = "string"
type = "ManagedImage"
}
Для PlatformImage используйте:
{
offer = "string"
planInfo = {
planName = "string"
planProduct = "string"
planPublisher = "string"
}
publisher = "string"
sku = "string"
type = "PlatformImage"
version = "string"
}
Для SharedImageVersion используйте:
{
imageVersionId = "string"
type = "SharedImageVersion"
}
Объекты ImageTemplateDistributor
Задайте свойство type , чтобы указать тип объекта.
Для ManagedImage используйте:
{
imageId = "string"
location = "string"
type = "ManagedImage"
}
Для SharedImage используйте:
{
excludeFromLatest = bool
galleryImageId = "string"
replicationMode = "string"
replicationRegions = [
"string"
]
storageAccountType = "string"
targetRegions = [
{
name = "string"
replicaCount = int
storageAccountType = "string"
}
]
type = "SharedImage"
versioning = {
scheme = "string"
// For remaining properties, see DistributeVersioner objects
}
}
Для VHD используйте:
{
type = "VHD"
uri = "string"
}
Объекты ImageTemplateInVMValidator
Задайте свойство type , чтобы указать тип объекта.
Для файла используйте:
{
destination = "string"
sha256Checksum = "string"
sourceUri = "string"
type = "File"
}
Для PowerShell используйте:
{
inline = [
"string"
]
runAsSystem = bool
runElevated = bool
scriptUri = "string"
sha256Checksum = "string"
type = "PowerShell"
validExitCodes = [
int
]
}
Для Shell используйте:
{
inline = [
"string"
]
scriptUri = "string"
sha256Checksum = "string"
type = "Shell"
}
Объекты DistributeVersioner
Задайте свойство scheme , чтобы указать тип объекта.
В качестве последней версии используйте:
{
major = int
scheme = "Latest"
}
Для Source используйте:
{
scheme = "Source"
}
Объекты ImageTemplateCustomizer
Задайте свойство type , чтобы указать тип объекта.
Для файла используйте:
{
destination = "string"
sha256Checksum = "string"
sourceUri = "string"
type = "File"
}
Для PowerShell используйте:
{
inline = [
"string"
]
runAsSystem = bool
runElevated = bool
scriptUri = "string"
sha256Checksum = "string"
type = "PowerShell"
validExitCodes = [
int
]
}
Для Shell используйте:
{
inline = [
"string"
]
scriptUri = "string"
sha256Checksum = "string"
type = "Shell"
}
Для WindowsRestart используйте:
{
restartCheckCommand = "string"
restartCommand = "string"
restartTimeout = "string"
type = "WindowsRestart"
}
Для WindowsUpdate используйте:
{
filters = [
"string"
]
searchCriteria = "string"
type = "WindowsUpdate"
updateLimit = int
}
Значения свойств
Microsoft. VirtualMachineImages/imageTemplates
| Name | Description | Value |
|---|---|---|
| identity | Удостоверение шаблона изображения, если оно настроено. | ImageTemplateIdentity (обязательно) |
| location | Географическое расположение, в котором находится ресурс | строка (обязательно) |
| name | имя ресурса. | string Constraints: Pattern = ^[A-Za-z0-9-_.]{1,64}$ (обязательно) |
| properties | Свойства шаблона изображения | ImageTemplateProperties |
| tags | Теги ресурсов | Словарь имен и значений тегов. |
| type | Тип ресурса | "Microsoft.VirtualMachineImages/imageTemplates@2025-10-01" |
DataDisk
| Name | Description | Value |
|---|---|---|
| sizeGB | Размер диска данных в ГБ. | int Constraints: Минимальное значение = 0 |
DistributeVersioner
| Name | Description | Value |
|---|---|---|
| scheme | Установите значение "Последний" для типа DistributeVersionerLatest. Установите значение 'Source' для типа DistributeVersionerSource. | 'Latest' Source (обязательный) |
DistributeVersionerLatest
| Name | Description | Value |
|---|---|---|
| major | Основная версия для созданного номера версии. Определите, что такое "последняя" на основе версий с этим значением в качестве основной версии. -1 эквивалентен выходу из него без набора. | int Constraints: Минимальное значение = -1 |
| scheme | Используемая схема нумерирования версий. | "Последнее" (обязательно) |
DistributeVersionerSource
| Name | Description | Value |
|---|---|---|
| scheme | Используемая схема нумерирования версий. | Source (обязательный) |
ImageTemplateAutoRun
| Name | Description | Value |
|---|---|---|
| state | Включение этого поля приведет к активации автоматической сборки на основе создания шаблона образа или обновления. | 'Disabled' 'Enabled' |
ImageTemplateCustomizer
| Name | Description | Value |
|---|---|---|
| name | Понятное имя для предоставления контекста по этому шагу настройки | string |
| type | Установите значение "File" для типа ImageTemplateFileCustomizer. Установите значение 'PowerShell' для типа ImageTemplatePowerShellCustomizer. Установите значение 'Shell' для типа ImageTemplateShellCustomizer. Установите значение 'WindowsRestart' для типа ImageTemplateRestartCustomizer. Установите значение 'WindowsUpdate' для типа ImageTemplateWindowsUpdateCustomizer. | 'File' 'PowerShell' 'Shell' 'WindowsRestart' 'WindowsUpdate' (обязательно) |
ImageTemplateDistributor
| Name | Description | Value |
|---|---|---|
| artifactTags | Теги, которые будут применены к артефакту после его создания или обновления распространителем. | ImageTemplateDistributorArtifactTags |
| runOutputName | Имя, используемое для связанного runOutput. | string Constraints: Pattern = ^[A-Za-z0-9-_.]{1,64}$ (обязательно) |
| type | Установите значение "ManagedImage" для типа ImageTemplateManagedImageDistributor. Установите значение 'SharedImage' для типа ImageTemplateSharedImageDistributor. Установите значение "VHD" для типа ImageTemplateVhdDistributor. | 'ManagedImage' 'SharedImage' VHD (обязательно) |
ImageTemplateDistributorArtifactTags
| Name | Description | Value |
|---|
ImageTemplateFileCustomizer
| Name | Description | Value |
|---|---|---|
| destination | Абсолютный путь к файлу (с уже созданными вложенными структурами каталогов), в котором файл (из sourceUri) будет отправлен в виртуальную машину. | string |
| sha256Checksum | Контрольная сумма SHA256 файла, предоставленного в поле sourceUri выше | string |
| sourceUri | URI файла, который необходимо отправить для настройки виртуальной машины. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее | string |
| type | Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки | "Файл" (обязательный) |
ImageTemplateFileValidator
| Name | Description | Value |
|---|---|---|
| destination | Абсолютный путь к файлу (с уже созданными вложенными структурами каталогов), в котором файл (из sourceUri) будет отправлен в виртуальную машину. | string |
| sha256Checksum | Контрольная сумма SHA256 файла, предоставленного в поле sourceUri выше | string |
| sourceUri | URI файла, который необходимо отправить на виртуальную машину для проверки. Это может быть ссылка на github, служба хранилища Azure URI (авторизованный или SAS) и так далее | string |
| type | Тип проверки, которую вы хотите использовать на изображении. Например, "Shell" может быть проверкой оболочки | "Файл" (обязательный) |
ImageTemplateIdentity
| Name | Description | Value |
|---|---|---|
| type | Тип удостоверения, используемого для шаблона изображения. Тип "Нет" приведет к удалению удостоверений из шаблона образа. | 'None' 'UserAssigned' |
| userAssignedIdentities | Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в виде: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах. | ImageTemplateIdentityUserAssignedIdentities |
ImageTemplateIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ImageTemplateInVMValidator
| Name | Description | Value |
|---|---|---|
| name | Понятное имя для предоставления контекста по этому шагу проверки | string |
| type | Установите значение 'File' для типа ImageTemplateFileValidator. Установите значение 'PowerShell' для типа ImageTemplatePowerShellValidator. Установите значение 'Shell' для типа ImageTemplateShellValidator. | 'File' 'PowerShell' «Ракушка» (обязательно) |
ImageTemplateManagedImageDistributor
| Name | Description | Value |
|---|---|---|
| imageId | Идентификатор ресурса образа управляемого диска | строка (обязательно) |
| location | Azure местоположение для изображения должно совпадать, если изображение уже существует | строка (обязательно) |
| type | Тип распределения. | 'ManagedImage' (обязательно) |
ImageTemplateManagedImageSource
| Name | Description | Value |
|---|---|---|
| imageId | Идентификатор ресурса ARM управляемого образа в подписке клиента | строка (обязательно) |
| type | Указывает тип исходного образа, с которого вы хотите начать. | 'ManagedImage' (обязательно) |
ImageTemplatePlatformImageSource
| Name | Description | Value |
|---|---|---|
| offer | Предложение изображения из галереи Azure Images. | string |
| planInfo | Необязательной конфигурации плана покупки для образа платформы. | PlatformImagePurchasePlan |
| publisher | Изображение Publisher в Azure Галерейные изображения. | string |
| sku | Изображение из галереи Azure Images. | string |
| type | Указывает тип исходного образа, с которого вы хотите начать. | 'PlatformImage' (обязательно) |
| version | Версия изображения из галереи Azure Images. Если здесь указана последняя версия, версия вычисляется при выполнении сборки образа, а не при отправке шаблона. | string |
ImageTemplatePowerShellCustomizer
| Name | Description | Value |
|---|---|---|
| inline | Массив команд PowerShell для выполнения | string[] |
| runAsSystem | Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями с помощью локального пользователя системы. Значение true может быть только в том случае, если указанное выше поле runElevated имеет значение true. | bool |
| runElevated | Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями | bool |
| scriptUri | URI скрипта PowerShell для настройки. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее | string |
| sha256Checksum | Контрольная сумма SHA256 скрипта Power Shell, предоставленного в поле scriptUri выше | string |
| type | Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки | 'PowerShell' (обязательно) |
| validExitCodes | Допустимые коды выхода для скрипта PowerShell. [По умолчанию: 0] | int[] |
ImageTemplatePowerShellValidator
| Name | Description | Value |
|---|---|---|
| inline | Массив команд PowerShell для выполнения | string[] |
| runAsSystem | Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями с помощью локального пользователя системы. Значение true может быть только в том случае, если указанное выше поле runElevated имеет значение true. | bool |
| runElevated | Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями | bool |
| scriptUri | URI скрипта PowerShell для проверки. Это может быть ссылка на github, служба хранилища Azure URI и так далее | string |
| sha256Checksum | Контрольная сумма SHA256 скрипта Power Shell, предоставленного в поле scriptUri выше | string |
| type | Тип проверки, которую вы хотите использовать на изображении. Например, "Shell" может быть проверкой оболочки | 'PowerShell' (обязательно) |
| validExitCodes | Допустимые коды выхода для скрипта PowerShell. [По умолчанию: 0] | int[] |
ImageTemplateProperties
| Name | Description | Value |
|---|---|---|
| дополнительные данныеDataDisks | Опциональный массив дополнительных дисков данных, которые должны быть добавлены к образу. | DataDisk[] |
| autoRun | Указывает, следует ли автоматически запускать шаблон образа при создании или обновлении шаблона. | ImageTemplateAutoRun |
| buildTimeoutInMinutes | Максимальная длительность ожидания при создании шаблона образа (включает все настройки, оптимизацию, проверку и дистрибутивы). Опустить или указать значение 0, чтобы использовать значение по умолчанию (4 часа). | int Constraints: Минимальное значение = 0 Максимальное значение = 960 |
| customize | Указывает свойства, используемые для описания шагов настройки изображения, таких как источник изображения и т. д. | ImageTemplateCustomizer[] |
| distribute | Целевые объекты распределения, в которых выходные данные изображения должны перейти. | ImageTemplateDistributor[] (обязательно) |
| errorHandling | Параметры обработки ошибок при сбое сборки | ImageTemplatePropertiesErrorHandling |
| managedResourceTags | Теги, которые будут применяться к группе ресурсов и /или ресурсам, созданным службой. | ImageTemplatePropertiesManagedResourceTags |
| optimize | Указывает оптимизацию, выполняемую на изображении. | ImageTemplatePropertiesOptimize |
| source | Указывает свойства, используемые для описания исходного образа. | ImageTemplateSource (обязательно) |
| stagingResourceGroup | Идентификатор промежуточной группы ресурсов в той же подписке, что и шаблон образа, который будет использоваться для сборки образа. Если это поле пусто, будет создана группа ресурсов со случайным именем. Если группа ресурсов, указанная в этом поле, не существует, она будет создана с тем же именем. Если указанная группа ресурсов существует, она должна быть пустой и в том же регионе, что и шаблон изображения. Созданная группа ресурсов будет удалена во время удаления шаблона, если это поле пусто или указанная группа ресурсов не существует, но если указанная группа ресурсов существует, ресурсы, созданные в группе ресурсов, будут удалены во время удаления шаблона, и сама группа ресурсов останется. | string |
| validate | Параметры конфигурации и список проверок, выполняемых на результирующем изображении. | ImageTemplatePropertiesValidate |
| vmProfile | Описание настройки виртуальной машины для создания образов | ImageTemplateVmProfile |
ImageTemplatePropertiesErrorHandling
| Name | Description | Value |
|---|---|---|
| onCustomizerError | Если имеется ошибка настройщика, и это поле имеет значение "очистка", виртуальная машина сборки и связанные сетевые ресурсы будут удалены. Это поведение по умолчанию. Если имеется ошибка настройщика, и это поле имеет значение "прерывание", виртуальная машина сборки будет сохранена. | 'abort' 'cleanup' |
| onValidationError | Если имеется ошибка проверки, и это поле имеет значение "очистка", виртуальная машина сборки и связанные сетевые ресурсы будут удалены. Это поведение по умолчанию. Если имеется ошибка проверки, и это поле имеет значение "прерывание", виртуальная машина сборки будет сохранена. | 'abort' 'cleanup' |
ImageTemplatePropertiesManagedResourceTags
| Name | Description | Value |
|---|
ImageTemplatePropertiesOptimize
| Name | Description | Value |
|---|---|---|
| vmBoot | Оптимизация применяется к образу для ускорения загрузки виртуальной машины. | ImageTemplatePropertiesOptimizeVmBoot |
| Рабочая нагрузка | Оптимизация применяется к изображению для конкретных рабочих нагрузок. | ImageTemplatePropertiesOptimizeWorkload |
ImageTemplatePropertiesOptimizeVmBoot
| Name | Description | Value |
|---|---|---|
| state | Включение этого поля улучшит время загрузки виртуальной машины, оптимизируя окончательные настраиваемые выходные данные образа. | 'Disabled' 'Enabled' |
ImageTemplatePropertiesOptimizeWorkload
| Name | Description | Value |
|---|---|---|
| scriptUri | URI скрипта для запуска для оптимизации рабочей нагрузки. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее | string |
| sha256Checksum | Контрольная сумма SHA256 скрипта, предоставленная в поле scriptUri | string |
| state | Включение этого поля оптимизирует изображения виртуальных машин под конкретные рабочие нагрузки. | 'Disabled' 'Enabled' |
ImageTemplatePropertiesValidate
| Name | Description | Value |
|---|---|---|
| continueDistributeOnFailure | Если проверка завершается ошибкой, и это поле имеет значение false, выходные образы не будут распространяться. Это поведение по умолчанию. Если проверка завершается ошибкой, и это поле имеет значение true, выходные образы по-прежнему будут распределены. Используйте этот параметр с осторожностью, так как это может привести к распространению плохих образов для использования. В любом случае (true или false), выполнение конечного образа будет сообщаться о сбое при сбое проверки. [Примечание. Это поле не влияет на успешное выполнение проверки.] | bool |
| inVMValidations | Список выполняемых проверок. | ImageTemplateInVMValidator[] |
| sourceValidationOnly | Если для этого поля задано значение true, то изображение, указанное в разделе "источник", будет проверено напрямую. Отдельная сборка не будет выполняться для создания и проверки настраиваемого образа. | bool |
ImageTemplateRestartCustomizer
| Name | Description | Value |
|---|---|---|
| restartCheckCommand | Команда для проверки успешности перезапуска [по умолчанию: '' | string |
| restartCommand | Команда для выполнения перезапуска [по умолчанию: "завершение работы /r /f /t 0 /c"packer restart"] | string |
| restartTimeout | Время ожидания перезапуска, указанное в виде строки величины и единицы, например "5 м" (5 минут) или "2h" (2 часа) [по умолчанию: "5 млн" ] | string |
| type | Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки | 'WindowsRestart' (обязательно) |
ImageTemplateSharedImageDistributor
| Name | Description | Value |
|---|---|---|
| excludeFromLatest | Флаг, указывающий, следует ли исключить созданную версию образа из последней версии. Не следует использовать значение по умолчанию (false). | bool |
| galleryImageId | Resource Id изображения Azure Compute Gallery | строка (обязательно) |
| replicationMode | Описывает режим репликации для распространения в Azure Compute Gallery. Опусти использование стандартного режима (Full). | Full "Неглубокий" |
| replicationRegions | [Не рекомендуется] Список регионов, в которые будет реплицирован образ. Этот список можно указать только в том случае, если targetRegions не указан. Это поле устарело. Вместо этого используйте targetRegions. | string[] |
| storageAccountType | [Устарело] Тип аккаунта Storage для хранения общего изображения. Не следует использовать значение по умолчанию (Standard_LRS). Это поле можно указать только в том случае, если указан параметр replicationRegions. Это поле устарело. Вместо этого используйте targetRegions. | 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
| targetRegions | Целевые регионы, в которых будет реплицироваться распределенная версия образа. Этот объект заменяет replicationRegions и может быть указан только в том случае, если репликацияRegions не указана. | TargetRegion[] |
| type | Тип распределения. | 'SharedImage' (обязательно) |
| versioning | Описывает создание нового номера версии x.y.z для распространения. | DistributeVersioner |
ImageTemplateSharedImageVersionSource
| Name | Description | Value |
|---|---|---|
| imageVersionId | Идентификатор ресурса ARM версии образа. Если имя версии образа является "последней", версия вычисляется при сборке образа. | строка (обязательно) |
| type | Указывает тип исходного образа, с которого вы хотите начать. | 'SharedImageVersion' (обязательно) |
ImageTemplateShellCustomizer
| Name | Description | Value |
|---|---|---|
| inline | Массив команд оболочки для выполнения | string[] |
| scriptUri | URI скрипта оболочки для настройки. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее | string |
| sha256Checksum | Контрольная сумма SHA256 скрипта оболочки, указанная в поле scriptUri | string |
| type | Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки | «Ракушка» (обязательно) |
ImageTemplateShellValidator
| Name | Description | Value |
|---|---|---|
| inline | Массив команд оболочки для выполнения | string[] |
| scriptUri | Универсальный код ресурса (URI) скрипта оболочки для проверки. Это может быть ссылка на github, служба хранилища Azure URI и так далее | string |
| sha256Checksum | Контрольная сумма SHA256 скрипта оболочки, указанная в поле scriptUri | string |
| type | Тип проверки, которую вы хотите использовать на изображении. Например, "Shell" может быть проверкой оболочки | «Ракушка» (обязательно) |
ImageTemplateSource
| Name | Description | Value |
|---|---|---|
| type | Установите значение "ManagedImage" для типа ImageTemplateManagedImageSource. Установите значение 'PlatformImage' для типа ImageTemplatePlatformImageSource. Установите значение 'SharedImageVersion' для типа ImageTemplateSharedImageVersionSource. | 'ManagedImage' 'PlatformImage' 'SharedImageVersion' (обязательно) |
ImageTemplateVhdDistributor
| Name | Description | Value |
|---|---|---|
| type | Тип распределения. | VHD (обязательно) |
| uri | Опциональный служба хранилища Azure URI для распределённого VHD-blob. Опустите использование по умолчанию (пустой строки), в таком случае VHD будет опубликован в аккаунт storage в группе staging ресурсов. | string |
ImageTemplateVmProfile
| Name | Description | Value |
|---|---|---|
| osDiskSizeGB | Размер диска ОС в ГБ. Опустите или укажите 0, чтобы использовать стандартный размер диска Azure. | int Constraints: Минимальное значение = 0 |
| userAssignedIdentities | Необязательный массив идентификаторов ресурсов назначенных пользователем управляемых удостоверений для настройки на виртуальной машине сборки и на виртуальной машине проверки. Это может включать удостоверение шаблона изображения. | string[] |
| vmSize | Размер виртуальной машины, используемой для создания, настройки и записи образов. Опустить или указать пустую строку, чтобы использовать значение по умолчанию (Standard_D1_v2 для образов 1-го поколения и Standard_D2ds_v4 для образов 2-го поколения). | string |
| vnetConfig | Опциональная конфигурация virtual network для развертывания сборки и валидационной виртуальной машины. Опустите, если не требуется использовать конкретную virtual network. | VirtualNetworkConfig |
ImageTemplateWindowsUpdateCustomizer
| Name | Description | Value |
|---|---|---|
| filters | Массив фильтров для выбора обновлений для применения. Опустите или укажите пустой массив для использования по умолчанию (без фильтра). См. приведенную выше ссылку на примеры и подробное описание этого поля. | string[] |
| searchCriteria | Критерии поиска обновлений. Опустить или указать пустую строку, чтобы использовать значение по умолчанию (выполните поиск всех). См. приведенную выше ссылку на примеры и подробное описание этого поля. | string |
| type | Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки | 'WindowsUpdate' (обязательно) |
| updateLimit | Максимальное количество обновлений, применяемых за раз. Опустить или указать 0, чтобы использовать значение по умолчанию (1000) | int Constraints: Минимальное значение = 0 |
PlatformImagePurchasePlan
| Name | Description | Value |
|---|---|---|
| planName | Имя плана покупки. | строка (обязательно) |
| planProduct | Продукт плана покупки. | строка (обязательно) |
| planPublisher | Издатель плана покупки. | строка (обязательно) |
TargetRegion
| Name | Description | Value |
|---|---|---|
| name | Имя региона. | строка (обязательно) |
| replicaCount | Количество реплик версии образа, создаваемых в этом регионе. Не следует использовать значение по умолчанию (1). | int Constraints: Минимальное значение = 1 |
| storageAccountType | Указывает тип аккаунта storage, который используется для хранения изображения в этой области. Не следует использовать значение по умолчанию (Standard_LRS). | 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
TrackedResourceTags
| Name | Description | Value |
|---|
UserAssignedIdentity
| Name | Description | Value |
|---|
VirtualNetworkConfig
| Name | Description | Value |
|---|---|---|
| containerInstanceSubnetId | Идентификатор ресурса уже существующей подсети, на которой будет развернут экземпляр Azure Container для изолированных сборок. Это поле может быть указано только если также указана subnetId и должно находиться на той же виртуальная сеть, что и подсеть, указанная в subnetId. |
string |
| proxyVmSize | Размер виртуальной машины прокси-сервера, используемой для передачи трафика на виртуальную машину сборки и проверку виртуальной машины. Это не должно быть указано, если containerInstanceSubnetId он указан, так как в этом случае виртуальная машина прокси-сервера не развертывается. Опустить или указать пустую строку, чтобы использовать значение по умолчанию (Standard_A1_v2). |
string |
| subnetId | Идентификатор ресурса предварительно существующей подсети, в которой будет развернута виртуальная машина сборки и проверка виртуальной машины. | string |