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

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

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

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

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

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

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

resource symbolicname 'Microsoft.Compute/snapshots@2023-04-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
      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'
  }
}

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

Microsoft.Compute/snapshots

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

CopyCompletionError (Ошибка копирования)

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

СозданиеData

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

Профиль безопасности диска

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

Шифрование

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

ШифрованиеНастройкиКоллекция

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

EncryptionSettingsElement

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

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

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

Ссылка на ImageDiskReference

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

KeyVaultAndKeyReference

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

KeyVaultAndSecretReference

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

План закупок

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

Теги ресурса

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

Свойства снимка

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

Моментальный Sku

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

ИсточникСейф

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

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

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

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

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

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

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

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

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

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

Microsoft.Compute/snapshots

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

CopyCompletionError (Ошибка копирования)

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

СозданиеData

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

Профиль безопасности диска

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

Шифрование

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

ШифрованиеНастройкиКоллекция

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

EncryptionSettingsElement

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

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

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

Ссылка на ImageDiskReference

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

KeyVaultAndKeyReference

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

KeyVaultAndSecretReference

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

План закупок

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

Теги ресурса

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

Свойства снимка

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

Моментальный Sku

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

ИсточникСейф

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

Поддерживаемые возможности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@2023-04-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
        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"
    }
  }
}

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

Microsoft.Compute/snapshots

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

CopyCompletionError (Ошибка копирования)

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

СозданиеData

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

Профиль безопасности диска

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

Шифрование

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

ШифрованиеНастройкиКоллекция

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

EncryptionSettingsElement

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

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

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

Ссылка на ImageDiskReference

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

KeyVaultAndKeyReference

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

KeyVaultAndSecretReference

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

План закупок

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

Теги ресурса

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

Свойства снимка

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

Моментальный Sku

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

ИсточникСейф

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

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

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