Azure Native v1.102.0, May 2 23

azure-native.compute.VirtualMachineScaleSetVMExtension

Explore with Pulumi AI

Describes a VMSS VM Extension. API Version: 2021-03-01.

Example Usage

Create VirtualMachineScaleSet VM extension.

using System.Collections.Generic;
using Pulumi;
using AzureNative = Pulumi.AzureNative;

return await Deployment.RunAsync(() => 
{
    var virtualMachineScaleSetVMExtension = new AzureNative.Compute.VirtualMachineScaleSetVMExtension("virtualMachineScaleSetVMExtension", new()
    {
        AutoUpgradeMinorVersion = true,
        InstanceId = "0",
        Publisher = "extPublisher",
        ResourceGroupName = "myResourceGroup",
        Settings = 
        {
            { "UserName", "xyz@microsoft.com" },
        },
        Type = "extType",
        TypeHandlerVersion = "1.2",
        VmExtensionName = "myVMExtension",
        VmScaleSetName = "myvmScaleSet",
    });

});

package main

import (
	compute "github.com/pulumi/pulumi-azure-native/sdk/go/azure/compute"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := compute.NewVirtualMachineScaleSetVMExtension(ctx, "virtualMachineScaleSetVMExtension", &compute.VirtualMachineScaleSetVMExtensionArgs{
			AutoUpgradeMinorVersion: pulumi.Bool(true),
			InstanceId:              pulumi.String("0"),
			Publisher:               pulumi.String("extPublisher"),
			ResourceGroupName:       pulumi.String("myResourceGroup"),
			Settings: pulumi.Any{
				UserName: "xyz@microsoft.com",
			},
			Type:               pulumi.String("extType"),
			TypeHandlerVersion: pulumi.String("1.2"),
			VmExtensionName:    pulumi.String("myVMExtension"),
			VmScaleSetName:     pulumi.String("myvmScaleSet"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.compute.VirtualMachineScaleSetVMExtension;
import com.pulumi.azurenative.compute.VirtualMachineScaleSetVMExtensionArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var virtualMachineScaleSetVMExtension = new VirtualMachineScaleSetVMExtension("virtualMachineScaleSetVMExtension", VirtualMachineScaleSetVMExtensionArgs.builder()        
            .autoUpgradeMinorVersion(true)
            .instanceId("0")
            .publisher("extPublisher")
            .resourceGroupName("myResourceGroup")
            .settings(Map.of("UserName", "xyz@microsoft.com"))
            .type("extType")
            .typeHandlerVersion("1.2")
            .vmExtensionName("myVMExtension")
            .vmScaleSetName("myvmScaleSet")
            .build());

    }
}

import pulumi
import pulumi_azure_native as azure_native

virtual_machine_scale_set_vm_extension = azure_native.compute.VirtualMachineScaleSetVMExtension("virtualMachineScaleSetVMExtension",
    auto_upgrade_minor_version=True,
    instance_id="0",
    publisher="extPublisher",
    resource_group_name="myResourceGroup",
    settings={
        "UserName": "xyz@microsoft.com",
    },
    type="extType",
    type_handler_version="1.2",
    vm_extension_name="myVMExtension",
    vm_scale_set_name="myvmScaleSet")

import * as pulumi from "@pulumi/pulumi";
import * as azure_native from "@pulumi/azure-native";

const virtualMachineScaleSetVMExtension = new azure_native.compute.VirtualMachineScaleSetVMExtension("virtualMachineScaleSetVMExtension", {
    autoUpgradeMinorVersion: true,
    instanceId: "0",
    publisher: "extPublisher",
    resourceGroupName: "myResourceGroup",
    settings: {
        UserName: "xyz@microsoft.com",
    },
    type: "extType",
    typeHandlerVersion: "1.2",
    vmExtensionName: "myVMExtension",
    vmScaleSetName: "myvmScaleSet",
});

resources:
  virtualMachineScaleSetVMExtension:
    type: azure-native:compute:VirtualMachineScaleSetVMExtension
    properties:
      autoUpgradeMinorVersion: true
      instanceId: '0'
      publisher: extPublisher
      resourceGroupName: myResourceGroup
      settings:
        UserName: xyz@microsoft.com
      type: extType
      typeHandlerVersion: '1.2'
      vmExtensionName: myVMExtension
      vmScaleSetName: myvmScaleSet

Create VirtualMachineScaleSetVMExtension Resource

new VirtualMachineScaleSetVMExtension(name: string, args: VirtualMachineScaleSetVMExtensionArgs, opts?: CustomResourceOptions);

@overload
def VirtualMachineScaleSetVMExtension(resource_name: str,
                                      opts: Optional[ResourceOptions] = None,
                                      auto_upgrade_minor_version: Optional[bool] = None,
                                      enable_automatic_upgrade: Optional[bool] = None,
                                      force_update_tag: Optional[str] = None,
                                      instance_id: Optional[str] = None,
                                      instance_view: Optional[VirtualMachineExtensionInstanceViewArgs] = None,
                                      protected_settings: Optional[Any] = None,
                                      publisher: Optional[str] = None,
                                      resource_group_name: Optional[str] = None,
                                      settings: Optional[Any] = None,
                                      type: Optional[str] = None,
                                      type_handler_version: Optional[str] = None,
                                      vm_extension_name: Optional[str] = None,
                                      vm_scale_set_name: Optional[str] = None)
@overload
def VirtualMachineScaleSetVMExtension(resource_name: str,
                                      args: VirtualMachineScaleSetVMExtensionArgs,
                                      opts: Optional[ResourceOptions] = None)

func NewVirtualMachineScaleSetVMExtension(ctx *Context, name string, args VirtualMachineScaleSetVMExtensionArgs, opts ...ResourceOption) (*VirtualMachineScaleSetVMExtension, error)

public VirtualMachineScaleSetVMExtension(string name, VirtualMachineScaleSetVMExtensionArgs args, CustomResourceOptions? opts = null)

public VirtualMachineScaleSetVMExtension(String name, VirtualMachineScaleSetVMExtensionArgs args)
public VirtualMachineScaleSetVMExtension(String name, VirtualMachineScaleSetVMExtensionArgs args, CustomResourceOptions options)

type: azure-native:compute:VirtualMachineScaleSetVMExtension
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

name string: The unique name of the resource.
args VirtualMachineScaleSetVMExtensionArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

resource_name str: The unique name of the resource.
args VirtualMachineScaleSetVMExtensionArgs: The arguments to resource properties.
opts ResourceOptions: Bag of options to control resource's behavior.

ctx Context: Context object for the current deployment.
name string: The unique name of the resource.
args VirtualMachineScaleSetVMExtensionArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args VirtualMachineScaleSetVMExtensionArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args VirtualMachineScaleSetVMExtensionArgs: The arguments to resource properties.
options CustomResourceOptions: Bag of options to control resource's behavior.

VirtualMachineScaleSetVMExtension Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

The VirtualMachineScaleSetVMExtension resource accepts the following input properties:

InstanceId string: The instance ID of the virtual machine.
ResourceGroupName string: The name of the resource group.
VmScaleSetName string: The name of the VM scale set.
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.Inputs.VirtualMachineExtensionInstanceViewArgs: The virtual machine extension instance view.
ProtectedSettings object: The extension can contain either protectedSettings or protectedSettingsFromKeyVault or no protected settings at all.
Publisher string: The name of the extension handler publisher.
Settings object: Json formatted public settings for the extension.
Type string: Specifies the type of the extension; an example is "CustomScriptExtension".
TypeHandlerVersion string: Specifies the version of the script handler.
VmExtensionName string: The name of the virtual machine extension.

InstanceId string: The instance ID of the virtual machine.
ResourceGroupName string: The name of the resource group.
VmScaleSetName string: The name of the VM scale set.
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 VirtualMachineExtensionInstanceViewArgs: The virtual machine extension instance view.
ProtectedSettings interface{}: The extension can contain either protectedSettings or protectedSettingsFromKeyVault or no protected settings at all.
Publisher string: The name of the extension handler publisher.
Settings interface{}: Json formatted public settings for the extension.
Type string: Specifies the type of the extension; an example is "CustomScriptExtension".
TypeHandlerVersion string: Specifies the version of the script handler.
VmExtensionName string: The name of the virtual machine extension.

instanceId String: The instance ID of the virtual machine.
resourceGroupName String: The name of the resource group.
vmScaleSetName String: The name of the VM scale set.
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 VirtualMachineExtensionInstanceViewArgs: The virtual machine extension instance view.
protectedSettings Object: The extension can contain either protectedSettings or protectedSettingsFromKeyVault or no protected settings at all.
publisher String: The name of the extension handler publisher.
settings Object: Json formatted public settings for the extension.
type String: Specifies the type of the extension; an example is "CustomScriptExtension".
typeHandlerVersion String: Specifies the version of the script handler.
vmExtensionName String: The name of the virtual machine extension.

instanceId string: The instance ID of the virtual machine.
resourceGroupName string: The name of the resource group.
vmScaleSetName string: The name of the VM scale set.
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 VirtualMachineExtensionInstanceViewArgs: The virtual machine extension instance view.
protectedSettings any: The extension can contain either protectedSettings or protectedSettingsFromKeyVault or no protected settings at all.
publisher string: The name of the extension handler publisher.
settings any: Json formatted public settings for the extension.
type string: Specifies the type of the extension; an example is "CustomScriptExtension".
typeHandlerVersion string: Specifies the version of the script handler.
vmExtensionName string: The name of the virtual machine extension.

instance_id str: The instance ID of the virtual machine.
resource_group_name str: The name of the resource group.
vm_scale_set_name str: The name of the VM scale set.
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 VirtualMachineExtensionInstanceViewArgs: The virtual machine extension instance view.
protected_settings Any: The extension can contain either protectedSettings or protectedSettingsFromKeyVault or no protected settings at all.
publisher str: The name of the extension handler publisher.
settings Any: Json formatted public settings for the extension.
type str: Specifies the type of the extension; an example is "CustomScriptExtension".
type_handler_version str: Specifies the version of the script handler.
vm_extension_name str: The name of the virtual machine extension.

instanceId String: The instance ID of the virtual machine.
resourceGroupName String: The name of the resource group.
vmScaleSetName String: The name of the VM scale set.
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.
protectedSettings Any: The extension can contain either protectedSettings or protectedSettingsFromKeyVault or no protected settings at all.
publisher String: The name of the extension handler publisher.
settings Any: Json formatted public settings for the extension.
type String: Specifies the type of the extension; an example is "CustomScriptExtension".
typeHandlerVersion String: Specifies the version of the script handler.
vmExtensionName String: The name of the virtual machine extension.

Outputs

All input properties are implicitly available as output properties. Additionally, the VirtualMachineScaleSetVMExtension resource produces the following output properties:

Id string: The provider-assigned unique ID for this managed resource.
Name string: The name of the extension.
ProvisioningState string: The provisioning state, which only appears in the response.

Id string: The provider-assigned unique ID for this managed resource.
Name string: The name of the extension.
ProvisioningState string: The provisioning state, which only appears in the response.

id String: The provider-assigned unique ID for this managed resource.
name String: The name of the extension.
provisioningState String: The provisioning state, which only appears in the response.

id string: The provider-assigned unique ID for this managed resource.
name string: The name of the extension.
provisioningState string: The provisioning state, which only appears in the response.

id str: The provider-assigned unique ID for this managed resource.
name str: The name of the extension.
provisioning_state str: The provisioning state, which only appears in the response.

id String: The provider-assigned unique ID for this managed resource.
name String: The name of the extension.
provisioningState String: The provisioning state, which only appears in the response.

Supporting Types

InstanceViewStatus

Code string: The status code.
DisplayStatus string: The short localizable label for the status.
Level Pulumi.AzureNative.Compute.StatusLevelTypes: 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 StatusLevelTypes: 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 StatusLevelTypes: 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 StatusLevelTypes: 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 StatusLevelTypes: 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 "Info" | "Warning" | "Error": The level code.
message String: The detailed status message, including for alerts and error messages.
time String: The time of the status.

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.

StatusLevelTypes

Info: Info
Warning: Warning
Error: Error

StatusLevelTypesInfo: Info
StatusLevelTypesWarning: Warning
StatusLevelTypesError: Error

Info: Info
Warning: Warning
Error: Error

Info: Info
Warning: Warning
Error: Error

INFO: Info
WARNING: Warning
ERROR: Error

"Info": Info
"Warning": Warning
"Error": Error

VirtualMachineExtensionInstanceView

Name string: The virtual machine extension name.
Statuses List<Pulumi.AzureNative.Compute.Inputs.InstanceViewStatus>: The resource status information.
Substatuses List<Pulumi.AzureNative.Compute.Inputs.InstanceViewStatus>: 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 []InstanceViewStatus: The resource status information.
Substatuses []InstanceViewStatus: 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<InstanceViewStatus>: The resource status information.
substatuses List<InstanceViewStatus>: 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 InstanceViewStatus[]: The resource status information.
substatuses InstanceViewStatus[]: 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[InstanceViewStatus]: The resource status information.
substatuses Sequence[InstanceViewStatus]: 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.

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.

Import

An existing resource can be imported using its type token, name, and identifier, e.g.

$ pulumi import azure-native:compute:VirtualMachineScaleSetVMExtension myVMExtension /subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myvmScaleSet/virtualMachines/0/extensions/myVMExtension

Package Details

Repository: Azure Native pulumi/pulumi-azure-native
License: Apache-2.0