Virtual Machine Scale Set Extensions - Update

Операция по обновлению расширения.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/extensions/{vmssExtensionName}?api-version=2026-04-01

Параметры URI

Имя В Обязательно Тип Описание
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Имя группы ресурсов. Имя нечувствительно к регистру.

subscriptionId
path True

string

minLength: 1

Идентификатор целевой подписки.

vmScaleSetName
path True

string

Имя масштабируемого набора виртуальных машин.

vmssExtensionName
path True

string

Имя расширения масштабируемого набора виртуальных машин.

api-version
query True

string

minLength: 1

Версия API, используемая для данной операции.

Текст запроса

Имя Тип Описание
properties.autoUpgradeMinorVersion

boolean

Указывает, следует ли использовать более новую дополнительную версию, если она доступна во время развертывания. Однако после развертывания расширение не будет обновлять дополнительные версии без повторного развертывания, даже если это свойство не имеет значения true.

properties.enableAutomaticUpgrade

boolean

Указывает, следует ли автоматически обновлять расширение платформой, если доступна более новая версия расширения.

properties.forceUpdateTag

string

Если задано значение и отличается от предыдущего значения, обработчик расширений будет вынужден обновляться, даже если конфигурация расширения не изменилась.

properties.protectedSettings

Расширение может содержать защищенные параметрыSettings или protectedSettingsFromKeyVault или не иметь защищенных параметров.

properties.protectedSettingsFromKeyVault

KeyVaultSecretReference

Защищенные расширения, передаваемые по ссылке, и используемые из хранилища ключей

properties.provisionAfterExtensions

string[]

Коллекция имен расширений, после которой необходимо подготовить это расширение.

properties.publisher

string

Имя издателя обработчика расширений.

properties.settings

Форматированные общедоступные параметры json для расширения.

properties.suppressFailures

boolean

Указывает, будут ли отключены сбои, возникающие из расширения (операционные сбои, такие как отсутствие подключения к виртуальной машине, не будут подавляться независимо от этого значения). Значение по умолчанию — false.

properties.type

string

Указывает тип расширения; примером является CustomScriptExtension.

properties.typeHandlerVersion

string

Указывает Major.Minor версию обработчика скриптов. Клиент может указать только версию расширения Major.Minor, платформа Azure предоставит последнюю версию Patch.Hotfix из серии Major.Minor.

Ответы

Имя Тип Описание
200 OK

VirtualMachineScaleSetExtension

Операция Azure успешно завершена.

201 Created

VirtualMachineScaleSetExtension

Операция по созданию ресурса 'VirtualMachineScaleSetExtension' выполнена успешно

Заголовки

  • Location: string
  • Retry-After: integer
Other Status Codes

CloudError

Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation выдать себя за учетную запись пользователя

Примеры

VirtualMachineScaleSetExtension_Update_MaximumSet_Gen
VirtualMachineScaleSetExtension_Update_MinimumSet_Gen

VirtualMachineScaleSetExtension_Update_MaximumSet_Gen

Образец запроса

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaaaaa/extensions/aaaa?api-version=2026-04-01

{
  "properties": {
    "autoUpgradeMinorVersion": true,
    "publisher": "{extension-Publisher}",
    "type": "{extension-Type}",
    "typeHandlerVersion": "{handler-version}",
    "settings": {},
    "forceUpdateTag": "aaaaaaaaa",
    "enableAutomaticUpgrade": true,
    "protectedSettings": {},
    "provisionAfterExtensions": [
      "aa"
    ],
    "suppressFailures": true
  }
}

Пример ответа

{
  "name": "{extension-name}",
  "properties": {
    "autoUpgradeMinorVersion": true,
    "publisher": "{extension-Publisher}",
    "type": "{extension-Type}",
    "typeHandlerVersion": "{handler-version}",
    "settings": {},
    "forceUpdateTag": "aaaaaaaaa",
    "enableAutomaticUpgrade": true,
    "protectedSettings": {},
    "provisioningState": "aaa",
    "provisionAfterExtensions": [
      "aa"
    ],
    "suppressFailures": true
  },
  "type": "aaaaaaaaaaaaaaaaaaaaaaaa",
  "id": "aaaaaaaa"
}
location: https://foo.com/operationstatus
{
  "name": "{extension-name}",
  "properties": {
    "autoUpgradeMinorVersion": true,
    "publisher": "{extension-Publisher}",
    "type": "{extension-Type}",
    "typeHandlerVersion": "{handler-version}",
    "settings": {},
    "forceUpdateTag": "aaaaaaaaa",
    "enableAutomaticUpgrade": true,
    "protectedSettings": {},
    "provisioningState": "aaa",
    "provisionAfterExtensions": [
      "aa"
    ],
    "suppressFailures": true
  },
  "type": "aaaaaaaaaaaaaaaaaaaaaaaa",
  "id": "aaaaaaaa"
}

VirtualMachineScaleSetExtension_Update_MinimumSet_Gen

Образец запроса

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaa/extensions/aa?api-version=2026-04-01

{}

Пример ответа

{}
location: https://foo.com/operationstatus
{}

Определения

Имя Описание
ApiError

Ошибка API.

ApiErrorBase

База ошибок API.

CloudError

Ответ на ошибку из службы вычислений.

InnerError

Сведения о внутренней ошибке.

KeyVaultSecretReference

Описание ссылки на секрет Key Vault

SubResource
VirtualMachineScaleSetExtension

Описывает расширение масштабируемого набора виртуальных машин.

VirtualMachineScaleSetExtensionUpdate

Описывает расширение масштабируемого набора виртуальных машин.

ApiError

Ошибка API.

Имя Тип Описание
code

string

Код ошибки.

details

ApiErrorBase[]

Сведения об ошибке API

innererror

InnerError

Внутренняя ошибка API

message

string

Сообщение об ошибке.

target

string

Целевой объект конкретной ошибки.

ApiErrorBase

База ошибок API.

Имя Тип Описание
code

string

Код ошибки.

message

string

Сообщение об ошибке.

target

string

Целевой объект конкретной ошибки.

CloudError

Ответ на ошибку из службы вычислений.

Имя Тип Описание
error

ApiError

Ошибка API.

InnerError

Сведения о внутренней ошибке.

Имя Тип Описание
errordetail

string

Внутреннее сообщение об ошибке или дамп исключений.

exceptiontype

string

Тип исключения.

KeyVaultSecretReference

Описание ссылки на секрет Key Vault

Имя Тип Описание
secretUrl

string

URL-адрес, ссылающийся на секрет в Key Vault.

sourceVault

SubResource

Относительный URL-адрес Хранилища ключей, содержащий секрет.

SubResource

Имя Тип Описание
id

string

Идентификатор ресурса

VirtualMachineScaleSetExtension

Описывает расширение масштабируемого набора виртуальных машин.

Имя Тип Описание
id

string

Идентификатор ресурса

name

string

Имя ресурса

properties.autoUpgradeMinorVersion

boolean

Указывает, следует ли использовать более новую дополнительную версию, если она доступна во время развертывания. Однако после развертывания расширение не будет обновлять дополнительные версии без повторного развертывания, даже если это свойство не имеет значения true.

properties.enableAutomaticUpgrade

boolean

Указывает, следует ли автоматически обновлять расширение платформой, если доступна более новая версия расширения.

properties.forceUpdateTag

string

Если задано значение и отличается от предыдущего значения, обработчик расширений будет вынужден обновляться, даже если конфигурация расширения не изменилась.

properties.protectedSettings

Расширение может содержать защищенные параметрыSettings или protectedSettingsFromKeyVault или не иметь защищенных параметров.

properties.protectedSettingsFromKeyVault

KeyVaultSecretReference

Защищенные расширения, передаваемые по ссылке, и используемые из хранилища ключей

properties.provisionAfterExtensions

string[]

Коллекция имен расширений, после которой необходимо подготовить это расширение.

properties.provisioningState

string

Состояние подготовки, которое отображается только в ответе.

properties.publisher

string

Имя издателя обработчика расширений.

properties.settings

Форматированные общедоступные параметры json для расширения.

properties.suppressFailures

boolean

Указывает, будут ли отключены сбои, возникающие из расширения (операционные сбои, такие как отсутствие подключения к виртуальной машине, не будут подавляться независимо от этого значения). Значение по умолчанию — false.

properties.type

string

Указывает тип расширения; примером является CustomScriptExtension.

properties.typeHandlerVersion

string

Указывает Major.Minor версию обработчика скриптов. Клиент может указать только версию расширения Major.Minor, платформа Azure предоставит последнюю версию Patch.Hotfix из серии Major.Minor.

type

string

Тип ресурса

VirtualMachineScaleSetExtensionUpdate

Описывает расширение масштабируемого набора виртуальных машин.

Имя Тип Описание
id

string

Идентификатор ресурса

name

string

Имя расширения.

properties.autoUpgradeMinorVersion

boolean

Указывает, следует ли использовать более новую дополнительную версию, если она доступна во время развертывания. Однако после развертывания расширение не будет обновлять дополнительные версии без повторного развертывания, даже если это свойство не имеет значения true.

properties.enableAutomaticUpgrade

boolean

Указывает, следует ли автоматически обновлять расширение платформой, если доступна более новая версия расширения.

properties.forceUpdateTag

string

Если задано значение и отличается от предыдущего значения, обработчик расширений будет вынужден обновляться, даже если конфигурация расширения не изменилась.

properties.protectedSettings

Расширение может содержать защищенные параметрыSettings или protectedSettingsFromKeyVault или не иметь защищенных параметров.

properties.protectedSettingsFromKeyVault

KeyVaultSecretReference

Защищенные расширения, передаваемые по ссылке, и используемые из хранилища ключей

properties.provisionAfterExtensions

string[]

Коллекция имен расширений, после которой необходимо подготовить это расширение.

properties.provisioningState

string

Состояние подготовки, которое отображается только в ответе.

properties.publisher

string

Имя издателя обработчика расширений.

properties.settings

Форматированные общедоступные параметры json для расширения.

properties.suppressFailures

boolean

Указывает, будут ли отключены сбои, возникающие из расширения (операционные сбои, такие как отсутствие подключения к виртуальной машине, не будут подавляться независимо от этого значения). Значение по умолчанию — false.

properties.type

string

Указывает тип расширения; примером является CustomScriptExtension.

properties.typeHandlerVersion

string

Указывает Major.Minor версию обработчика скриптов. Клиент может указать только версию расширения Major.Minor, платформа Azure предоставит последнюю версию Patch.Hotfix из серии Major.Minor.

type

string

Тип ресурса