Поделиться через

Образы Microsoft.Compute 2023-09-01

  • Статья

Определение ресурсов Bicep

Тип ресурса изображений можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Compute/images, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.Compute/images@2023-09-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  extendedLocation: {
    name: 'string'
    type: 'EdgeZone'
  }
  properties: {
    hyperVGeneration: 'string'
    sourceVirtualMachine: {
      id: 'string'
    }
    storageProfile: {
      dataDisks: [
        {
          blobUri: 'string'
          caching: 'string'
          diskEncryptionSet: {
            id: 'string'
          }
          diskSizeGB: int
          lun: int
          managedDisk: {
            id: 'string'
          }
          snapshot: {
            id: 'string'
          }
          storageAccountType: 'string'
        }
      ]
      osDisk: {
        blobUri: 'string'
        caching: 'string'
        diskEncryptionSet: {
          id: 'string'
        }
        diskSizeGB: int
        managedDisk: {
          id: 'string'
        }
        osState: 'string'
        osType: 'string'
        snapshot: {
          id: 'string'
        }
        storageAccountType: 'string'
      }
      zoneResilient: bool
    }
  }
}

Значения свойств

Изображения

Имя Описание Ценность
имя Имя ресурса строка (обязательно)

Ограничение символов: 1–80

Допустимые символы:
Буквенно-цифровые символы, символы подчеркивания, периоды и дефисы.

Начните с буквенно-цифровых символов. Заканчивается буквенно-цифровым или подчеркиванием.
местоположение Расположение ресурса строка (обязательно)
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
extendedLocation Расширенное расположение изображения. ExtendedLocation
свойства Описывает свойства изображения. ImageProperties

ExtendedLocation

Имя Описание Ценность
имя Имя расширенного расположения. струна
тип Тип расширенного расположения. EdgeZone

ImageProperties

Имя Описание Ценность
hyperVGeneration Задает тип HyperVGenerationType виртуальнойMachine, созданной на основе образа. В API версии 2019-03-01, если источник образа является большим двоичным объектом, то пользователю нужно указать значение, если источник управляется ресурсом, например диском или моментальным снимком, может потребоваться указать свойство, если мы не можем вывести его из исходного управляемого ресурса. "V1"
"V2"
sourceVirtualMachine Исходная виртуальная машина, из которой создается образ. SubResource
storageProfile Задает параметры хранилища для дисков виртуальной машины. ImageStorageProfile

SubResource

Имя Описание Ценность
идентификатор Идентификатор ресурса струна

ImageStorageProfile

Имя Описание Ценность
dataDisks Указывает параметры, используемые для добавления диска данных на виртуальную машину.

Дополнительные сведения о дисках см. в статье Сведения о дисках и виртуальных жестких дисках для виртуальных машин Azure.		 ImageDataDisk[]
osDisk Указывает сведения о диске операционной системы, используемом виртуальной машиной.

Дополнительные сведения о дисках см. в статье Сведения о дисках и виртуальных жестких дисках для виртуальных машин Azure.		 ImageOSDisk
zoneResilient Указывает, является ли изображение устойчивым к зонам. Значение по умолчанию — false. Устойчивые к зонам образы можно создавать только в регионах, которые предоставляют хранилище, избыточное между зонами (ZRS). bool

ImageDataDisk

Имя Описание Ценность
BLOBURI Виртуальный жесткий диск. струна
Кэширование Указывает требования к кэшированию. Возможные значения: None,ReadOnly,ReadWrite. Значения по умолчанию: Нет для хранилища уровня "Стандартный". ReadOnly для хранилища Premium. "Нет"
"ReadOnly"
ReadWrite
diskEncryptionSet Указывает идентификатор ресурса набора шифрования управляемых пользователем дисков для управляемого диска образа. DiskEncryptionSetParameters
diskSizeGB Задает размер пустых дисков данных в гигабайтах. Этот элемент можно использовать для перезаписи имени диска в образе виртуальной машины. Это значение не может превышать 1023 ГБ. int
lun Указывает логическую единицу диска данных. Это значение используется для идентификации дисков данных на виртуальной машине и поэтому должно быть уникальным для каждого диска данных, подключенного к виртуальной машине. int (обязательно)
managedDisk УправляемыйDisk. SubResource
снимок Моментальный снимок. SubResource
storageAccountType Указывает тип учетной записи хранения для управляемого диска. ПРИМЕЧАНИЕ. UltraSSD_LRS можно использовать только с дисками данных, его нельзя использовать с диском ОС. "PremiumV2_LRS"
"Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"
"UltraSSD_LRS"

DiskEncryptionSetParameters

Имя Описание Ценность
идентификатор Идентификатор ресурса струна

ImageOSDisk

Имя Описание Ценность
BLOBURI Виртуальный жесткий диск. струна
Кэширование Указывает требования к кэшированию. Возможные значения: None,ReadOnly,ReadWrite. Значения по умолчанию: Нет для хранилища уровня "Стандартный". ReadOnly для хранилища Premium. "Нет"
"ReadOnly"
ReadWrite
diskEncryptionSet Указывает идентификатор ресурса набора шифрования управляемых пользователем дисков для управляемого диска образа. DiskEncryptionSetParameters
diskSizeGB Задает размер пустых дисков данных в гигабайтах. Этот элемент можно использовать для перезаписи имени диска в образе виртуальной машины. Это значение не может превышать 1023 ГБ. int
managedDisk УправляемыйDisk. SubResource
osState Состояние ОС. Для управляемых образов используйте generalized. "Обобщенный"
'Специализированный' (обязательный)
osType Это свойство позволяет указать тип ОПЕРАЦИОННОй системы, включенной в диск, при создании виртуальной машины из пользовательского образа. Возможные значения: Windows,Linux. Linux
"Windows" (обязательно)
снимок Моментальный снимок. SubResource
storageAccountType Указывает тип учетной записи хранения для управляемого диска. ПРИМЕЧАНИЕ. UltraSSD_LRS можно использовать только с дисками данных, его нельзя использовать с диском ОС. "PremiumV2_LRS"
"Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"
"UltraSSD_LRS"

Шаблоны быстрого запуска

Следующие шаблоны быстрого запуска развертывают этот тип ресурса.

Шаблон Описание
создание виртуальной машины из образа пользователя

развертывание в Azure		 Этот шаблон позволяет создавать виртуальные машины из образа пользователя. Этот шаблон также развертывает виртуальную сеть, общедоступные IP-адреса и сетевой интерфейс.
Создание виртуальной машины в новой или существующей виртуальной сети из обобщенного виртуального жесткого диска

развертывание в Azure		 Этот шаблон создает виртуальную машину из обобщенного виртуального жесткого диска и позволяет подключить ее к новой или существующей виртуальной сети, которая может находиться в другой группе ресурсов, чем виртуальная машина.
Развертывание масштабируемого набора виртуальных машин с помощью пользовательского образа Linux

развертывание в Azure		 Этот шаблон позволяет развернуть пользовательский образ виртуальной машины Linux в масштабируемом наборе. Эти виртуальные машины находятся за балансировщиком нагрузки с балансировкой нагрузки HTTP (по умолчанию на порте 80). В примере используется пользовательский скрипт для развертывания и обновления приложения, возможно, потребуется предоставить пользовательский скрипт для собственной процедуры обновления. Вам потребуется предоставить обобщенный образ виртуальной машины в той же подписке и регионе, где создается VMSS.
Развертывание масштабируемого набора виртуальных машин с помощью пользовательского образа Windows

развертывание в Azure		 Этот шаблон позволяет развернуть простой масштабируемый набор виртуальных машин для пользовательского образа Windows. Эти виртуальные машины находятся за балансировщиком нагрузки с балансировкой нагрузки HTTP (по умолчанию на порте 80).

Определение ресурса шаблона ARM

Тип ресурса изображений можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Compute/images, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.Compute/images",
  "apiVersion": "2023-09-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "extendedLocation": {
    "name": "string",
    "type": "EdgeZone"
  },
  "properties": {
    "hyperVGeneration": "string",
    "sourceVirtualMachine": {
      "id": "string"
    },
    "storageProfile": {
      "dataDisks": [
        {
          "blobUri": "string",
          "caching": "string",
          "diskEncryptionSet": {
            "id": "string"
          },
          "diskSizeGB": "int",
          "lun": "int",
          "managedDisk": {
            "id": "string"
          },
          "snapshot": {
            "id": "string"
          },
          "storageAccountType": "string"
        }
      ],
      "osDisk": {
        "blobUri": "string",
        "caching": "string",
        "diskEncryptionSet": {
          "id": "string"
        },
        "diskSizeGB": "int",
        "managedDisk": {
          "id": "string"
        },
        "osState": "string",
        "osType": "string",
        "snapshot": {
          "id": "string"
        },
        "storageAccountType": "string"
      },
      "zoneResilient": "bool"
    }
  }
}

Значения свойств

Изображения

Имя Описание Ценность
тип Тип ресурса "Microsoft.Compute/images"
apiVersion Версия API ресурсов '2023-09-01'
имя Имя ресурса строка (обязательно)

Ограничение символов: 1–80

Допустимые символы:
Буквенно-цифровые символы, символы подчеркивания, периоды и дефисы.

Начните с буквенно-цифровых символов. Заканчивается буквенно-цифровым или подчеркиванием.
местоположение Расположение ресурса строка (обязательно)
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
extendedLocation Расширенное расположение изображения. ExtendedLocation
свойства Описывает свойства изображения. ImageProperties

ExtendedLocation

Имя Описание Ценность
имя Имя расширенного расположения. струна
тип Тип расширенного расположения. EdgeZone

ImageProperties

Имя Описание Ценность
hyperVGeneration Задает тип HyperVGenerationType виртуальнойMachine, созданной на основе образа. В API версии 2019-03-01, если источник образа является большим двоичным объектом, то пользователю нужно указать значение, если источник управляется ресурсом, например диском или моментальным снимком, может потребоваться указать свойство, если мы не можем вывести его из исходного управляемого ресурса. "V1"
"V2"
sourceVirtualMachine Исходная виртуальная машина, из которой создается образ. SubResource
storageProfile Задает параметры хранилища для дисков виртуальной машины. ImageStorageProfile

SubResource

Имя Описание Ценность
идентификатор Идентификатор ресурса струна

ImageStorageProfile

Имя Описание Ценность
dataDisks Указывает параметры, используемые для добавления диска данных на виртуальную машину.

Дополнительные сведения о дисках см. в статье Сведения о дисках и виртуальных жестких дисках для виртуальных машин Azure.		 ImageDataDisk[]
osDisk Указывает сведения о диске операционной системы, используемом виртуальной машиной.

Дополнительные сведения о дисках см. в статье Сведения о дисках и виртуальных жестких дисках для виртуальных машин Azure.		 ImageOSDisk
zoneResilient Указывает, является ли изображение устойчивым к зонам. Значение по умолчанию — false. Устойчивые к зонам образы можно создавать только в регионах, которые предоставляют хранилище, избыточное между зонами (ZRS). bool

ImageDataDisk

Имя Описание Ценность
BLOBURI Виртуальный жесткий диск. струна
Кэширование Указывает требования к кэшированию. Возможные значения: None,ReadOnly,ReadWrite. Значения по умолчанию: Нет для хранилища уровня "Стандартный". ReadOnly для хранилища Premium. "Нет"
"ReadOnly"
ReadWrite
diskEncryptionSet Указывает идентификатор ресурса набора шифрования управляемых пользователем дисков для управляемого диска образа. DiskEncryptionSetParameters
diskSizeGB Задает размер пустых дисков данных в гигабайтах. Этот элемент можно использовать для перезаписи имени диска в образе виртуальной машины. Это значение не может превышать 1023 ГБ. int
lun Указывает логическую единицу диска данных. Это значение используется для идентификации дисков данных на виртуальной машине и поэтому должно быть уникальным для каждого диска данных, подключенного к виртуальной машине. int (обязательно)
managedDisk УправляемыйDisk. SubResource
снимок Моментальный снимок. SubResource
storageAccountType Указывает тип учетной записи хранения для управляемого диска. ПРИМЕЧАНИЕ. UltraSSD_LRS можно использовать только с дисками данных, его нельзя использовать с диском ОС. "PremiumV2_LRS"
"Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"
"UltraSSD_LRS"

DiskEncryptionSetParameters

Имя Описание Ценность
идентификатор Идентификатор ресурса струна

ImageOSDisk

Имя Описание Ценность
BLOBURI Виртуальный жесткий диск. струна
Кэширование Указывает требования к кэшированию. Возможные значения: None,ReadOnly,ReadWrite. Значения по умолчанию: Нет для хранилища уровня "Стандартный". ReadOnly для хранилища Premium. "Нет"
"ReadOnly"
ReadWrite
diskEncryptionSet Указывает идентификатор ресурса набора шифрования управляемых пользователем дисков для управляемого диска образа. DiskEncryptionSetParameters
diskSizeGB Задает размер пустых дисков данных в гигабайтах. Этот элемент можно использовать для перезаписи имени диска в образе виртуальной машины. Это значение не может превышать 1023 ГБ. int
managedDisk УправляемыйDisk. SubResource
osState Состояние ОС. Для управляемых образов используйте generalized. "Обобщенный"
'Специализированный' (обязательный)
osType Это свойство позволяет указать тип ОПЕРАЦИОННОй системы, включенной в диск, при создании виртуальной машины из пользовательского образа. Возможные значения: Windows,Linux. Linux
"Windows" (обязательно)
снимок Моментальный снимок. SubResource
storageAccountType Указывает тип учетной записи хранения для управляемого диска. ПРИМЕЧАНИЕ. UltraSSD_LRS можно использовать только с дисками данных, его нельзя использовать с диском ОС. "PremiumV2_LRS"
"Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"
"UltraSSD_LRS"

Шаблоны быстрого запуска

Следующие шаблоны быстрого запуска развертывают этот тип ресурса.

Шаблон Описание
создание виртуальной машины из образа пользователя

развертывание в Azure		 Этот шаблон позволяет создавать виртуальные машины из образа пользователя. Этот шаблон также развертывает виртуальную сеть, общедоступные IP-адреса и сетевой интерфейс.
Создание виртуальной машины в новой или существующей виртуальной сети из обобщенного виртуального жесткого диска

развертывание в Azure		 Этот шаблон создает виртуальную машину из обобщенного виртуального жесткого диска и позволяет подключить ее к новой или существующей виртуальной сети, которая может находиться в другой группе ресурсов, чем виртуальная машина.
Развертывание масштабируемого набора виртуальных машин с помощью пользовательского образа Linux

развертывание в Azure		 Этот шаблон позволяет развернуть пользовательский образ виртуальной машины Linux в масштабируемом наборе. Эти виртуальные машины находятся за балансировщиком нагрузки с балансировкой нагрузки HTTP (по умолчанию на порте 80). В примере используется пользовательский скрипт для развертывания и обновления приложения, возможно, потребуется предоставить пользовательский скрипт для собственной процедуры обновления. Вам потребуется предоставить обобщенный образ виртуальной машины в той же подписке и регионе, где создается VMSS.
Развертывание масштабируемого набора виртуальных машин с помощью пользовательского образа Windows

развертывание в Azure		 Этот шаблон позволяет развернуть простой масштабируемый набор виртуальных машин для пользовательского образа Windows. Эти виртуальные машины находятся за балансировщиком нагрузки с балансировкой нагрузки HTTP (по умолчанию на порте 80).

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса изображений можно развернуть с помощью операций, предназначенных для следующих операций:

  • групп ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Compute/images, добавьте следующий объект Terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/images@2023-09-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      hyperVGeneration = "string"
      sourceVirtualMachine = {
        id = "string"
      }
      storageProfile = {
        dataDisks = [
          {
            blobUri = "string"
            caching = "string"
            diskEncryptionSet = {
              id = "string"
            }
            diskSizeGB = int
            lun = int
            managedDisk = {
              id = "string"
            }
            snapshot = {
              id = "string"
            }
            storageAccountType = "string"
          }
        ]
        osDisk = {
          blobUri = "string"
          caching = "string"
          diskEncryptionSet = {
            id = "string"
          }
          diskSizeGB = int
          managedDisk = {
            id = "string"
          }
          osState = "string"
          osType = "string"
          snapshot = {
            id = "string"
          }
          storageAccountType = "string"
        }
        zoneResilient = bool
      }
    }
    extendedLocation = {
      name = "string"
      type = "EdgeZone"
    }
  })
}

Значения свойств

Изображения

Имя Описание Ценность
тип Тип ресурса "Microsoft.Compute/images@2023-09-01"
имя Имя ресурса строка (обязательно)

Ограничение символов: 1–80

Допустимые символы:
Буквенно-цифровые символы, символы подчеркивания, периоды и дефисы.

Начните с буквенно-цифровых символов. Заканчивается буквенно-цифровым или подчеркиванием.
местоположение Расположение ресурса строка (обязательно)
parent_id Чтобы развернуть в группе ресурсов, используйте идентификатор этой группы ресурсов. строка (обязательно)
Теги Теги ресурсов Словарь имен и значений тегов.
extendedLocation Расширенное расположение изображения. ExtendedLocation
свойства Описывает свойства изображения. ImageProperties

ExtendedLocation

Имя Описание Ценность
имя Имя расширенного расположения. струна
тип Тип расширенного расположения. EdgeZone

ImageProperties

Имя Описание Ценность
hyperVGeneration Задает тип HyperVGenerationType виртуальнойMachine, созданной на основе образа. В API версии 2019-03-01, если источник образа является большим двоичным объектом, то пользователю нужно указать значение, если источник управляется ресурсом, например диском или моментальным снимком, может потребоваться указать свойство, если мы не можем вывести его из исходного управляемого ресурса. "V1"
"V2"
sourceVirtualMachine Исходная виртуальная машина, из которой создается образ. SubResource
storageProfile Задает параметры хранилища для дисков виртуальной машины. ImageStorageProfile

SubResource

Имя Описание Ценность
идентификатор Идентификатор ресурса струна

ImageStorageProfile

Имя Описание Ценность
dataDisks Указывает параметры, используемые для добавления диска данных на виртуальную машину.

Дополнительные сведения о дисках см. в статье Сведения о дисках и виртуальных жестких дисках для виртуальных машин Azure.		 ImageDataDisk[]
osDisk Указывает сведения о диске операционной системы, используемом виртуальной машиной.

Дополнительные сведения о дисках см. в статье Сведения о дисках и виртуальных жестких дисках для виртуальных машин Azure.		 ImageOSDisk
zoneResilient Указывает, является ли изображение устойчивым к зонам. Значение по умолчанию — false. Устойчивые к зонам образы можно создавать только в регионах, которые предоставляют хранилище, избыточное между зонами (ZRS). bool

ImageDataDisk

Имя Описание Ценность
BLOBURI Виртуальный жесткий диск. струна
Кэширование Указывает требования к кэшированию. Возможные значения: None,ReadOnly,ReadWrite. Значения по умолчанию: Нет для хранилища уровня "Стандартный". ReadOnly для хранилища Premium. "Нет"
"ReadOnly"
ReadWrite
diskEncryptionSet Указывает идентификатор ресурса набора шифрования управляемых пользователем дисков для управляемого диска образа. DiskEncryptionSetParameters
diskSizeGB Задает размер пустых дисков данных в гигабайтах. Этот элемент можно использовать для перезаписи имени диска в образе виртуальной машины. Это значение не может превышать 1023 ГБ. int
lun Указывает логическую единицу диска данных. Это значение используется для идентификации дисков данных на виртуальной машине и поэтому должно быть уникальным для каждого диска данных, подключенного к виртуальной машине. int (обязательно)
managedDisk УправляемыйDisk. SubResource
снимок Моментальный снимок. SubResource
storageAccountType Указывает тип учетной записи хранения для управляемого диска. ПРИМЕЧАНИЕ. UltraSSD_LRS можно использовать только с дисками данных, его нельзя использовать с диском ОС. "PremiumV2_LRS"
"Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"
"UltraSSD_LRS"

DiskEncryptionSetParameters

Имя Описание Ценность
идентификатор Идентификатор ресурса струна

ImageOSDisk

Имя Описание Ценность
BLOBURI Виртуальный жесткий диск. струна
Кэширование Указывает требования к кэшированию. Возможные значения: None,ReadOnly,ReadWrite. Значения по умолчанию: Нет для хранилища уровня "Стандартный". ReadOnly для хранилища Premium. "Нет"
"ReadOnly"
ReadWrite
diskEncryptionSet Указывает идентификатор ресурса набора шифрования управляемых пользователем дисков для управляемого диска образа. DiskEncryptionSetParameters
diskSizeGB Задает размер пустых дисков данных в гигабайтах. Этот элемент можно использовать для перезаписи имени диска в образе виртуальной машины. Это значение не может превышать 1023 ГБ. int
managedDisk УправляемыйDisk. SubResource
osState Состояние ОС. Для управляемых образов используйте generalized. "Обобщенный"
"Специализированный" (обязательный)
osType Это свойство позволяет указать тип ОПЕРАЦИОННОй системы, включенной в диск, при создании виртуальной машины из пользовательского образа. Возможные значения: Windows,Linux. Linux
"Windows" (обязательно)
снимок Моментальный снимок. SubResource
storageAccountType Указывает тип учетной записи хранения для управляемого диска. ПРИМЕЧАНИЕ. UltraSSD_LRS можно использовать только с дисками данных, его нельзя использовать с диском ОС. "PremiumV2_LRS"
"Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"
"UltraSSD_LRS"