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
| Имя | В | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Имя группы ресурсов. Имя нечувствительно к регистру. |
|
subscription
|
path | True |
string minLength: 1 |
Идентификатор целевой подписки. |
|
vm
|
path | True |
string |
Имя масштабируемого набора виртуальных машин. |
|
vmss
|
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 |
Защищенные расширения, передаваемые по ссылке, и используемые из хранилища ключей |
|
| 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 |
Операция Azure успешно завершена. |
|
| 201 Created |
Операция по созданию ресурса 'VirtualMachineScaleSetExtension' выполнена успешно Заголовки
|
|
| Other Status Codes |
Непредвиденное сообщение об ошибке. |
Безопасность
azure_auth
Поток OAuth2 в Azure Active Directory.
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
| Имя | Описание |
|---|---|
| user_impersonation | выдать себя за учетную запись пользователя |
Примеры
|
Virtual |
|
Virtual |
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
{}
Определения
| Имя | Описание |
|---|---|
|
Api |
Ошибка API. |
|
Api |
База ошибок API. |
|
Cloud |
Ответ на ошибку из службы вычислений. |
|
Inner |
Сведения о внутренней ошибке. |
|
Key |
Описание ссылки на секрет Key Vault |
|
Sub |
|
|
Virtual |
Описывает расширение масштабируемого набора виртуальных машин. |
|
Virtual |
Описывает расширение масштабируемого набора виртуальных машин. |
ApiError
Ошибка API.
| Имя | Тип | Описание |
|---|---|---|
| code |
string |
Код ошибки. |
| details |
Сведения об ошибке API |
|
| innererror |
Внутренняя ошибка API |
|
| message |
string |
Сообщение об ошибке. |
| target |
string |
Целевой объект конкретной ошибки. |
ApiErrorBase
База ошибок API.
| Имя | Тип | Описание |
|---|---|---|
| code |
string |
Код ошибки. |
| message |
string |
Сообщение об ошибке. |
| target |
string |
Целевой объект конкретной ошибки. |
CloudError
Ответ на ошибку из службы вычислений.
| Имя | Тип | Описание |
|---|---|---|
| error |
Ошибка API. |
InnerError
Сведения о внутренней ошибке.
| Имя | Тип | Описание |
|---|---|---|
| errordetail |
string |
Внутреннее сообщение об ошибке или дамп исключений. |
| exceptiontype |
string |
Тип исключения. |
KeyVaultSecretReference
Описание ссылки на секрет Key Vault
| Имя | Тип | Описание |
|---|---|---|
| secretUrl |
string |
URL-адрес, ссылающийся на секрет в Key Vault. |
| sourceVault |
Относительный 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 |
Защищенные расширения, передаваемые по ссылке, и используемые из хранилища ключей |
|
| 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 |
Защищенные расширения, передаваемые по ссылке, и используемые из хранилища ключей |
|
| 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 |
Тип ресурса |