1. Packages
  2. Azure Native
  3. API Docs
  4. compute
  5. getVirtualMachineExtension
This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
Azure Native v3.2.0 published on Monday, Apr 14, 2025 by Pulumi

azure-native.compute.getVirtualMachineExtension

Explore with Pulumi AI

This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
Azure Native v3.2.0 published on Monday, Apr 14, 2025 by Pulumi

The operation to get the extension.

Uses Azure REST API version 2024-11-01.

Other available API versions: 2022-08-01, 2022-11-01, 2023-03-01, 2023-07-01, 2023-09-01, 2024-03-01, 2024-07-01. These can be accessed by generating a local SDK package using the CLI command pulumi package add azure-native compute [ApiVersion]. See the version guide for details.

Using getVirtualMachineExtension

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getVirtualMachineExtension(args: GetVirtualMachineExtensionArgs, opts?: InvokeOptions): Promise<GetVirtualMachineExtensionResult>
function getVirtualMachineExtensionOutput(args: GetVirtualMachineExtensionOutputArgs, opts?: InvokeOptions): Output<GetVirtualMachineExtensionResult>
Copy
def get_virtual_machine_extension(expand: Optional[str] = None,
                                  resource_group_name: Optional[str] = None,
                                  vm_extension_name: Optional[str] = None,
                                  vm_name: Optional[str] = None,
                                  opts: Optional[InvokeOptions] = None) -> GetVirtualMachineExtensionResult
def get_virtual_machine_extension_output(expand: Optional[pulumi.Input[str]] = None,
                                  resource_group_name: Optional[pulumi.Input[str]] = None,
                                  vm_extension_name: Optional[pulumi.Input[str]] = None,
                                  vm_name: Optional[pulumi.Input[str]] = None,
                                  opts: Optional[InvokeOptions] = None) -> Output[GetVirtualMachineExtensionResult]
Copy
func LookupVirtualMachineExtension(ctx *Context, args *LookupVirtualMachineExtensionArgs, opts ...InvokeOption) (*LookupVirtualMachineExtensionResult, error)
func LookupVirtualMachineExtensionOutput(ctx *Context, args *LookupVirtualMachineExtensionOutputArgs, opts ...InvokeOption) LookupVirtualMachineExtensionResultOutput
Copy

> Note: This function is named LookupVirtualMachineExtension in the Go SDK.

public static class GetVirtualMachineExtension 
{
    public static Task<GetVirtualMachineExtensionResult> InvokeAsync(GetVirtualMachineExtensionArgs args, InvokeOptions? opts = null)
    public static Output<GetVirtualMachineExtensionResult> Invoke(GetVirtualMachineExtensionInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetVirtualMachineExtensionResult> getVirtualMachineExtension(GetVirtualMachineExtensionArgs args, InvokeOptions options)
public static Output<GetVirtualMachineExtensionResult> getVirtualMachineExtension(GetVirtualMachineExtensionArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: azure-native:compute:getVirtualMachineExtension
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

ResourceGroupName
This property is required.
Changes to this property will trigger replacement.
string
The name of the resource group.
VmExtensionName
This property is required.
Changes to this property will trigger replacement.
string
The name of the virtual machine extension.
VmName
This property is required.
Changes to this property will trigger replacement.
string
The name of the virtual machine containing the extension.
Expand string
The expand expression to apply on the operation.
ResourceGroupName
This property is required.
Changes to this property will trigger replacement.
string
The name of the resource group.
VmExtensionName
This property is required.
Changes to this property will trigger replacement.
string
The name of the virtual machine extension.
VmName
This property is required.
Changes to this property will trigger replacement.
string
The name of the virtual machine containing the extension.
Expand string
The expand expression to apply on the operation.
resourceGroupName
This property is required.
Changes to this property will trigger replacement.
String
The name of the resource group.
vmExtensionName
This property is required.
Changes to this property will trigger replacement.
String
The name of the virtual machine extension.
vmName
This property is required.
Changes to this property will trigger replacement.
String
The name of the virtual machine containing the extension.
expand String
The expand expression to apply on the operation.
resourceGroupName
This property is required.
Changes to this property will trigger replacement.
string
The name of the resource group.
vmExtensionName
This property is required.
Changes to this property will trigger replacement.
string
The name of the virtual machine extension.
vmName
This property is required.
Changes to this property will trigger replacement.
string
The name of the virtual machine containing the extension.
expand string
The expand expression to apply on the operation.
resource_group_name
This property is required.
Changes to this property will trigger replacement.
str
The name of the resource group.
vm_extension_name
This property is required.
Changes to this property will trigger replacement.
str
The name of the virtual machine extension.
vm_name
This property is required.
Changes to this property will trigger replacement.
str
The name of the virtual machine containing the extension.
expand str
The expand expression to apply on the operation.
resourceGroupName
This property is required.
Changes to this property will trigger replacement.
String
The name of the resource group.
vmExtensionName
This property is required.
Changes to this property will trigger replacement.
String
The name of the virtual machine extension.
vmName
This property is required.
Changes to this property will trigger replacement.
String
The name of the virtual machine containing the extension.
expand String
The expand expression to apply on the operation.

getVirtualMachineExtension Result

The following output properties are available:

AzureApiVersion string
The Azure API version of the resource.
Id string
Resource Id
Name string
Resource name
ProvisioningState string
The provisioning state, which only appears in the response.
Type string
Resource type
AutoUpgradeMinorVersion bool
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.
EnableAutomaticUpgrade bool
Indicates whether the extension should be automatically upgraded by the platform if there is a newer version of the extension available.
ForceUpdateTag string
How the extension handler should be forced to update even if the extension configuration has not changed.
InstanceView Pulumi.AzureNative.Compute.Outputs.VirtualMachineExtensionInstanceViewResponse
The virtual machine extension instance view.
Location string
Resource location
ProtectedSettings object
The extension can contain either protectedSettings or protectedSettingsFromKeyVault or no protected settings at all.
ProtectedSettingsFromKeyVault Pulumi.AzureNative.Compute.Outputs.KeyVaultSecretReferenceResponse
The extensions protected settings that are passed by reference, and consumed from key vault
ProvisionAfterExtensions List<string>
Collection of extension names after which this extension needs to be provisioned.
Publisher string
The name of the extension handler publisher.
Settings object
Json formatted public settings for the extension.
SuppressFailures bool
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.
Tags Dictionary<string, string>
Resource tags
TypeHandlerVersion string
Specifies the version of the script handler.
AzureApiVersion string
The Azure API version of the resource.
Id string
Resource Id
Name string
Resource name
ProvisioningState string
The provisioning state, which only appears in the response.
Type string
Resource type
AutoUpgradeMinorVersion bool
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.
EnableAutomaticUpgrade bool
Indicates whether the extension should be automatically upgraded by the platform if there is a newer version of the extension available.
ForceUpdateTag string
How the extension handler should be forced to update even if the extension configuration has not changed.
InstanceView VirtualMachineExtensionInstanceViewResponse
The virtual machine extension instance view.
Location string
Resource location
ProtectedSettings interface{}
The extension can contain either protectedSettings or protectedSettingsFromKeyVault or no protected settings at all.
ProtectedSettingsFromKeyVault KeyVaultSecretReferenceResponse
The extensions protected settings that are passed by reference, and consumed from key vault
ProvisionAfterExtensions []string
Collection of extension names after which this extension needs to be provisioned.
Publisher string
The name of the extension handler publisher.
Settings interface{}
Json formatted public settings for the extension.
SuppressFailures bool
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.
Tags map[string]string
Resource tags
TypeHandlerVersion string
Specifies the version of the script handler.
azureApiVersion String
The Azure API version of the resource.
id String
Resource Id
name String
Resource name
provisioningState String
The provisioning state, which only appears in the response.
type String
Resource type
autoUpgradeMinorVersion Boolean
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.
enableAutomaticUpgrade Boolean
Indicates whether the extension should be automatically upgraded by the platform if there is a newer version of the extension available.
forceUpdateTag String
How the extension handler should be forced to update even if the extension configuration has not changed.
instanceView VirtualMachineExtensionInstanceViewResponse
The virtual machine extension instance view.
location String
Resource location
protectedSettings Object
The extension can contain either protectedSettings or protectedSettingsFromKeyVault or no protected settings at all.
protectedSettingsFromKeyVault KeyVaultSecretReferenceResponse
The extensions protected settings that are passed by reference, and consumed from key vault
provisionAfterExtensions List<String>
Collection of extension names after which this extension needs to be provisioned.
publisher String
The name of the extension handler publisher.
settings Object
Json formatted public settings for the extension.
suppressFailures Boolean
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.
tags Map<String,String>
Resource tags
typeHandlerVersion String
Specifies the version of the script handler.
azureApiVersion string
The Azure API version of the resource.
id string
Resource Id
name string
Resource name
provisioningState string
The provisioning state, which only appears in the response.
type string
Resource type
autoUpgradeMinorVersion boolean
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.
enableAutomaticUpgrade boolean
Indicates whether the extension should be automatically upgraded by the platform if there is a newer version of the extension available.
forceUpdateTag string
How the extension handler should be forced to update even if the extension configuration has not changed.
instanceView VirtualMachineExtensionInstanceViewResponse
The virtual machine extension instance view.
location string
Resource location
protectedSettings any
The extension can contain either protectedSettings or protectedSettingsFromKeyVault or no protected settings at all.
protectedSettingsFromKeyVault KeyVaultSecretReferenceResponse
The extensions protected settings that are passed by reference, and consumed from key vault
provisionAfterExtensions string[]
Collection of extension names after which this extension needs to be provisioned.
publisher string
The name of the extension handler publisher.
settings any
Json formatted public settings for the extension.
suppressFailures boolean
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.
tags {[key: string]: string}
Resource tags
typeHandlerVersion string
Specifies the version of the script handler.
azure_api_version str
The Azure API version of the resource.
id str
Resource Id
name str
Resource name
provisioning_state str
The provisioning state, which only appears in the response.
type str
Resource type
auto_upgrade_minor_version bool
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.
enable_automatic_upgrade bool
Indicates whether the extension should be automatically upgraded by the platform if there is a newer version of the extension available.
force_update_tag str
How the extension handler should be forced to update even if the extension configuration has not changed.
instance_view VirtualMachineExtensionInstanceViewResponse
The virtual machine extension instance view.
location str
Resource location
protected_settings Any
The extension can contain either protectedSettings or protectedSettingsFromKeyVault or no protected settings at all.
protected_settings_from_key_vault KeyVaultSecretReferenceResponse
The extensions protected settings that are passed by reference, and consumed from key vault
provision_after_extensions Sequence[str]
Collection of extension names after which this extension needs to be provisioned.
publisher str
The name of the extension handler publisher.
settings Any
Json formatted public settings for the extension.
suppress_failures bool
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.
tags Mapping[str, str]
Resource tags
type_handler_version str
Specifies the version of the script handler.
azureApiVersion String
The Azure API version of the resource.
id String
Resource Id
name String
Resource name
provisioningState String
The provisioning state, which only appears in the response.
type String
Resource type
autoUpgradeMinorVersion Boolean
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.
enableAutomaticUpgrade Boolean
Indicates whether the extension should be automatically upgraded by the platform if there is a newer version of the extension available.
forceUpdateTag String
How the extension handler should be forced to update even if the extension configuration has not changed.
instanceView Property Map
The virtual machine extension instance view.
location String
Resource location
protectedSettings Any
The extension can contain either protectedSettings or protectedSettingsFromKeyVault or no protected settings at all.
protectedSettingsFromKeyVault Property Map
The extensions protected settings that are passed by reference, and consumed from key vault
provisionAfterExtensions List<String>
Collection of extension names after which this extension needs to be provisioned.
publisher String
The name of the extension handler publisher.
settings Any
Json formatted public settings for the extension.
suppressFailures Boolean
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.
tags Map<String>
Resource tags
typeHandlerVersion String
Specifies the version of the script handler.

Supporting Types

InstanceViewStatusResponse

Code string
The status code.
DisplayStatus string
The short localizable label for the status.
Level string
The level code.
Message string
The detailed status message, including for alerts and error messages.
Time string
The time of the status.
Code string
The status code.
DisplayStatus string
The short localizable label for the status.
Level string
The level code.
Message string
The detailed status message, including for alerts and error messages.
Time string
The time of the status.
code String
The status code.
displayStatus String
The short localizable label for the status.
level String
The level code.
message String
The detailed status message, including for alerts and error messages.
time String
The time of the status.
code string
The status code.
displayStatus string
The short localizable label for the status.
level string
The level code.
message string
The detailed status message, including for alerts and error messages.
time string
The time of the status.
code str
The status code.
display_status str
The short localizable label for the status.
level str
The level code.
message str
The detailed status message, including for alerts and error messages.
time str
The time of the status.
code String
The status code.
displayStatus String
The short localizable label for the status.
level String
The level code.
message String
The detailed status message, including for alerts and error messages.
time String
The time of the status.

KeyVaultSecretReferenceResponse

SecretUrl This property is required. string
The URL referencing a secret in a Key Vault.
SourceVault This property is required. Pulumi.AzureNative.Compute.Inputs.SubResourceResponse
The relative URL of the Key Vault containing the secret.
SecretUrl This property is required. string
The URL referencing a secret in a Key Vault.
SourceVault This property is required. SubResourceResponse
The relative URL of the Key Vault containing the secret.
secretUrl This property is required. String
The URL referencing a secret in a Key Vault.
sourceVault This property is required. SubResourceResponse
The relative URL of the Key Vault containing the secret.
secretUrl This property is required. string
The URL referencing a secret in a Key Vault.
sourceVault This property is required. SubResourceResponse
The relative URL of the Key Vault containing the secret.
secret_url This property is required. str
The URL referencing a secret in a Key Vault.
source_vault This property is required. SubResourceResponse
The relative URL of the Key Vault containing the secret.
secretUrl This property is required. String
The URL referencing a secret in a Key Vault.
sourceVault This property is required. Property Map
The relative URL of the Key Vault containing the secret.

SubResourceResponse

Id string
Resource Id
Id string
Resource Id
id String
Resource Id
id string
Resource Id
id str
Resource Id
id String
Resource Id

VirtualMachineExtensionInstanceViewResponse

Name string
The virtual machine extension name.
Statuses List<Pulumi.AzureNative.Compute.Inputs.InstanceViewStatusResponse>
The resource status information.
Substatuses List<Pulumi.AzureNative.Compute.Inputs.InstanceViewStatusResponse>
The resource status information.
Type string
Specifies the type of the extension; an example is "CustomScriptExtension".
TypeHandlerVersion string
Specifies the version of the script handler.
Name string
The virtual machine extension name.
Statuses []InstanceViewStatusResponse
The resource status information.
Substatuses []InstanceViewStatusResponse
The resource status information.
Type string
Specifies the type of the extension; an example is "CustomScriptExtension".
TypeHandlerVersion string
Specifies the version of the script handler.
name String
The virtual machine extension name.
statuses List<InstanceViewStatusResponse>
The resource status information.
substatuses List<InstanceViewStatusResponse>
The resource status information.
type String
Specifies the type of the extension; an example is "CustomScriptExtension".
typeHandlerVersion String
Specifies the version of the script handler.
name string
The virtual machine extension name.
statuses InstanceViewStatusResponse[]
The resource status information.
substatuses InstanceViewStatusResponse[]
The resource status information.
type string
Specifies the type of the extension; an example is "CustomScriptExtension".
typeHandlerVersion string
Specifies the version of the script handler.
name str
The virtual machine extension name.
statuses Sequence[InstanceViewStatusResponse]
The resource status information.
substatuses Sequence[InstanceViewStatusResponse]
The resource status information.
type str
Specifies the type of the extension; an example is "CustomScriptExtension".
type_handler_version str
Specifies the version of the script handler.
name String
The virtual machine extension name.
statuses List<Property Map>
The resource status information.
substatuses List<Property Map>
The resource status information.
type String
Specifies the type of the extension; an example is "CustomScriptExtension".
typeHandlerVersion String
Specifies the version of the script handler.

Package Details

Repository
Azure Native pulumi/pulumi-azure-native
License
Apache-2.0
This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
Azure Native v3.2.0 published on Monday, Apr 14, 2025 by Pulumi