Диски Microsoft.Compute

  • Статья

Определение ресурса Bicep

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

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

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

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

resource symbolicname 'Microsoft.Compute/disks@2023-10-02' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    name: 'string'
  }
  extendedLocation: {
    name: 'string'
    type: 'EdgeZone'
  }
  properties: {
    burstingEnabled: bool
    completionPercent: int
    creationData: {
      createOption: 'string'
      elasticSanResourceId: 'string'
      galleryImageReference: {
        communityGalleryImageId: 'string'
        id: 'string'
        lun: int
        sharedGalleryImageId: 'string'
      }
      imageReference: {
        communityGalleryImageId: 'string'
        id: 'string'
        lun: int
        sharedGalleryImageId: 'string'
      }
      logicalSectorSize: int
      performancePlus: bool
      provisionedBandwidthCopySpeed: 'string'
      securityDataUri: 'string'
      sourceResourceId: 'string'
      sourceUri: 'string'
      storageAccountId: 'string'
      uploadSizeBytes: int
    }
    dataAccessAuthMode: 'string'
    diskAccessId: 'string'
    diskIOPSReadWrite: int
    diskMBpsReadWrite: int
    diskSizeGB: int
    encryption: {
      diskEncryptionSetId: 'string'
      type: 'string'
    }
    encryptionSettingsCollection: {
      enabled: bool
      encryptionSettings: [
        {
          diskEncryptionKey: {
            secretUrl: 'string'
            sourceVault: {
              id: 'string'
            }
          }
          keyEncryptionKey: {
            keyUrl: 'string'
            sourceVault: {
              id: 'string'
            }
          }
        }
      ]
      encryptionSettingsVersion: 'string'
    }
    hyperVGeneration: 'string'
    maxShares: int
    networkAccessPolicy: 'string'
    optimizedForFrequentAttach: bool
    osType: 'string'
    publicNetworkAccess: 'string'
    purchasePlan: {
      name: 'string'
      product: 'string'
      promotionCode: 'string'
      publisher: 'string'
    }
    securityProfile: {
      secureVMDiskEncryptionSetId: 'string'
      securityType: 'string'
    }
    supportedCapabilities: {
      acceleratedNetwork: bool
      architecture: 'string'
      diskControllerTypes: 'string'
    }
    supportsHibernation: bool
    tier: 'string'
  }
  zones: [
    'string'
  ]
}

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

disks

Имя Описание Значение
name имя ресурса. string (обязательно)

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

Допустимые символы:
Буквенно-цифровые символы, символы подчеркивания и дефисы.
location Расположение ресурса string (обязательно)
tags Теги ресурсов Словарь имен и значений тегов. См . раздел Теги в шаблонах
sku Имя SKU дисков. Может быть Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS или PremiumV2_LRS. DiskSku
extendedLocation Расширенное расположение, в котором будет создан диск. Невозможно изменить расширенное расположение. ExtendedLocation
properties Свойства ресурсов диска. Свойства diskProperties
зоны; Список логических зон для диска. string[]

ExtendedLocation

Имя Описание Значение
name Имя расширенного расположения. строка
type Тип расширенного расположения. 'EdgeZone'

Свойства diskProperties

Имя Описание Значение
burstingEnabled Присвойте значение true, чтобы обеспечить ускорение за пределами подготовленного целевого показателя производительности диска. Ускорение отключено по умолчанию. Не применяется к дискам категории "Ультра". bool
completionPercent Процент завершения фоновой копии при создании ресурса с помощью операции CopyStart. INT
creationData Сведения об источнике диска. Данные о создании данных нельзя изменить после создания диска. CreationData (обязательно)
dataAccessAuthMode Дополнительные требования к проверке подлинности при экспорте или отправке на диск или snapshot. AzureActiveDirectory
"Нет"
diskAccessId Идентификатор ARM ресурса DiskAccess для использования частных конечных точек на дисках. строка
diskIOPSReadWrite Количество операций ввода-вывода в секунду, разрешенных для этого диска; настраивается только для дисков UltraSSD. Одна операция может передавать от 4 до 256 байт. INT
diskMBpsReadWrite Пропускная способность, разрешенная для этого диска; настраивается только для дисков UltraSSD. Мбит/с означает миллионы байтов в секунду. Здесь МБ использует нотацию ISO с полномочиями 10. INT
diskSizeGB Если параметр creationData.createOption имеет значение Empty, это поле является обязательным и указывает размер создаваемого диска. Если это поле присутствует для обновлений или создания с другими параметрами, оно указывает на изменение размера. Изменение размера допускается, только если диск не подключен к работающей виртуальной машине и может только увеличить размер диска. INT
шифрование Свойство шифрования можно использовать для шифрования неактивных данных с помощью ключей, управляемых клиентом, или ключей, управляемых платформой. Шифрование
encryptionSettingsCollection Коллекция параметров шифрования, используемая для шифрования дисков Azure, может содержать несколько параметров шифрования для каждого диска или snapshot. EncryptionSettingsCollection
HyperVGeneration Создание гипервизора виртуальной машины. Применимо только к дискам ОС. "V1"
"V2"
maxShares Максимальное количество виртуальных машин, которые могут одновременно подключаться к диску. Значение больше единицы указывает на диск, который можно подключить к нескольким виртуальным машинам одновременно. INT
networkAccessPolicy Политика доступа к диску по сети. AllowAll
AllowPrivate
DenyAll
optimizedForFrequentAttach Установка для этого свойства значения true повышает надежность и производительность дисков данных, которые часто (более 5 раз в день) отсоединяются от одной виртуальной машины и подключаются к другой. Это свойство не следует задавать для дисков, которые не отсоединяются и не подключаются часто, так как это приводит к тому, что диски не соответствуют домену сбоя виртуальной машины. bool
osType Тип операционной системы. Linux
"Windows"
publicNetworkAccess Политика для управления экспортом на диске. "Отключено"
"Включено"
purchasePlan Сведения о плане приобретения для образа, из которого был создан диск ОС. Например: {name: 2019-Datacenter, publisher: MicrosoftWindowsServer, product: WindowsServer} PurchasePlan
securityProfile Содержит сведения, связанные с безопасностью ресурса. DiskSecurityProfile
supportedCapabilities Список поддерживаемых возможностей для образа, из которого был создан диск ОС. SupportedCapabilities
supportsHibernation Указывает, что ОС на диске поддерживает гибернацию. bool
Уровень Уровень производительности диска (например, P4, S10), как описано здесь: https://azure.microsoft.com/pricing/details/managed-disks/. Не применяется к дискам категории "Ультра". строка

CreationData

Имя Описание Значение
createOption При этом перечисляются возможные источники создания диска. 'Attach'
"Копировать"
CopyFromSanSnapshot
CopyStart
"Пустой"
FromImage
"Импорт"
ImportSecure
Восстановление
"Отправить"
UploadPreparedSecure (обязательно)
elasticSanResourceId Требуется, если параметр createOption имеет значение CopyFromSanSnapshot. Это идентификатор ARM исходного эластичного тома san snapshot. строка
galleryImageReference Требуется при создании из образа коллекции. Id/sharedGalleryImageId/communityGalleryImageId объекта ImageDiskReference будет идентификатором ARM версии общего образа, на основе которой создается диск. ImageDiskReference
imageReference Сведения об источнике диска для ПИР или образов пользователей. ImageDiskReference
LogicalSectorSize Размер логического сектора в байтах для дисков категории "Ультра". Поддерживаемые значения: 512 - 4096. Значение по умолчанию — 4096. INT
performancePlus Установите для этого флага значение true, чтобы повысить целевой показатель производительности развернутого диска, см. здесь о соответствующем целевом объекте производительности. Этот флаг можно установить только во время создания диска и не может быть отключен после включения. bool
provisionedBandwidthCopySpeed Если это поле задано в snapshot и параметр createOption имеет значение CopyStart, snapshot будет копироваться быстрее. "Расширенный"
"Нет"
securityDataUri Если параметр createOption имеет значение ImportSecure, это универсальный код ресурса (URI) большого двоичного объекта, импортируемого в гостевое состояние виртуальной машины. строка
sourceResourceId Если параметр createOption имеет значение Copy, это идентификатор ARM исходного snapshot или диска. строка
sourceUri Если параметр createOption имеет значение Import, это универсальный код ресурса (URI) большого двоичного объекта, импортируемого на управляемый диск. строка
storageAccountId Требуется, если параметр createOption имеет значение Import. Azure Resource Manager идентификатор учетной записи хранения, содержащей большой двоичный объект для импорта в качестве диска. строка
uploadSizeBytes Если для параметра createOption задано значение Upload, это размер содержимого отправки, включая нижний колонтитул виртуального жесткого диска. Это значение должно быть от 20972032 (20 МиБ + 512 байт для нижнего колонтитула VHD) и 35183298347520 байтов (32 ТиБ + 512 байт для нижнего колонтитула VHD). INT

ImageDiskReference

Имя Описание Значение
communityGalleryImageId Относительный URI, содержащий ссылку на образ из коллекции вычислений Azure сообщества. строка
идентификатор Относительный URI, содержащий репозиторий образов платформы, образ пользователя или ссылку на образ из коллекции вычислений Azure. строка
lun Если диск создается из диска данных образа, это индекс, который указывает, какой из дисков данных в образе использовать. Для дисков ОС это поле имеет значение NULL. INT
sharedGalleryImageId Относительный URI, содержащий прямую ссылку на образ из коллекции вычислений Azure. строка

Шифрование

Имя Описание Значение
diskEncryptionSetId ResourceId набора шифрования диска, используемого для включения шифрования неактивных данных. строка
type Тип ключа, используемого для шифрования данных диска. EncryptionAtRestWithCustomerKey
EncryptionAtRestWithPlatformAndCustomerKeys
EncryptionAtRestWithPlatformKey

EncryptionSettingsCollection

Имя Описание Значение
Включено Установите для этого флага значение true и укажите DiskEncryptionKey и (необязательно) KeyEncryptionKey, чтобы включить шифрование. Установите для этого флага значение false и удалите DiskEncryptionKey и KeyEncryptionKey, чтобы отключить шифрование. Если encryptionSettings имеет значение NULL в объекте запроса, существующие параметры остаются неизменными. bool (обязательно)
encryptionSettings Коллекция параметров шифрования, по одному для каждого тома диска. EncryptionSettingsElement[]
encryptionSettingsVersion Описывает, какой тип шифрования используется для дисков. После установки этого поля его нельзя будет перезаписать. "1.0" соответствует шифрованию дисков Azure с помощью приложения AAD. "1.1" соответствует шифрованию дисков Azure. строка

EncryptionSettingsElement

Имя Описание Значение
diskEncryptionKey Key Vault URL-адрес секрета и идентификатор хранилища ключа шифрования диска KeyVaultAndSecretReference
keyEncryptionKey Key Vault URL-адрес ключа и идентификатор хранилища ключа шифрования ключа. Ключ KeyEncryptionKey является необязательным. При его указании используется для распаковки ключа шифрования диска. KeyVaultAndKeyReference

KeyVaultAndSecretReference

Имя Описание Значение
secretUrl URL-адрес, указывающий на ключ или секрет в KeyVault строка (обязательно)
sourceVault Идентификатор ресурса хранилища ключей, содержащего ключ или секрет SourceVault (обязательно)

SourceVault

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

KeyVaultAndKeyReference

Имя Описание Значение
keyUrl URL-адрес, указывающий на ключ или секрет в KeyVault строка (обязательно)
sourceVault Идентификатор ресурса хранилища ключей, содержащего ключ или секрет SourceVault (обязательно)

PurchasePlan

Имя Описание Значение
name Идентификатор плана. строка (обязательно)
product Указывает продукт изображения из Marketplace. Это то же значение, что и Предложение в элементе imageReference. строка (обязательно)
promotionCode Код рекламного предложения. строка
publisher Идентификатор издателя. строка (обязательно)

DiskSecurityProfile

Имя Описание Значение
secureVMDiskEncryptionSetId ResourceId набора шифрования дисков, связанного с диском, поддерживаемым конфиденциальной виртуальной машиной, зашифрованным с помощью ключа, управляемого клиентом. строка
securityType Указывает Тип безопасности виртуальной машины. Применимо только к дискам ОС. "ConfidentialVM_DiskEncryptedWithCustomerKey"
"ConfidentialVM_DiskEncryptedWithPlatformKey"
"ConfidentialVM_NonPersistedTPM"
"ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey"
TrustedLaunch

SupportedCapabilities

Имя Описание Значение
acceleratedNetwork Значение true, если образ, из которого создается диск ОС, поддерживает ускорение сети. bool
архитектура Архитектура ЦП, поддерживаемая диском ОС. "Arm64"
'x64'
diskControllerTypes Контроллеры дисков, поддерживаемые диском ОС. Если задано, это может быть SCSI или SCSI, NVME или NVME, SCSI. строка

DiskSku

Имя Описание Значение
name Имя SKU. 'PremiumV2_LRS'
"Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"
"UltraSSD_LRS"

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

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

Шаблон Описание
Развертывание кластера Percona XtraDB с 3 узлами в Зоны доступности

Развертывание в Azure		 Этот шаблон развертывает кластер высокого уровня доступности MySQL с 3 узлами в CentOS 6.5 или Ubuntu 12.04.
Узел Windows Docker с предустановленным Портейнером и Traefik

Развертывание в Azure		 Узел Windows Docker с предустановленным Портейнером и Traefik
Создает управляемый диск ценовой категории "Ультра" с определенным размером сектора

Развертывание в Azure		 Этот шаблон создает новый управляемый диск ценовой категории "Ультра", позволяющий пользователю указать размер сектора 512 или 4096.
Создание виртуальной машины из VHD EfficientIP

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

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

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

Развертывание в Azure		 Разверните одну виртуальную машину Windows с включенной функцией Open SSH, чтобы подключиться через SSH с помощью проверки подлинности на основе ключей.
Создание диска & включения защиты с помощью Backup Vault

Развертывание в Azure		 Шаблон, создающий диск и обеспечивающий защиту с помощью Хранилища резервных копий
Параметры хранилища, оптимизированного для производительности виртуальной машины SQL, в UltraSSD

Развертывание в Azure		 Создание виртуальной машины SQL Server с оптимизированными для производительности параметрами хранилища с помощью UltraSSD для файлов журнала SQL

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

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

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

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

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

{
  "type": "Microsoft.Compute/disks",
  "apiVersion": "2023-10-02",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "name": "string"
  },
  "extendedLocation": {
    "name": "string",
    "type": "EdgeZone"
  },
  "properties": {
    "burstingEnabled": "bool",
    "completionPercent": "int",
    "creationData": {
      "createOption": "string",
      "elasticSanResourceId": "string",
      "galleryImageReference": {
        "communityGalleryImageId": "string",
        "id": "string",
        "lun": "int",
        "sharedGalleryImageId": "string"
      },
      "imageReference": {
        "communityGalleryImageId": "string",
        "id": "string",
        "lun": "int",
        "sharedGalleryImageId": "string"
      },
      "logicalSectorSize": "int",
      "performancePlus": "bool",
      "provisionedBandwidthCopySpeed": "string",
      "securityDataUri": "string",
      "sourceResourceId": "string",
      "sourceUri": "string",
      "storageAccountId": "string",
      "uploadSizeBytes": "int"
    },
    "dataAccessAuthMode": "string",
    "diskAccessId": "string",
    "diskIOPSReadWrite": "int",
    "diskMBpsReadWrite": "int",
    "diskSizeGB": "int",
    "encryption": {
      "diskEncryptionSetId": "string",
      "type": "string"
    },
    "encryptionSettingsCollection": {
      "enabled": "bool",
      "encryptionSettings": [
        {
          "diskEncryptionKey": {
            "secretUrl": "string",
            "sourceVault": {
              "id": "string"
            }
          },
          "keyEncryptionKey": {
            "keyUrl": "string",
            "sourceVault": {
              "id": "string"
            }
          }
        }
      ],
      "encryptionSettingsVersion": "string"
    },
    "hyperVGeneration": "string",
    "maxShares": "int",
    "networkAccessPolicy": "string",
    "optimizedForFrequentAttach": "bool",
    "osType": "string",
    "publicNetworkAccess": "string",
    "purchasePlan": {
      "name": "string",
      "product": "string",
      "promotionCode": "string",
      "publisher": "string"
    },
    "securityProfile": {
      "secureVMDiskEncryptionSetId": "string",
      "securityType": "string"
    },
    "supportedCapabilities": {
      "acceleratedNetwork": "bool",
      "architecture": "string",
      "diskControllerTypes": "string"
    },
    "supportsHibernation": "bool",
    "tier": "string"
  },
  "zones": [ "string" ]
}

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

disks

Имя Описание Значение
тип Тип ресурса Microsoft.Compute/disks
версия_API Версия API ресурсов '2023-10-02'
name имя ресурса. строка (обязательно)

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

Допустимые символы:
Буквенно-цифровые символы, символы подчеркивания и дефисы.
location Расположение ресурса string (обязательно)
tags Теги ресурсов Словарь имен и значений тегов. См . раздел Теги в шаблонах
sku Имя SKU дисков. Может быть Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS или PremiumV2_LRS. DiskSku
extendedLocation Расширенное расположение, в котором будет создан диск. Невозможно изменить расширенное расположение. ExtendedLocation
properties Свойства ресурсов диска. Свойства diskProperties
зоны; Список логических зон для диска. string[]

ExtendedLocation

Имя Описание Значение
name Имя расширенного расположения. строка
type Тип расширенного расположения. 'EdgeZone'

Свойства diskProperties

Имя Описание Значение
burstingEnabled Присвойте значение true, чтобы обеспечить ускорение за пределами подготовленного целевого показателя производительности диска. Ускорение отключено по умолчанию. Не применяется к дискам категории "Ультра". bool
completionPercent Процент завершения фоновой копии при создании ресурса с помощью операции CopyStart. INT
creationData Сведения об источнике диска. Данные о создании данных нельзя изменить после создания диска. CreationData (обязательно)
dataAccessAuthMode Дополнительные требования к проверке подлинности при экспорте или отправке на диск или snapshot. AzureActiveDirectory
"Нет"
diskAccessId Идентификатор ARM ресурса DiskAccess для использования частных конечных точек на дисках. строка
diskIOPSReadWrite Количество операций ввода-вывода в секунду, разрешенных для этого диска; настраивается только для дисков UltraSSD. Одна операция может передавать от 4 до 256 байт. INT
diskMBpsReadWrite Пропускная способность, разрешенная для этого диска; настраивается только для дисков UltraSSD. Мбит/с означает миллионы байтов в секунду. Здесь МБ использует нотацию ISO с полномочиями 10. INT
diskSizeGB Если параметр creationData.createOption имеет значение Empty, это поле является обязательным и указывает размер создаваемого диска. Если это поле присутствует для обновлений или создания с другими параметрами, оно указывает на изменение размера. Изменение размера допускается, только если диск не подключен к работающей виртуальной машине и может только увеличить размер диска. INT
шифрование Свойство шифрования можно использовать для шифрования неактивных данных с помощью ключей, управляемых клиентом, или ключей, управляемых платформой. Шифрование
encryptionSettingsCollection Коллекция параметров шифрования, используемая для шифрования дисков Azure, может содержать несколько параметров шифрования для каждого диска или snapshot. EncryptionSettingsCollection
hyperVGeneration Создание низкоуровневой оболочки виртуальной машины. Применимо только к дискам ОС. "V1"
"V2"
maxShares Максимальное количество виртуальных машин, которые могут одновременно подключаться к диску. Значение больше единицы указывает на диск, который можно подключить на нескольких виртуальных машинах одновременно. INT
networkAccessPolicy Политика доступа к диску по сети. 'AllowAll'
AllowPrivate
DenyAll
optimizedForFrequentAttach Установка этого свойства значения true повышает надежность и производительность дисков данных, которые часто (более 5 раз в день) отсоединяются от одной виртуальной машины и подключаются к другой. Это свойство не следует задавать для дисков, которые не отсоединяются и не подключаются часто, так как это приводит к тому, что диски не соответствуют домену сбоя виртуальной машины. bool
osType Тип операционной системы. Linux
"Windows"
publicNetworkAccess Политика управления экспортом на диске. "Отключено"
"Включено"
purchasePlan Сведения о плане приобретения для образа, из которого был создан диск ОС. Например: {name: 2019-Datacenter, publisher: MicrosoftWindowsServer, product: WindowsServer} PurchasePlan
securityProfile Содержит сведения, связанные с безопасностью для ресурса. DiskSecurityProfile
supportedCapabilities Список поддерживаемых возможностей для образа, из которого был создан диск ОС. SupportedCapabilities
supportsHibernation Указывает, что ОС на диске поддерживает режим гибернации. bool
Уровень Уровень производительности диска (например, P4, S10), как описано здесь: https://azure.microsoft.com/pricing/details/managed-disks/. Не применяется к дискам категории "Ультра". строка

CreationData

Имя Описание Значение
createOption Перечисляются возможные источники создания диска. 'Attach'
"Копировать"
'CopyFromSanSnapshot'
CopyStart
"Пустой"
FromImage
"Импорт"
ImportSecure
"Восстановить"
"Отправить"
UploadPreparedSecure (обязательно)
elasticSanResourceId Требуется, если параметр createOption имеет значение CopyFromSanSnapshot. Это идентификатор ARM исходного эластичного тома san snapshot. строка
galleryImageReference Требуется при создании из образа коллекции. Id/sharedGalleryImageId/communityGalleryImageId объекта ImageDiskReference будет идентификатором ARM версии общей коллекции, из которой создается диск. ImageDiskReference
imageReference Сведения об источнике диска для ПИР или пользовательских образов. ImageDiskReference
LogicalSectorSize Размер логического сектора в байтах для дисков категории "Ультра". Поддерживаемые значения: 512 - 4096. Значение по умолчанию — 4096. INT
performancePlus Установите для этого флага значение true, чтобы повысить целевой показатель производительности развернутого диска, см. здесь о соответствующем целевом объекте производительности. Этот флаг можно установить только во время создания диска и не может быть отключен после включения. bool
provisionedBandwidthCopySpeed Если это поле задано на snapshot и параметр createOption имеет значение CopyStart, snapshot будет копироваться быстрее. "Расширенный"
"Нет"
securityDataUri Если параметр createOption имеет значение ImportSecure, это универсальный код ресурса (URI) большого двоичного объекта, импортируемого в гостевое состояние виртуальной машины. строка
sourceResourceId Если параметр createOption имеет значение Copy, это идентификатор ARM исходного snapshot или диска. строка
sourceUri Если параметр createOption имеет значение Import, это универсальный код ресурса (URI) большого двоичного объекта, импортируемого на управляемый диск. строка
storageAccountId Требуется, если параметр createOption имеет значение Import. Azure Resource Manager идентификатор учетной записи хранения, содержащей большой двоичный объект для импорта в качестве диска. строка
uploadSizeBytes Если параметр createOption имеет значение Отправить, это размер содержимого отправки, включая нижний колонтитул VHD. Это значение должно быть от 20972032 (20 МиБ + 512 байт для нижнего колонтитула VHD) и 35183298347520 байт (32 ТиБ + 512 байт для нижнего колонтитула VHD). INT

ImageDiskReference

Имя Описание Значение
communityGalleryImageId Относительный универсальный код ресурса (URI), содержащий ссылку на образ из коллекции вычислений Azure сообщества. строка
идентификатор Относительный URI, содержащий репозиторий образов платформы, образ пользователя или образ коллекции вычислений Azure. строка
lun Если диск создается из диска данных образа, это индекс, который указывает, какой из дисков данных в образе использовать. Для дисков ОС это поле имеет значение NULL. INT
sharedGalleryImageId Относительный URI, содержащий прямую ссылку на образ из коллекции вычислений Azure. строка

Шифрование

Имя Описание Значение
diskEncryptionSetId ResourceId набора шифрования диска, используемого для включения шифрования неактивных данных. строка
type Тип ключа, используемого для шифрования данных диска. EncryptionAtRestWithCustomerKey
EncryptionAtRestWithPlatformAndCustomerKeys
EncryptionAtRestWithPlatformKey

EncryptionSettingsCollection

Имя Описание Значение
Включено Установите для этого флага значение true и укажите DiskEncryptionKey и (необязательно) KeyEncryptionKey, чтобы включить шифрование. Установите для этого флага значение false и удалите DiskEncryptionKey и KeyEncryptionKey, чтобы отключить шифрование. Если encryptionSettings имеет значение NULL в объекте запроса, существующие параметры остаются неизменными. bool (обязательно)
encryptionSettings Коллекция параметров шифрования, по одному для каждого тома диска. EncryptionSettingsElement[]
encryptionSettingsVersion Описывает, какой тип шифрования используется для дисков. После установки этого поля его нельзя будет перезаписать. "1.0" соответствует шифрованию дисков Azure с помощью приложения AAD. "1.1" соответствует шифрованию дисков Azure. строка

EncryptionSettingsElement

Имя Описание Значение
diskEncryptionKey Key Vault URL-адрес секрета и идентификатор хранилища ключа шифрования диска KeyVaultAndSecretReference
keyEncryptionKey Key Vault URL-адрес ключа и идентификатор хранилища ключа шифрования ключа. Ключ KeyEncryptionKey является необязательным. При его указании используется для распаковки ключа шифрования диска. KeyVaultAndKeyReference

KeyVaultAndSecretReference

Имя Описание Значение
secretUrl URL-адрес, указывающий на ключ или секрет в KeyVault строка (обязательно)
sourceVault Идентификатор ресурса хранилища ключей, содержащего ключ или секрет SourceVault (обязательно)

SourceVault

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

KeyVaultAndKeyReference

Имя Описание Значение
keyUrl URL-адрес, указывающий на ключ или секрет в KeyVault строка (обязательно)
sourceVault Идентификатор ресурса хранилища ключей, содержащего ключ или секрет SourceVault (обязательно)

PurchasePlan

Имя Описание Значение
name Идентификатор плана. строка (обязательно)
product Указывает продукт изображения из Marketplace. Это то же значение, что и Предложение в элементе imageReference. строка (обязательно)
promotionCode Код рекламного предложения. строка
publisher Идентификатор издателя. строка (обязательно)

DiskSecurityProfile

Имя Описание Значение
secureVMDiskEncryptionSetId ResourceId набора шифрования дисков, связанного с диском, поддерживаемым конфиденциальной виртуальной машиной, зашифрованным с помощью ключа, управляемого клиентом. строка
securityType Указывает Тип безопасности виртуальной машины. Применимо только к дискам ОС. "ConfidentialVM_DiskEncryptedWithCustomerKey"
"ConfidentialVM_DiskEncryptedWithPlatformKey"
"ConfidentialVM_NonPersistedTPM"
"ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey"
TrustedLaunch

SupportedCapabilities

Имя Описание Значение
acceleratedNetwork Значение true, если образ, из которого создается диск ОС, поддерживает ускорение сети. bool
архитектура Архитектура ЦП, поддерживаемая диском ОС. "Arm64"
'x64'
diskControllerTypes Контроллеры дисков, поддерживаемые диском ОС. Если задано, это может быть SCSI или SCSI, NVME или NVME, SCSI. строка

DiskSku

Имя Описание Значение
name Имя SKU. 'PremiumV2_LRS'
"Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"
"UltraSSD_LRS"

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

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

Шаблон Описание
Развертывание кластера Percona XtraDB с 3 узлами в Зоны доступности

Развертывание в Azure		 Этот шаблон развертывает кластер высокого уровня доступности MySQL с 3 узлами в CentOS 6.5 или Ubuntu 12.04.
Узел Windows Docker с предустановленным Портейнером и Traefik

Развертывание в Azure		 Узел Windows Docker с предустановленным Портейнером и Traefik
Создает управляемый диск ценовой категории "Ультра" с определенным размером сектора

Развертывание в Azure		 Этот шаблон создает новый управляемый диск ценовой категории "Ультра", позволяющий пользователю указать размер сектора 512 или 4096.
Создание виртуальной машины из VHD EfficientIP

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

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

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

Развертывание в Azure		 Разверните одну виртуальную машину Windows с включенной функцией Open SSH, чтобы подключиться через SSH с помощью проверки подлинности на основе ключей.
Создание диска & включения защиты с помощью Backup Vault

Развертывание в Azure		 Шаблон, создающий диск и обеспечивающий защиту с помощью Хранилища резервных копий
Параметры хранилища, оптимизированного для производительности виртуальной машины SQL, в UltraSSD

Развертывание в Azure		 Создание виртуальной машины SQL Server с оптимизированными для производительности параметрами хранилища с помощью UltraSSD для файлов журнала SQL

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

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

  • Группы ресурсов

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

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

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/disks@2023-10-02"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      burstingEnabled = bool
      completionPercent = int
      creationData = {
        createOption = "string"
        elasticSanResourceId = "string"
        galleryImageReference = {
          communityGalleryImageId = "string"
          id = "string"
          lun = int
          sharedGalleryImageId = "string"
        }
        imageReference = {
          communityGalleryImageId = "string"
          id = "string"
          lun = int
          sharedGalleryImageId = "string"
        }
        logicalSectorSize = int
        performancePlus = bool
        provisionedBandwidthCopySpeed = "string"
        securityDataUri = "string"
        sourceResourceId = "string"
        sourceUri = "string"
        storageAccountId = "string"
        uploadSizeBytes = int
      }
      dataAccessAuthMode = "string"
      diskAccessId = "string"
      diskIOPSReadWrite = int
      diskMBpsReadWrite = int
      diskSizeGB = int
      encryption = {
        diskEncryptionSetId = "string"
        type = "string"
      }
      encryptionSettingsCollection = {
        enabled = bool
        encryptionSettings = [
          {
            diskEncryptionKey = {
              secretUrl = "string"
              sourceVault = {
                id = "string"
              }
            }
            keyEncryptionKey = {
              keyUrl = "string"
              sourceVault = {
                id = "string"
              }
            }
          }
        ]
        encryptionSettingsVersion = "string"
      }
      hyperVGeneration = "string"
      maxShares = int
      networkAccessPolicy = "string"
      optimizedForFrequentAttach = bool
      osType = "string"
      publicNetworkAccess = "string"
      purchasePlan = {
        name = "string"
        product = "string"
        promotionCode = "string"
        publisher = "string"
      }
      securityProfile = {
        secureVMDiskEncryptionSetId = "string"
        securityType = "string"
      }
      supportedCapabilities = {
        acceleratedNetwork = bool
        architecture = "string"
        diskControllerTypes = "string"
      }
      supportsHibernation = bool
      tier = "string"
    }
    zones = [
      "string"
    ]
    sku = {
      name = "string"
    }
    extendedLocation = {
      name = "string"
      type = "EdgeZone"
    }
  })
}

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

disks

Имя Описание Значение
тип Тип ресурса "Microsoft.Compute/disks@2023-10-02"
name имя ресурса. строка (обязательно)

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

Допустимые символы:
Буквенно-цифровые символы, символы подчеркивания и дефисы.
location Расположение ресурса строка (обязательно)
parent_id Чтобы выполнить развертывание в группе ресурсов, используйте идентификатор этой группы ресурсов. строка (обязательно)
tags Теги ресурсов Словарь имен и значений тегов.
sku Имя номера SKU дисков. Может быть Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS или PremiumV2_LRS. DiskSku
extendedLocation Расширенное расположение, в котором будет создан диск. Невозможно изменить расширенное расположение. ExtendedLocation
properties Свойства ресурсов диска. Свойства diskProperties
зоны; Список логических зон для диска. string[]

ExtendedLocation

Имя Описание Значение
name Имя расширенного расположения. строка
type Тип расширенного расположения. "EdgeZone"

Свойства diskProperties

Имя Описание Значение
burstingEnabled Задайте значение true, чтобы обеспечить ускорение за пределами подготовленного целевого показателя производительности диска. Ускорение отключено по умолчанию. Не применяется к дискам категории "Ультра". bool
completionPercent Процент завершения фоновой копии при создании ресурса с помощью операции CopyStart. INT
creationData Сведения об источнике диска. Данные creationData нельзя изменить после создания диска. CreationData (обязательно)
dataAccessAuthMode Дополнительные требования к проверке подлинности при экспорте или отправке на диск или snapshot. AzureActiveDirectory
"None"
diskAccessId Идентификатор ARM ресурса DiskAccess для использования частных конечных точек на дисках. строка
diskIOPSReadWrite Количество операций ввода-вывода в секунду, разрешенных для этого диска; Устанавливается только для дисков UltraSSD. Одна операция может передавать от 4 ДО 256 байт. INT
diskMBpsReadWrite Пропускная способность, разрешенная для этого диска; Устанавливается только для дисков UltraSSD. Мбит/с означает миллионы байтов в секунду. Мб здесь использует нотацию ISO с 10 байтами. INT
diskSizeGB Если параметр creationData.createOption имеет значение Empty, это поле является обязательным и указывает размер создаваемого диска. Если это поле присутствует для обновления или создания с другими параметрами, оно указывает на изменение размера. Изменение размера допускается только в том случае, если диск не подключен к работающей виртуальной машине и может только увеличить размер диска. INT
шифрование Свойство шифрования можно использовать для шифрования неактивных данных с помощью ключей, управляемых клиентом, или ключей, управляемых платформой. Шифрование
encryptionSettingsCollection Коллекция параметров шифрования, используемая для шифрования дисков Azure, может содержать несколько параметров шифрования для каждого диска или snapshot. EncryptionSettingsCollection
HyperVGeneration Создание гипервизора виртуальной машины. Применимо только к дискам ОС. "V1"
"V2"
maxShares Максимальное количество виртуальных машин, которые могут одновременно подключаться к диску. Значение больше единицы указывает на диск, который можно подключить к нескольким виртуальным машинам одновременно. INT
networkAccessPolicy Политика доступа к диску по сети. "AllowAll"
"AllowPrivate"
DenyAll
optimizedForFrequentAttach Установка для этого свойства значения true повышает надежность и производительность дисков данных, которые часто (более 5 раз в день) отсоединяются от одной виртуальной машины и подключаются к другой. Это свойство не следует задавать для дисков, которые не отсоединяются и не подключаются часто, так как это приводит к тому, что диски не соответствуют домену сбоя виртуальной машины. bool
osType Тип операционной системы. "Linux"
"Windows"
publicNetworkAccess Политика для управления экспортом на диске. "Отключено"
"Включено"
purchasePlan Сведения о плане приобретения для образа, из которого был создан диск ОС. Например: {name: 2019-Datacenter, publisher: MicrosoftWindowsServer, product: WindowsServer} PurchasePlan
securityProfile Содержит сведения, связанные с безопасностью ресурса. DiskSecurityProfile
supportedCapabilities Список поддерживаемых возможностей для образа, из которого был создан диск ОС. SupportedCapabilities
supportsHibernation Указывает, что ОС на диске поддерживает гибернацию. bool
Уровень Уровень производительности диска (например, P4, S10), как описано здесь: https://azure.microsoft.com/pricing/details/managed-disks/. Не применяется к дискам категории "Ультра". строка

CreationData

Имя Описание Значение
createOption При этом перечисляются возможные источники создания диска. "Attach"
"Копировать"
CopyFromSanSnapshot
CopyStart
"Empty"
"FromImage"
"Импорт"
"ImportSecure"
"Восстановление"
"Отправить"
UploadPreparedSecure (обязательно)
elasticSanResourceId Требуется, если параметр createOption имеет значение CopyFromSanSnapshot. Это идентификатор ARM исходного эластичного тома san snapshot. строка
galleryImageReference Требуется при создании из образа коллекции. Id/sharedGalleryImageId/communityGalleryImageId объекта ImageDiskReference будет идентификатором ARM версии общего образа, на основе которой создается диск. ImageDiskReference
imageReference Сведения об источнике диска для ПИР или образов пользователей. ImageDiskReference
LogicalSectorSize Размер логического сектора в байтах для дисков категории "Ультра". Поддерживаемые значения: 512 - 4096. Значение по умолчанию — 4096. INT
performancePlus Установите для этого флага значение true, чтобы повысить целевой показатель производительности развернутого диска, см. здесь о соответствующем целевом объекте производительности. Этот флаг можно установить только во время создания диска и не может быть отключен после включения. bool
provisionedBandwidthCopySpeed Если это поле задано в snapshot и параметр createOption имеет значение CopyStart, snapshot будет копироваться быстрее. "Расширенный"
"None"
securityDataUri Если параметр createOption имеет значение ImportSecure, это универсальный код ресурса (URI) большого двоичного объекта, импортируемого в гостевое состояние виртуальной машины. строка
sourceResourceId Если параметр createOption имеет значение Copy, это идентификатор ARM исходного snapshot или диска. строка
sourceUri Если параметр createOption имеет значение Import, это универсальный код ресурса (URI) большого двоичного объекта, импортируемого на управляемый диск. строка
storageAccountId Требуется, если параметр createOption имеет значение Import. Azure Resource Manager идентификатор учетной записи хранения, содержащей большой двоичный объект для импорта в качестве диска. строка
uploadSizeBytes Если для параметра createOption задано значение Upload, это размер содержимого отправки, включая нижний колонтитул виртуального жесткого диска. Это значение должно быть от 20972032 (20 МиБ + 512 байт для нижнего колонтитула VHD) и 35183298347520 байтов (32 ТиБ + 512 байт для нижнего колонтитула VHD). INT

ImageDiskReference

Имя Описание Значение
communityGalleryImageId Относительный URI, содержащий ссылку на образ из коллекции вычислений Azure сообщества. строка
идентификатор Относительный URI, содержащий репозиторий образов платформы, образ пользователя или ссылку на образ из коллекции вычислений Azure. строка
lun Если диск создается из диска данных образа, это индекс, который указывает, какой из дисков данных в образе использовать. Для дисков ОС это поле имеет значение NULL. INT
sharedGalleryImageId Относительный URI, содержащий прямую ссылку на образ из коллекции вычислений Azure. строка

Шифрование

Имя Описание Значение
diskEncryptionSetId ResourceId набора шифрования диска, используемого для включения шифрования неактивных данных. строка
type Тип ключа, используемого для шифрования данных диска. EncryptionAtRestWithCustomerKey
EncryptionAtRestWithPlatformAndCustomerKeys
EncryptionAtRestWithPlatformKey

EncryptionSettingsCollection

Имя Описание Значение
Включено Установите для этого флага значение true и укажите DiskEncryptionKey и (необязательно) KeyEncryptionKey, чтобы включить шифрование. Установите для этого флага значение false и удалите DiskEncryptionKey и KeyEncryptionKey, чтобы отключить шифрование. Если encryptionSettings имеет значение NULL в объекте запроса, существующие параметры остаются неизменными. bool (обязательно)
encryptionSettings Коллекция параметров шифрования, по одному для каждого тома диска. EncryptionSettingsElement[]
encryptionSettingsVersion Описывает, какой тип шифрования используется для дисков. После установки этого поля его нельзя будет перезаписать. "1.0" соответствует шифрованию дисков Azure с помощью приложения AAD. "1.1" соответствует шифрованию дисков Azure. строка

EncryptionSettingsElement

Имя Описание Значение
diskEncryptionKey Key Vault URL-адрес секрета и идентификатор хранилища ключа шифрования диска KeyVaultAndSecretReference
keyEncryptionKey Key Vault URL-адрес ключа и идентификатор хранилища ключа шифрования ключа. Ключ KeyEncryptionKey является необязательным. При его указании используется для распаковки ключа шифрования диска. KeyVaultAndKeyReference

KeyVaultAndSecretReference

Имя Описание Значение
secretUrl URL-адрес, указывающий на ключ или секрет в KeyVault строка (обязательно)
sourceVault Идентификатор ресурса хранилища ключей, содержащего ключ или секрет SourceVault (обязательно)

SourceVault

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

KeyVaultAndKeyReference

Имя Описание Значение
keyUrl URL-адрес, указывающий на ключ или секрет в KeyVault строка (обязательно)
sourceVault Идентификатор ресурса хранилища ключей, содержащего ключ или секрет SourceVault (обязательно)

PurchasePlan

Имя Описание Значение
name Идентификатор плана. строка (обязательно)
product Указывает продукт изображения из Marketplace. Это то же значение, что и Предложение в элементе imageReference. строка (обязательно)
promotionCode Код рекламного предложения. строка
publisher Идентификатор издателя. строка (обязательно)

DiskSecurityProfile

Имя Описание Значение
secureVMDiskEncryptionSetId ResourceId набора шифрования дисков, связанного с диском, поддерживаемым конфиденциальной виртуальной машиной, зашифрованным с помощью ключа, управляемого клиентом. строка
securityType Указывает Тип безопасности виртуальной машины. Применимо только к дискам ОС. "ConfidentialVM_DiskEncryptedWithCustomerKey"
"ConfidentialVM_DiskEncryptedWithPlatformKey"
"ConfidentialVM_NonPersistedTPM"
"ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey"
"TrustedLaunch"

SupportedCapabilities

Имя Описание Значение
acceleratedNetwork Значение true, если образ, из которого создается диск ОС, поддерживает ускорение сети. bool
архитектура Архитектура ЦП, поддерживаемая диском ОС. "Arm64"
"x64"
diskControllerTypes Контроллеры дисков, поддерживаемые диском ОС. Если задано, это может быть SCSI или SCSI, NVME или NVME, SCSI. строка

DiskSku

Имя Описание Значение
name Имя SKU. "PremiumV2_LRS"
"Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"
"UltraSSD_LRS"