This is the latest version of Azure Native. Use the Azure Native v1 docs if using the v1 version of this package.
Azure Native v2.89.1 published on Sunday, Mar 2, 2025 by Pulumi
azure-native.compute.getVirtualMachineExtension
Explore with Pulumi AI
This is the latest version of Azure Native. Use the Azure Native v1 docs if using the v1 version of this package.
Azure Native v2.89.1 published on Sunday, Mar 2, 2025 by Pulumi
The operation to get the extension. Azure REST API version: 2023-03-01.
Other available API versions: 2021-11-01, 2023-07-01, 2023-09-01, 2024-03-01, 2024-07-01.
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>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]func LookupVirtualMachineExtension(ctx *Context, args *LookupVirtualMachineExtensionArgs, opts ...InvokeOption) (*LookupVirtualMachineExtensionResult, error)
func LookupVirtualMachineExtensionOutput(ctx *Context, args *LookupVirtualMachineExtensionOutputArgs, opts ...InvokeOption) LookupVirtualMachineExtensionResultOutput> 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)
}public static CompletableFuture<GetVirtualMachineExtensionResult> getVirtualMachineExtension(GetVirtualMachineExtensionArgs args, InvokeOptions options)
public static Output<GetVirtualMachineExtensionResult> getVirtualMachineExtension(GetVirtualMachineExtensionArgs args, InvokeOptions options)
fn::invoke:
  function: azure-native:compute:getVirtualMachineExtension
  arguments:
    # arguments dictionaryThe following arguments are supported:
- ResourceGroup stringName 
- The name of the resource group.
- VmExtension stringName 
- The name of the virtual machine extension.
- VmName string
- The name of the virtual machine containing the extension.
- Expand string
- The expand expression to apply on the operation.
- ResourceGroup stringName 
- The name of the resource group.
- VmExtension stringName 
- The name of the virtual machine extension.
- VmName string
- The name of the virtual machine containing the extension.
- Expand string
- The expand expression to apply on the operation.
- resourceGroup StringName 
- The name of the resource group.
- vmExtension StringName 
- The name of the virtual machine extension.
- vmName String
- The name of the virtual machine containing the extension.
- expand String
- The expand expression to apply on the operation.
- resourceGroup stringName 
- The name of the resource group.
- vmExtension stringName 
- The name of the virtual machine extension.
- vmName string
- The name of the virtual machine containing the extension.
- expand string
- The expand expression to apply on the operation.
- resource_group_ strname 
- The name of the resource group.
- vm_extension_ strname 
- The name of the virtual machine extension.
- vm_name str
- The name of the virtual machine containing the extension.
- expand str
- The expand expression to apply on the operation.
- resourceGroup StringName 
- The name of the resource group.
- vmExtension StringName 
- The name of the virtual machine extension.
- vmName 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:
- Id string
- Resource Id
- Name string
- Resource name
- ProvisioningState string
- The provisioning state, which only appears in the response.
- Type string
- Resource type
- AutoUpgrade boolMinor Version 
- 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.
- EnableAutomatic boolUpgrade 
- Indicates whether the extension should be automatically upgraded by the platform if there is a newer version of the extension available.
- ForceUpdate stringTag 
- How the extension handler should be forced to update even if the extension configuration has not changed.
- InstanceView Pulumi.Azure Native. Compute. Outputs. Virtual Machine Extension Instance View Response 
- 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.
- ProtectedSettings Pulumi.From Key Vault Azure Native. Compute. Outputs. Key Vault Secret Reference Response 
- The extensions protected settings that are passed by reference, and consumed from key vault
- ProvisionAfter List<string>Extensions 
- 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.
- Dictionary<string, string>
- Resource tags
- TypeHandler stringVersion 
- Specifies the version of the script handler.
- Id string
- Resource Id
- Name string
- Resource name
- ProvisioningState string
- The provisioning state, which only appears in the response.
- Type string
- Resource type
- AutoUpgrade boolMinor Version 
- 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.
- EnableAutomatic boolUpgrade 
- Indicates whether the extension should be automatically upgraded by the platform if there is a newer version of the extension available.
- ForceUpdate stringTag 
- How the extension handler should be forced to update even if the extension configuration has not changed.
- InstanceView VirtualMachine Extension Instance View Response 
- 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.
- ProtectedSettings KeyFrom Key Vault Vault Secret Reference Response 
- The extensions protected settings that are passed by reference, and consumed from key vault
- ProvisionAfter []stringExtensions 
- 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.
- map[string]string
- Resource tags
- TypeHandler stringVersion 
- Specifies the version of the script handler.
- id String
- Resource Id
- name String
- Resource name
- provisioningState String
- The provisioning state, which only appears in the response.
- type String
- Resource type
- autoUpgrade BooleanMinor Version 
- 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.
- enableAutomatic BooleanUpgrade 
- Indicates whether the extension should be automatically upgraded by the platform if there is a newer version of the extension available.
- forceUpdate StringTag 
- How the extension handler should be forced to update even if the extension configuration has not changed.
- instanceView VirtualMachine Extension Instance View Response 
- 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.
- protectedSettings KeyFrom Key Vault Vault Secret Reference Response 
- The extensions protected settings that are passed by reference, and consumed from key vault
- provisionAfter List<String>Extensions 
- 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.
- Map<String,String>
- Resource tags
- typeHandler StringVersion 
- Specifies the version of the script handler.
- id string
- Resource Id
- name string
- Resource name
- provisioningState string
- The provisioning state, which only appears in the response.
- type string
- Resource type
- autoUpgrade booleanMinor Version 
- 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.
- enableAutomatic booleanUpgrade 
- Indicates whether the extension should be automatically upgraded by the platform if there is a newer version of the extension available.
- forceUpdate stringTag 
- How the extension handler should be forced to update even if the extension configuration has not changed.
- instanceView VirtualMachine Extension Instance View Response 
- 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.
- protectedSettings KeyFrom Key Vault Vault Secret Reference Response 
- The extensions protected settings that are passed by reference, and consumed from key vault
- provisionAfter string[]Extensions 
- 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.
- {[key: string]: string}
- Resource tags
- typeHandler stringVersion 
- Specifies the version of the script handler.
- 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_ boolminor_ version 
- 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_ boolupgrade 
- Indicates whether the extension should be automatically upgraded by the platform if there is a newer version of the extension available.
- force_update_ strtag 
- How the extension handler should be forced to update even if the extension configuration has not changed.
- instance_view VirtualMachine Extension Instance View Response 
- 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_ Keyfrom_ key_ vault Vault Secret Reference Response 
- The extensions protected settings that are passed by reference, and consumed from key vault
- provision_after_ Sequence[str]extensions 
- 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.
- Mapping[str, str]
- Resource tags
- type_handler_ strversion 
- Specifies the version of the script handler.
- id String
- Resource Id
- name String
- Resource name
- provisioningState String
- The provisioning state, which only appears in the response.
- type String
- Resource type
- autoUpgrade BooleanMinor Version 
- 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.
- enableAutomatic BooleanUpgrade 
- Indicates whether the extension should be automatically upgraded by the platform if there is a newer version of the extension available.
- forceUpdate StringTag 
- 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.
- protectedSettings Property MapFrom Key Vault 
- The extensions protected settings that are passed by reference, and consumed from key vault
- provisionAfter List<String>Extensions 
- 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.
- Map<String>
- Resource tags
- typeHandler StringVersion 
- 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 string
- The URL referencing a secret in a Key Vault.
- SourceVault Pulumi.Azure Native. Compute. Inputs. Sub Resource Response 
- The relative URL of the Key Vault containing the secret.
- SecretUrl string
- The URL referencing a secret in a Key Vault.
- SourceVault SubResource Response 
- The relative URL of the Key Vault containing the secret.
- secretUrl String
- The URL referencing a secret in a Key Vault.
- sourceVault SubResource Response 
- The relative URL of the Key Vault containing the secret.
- secretUrl string
- The URL referencing a secret in a Key Vault.
- sourceVault SubResource Response 
- The relative URL of the Key Vault containing the secret.
- secret_url str
- The URL referencing a secret in a Key Vault.
- source_vault SubResource Response 
- The relative URL of the Key Vault containing the secret.
- secretUrl String
- The URL referencing a secret in a Key Vault.
- sourceVault 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.Azure Native. Compute. Inputs. Instance View Status Response> 
- The resource status information.
- Substatuses
List<Pulumi.Azure Native. Compute. Inputs. Instance View Status Response> 
- The resource status information.
- Type string
- Specifies the type of the extension; an example is "CustomScriptExtension".
- TypeHandler stringVersion 
- Specifies the version of the script handler.
- Name string
- The virtual machine extension name.
- Statuses
[]InstanceView Status Response 
- The resource status information.
- Substatuses
[]InstanceView Status Response 
- The resource status information.
- Type string
- Specifies the type of the extension; an example is "CustomScriptExtension".
- TypeHandler stringVersion 
- Specifies the version of the script handler.
- name String
- The virtual machine extension name.
- statuses
List<InstanceView Status Response> 
- The resource status information.
- substatuses
List<InstanceView Status Response> 
- The resource status information.
- type String
- Specifies the type of the extension; an example is "CustomScriptExtension".
- typeHandler StringVersion 
- Specifies the version of the script handler.
- name string
- The virtual machine extension name.
- statuses
InstanceView Status Response[] 
- The resource status information.
- substatuses
InstanceView Status Response[] 
- The resource status information.
- type string
- Specifies the type of the extension; an example is "CustomScriptExtension".
- typeHandler stringVersion 
- Specifies the version of the script handler.
- name str
- The virtual machine extension name.
- statuses
Sequence[InstanceView Status Response] 
- The resource status information.
- substatuses
Sequence[InstanceView Status Response] 
- The resource status information.
- type str
- Specifies the type of the extension; an example is "CustomScriptExtension".
- type_handler_ strversion 
- 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".
- typeHandler StringVersion 
- 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 v1 docs if using the v1 version of this package.
Azure Native v2.89.1 published on Sunday, Mar 2, 2025 by Pulumi