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

Диски Microsoft.Compute 2023-04-02

  • Статья

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

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

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

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

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

resource symbolicname 'Microsoft.Compute/disks@2023-04-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
      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' or int
  ]
}

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

Дисков

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

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

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

ExtendedLocation

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

DiskProperties

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

СозданиеData

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

ImageDiskReference

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

Шифрование

Имя Описание Ценность
diskEncryptionSetId ResourceId набора шифрования дисков, который используется для включения шифрования неактивных данных. струна
тип Тип ключа, используемого для шифрования данных диска. 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 Url-адрес секрета Key Vault и идентификатор хранилища ключа шифрования диска KeyVaultAndSecretReference
keyEncryptionKey Url-адрес ключа Key Vault и идентификатор хранилища ключа шифрования ключей. KeyEncryptionKey является необязательным и при использовании используется для распаковки ключа шифрования диска. KeyVaultAndKeyReference

KeyVaultAndSecretReference

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

SourceVault

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

KeyVaultAndKeyReference

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

PurchasePlan

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

DiskSecurityProfile

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

Поддерживаемые возможностиCapabilities

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

DiskSku

Имя Описание Ценность
имя Имя SKU. "PremiumV2_LRS"
"Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"
"UltraSSD_LRS"

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

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

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

развертывание в Azure		 Этот шаблон развертывает 3 узла MySQL с высоким уровнем доступности в CentOS 6.5 или Ubuntu 12.04
узле Windows Docker с предварительно установленной Portainer и Traefik

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

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

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

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

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

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

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

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

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

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

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

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

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

{
  "type": "Microsoft.Compute/disks",
  "apiVersion": "2023-04-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",
      "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" or int ]
}

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

Дисков

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

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

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

ExtendedLocation

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

DiskProperties

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

СозданиеData

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

ImageDiskReference

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

Шифрование

Имя Описание Ценность
diskEncryptionSetId ResourceId набора шифрования дисков, который используется для включения шифрования неактивных данных. струна
тип Тип ключа, используемого для шифрования данных диска. 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 Url-адрес секрета Key Vault и идентификатор хранилища ключа шифрования диска KeyVaultAndSecretReference
keyEncryptionKey Url-адрес ключа Key Vault и идентификатор хранилища ключа шифрования ключей. KeyEncryptionKey является необязательным и при использовании используется для распаковки ключа шифрования диска. KeyVaultAndKeyReference

KeyVaultAndSecretReference

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

SourceVault

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

KeyVaultAndKeyReference

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

PurchasePlan

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

DiskSecurityProfile

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

Поддерживаемые возможностиCapabilities

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

DiskSku

Имя Описание Ценность
имя Имя SKU. "PremiumV2_LRS"
"Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"
"UltraSSD_LRS"

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

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

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

развертывание в Azure		 Этот шаблон развертывает 3 узла MySQL с высоким уровнем доступности в CentOS 6.5 или Ubuntu 12.04
узле Windows Docker с предварительно установленной Portainer и Traefik

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

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

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

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

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

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

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

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

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

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

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

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

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

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/disks@2023-04-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
        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" or int
    ]
    sku = {
      name = "string"
    }
    extendedLocation = {
      name = "string"
      type = "EdgeZone"
    }
  })
}

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

Дисков

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

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

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

ExtendedLocation

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

DiskProperties

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

СозданиеData

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

ImageDiskReference

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

Шифрование

Имя Описание Ценность
diskEncryptionSetId ResourceId набора шифрования дисков, который используется для включения шифрования неактивных данных. струна
тип Тип ключа, используемого для шифрования данных диска. 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 Url-адрес секрета Key Vault и идентификатор хранилища ключа шифрования диска KeyVaultAndSecretReference
keyEncryptionKey Url-адрес ключа Key Vault и идентификатор хранилища ключа шифрования ключей. KeyEncryptionKey является необязательным и при использовании используется для распаковки ключа шифрования диска. KeyVaultAndKeyReference

KeyVaultAndSecretReference

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

SourceVault

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

KeyVaultAndKeyReference

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

PurchasePlan

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

DiskSecurityProfile

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

Поддерживаемые возможностиCapabilities

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

DiskSku

Имя Описание Ценность
имя Имя SKU. "PremiumV2_LRS"
"Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"
"UltraSSD_LRS"