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


Microsoft.Compute virtualMachineScaleSets/virtualMachines/extensions 2025-04-01

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

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

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

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

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

resource symbolicname 'Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions@2025-04-01' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    autoUpgradeMinorVersion: bool
    enableAutomaticUpgrade: bool
    forceUpdateTag: 'string'
    instanceView: {
      name: 'string'
      statuses: [
        {
          code: 'string'
          displayStatus: 'string'
          level: 'string'
          message: 'string'
          time: 'string'
        }
      ]
      substatuses: [
        {
          code: 'string'
          displayStatus: 'string'
          level: 'string'
          message: 'string'
          time: 'string'
        }
      ]
      type: 'string'
      typeHandlerVersion: 'string'
    }
    protectedSettings: any(...)
    protectedSettingsFromKeyVault: {
      secretUrl: 'string'
      sourceVault: {
        id: 'string'
      }
    }
    provisionAfterExtensions: [
      'string'
    ]
    publisher: 'string'
    settings: any(...)
    suppressFailures: bool
    type: 'string'
    typeHandlerVersion: 'string'
  }
}

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

Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions

Имя Description Ценность
location Расположение расширения. струна
имя имя ресурса. строка (обязательно)
parent В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить, только если дочерний ресурс объявлен за пределами родительского ресурса.

Дополнительные сведения см. в разделе Дочерний ресурс за пределами родительского ресурса.
Символьное имя ресурса типа: virtualMachineScaleSets/virtualMachines
properties Описывает свойства расширения виртуальной машины. Свойства расширения VirtualMachine

InstanceViewStatus (СтатусInstanceView)

Имя Description Ценность
код Код состояния. струна
displayStatus Короткая локализуемая метка для состояния. струна
уровень Код уровня. "Ошибка"
'Info'
Предупреждение
сообщение Подробное сообщение о состоянии, в том числе для оповещений и сообщений об ошибках. струна
time Время состояния. струна

Ссылка на KeyVaultSecretReference

Имя Description Ценность
secretUrl URL-адрес, ссылающийся на секрет в Key Vault. строка (обязательно)
sourceVault Относительный URL-адрес Хранилища ключей, содержащий секрет. subResource (обязательно)

Подресурс

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

VirtualMachineExtensionInstanceView

Имя Description Ценность
имя Имя расширения виртуальной машины. струна
statuses Сведения о состоянии ресурса. InstanceViewStatus[]
вложенные статистические выражения Сведения о состоянии ресурса. InstanceViewStatus[]
type Указывает тип расширения; примером является CustomScriptExtension. струна
версияТипаОбработчика Указывает версию обработчика скрипта. струна

Свойства расширения VirtualMachine

Имя Description Ценность
автоматическое обновление минорной версии Указывает, следует ли использовать более новую дополнительную версию, если она доступна во время развертывания. Однако после развертывания расширение не будет обновляться до дополнительных версий, кроме случаев повторного развертывания, даже если это свойство имеет значение true. bool
включитьАвтоматическоеОбновление Указывает, следует ли автоматически обновлять расширение платформой, если доступна более новая версия расширения. bool
forceUpdateTag Как обработчик расширений должен быть вынужден обновляться, даже если конфигурация расширения не изменилась. струна
instanceView Представление экземпляра расширения виртуальной машины. VirtualMachineExtensionInstanceView
защищенныеНастройки Расширение может содержать защищенные параметрыSettings или protectedSettingsFromKeyVault или не иметь защищенных параметров. any
protectedSettingsFromKeyVault Защищенные расширения, передаваемые по ссылке, и используемые из хранилища ключей Ссылка на KeyVaultSecretReference
provisionAfterExtensions Коллекция имен расширений, после которой необходимо подготовить это расширение. строка[]
издатель Имя издателя обработчика расширений. струна
settings Форматированные общедоступные параметры json для расширения. any
suppressFailures Указывает, будут ли отключены сбои, возникающие из расширения (операционные сбои, такие как отсутствие подключения к виртуальной машине, не будут подавляться независимо от этого значения). Значение по умолчанию — false. bool
type Указывает тип расширения; примером является CustomScriptExtension. струна
версияТипаОбработчика Указывает версию обработчика скрипта. струна

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

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

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

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

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

{
  "type": "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions",
  "apiVersion": "2025-04-01",
  "name": "string",
  "location": "string",
  "properties": {
    "autoUpgradeMinorVersion": "bool",
    "enableAutomaticUpgrade": "bool",
    "forceUpdateTag": "string",
    "instanceView": {
      "name": "string",
      "statuses": [
        {
          "code": "string",
          "displayStatus": "string",
          "level": "string",
          "message": "string",
          "time": "string"
        }
      ],
      "substatuses": [
        {
          "code": "string",
          "displayStatus": "string",
          "level": "string",
          "message": "string",
          "time": "string"
        }
      ],
      "type": "string",
      "typeHandlerVersion": "string"
    },
    "protectedSettings": {},
    "protectedSettingsFromKeyVault": {
      "secretUrl": "string",
      "sourceVault": {
        "id": "string"
      }
    },
    "provisionAfterExtensions": [ "string" ],
    "publisher": "string",
    "settings": {},
    "suppressFailures": "bool",
    "type": "string",
    "typeHandlerVersion": "string"
  }
}

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

Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions

Имя Description Ценность
apiVersion Версия API '2025-04-01'
location Расположение расширения. струна
имя имя ресурса. строка (обязательно)
properties Описывает свойства расширения виртуальной машины. Свойства расширения VirtualMachine
type Тип ресурса "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions"

InstanceViewStatus (СтатусInstanceView)

Имя Description Ценность
код Код состояния. струна
displayStatus Короткая локализуемая метка для состояния. струна
уровень Код уровня. "Ошибка"
'Info'
Предупреждение
сообщение Подробное сообщение о состоянии, в том числе для оповещений и сообщений об ошибках. струна
time Время состояния. струна

Ссылка на KeyVaultSecretReference

Имя Description Ценность
secretUrl URL-адрес, ссылающийся на секрет в Key Vault. строка (обязательно)
sourceVault Относительный URL-адрес Хранилища ключей, содержащий секрет. subResource (обязательно)

Подресурс

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

VirtualMachineExtensionInstanceView

Имя Description Ценность
имя Имя расширения виртуальной машины. струна
statuses Сведения о состоянии ресурса. InstanceViewStatus[]
вложенные статистические выражения Сведения о состоянии ресурса. InstanceViewStatus[]
type Указывает тип расширения; примером является CustomScriptExtension. струна
версияТипаОбработчика Указывает версию обработчика скрипта. струна

Свойства расширения VirtualMachine

Имя Description Ценность
автоматическое обновление минорной версии Указывает, следует ли использовать более новую дополнительную версию, если она доступна во время развертывания. Однако после развертывания расширение не будет обновляться до дополнительных версий, кроме случаев повторного развертывания, даже если это свойство имеет значение true. bool
включитьАвтоматическоеОбновление Указывает, следует ли автоматически обновлять расширение платформой, если доступна более новая версия расширения. bool
forceUpdateTag Как обработчик расширений должен быть вынужден обновляться, даже если конфигурация расширения не изменилась. струна
instanceView Представление экземпляра расширения виртуальной машины. VirtualMachineExtensionInstanceView
защищенныеНастройки Расширение может содержать защищенные параметрыSettings или protectedSettingsFromKeyVault или не иметь защищенных параметров. any
protectedSettingsFromKeyVault Защищенные расширения, передаваемые по ссылке, и используемые из хранилища ключей Ссылка на KeyVaultSecretReference
provisionAfterExtensions Коллекция имен расширений, после которой необходимо подготовить это расширение. строка[]
издатель Имя издателя обработчика расширений. струна
settings Форматированные общедоступные параметры json для расширения. any
suppressFailures Указывает, будут ли отключены сбои, возникающие из расширения (операционные сбои, такие как отсутствие подключения к виртуальной машине, не будут подавляться независимо от этого значения). Значение по умолчанию — false. bool
type Указывает тип расширения; примером является CustomScriptExtension. струна
версияТипаОбработчика Указывает версию обработчика скрипта. струна

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

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

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

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

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

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions@2025-04-01"
  name = "string"
  parent_id = "string"
  location = "string"
  body = {
    properties = {
      autoUpgradeMinorVersion = bool
      enableAutomaticUpgrade = bool
      forceUpdateTag = "string"
      instanceView = {
        name = "string"
        statuses = [
          {
            code = "string"
            displayStatus = "string"
            level = "string"
            message = "string"
            time = "string"
          }
        ]
        substatuses = [
          {
            code = "string"
            displayStatus = "string"
            level = "string"
            message = "string"
            time = "string"
          }
        ]
        type = "string"
        typeHandlerVersion = "string"
      }
      protectedSettings = ?
      protectedSettingsFromKeyVault = {
        secretUrl = "string"
        sourceVault = {
          id = "string"
        }
      }
      provisionAfterExtensions = [
        "string"
      ]
      publisher = "string"
      settings = ?
      suppressFailures = bool
      type = "string"
      typeHandlerVersion = "string"
    }
  }
}

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

Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions

Имя Description Ценность
location Расположение расширения. струна
имя имя ресурса. строка (обязательно)
parent_id Идентификатор ресурса, который является родительским для этого ресурса. Идентификатор ресурса типа: virtualMachineScaleSets/virtualMachines
properties Описывает свойства расширения виртуальной машины. Свойства расширения VirtualMachine
type Тип ресурса "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions@2025-04-01"

InstanceViewStatus (СтатусInstanceView)

Имя Description Ценность
код Код состояния. струна
displayStatus Короткая локализуемая метка для состояния. струна
уровень Код уровня. "Ошибка"
'Info'
Предупреждение
сообщение Подробное сообщение о состоянии, в том числе для оповещений и сообщений об ошибках. струна
time Время состояния. струна

Ссылка на KeyVaultSecretReference

Имя Description Ценность
secretUrl URL-адрес, ссылающийся на секрет в Key Vault. строка (обязательно)
sourceVault Относительный URL-адрес Хранилища ключей, содержащий секрет. subResource (обязательно)

Подресурс

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

VirtualMachineExtensionInstanceView

Имя Description Ценность
имя Имя расширения виртуальной машины. струна
statuses Сведения о состоянии ресурса. InstanceViewStatus[]
вложенные статистические выражения Сведения о состоянии ресурса. InstanceViewStatus[]
type Указывает тип расширения; примером является CustomScriptExtension. струна
версияТипаОбработчика Указывает версию обработчика скрипта. струна

Свойства расширения VirtualMachine

Имя Description Ценность
автоматическое обновление минорной версии Указывает, следует ли использовать более новую дополнительную версию, если она доступна во время развертывания. Однако после развертывания расширение не будет обновляться до дополнительных версий, кроме случаев повторного развертывания, даже если это свойство имеет значение true. bool
включитьАвтоматическоеОбновление Указывает, следует ли автоматически обновлять расширение платформой, если доступна более новая версия расширения. bool
forceUpdateTag Как обработчик расширений должен быть вынужден обновляться, даже если конфигурация расширения не изменилась. струна
instanceView Представление экземпляра расширения виртуальной машины. VirtualMachineExtensionInstanceView
защищенныеНастройки Расширение может содержать защищенные параметрыSettings или protectedSettingsFromKeyVault или не иметь защищенных параметров. any
protectedSettingsFromKeyVault Защищенные расширения, передаваемые по ссылке, и используемые из хранилища ключей Ссылка на KeyVaultSecretReference
provisionAfterExtensions Коллекция имен расширений, после которой необходимо подготовить это расширение. строка[]
издатель Имя издателя обработчика расширений. струна
settings Форматированные общедоступные параметры json для расширения. any
suppressFailures Указывает, будут ли отключены сбои, возникающие из расширения (операционные сбои, такие как отсутствие подключения к виртуальной машине, не будут подавляться независимо от этого значения). Значение по умолчанию — false. bool
type Указывает тип расширения; примером является CustomScriptExtension. струна
версияТипаОбработчика Указывает версию обработчика скрипта. струна