pulumi-azure-native-kotlin/com.pulumi.azurenative.compute.kotlin/DedicatedHostGroupArgs

DedicatedHostGroupArgs

data class DedicatedHostGroupArgs(val additionalCapabilities: Output<DedicatedHostGroupPropertiesAdditionalCapabilitiesArgs>? = null, val hostGroupName: Output<String>? = null, val location: Output<String>? = null, val platformFaultDomainCount: Output<Int>? = null, val resourceGroupName: Output<String>? = null, val supportAutomaticPlacement: Output<Boolean>? = null, val tags: Output<Map<String, String>>? = null, val zones: Output<List<String>>? = null) : ConvertibleToJava<DedicatedHostGroupArgs>

Specifies information about the dedicated host group that the dedicated hosts should be assigned to. Currently, a dedicated host can only be added to a dedicated host group at creation time. An existing dedicated host cannot be added to another dedicated host group. Uses Azure REST API version 2024-11-01. In version 2.x of the Azure Native provider, it used API version 2023-03-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/#accessing-any-api-version-via-local-packages for details.

Example Usage

Create or update a dedicated host group with Ultra SSD support.

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
    var dedicatedHostGroup = new AzureNative.Compute.DedicatedHostGroup("dedicatedHostGroup", new()
    {
        AdditionalCapabilities = new AzureNative.Compute.Inputs.DedicatedHostGroupPropertiesAdditionalCapabilitiesArgs
        {
            UltraSSDEnabled = true,
        },
        HostGroupName = "myDedicatedHostGroup",
        Location = "westus",
        PlatformFaultDomainCount = 3,
        ResourceGroupName = "myResourceGroup",
        SupportAutomaticPlacement = true,
        Tags =
        {
            { "department", "finance" },
        },
        Zones = new[]
        {
            "1",
        },
    });
});
Content copied to clipboard
package main
import (
	compute "github.com/pulumi/pulumi-azure-native-sdk/compute/v2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := compute.NewDedicatedHostGroup(ctx, "dedicatedHostGroup", &compute.DedicatedHostGroupArgs{
			AdditionalCapabilities: &compute.DedicatedHostGroupPropertiesAdditionalCapabilitiesArgs{
				UltraSSDEnabled: pulumi.Bool(true),
			},
			HostGroupName:             pulumi.String("myDedicatedHostGroup"),
			Location:                  pulumi.String("westus"),
			PlatformFaultDomainCount:  pulumi.Int(3),
			ResourceGroupName:         pulumi.String("myResourceGroup"),
			SupportAutomaticPlacement: pulumi.Bool(true),
			Tags: pulumi.StringMap{
				"department": pulumi.String("finance"),
			},
			Zones: pulumi.StringArray{
				pulumi.String("1"),
			},
		})
		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.azurenative.compute.DedicatedHostGroup;
import com.pulumi.azurenative.compute.DedicatedHostGroupArgs;
import com.pulumi.azurenative.compute.inputs.DedicatedHostGroupPropertiesAdditionalCapabilitiesArgs;
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 dedicatedHostGroup = new DedicatedHostGroup("dedicatedHostGroup", DedicatedHostGroupArgs.builder()
            .additionalCapabilities(DedicatedHostGroupPropertiesAdditionalCapabilitiesArgs.builder()
                .ultraSSDEnabled(true)
                .build())
            .hostGroupName("myDedicatedHostGroup")
            .location("westus")
            .platformFaultDomainCount(3)
            .resourceGroupName("myResourceGroup")
            .supportAutomaticPlacement(true)
            .tags(Map.of("department", "finance"))
            .zones("1")
            .build());
    }
}
Content copied to clipboard

Create or update a dedicated host group.

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
    var dedicatedHostGroup = new AzureNative.Compute.DedicatedHostGroup("dedicatedHostGroup", new()
    {
        HostGroupName = "myDedicatedHostGroup",
        Location = "westus",
        PlatformFaultDomainCount = 3,
        ResourceGroupName = "myResourceGroup",
        SupportAutomaticPlacement = true,
        Tags =
        {
            { "department", "finance" },
        },
        Zones = new[]
        {
            "1",
        },
    });
});
Content copied to clipboard
package main
import (
	compute "github.com/pulumi/pulumi-azure-native-sdk/compute/v2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := compute.NewDedicatedHostGroup(ctx, "dedicatedHostGroup", &compute.DedicatedHostGroupArgs{
			HostGroupName:             pulumi.String("myDedicatedHostGroup"),
			Location:                  pulumi.String("westus"),
			PlatformFaultDomainCount:  pulumi.Int(3),
			ResourceGroupName:         pulumi.String("myResourceGroup"),
			SupportAutomaticPlacement: pulumi.Bool(true),
			Tags: pulumi.StringMap{
				"department": pulumi.String("finance"),
			},
			Zones: pulumi.StringArray{
				pulumi.String("1"),
			},
		})
		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.azurenative.compute.DedicatedHostGroup;
import com.pulumi.azurenative.compute.DedicatedHostGroupArgs;
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 dedicatedHostGroup = new DedicatedHostGroup("dedicatedHostGroup", DedicatedHostGroupArgs.builder()
            .hostGroupName("myDedicatedHostGroup")
            .location("westus")
            .platformFaultDomainCount(3)
            .resourceGroupName("myResourceGroup")
            .supportAutomaticPlacement(true)
            .tags(Map.of("department", "finance"))
            .zones("1")
            .build());
    }
}
Content copied to clipboard

Import

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

$ pulumi import azure-native:compute:DedicatedHostGroup myDedicatedHostGroup /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}
Content copied to clipboard

Constructors

Link copied to clipboard
constructor(additionalCapabilities: Output<DedicatedHostGroupPropertiesAdditionalCapabilitiesArgs>? = null, hostGroupName: Output<String>? = null, location: Output<String>? = null, platformFaultDomainCount: Output<Int>? = null, resourceGroupName: Output<String>? = null, supportAutomaticPlacement: Output<Boolean>? = null, tags: Output<Map<String, String>>? = null, zones: Output<List<String>>? = null)

Properties

Link copied to clipboard
val additionalCapabilities: Output<DedicatedHostGroupPropertiesAdditionalCapabilitiesArgs>? = null

Enables or disables a capability on the dedicated host group. Minimum api-version: 2022-03-01.

Link copied to clipboard
val hostGroupName: Output<String>? = null

The name of the dedicated host group.

Link copied to clipboard
val location: Output<String>? = null

Resource location

Link copied to clipboard
val platformFaultDomainCount: Output<Int>? = null

Number of fault domains that the host group can span.

Link copied to clipboard
val resourceGroupName: Output<String>? = null

The name of the resource group.

Link copied to clipboard
val supportAutomaticPlacement: Output<Boolean>? = null

Specifies whether virtual machines or virtual machine scale sets can be placed automatically on the dedicated host group. Automatic placement means resources are allocated on dedicated hosts, that are chosen by Azure, under the dedicated host group. The value is defaulted to 'false' when not provided. Minimum api-version: 2020-06-01.

Link copied to clipboard
val tags: Output<Map<String, String>>? = null

Resource tags

Link copied to clipboard
val zones: Output<List<String>>? = null

Availability Zone to use for this host group. Only single zone is supported. The zone can be assigned only during creation. If not provided, the group supports all zones in the region. If provided, enforces each host in the group to be in the same zone.

Functions

Link copied to clipboard
open override fun toJava(): DedicatedHostGroupArgs