PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/extensions/{vmExtensionName}/?api-version=2023-09-01
The operation to update the extension.
Servers
- https://management.azure.com/
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
vmExtensionName |
String | Yes |
The name of the virtual machine extension. |
vmName |
String | Yes |
The name of the virtual machine where the extension should be updated. |
subscriptionId |
String | Yes |
Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. |
resourceGroupName |
String | Yes |
The name of the resource group. |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
properties |
Object | No |
Describes the properties of a Virtual Machine Extension. |
properties.forceUpdateTag |
String | No |
How the extension handler should be forced to update even if the extension configuration has not changed. |
properties.publisher |
String | No |
The name of the extension handler publisher. |
properties.protectedSettings |
Object | No |
The extension can contain either protectedSettings or protectedSettingsFromKeyVault or no protected settings at all. |
properties.enableAutomaticUpgrade |
Boolean | No |
Indicates whether the extension should be automatically upgraded by the platform if there is a newer version of the extension available. |
properties.type |
String | No |
Specifies the type of the extension; an example is "CustomScriptExtension". |
properties.settings |
Object | No |
Json formatted public settings for the extension. |
properties.typeHandlerVersion |
String | No |
Specifies the version of the script handler. |
properties.autoUpgradeMinorVersion |
Boolean | No |
Indicates whether the extension should use a newer minor version if one is available at deployment time. Once deployed, however, the extension will not upgrade minor versions unless redeployed, even with this property set to true. |
properties.suppressFailures |
Boolean | No |
Indicates whether failures stemming from the extension will be suppressed (Operational failures such as not connecting to the VM will not be suppressed regardless of this value). The default is false. |
properties.protectedSettingsFromKeyVault |
Object | No |
Describes a reference to Key Vault Secret |
properties.protectedSettingsFromKeyVault.sourceVault |
Object | Yes | |
properties.protectedSettingsFromKeyVault.sourceVault.id |
String | No |
Resource Id |
properties.protectedSettingsFromKeyVault.secretUrl |
String | Yes |
The URL referencing a secret in a Key Vault. |
tags |
Object | No |
Resource tags |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.