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

Моментальные снимки Microsoft.Compute

  • Статья

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

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

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

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

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

resource symbolicname 'Microsoft.Compute/snapshots@2024-03-02' = {
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    completionPercent: int
    copyCompletionError: {
      errorCode: 'string'
      errorMessage: 'string'
    }
    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'
    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'
    incremental: bool
    networkAccessPolicy: 'string'
    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
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

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

CopyCompletionError

Имя Описание Ценность
ErrorCode Указывает код ошибки, если фоновая копия ресурса, созданного с помощью операции CopyStart, завершается сбоем. CopySourceNotFound (обязательно)
сообщение об ошибке Указывает сообщение об ошибке, если фоновая копия ресурса, созданного с помощью операции CopyStart, завершается сбоем. строка (обязательно)

СозданиеData

Имя Описание Ценность
createOption Это перечисляет возможные источники создания диска. "Присоединить"
"Копировать"
CopyFromSanSnapshot
"CopyStart"
"Пустой"
FromImage
"Импорт"
ImportSecure
"Восстановить"
"Отправить"
UploadPreparedSecure (обязательный)
elasticSanResourceId Требуется, если createOption — CopyFromSanSnapshot. Это идентификатор ARM исходного моментального снимка эластичного сан-тома. струна
galleryImageReference Требуется при создании из образа коллекции. Идентификатор/sharedGalleryImageId/communityGalleryImageId объекта ImageDiskReference будет идентификатором ARM общей версии образа галли, из которой создается диск. ImageDiskReference
ImageReference Сведения о источнике диска для образов ПИР или пользователей. ImageDiskReference
logicalSectorSize Размер логического сектора в байтах для дисков Категории "Ультра". Поддерживаемые значения : 512 ad 4096. 4096 — это значение по умолчанию. инт
performancePlus Задайте для этого флага значение true, чтобы повысить производительность целевого объекта развернутого диска, см. здесь по соответствующему целевому объекту производительности. Этот флаг можно задать только во время создания диска и не может быть отключен после включения. булевая переменная (bool)
provisionedBandwidthCopySpeed Если это поле установлено на моментальном снимке и createOption — CopyStart, моментальный снимок будет скопирован быстрее. "Расширенный"
"Нет"
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). инт

DiskSecurityProfile

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

Шифрование

Имя Описание Ценность
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

Расширенное местоположение

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

ImageDiskReference

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

KeyVaultAndKeyReference

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

KeyVaultAndSecretReference

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

Microsoft.Compute/snapshots

Имя Описание Ценность
extendedLocation Расширенное расположение, в котором будет создан моментальный снимок. Невозможно изменить расширенное расположение. ExtendedLocation
местоположение Расположение ресурса строка (обязательно)
имя Имя ресурса строка (обязательно)
свойства Свойства ресурса моментального снимка. SnapshotProperties
SKU Имя SKU моментальных снимков. Может быть Standard_LRS, Premium_LRS или Standard_ZRS. Это необязательный параметр для добавочного моментального снимка, а поведение по умолчанию — SKU будет иметь тот же номер SKU, что и предыдущий моментальный снимок. SnapshotSku
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах

PurchasePlan

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

ResourceTags

Имя Описание Ценность

SnapshotProperties

Имя Описание Ценность
завершениеPercent Процент завершения фоновой копии при создании ресурса с помощью операции CopyStart. инт
copyCompletionError Указывает сведения об ошибке, если фоновая копия ресурса, созданного с помощью операции CopyStart, завершается сбоем. CopyCompletionError
creationData Сведения об источнике диска. Данные creationData нельзя изменить после создания диска. CreationData (обязательно)
dataAccessAuthMode Дополнительные требования к проверке подлинности при экспорте или отправке на диск или моментальный снимок. AzureActiveDirectory
"Нет"
diskAccessId Идентификатор ARM ресурса DiskAccess для использования частных конечных точек на дисках. струна
diskSizeGB Если createData.createOption является пустым, это поле является обязательным и указывает размер создаваемого диска. Если это поле присутствует для обновлений или создания с другими параметрами, оно указывает на изменение размера. Изменение размера допускается только в том случае, если диск не подключен к работающей виртуальной машине и может увеличить размер диска. инт
шифрование Свойство шифрования можно использовать для шифрования неактивных данных с помощью управляемых клиентом ключей или управляемых платформой ключей. Шифрование
encryptionSettingsCollection Коллекция параметров шифрования, используемая для шифрования дисков Azure, может содержать несколько параметров шифрования на диск или моментальный снимок. EncryptionSettingsCollection
hyperVGeneration Создание гипервизора виртуальной машины. Применимо только к дискам ОС. "V1"
"V2"
Добавочного Является ли моментальный снимок добавочным. Добавочные моментальные снимки на том же диске занимают меньше места, чем полные моментальные снимки и могут быть различаются. булевая переменная (bool)
networkAccessPolicy Политика доступа к диску через сеть. AllowAll
AllowPrivate
"DenyAll"
Тип ОС Тип операционной системы. Linux
"Windows"
publicNetworkAccess Политика управления экспортом на диске. "Отключено"
"Включено"
purchasePlan Сведения о плане покупки для образа, из которого был создан исходный диск для моментального снимка. PurchasePlan
securityProfile Содержит сведения, связанные с безопасностью для ресурса. DiskSecurityProfile
supportedCapabilities Список поддерживаемых возможностей для образа, из которого исходный диск был создан из моментального снимка. Поддерживаемые возможностиCapabilities
поддержка поддержкиHibernation Указывает, что ОС на моментальном снимке поддерживает гибернацию. булевая переменная (bool)

SnapshotSku

Имя Описание Ценность
имя Имя SKU. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"

SourceVault

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

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

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

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

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

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

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

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

{
  "type": "Microsoft.Compute/snapshots",
  "apiVersion": "2024-03-02",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "location": "string",
  "properties": {
    "completionPercent": "int",
    "copyCompletionError": {
      "errorCode": "string",
      "errorMessage": "string"
    },
    "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",
    "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",
    "incremental": "bool",
    "networkAccessPolicy": "string",
    "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"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

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

CopyCompletionError

Имя Описание Ценность
ErrorCode Указывает код ошибки, если фоновая копия ресурса, созданного с помощью операции CopyStart, завершается сбоем. CopySourceNotFound (обязательно)
сообщение об ошибке Указывает сообщение об ошибке, если фоновая копия ресурса, созданного с помощью операции CopyStart, завершается сбоем. строка (обязательно)

СозданиеData

Имя Описание Ценность
createOption Это перечисляет возможные источники создания диска. "Присоединить"
"Копировать"
CopyFromSanSnapshot
"CopyStart"
"Пустой"
FromImage
"Импорт"
ImportSecure
"Восстановить"
"Отправить"
UploadPreparedSecure (обязательный)
elasticSanResourceId Требуется, если createOption — CopyFromSanSnapshot. Это идентификатор ARM исходного моментального снимка эластичного сан-тома. струна
galleryImageReference Требуется при создании из образа коллекции. Идентификатор/sharedGalleryImageId/communityGalleryImageId объекта ImageDiskReference будет идентификатором ARM общей версии образа галли, из которой создается диск. ImageDiskReference
ImageReference Сведения о источнике диска для образов ПИР или пользователей. ImageDiskReference
logicalSectorSize Размер логического сектора в байтах для дисков Категории "Ультра". Поддерживаемые значения : 512 ad 4096. 4096 — это значение по умолчанию. инт
performancePlus Задайте для этого флага значение true, чтобы повысить производительность целевого объекта развернутого диска, см. здесь по соответствующему целевому объекту производительности. Этот флаг можно задать только во время создания диска и не может быть отключен после включения. булевая переменная (bool)
provisionedBandwidthCopySpeed Если это поле установлено на моментальном снимке и createOption — CopyStart, моментальный снимок будет скопирован быстрее. "Расширенный"
"Нет"
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). инт

DiskSecurityProfile

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

Шифрование

Имя Описание Ценность
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

Расширенное местоположение

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

ImageDiskReference

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

KeyVaultAndKeyReference

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

KeyVaultAndSecretReference

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

Microsoft.Compute/snapshots

Имя Описание Ценность
apiVersion Версия API '2024-03-02'
extendedLocation Расширенное расположение, в котором будет создан моментальный снимок. Невозможно изменить расширенное расположение. ExtendedLocation
местоположение Расположение ресурса строка (обязательно)
имя Имя ресурса строка (обязательно)
свойства Свойства ресурса моментального снимка. SnapshotProperties
SKU Имя SKU моментальных снимков. Может быть Standard_LRS, Premium_LRS или Standard_ZRS. Это необязательный параметр для добавочного моментального снимка, а поведение по умолчанию — SKU будет иметь тот же номер SKU, что и предыдущий моментальный снимок. SnapshotSku
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
тип Тип ресурса "Microsoft.Compute/snapshots"

PurchasePlan

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

ResourceTags

Имя Описание Ценность

SnapshotProperties

Имя Описание Ценность
завершениеPercent Процент завершения фоновой копии при создании ресурса с помощью операции CopyStart. инт
copyCompletionError Указывает сведения об ошибке, если фоновая копия ресурса, созданного с помощью операции CopyStart, завершается сбоем. CopyCompletionError
creationData Сведения об источнике диска. Данные creationData нельзя изменить после создания диска. CreationData (обязательно)
dataAccessAuthMode Дополнительные требования к проверке подлинности при экспорте или отправке на диск или моментальный снимок. AzureActiveDirectory
"Нет"
diskAccessId Идентификатор ARM ресурса DiskAccess для использования частных конечных точек на дисках. струна
diskSizeGB Если createData.createOption является пустым, это поле является обязательным и указывает размер создаваемого диска. Если это поле присутствует для обновлений или создания с другими параметрами, оно указывает на изменение размера. Изменение размера допускается только в том случае, если диск не подключен к работающей виртуальной машине и может увеличить размер диска. инт
шифрование Свойство шифрования можно использовать для шифрования неактивных данных с помощью управляемых клиентом ключей или управляемых платформой ключей. Шифрование
encryptionSettingsCollection Коллекция параметров шифрования, используемая для шифрования дисков Azure, может содержать несколько параметров шифрования на диск или моментальный снимок. EncryptionSettingsCollection
hyperVGeneration Создание гипервизора виртуальной машины. Применимо только к дискам ОС. "V1"
"V2"
Добавочного Является ли моментальный снимок добавочным. Добавочные моментальные снимки на том же диске занимают меньше места, чем полные моментальные снимки и могут быть различаются. булевая переменная (bool)
networkAccessPolicy Политика доступа к диску через сеть. AllowAll
AllowPrivate
"DenyAll"
Тип ОС Тип операционной системы. Linux
"Windows"
publicNetworkAccess Политика управления экспортом на диске. "Отключено"
"Включено"
purchasePlan Сведения о плане покупки для образа, из которого был создан исходный диск для моментального снимка. PurchasePlan
securityProfile Содержит сведения, связанные с безопасностью для ресурса. DiskSecurityProfile
supportedCapabilities Список поддерживаемых возможностей для образа, из которого исходный диск был создан из моментального снимка. Поддерживаемые возможностиCapabilities
поддержка поддержкиHibernation Указывает, что ОС на моментальном снимке поддерживает гибернацию. булевая переменная (bool)

SnapshotSku

Имя Описание Ценность
имя Имя SKU. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"

SourceVault

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

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

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

Примеры использования

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

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

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

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

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

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/snapshots@2024-03-02"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    extendedLocation = {
      name = "string"
      type = "string"
    }
    properties = {
      completionPercent = int
      copyCompletionError = {
        errorCode = "string"
        errorMessage = "string"
      }
      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"
      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"
      incremental = bool
      networkAccessPolicy = "string"
      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
    }
    sku = {
      name = "string"
    }
  }
}

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

CopyCompletionError

Имя Описание Ценность
ErrorCode Указывает код ошибки, если фоновая копия ресурса, созданного с помощью операции CopyStart, завершается сбоем. CopySourceNotFound (обязательно)
сообщение об ошибке Указывает сообщение об ошибке, если фоновая копия ресурса, созданного с помощью операции CopyStart, завершается сбоем. строка (обязательно)

СозданиеData

Имя Описание Ценность
createOption Это перечисляет возможные источники создания диска. "Присоединить"
"Копировать"
CopyFromSanSnapshot
"CopyStart"
"Пустой"
FromImage
"Импорт"
ImportSecure
"Восстановить"
"Отправить"
UploadPreparedSecure (обязательный)
elasticSanResourceId Требуется, если createOption — CopyFromSanSnapshot. Это идентификатор ARM исходного моментального снимка эластичного сан-тома. струна
galleryImageReference Требуется при создании из образа коллекции. Идентификатор/sharedGalleryImageId/communityGalleryImageId объекта ImageDiskReference будет идентификатором ARM общей версии образа галли, из которой создается диск. ImageDiskReference
ImageReference Сведения о источнике диска для образов ПИР или пользователей. ImageDiskReference
logicalSectorSize Размер логического сектора в байтах для дисков Категории "Ультра". Поддерживаемые значения : 512 ad 4096. 4096 — это значение по умолчанию. инт
performancePlus Задайте для этого флага значение true, чтобы повысить производительность целевого объекта развернутого диска, см. здесь по соответствующему целевому объекту производительности. Этот флаг можно задать только во время создания диска и не может быть отключен после включения. булевая переменная (bool)
provisionedBandwidthCopySpeed Если это поле установлено на моментальном снимке и createOption — CopyStart, моментальный снимок будет скопирован быстрее. "Расширенный"
"Нет"
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). инт

DiskSecurityProfile

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

Шифрование

Имя Описание Ценность
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

Расширенное местоположение

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

ImageDiskReference

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

KeyVaultAndKeyReference

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

KeyVaultAndSecretReference

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

Microsoft.Compute/snapshots

Имя Описание Ценность
extendedLocation Расширенное расположение, в котором будет создан моментальный снимок. Невозможно изменить расширенное расположение. ExtendedLocation
местоположение Расположение ресурса строка (обязательно)
имя Имя ресурса строка (обязательно)
свойства Свойства ресурса моментального снимка. SnapshotProperties
SKU Имя SKU моментальных снимков. Может быть Standard_LRS, Premium_LRS или Standard_ZRS. Это необязательный параметр для добавочного моментального снимка, а поведение по умолчанию — SKU будет иметь тот же номер SKU, что и предыдущий моментальный снимок. SnapshotSku
Теги Теги ресурсов Словарь имен и значений тегов.
тип Тип ресурса "Microsoft.Compute/snapshots@2024-03-02"

PurchasePlan

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

ResourceTags

Имя Описание Ценность

SnapshotProperties

Имя Описание Ценность
завершениеPercent Процент завершения фоновой копии при создании ресурса с помощью операции CopyStart. инт
copyCompletionError Указывает сведения об ошибке, если фоновая копия ресурса, созданного с помощью операции CopyStart, завершается сбоем. CopyCompletionError
creationData Сведения об источнике диска. Данные creationData нельзя изменить после создания диска. CreationData (обязательно)
dataAccessAuthMode Дополнительные требования к проверке подлинности при экспорте или отправке на диск или моментальный снимок. AzureActiveDirectory
"Нет"
diskAccessId Идентификатор ARM ресурса DiskAccess для использования частных конечных точек на дисках. струна
diskSizeGB Если createData.createOption является пустым, это поле является обязательным и указывает размер создаваемого диска. Если это поле присутствует для обновлений или создания с другими параметрами, оно указывает на изменение размера. Изменение размера допускается только в том случае, если диск не подключен к работающей виртуальной машине и может увеличить размер диска. инт
шифрование Свойство шифрования можно использовать для шифрования неактивных данных с помощью управляемых клиентом ключей или управляемых платформой ключей. Шифрование
encryptionSettingsCollection Коллекция параметров шифрования, используемая для шифрования дисков Azure, может содержать несколько параметров шифрования на диск или моментальный снимок. EncryptionSettingsCollection
hyperVGeneration Создание гипервизора виртуальной машины. Применимо только к дискам ОС. "V1"
"V2"
Добавочного Является ли моментальный снимок добавочным. Добавочные моментальные снимки на том же диске занимают меньше места, чем полные моментальные снимки и могут быть различаются. булевая переменная (bool)
networkAccessPolicy Политика доступа к диску через сеть. AllowAll
AllowPrivate
"DenyAll"
Тип ОС Тип операционной системы. Linux
"Windows"
publicNetworkAccess Политика управления экспортом на диске. "Отключено"
"Включено"
purchasePlan Сведения о плане покупки для образа, из которого был создан исходный диск для моментального снимка. PurchasePlan
securityProfile Содержит сведения, связанные с безопасностью для ресурса. DiskSecurityProfile
supportedCapabilities Список поддерживаемых возможностей для образа, из которого исходный диск был создан из моментального снимка. Поддерживаемые возможностиCapabilities
поддержка поддержкиHibernation Указывает, что ОС на моментальном снимке поддерживает гибернацию. булевая переменная (bool)

SnapshotSku

Имя Описание Ценность
имя Имя SKU. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"

SourceVault

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

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

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