Extension

class Extension : KotlinCustomResource

Details of a particular extension in HCI Cluster. Uses Azure REST API version 2024-04-01. In version 2.x of the Azure Native provider, it used API version 2023-03-01. Other available API versions: 2022-12-15-preview, 2023-02-01, 2023-03-01, 2023-06-01, 2023-08-01, 2023-08-01-preview, 2023-11-01-preview, 2024-01-01, 2024-02-15-preview, 2024-09-01-preview, 2024-12-01-preview. These can be accessed by generating a local SDK package using the CLI command pulumi package add azure-native azurestackhci [ApiVersion]. See the ../../../version-guide/#accessing-any-api-version-via-local-packages for details.

Example Usage

Create Arc Extension

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
var extension = new AzureNative.AzureStackHCI.Extension("extension", new()
{
ArcSettingName = "default",
ClusterName = "myCluster",
EnableAutomaticUpgrade = false,
ExtensionName = "MicrosoftMonitoringAgent",
ProtectedSettings = new Dictionary<string, object?>
{
["workspaceKey"] = "xx",
},
Publisher = "Microsoft.Compute",
ResourceGroupName = "test-rg",
Settings = new Dictionary<string, object?>
{
["workspaceId"] = "xx",
},
Type = "MicrosoftMonitoringAgent",
TypeHandlerVersion = "1.10",
});
});
package main
import (
azurestackhci "github.com/pulumi/pulumi-azure-native-sdk/azurestackhci/v2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := azurestackhci.NewExtension(ctx, "extension", &azurestackhci.ExtensionArgs{
ArcSettingName: pulumi.String("default"),
ClusterName: pulumi.String("myCluster"),
EnableAutomaticUpgrade: pulumi.Bool(false),
ExtensionName: pulumi.String("MicrosoftMonitoringAgent"),
ProtectedSettings: pulumi.Any(map[string]interface{}{
"workspaceKey": "xx",
}),
Publisher: pulumi.String("Microsoft.Compute"),
ResourceGroupName: pulumi.String("test-rg"),
Settings: pulumi.Any(map[string]interface{}{
"workspaceId": "xx",
}),
Type: pulumi.String("MicrosoftMonitoringAgent"),
TypeHandlerVersion: pulumi.String("1.10"),
})
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.azurestackhci.Extension;
import com.pulumi.azurenative.azurestackhci.ExtensionArgs;
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 extension = new Extension("extension", ExtensionArgs.builder()
.arcSettingName("default")
.clusterName("myCluster")
.enableAutomaticUpgrade(false)
.extensionName("MicrosoftMonitoringAgent")
.protectedSettings(Map.of("workspaceKey", "xx"))
.publisher("Microsoft.Compute")
.resourceGroupName("test-rg")
.settings(Map.of("workspaceId", "xx"))
.type("MicrosoftMonitoringAgent")
.typeHandlerVersion("1.10")
.build());
}
}

Import

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

$ pulumi import azure-native:azurestackhci:Extension MicrosoftMonitoringAgent /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/clusters/{clusterName}/arcSettings/{arcSettingName}/extensions/{extensionName}

Properties

Link copied to clipboard
val aggregateState: Output<String>

Aggregate state of Arc Extensions across the nodes in this HCI cluster.

Link copied to clipboard

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.

Link copied to clipboard
val azureApiVersion: Output<String>

The Azure API version of the resource.

Link copied to clipboard

Indicates whether the extension should be automatically upgraded by the platform if there is a newer version available.

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

How the extension handler should be forced to update even if the extension configuration has not changed.

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

Indicates if the extension is managed by azure or the user.

Link copied to clipboard
val name: Output<String>

The name of the resource

Link copied to clipboard

State of Arc Extension in each of the nodes.

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

Protected settings (may contain secrets).

Link copied to clipboard

Provisioning state of the Extension proxy resource.

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

The name of the extension handler publisher.

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

Json formatted public settings for the extension.

Link copied to clipboard

Azure Resource Manager metadata containing createdBy and modifiedBy information.

Link copied to clipboard
val type: Output<String>

The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

Link copied to clipboard

Specifies the version of the script handler. Latest version would be used if not specified.

Link copied to clipboard
val urn: Output<String>