pulumi-azure-kotlin/com.pulumi.azure.stack.kotlin/HciExtension

HciExtension

class HciExtension : KotlinCustomResource

Manages an Azure Stack HCI Extension.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as azure from "@pulumi/azure";
const example = new azure.core.ResourceGroup("example", {
    name: "example-hci-ext",
    location: "West Europe",
});
const exampleHciExtension = new azure.stack.HciExtension("example", {
    name: "AzureMonitorWindowsAgent",
    arcSettingId: "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/example-hci/providers/Microsoft.AzureStackHCI/clusters/hci-cl/arcSettings/default",
    publisher: "Microsoft.Azure.Monitor",
    type: "MicrosoftMonitoringAgent",
    autoUpgradeMinorVersionEnabled: true,
    automaticUpgradeEnabled: true,
    typeHandlerVersion: "1.22.0",
});
Content copied to clipboard
import pulumi
import pulumi_azure as azure
example = azure.core.ResourceGroup("example",
    name="example-hci-ext",
    location="West Europe")
example_hci_extension = azure.stack.HciExtension("example",
    name="AzureMonitorWindowsAgent",
    arc_setting_id="/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/example-hci/providers/Microsoft.AzureStackHCI/clusters/hci-cl/arcSettings/default",
    publisher="Microsoft.Azure.Monitor",
    type="MicrosoftMonitoringAgent",
    auto_upgrade_minor_version_enabled=True,
    automatic_upgrade_enabled=True,
    type_handler_version="1.22.0")
Content copied to clipboard
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Azure = Pulumi.Azure;
return await Deployment.RunAsync(() =>
{
    var example = new Azure.Core.ResourceGroup("example", new()
    {
        Name = "example-hci-ext",
        Location = "West Europe",
    });
    var exampleHciExtension = new Azure.Stack.HciExtension("example", new()
    {
        Name = "AzureMonitorWindowsAgent",
        ArcSettingId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/example-hci/providers/Microsoft.AzureStackHCI/clusters/hci-cl/arcSettings/default",
        Publisher = "Microsoft.Azure.Monitor",
        Type = "MicrosoftMonitoringAgent",
        AutoUpgradeMinorVersionEnabled = true,
        AutomaticUpgradeEnabled = true,
        TypeHandlerVersion = "1.22.0",
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-azure/sdk/v6/go/azure/core"
	"github.com/pulumi/pulumi-azure/sdk/v6/go/azure/stack"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := core.NewResourceGroup(ctx, "example", &core.ResourceGroupArgs{
			Name:     pulumi.String("example-hci-ext"),
			Location: pulumi.String("West Europe"),
		})
		if err != nil {
			return err
		}
		_, err = stack.NewHciExtension(ctx, "example", &stack.HciExtensionArgs{
			Name:                           pulumi.String("AzureMonitorWindowsAgent"),
			ArcSettingId:                   pulumi.String("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/example-hci/providers/Microsoft.AzureStackHCI/clusters/hci-cl/arcSettings/default"),
			Publisher:                      pulumi.String("Microsoft.Azure.Monitor"),
			Type:                           pulumi.String("MicrosoftMonitoringAgent"),
			AutoUpgradeMinorVersionEnabled: pulumi.Bool(true),
			AutomaticUpgradeEnabled:        pulumi.Bool(true),
			TypeHandlerVersion:             pulumi.String("1.22.0"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azure.core.ResourceGroup;
import com.pulumi.azure.core.ResourceGroupArgs;
import com.pulumi.azure.stack.HciExtension;
import com.pulumi.azure.stack.HciExtensionArgs;
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 example = new ResourceGroup("example", ResourceGroupArgs.builder()
            .name("example-hci-ext")
            .location("West Europe")
            .build());
        var exampleHciExtension = new HciExtension("exampleHciExtension", HciExtensionArgs.builder()
            .name("AzureMonitorWindowsAgent")
            .arcSettingId("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/example-hci/providers/Microsoft.AzureStackHCI/clusters/hci-cl/arcSettings/default")
            .publisher("Microsoft.Azure.Monitor")
            .type("MicrosoftMonitoringAgent")
            .autoUpgradeMinorVersionEnabled(true)
            .automaticUpgradeEnabled(true)
            .typeHandlerVersion("1.22.0")
            .build());
    }
}
Content copied to clipboard
resources:
  example:
    type: azure:core:ResourceGroup
    properties:
      name: example-hci-ext
      location: West Europe
  exampleHciExtension:
    type: azure:stack:HciExtension
    name: example
    properties:
      name: AzureMonitorWindowsAgent
      arcSettingId: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/example-hci/providers/Microsoft.AzureStackHCI/clusters/hci-cl/arcSettings/default
      publisher: Microsoft.Azure.Monitor
      type: MicrosoftMonitoringAgent
      autoUpgradeMinorVersionEnabled: true
      automaticUpgradeEnabled: true
      typeHandlerVersion: 1.22.0
Content copied to clipboard

API Providers

This resource uses the following Azure API Providers:

  • Microsoft.AzureStackHCI: 2024-01-01

Import

Azure Stack HCI Extension can be imported using the resource id, e.g.

$ pulumi import azure:stack/hciExtension:HciExtension example /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.AzureStackHCI/clusters/cluster1/arcSettings/default/extensions/extension1
Content copied to clipboard

Properties

Link copied to clipboard
val arcSettingId: Output<String>

The ID of the Azure Stack HCI Cluster Arc Setting. Changing this forces a new resource to be created.

Link copied to clipboard
val automaticUpgradeEnabled: Output<Boolean>?

Indicates whether the extension should be automatically upgraded by the platform if there is a newer version available. Possible values are true and false. Defaults to true.

Link copied to clipboard
val autoUpgradeMinorVersionEnabled: Output<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. Changing this forces a new resource to be created. Possible values are true and false. Defaults to true.

Link copied to clipboard
val id: Output<String>
Link copied to clipboard
val name: Output<String>

The name which should be used for this Azure Stack HCI Extension. Changing this forces a new resource to be created.

Link copied to clipboard
val protectedSettings: Output<String>?

The json formatted protected settings for the extension.

Link copied to clipboard
val publisher: Output<String>

The name of the extension handler publisher, such as Microsoft.Azure.Monitor. Changing this forces a new resource to be created.

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val settings: Output<String>?

The json formatted public settings for the extension.

Link copied to clipboard
val type: Output<String>

Specifies the type of the extension. For example CustomScriptExtension or AzureMonitorLinuxAgent. Changing this forces a new resource to be created.

Link copied to clipboard
val typeHandlerVersion: Output<String>?

Specifies the version of the script handler.

Link copied to clipboard
val urn: Output<String>