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

DedicatedHostGroup

class DedicatedHostGroup : KotlinCustomResource

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 2023-03-01. In version 1.x of the Azure Native provider, it used API version 2020-12-01. Other available API versions: 2023-07-01, 2023-09-01, 2024-03-01, 2024-07-01, 2024-11-01.

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",
        },
    });
});

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
	})
}

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());
    }
}

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",
        },
    });
});

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
	})
}

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());
    }
}

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}

Properties

additionalCapabilities

val additionalCapabilities: Output<DedicatedHostGroupPropertiesResponseAdditionalCapabilities>?

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

hosts

val hosts: Output<List<SubResourceReadOnlyResponse>>

A list of references to all dedicated hosts in the dedicated host group.

val id: Output<String>

instanceView

val instanceView: Output<DedicatedHostGroupInstanceViewResponse>

The dedicated host group instance view, which has the list of instance view of the dedicated hosts under the dedicated host group.

location

val location: Output<String>

Resource location

name

val name: Output<String>

Resource name

platformFaultDomainCount

val platformFaultDomainCount: Output<Int>

Number of fault domains that the host group can span.

pulumiChildResources

val pulumiChildResources: Set<KotlinResource>

pulumiResourceName

val pulumiResourceName: String

pulumiResourceType

val pulumiResourceType: String

supportAutomaticPlacement

val supportAutomaticPlacement: Output<Boolean>?

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.