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

DedicatedHost

class DedicatedHost : KotlinCustomResource

Specifies information about the Dedicated host. 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 .

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
    var dedicatedHost = new AzureNative.Compute.DedicatedHost("dedicatedHost", new()
    {
        HostGroupName = "myDedicatedHostGroup",
        HostName = "myDedicatedHost",
        Location = "westus",
        PlatformFaultDomain = 1,
        ResourceGroupName = "myResourceGroup",
        Sku = new AzureNative.Compute.Inputs.SkuArgs
        {
            Name = "DSv3-Type1",
        },
        Tags =
        {
            { "department", "HR" },
        },
    });
});

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.NewDedicatedHost(ctx, "dedicatedHost", &compute.DedicatedHostArgs{
			HostGroupName:       pulumi.String("myDedicatedHostGroup"),
			HostName:            pulumi.String("myDedicatedHost"),
			Location:            pulumi.String("westus"),
			PlatformFaultDomain: pulumi.Int(1),
			ResourceGroupName:   pulumi.String("myResourceGroup"),
			Sku: &compute.SkuArgs{
				Name: pulumi.String("DSv3-Type1"),
			},
			Tags: pulumi.StringMap{
				"department": pulumi.String("HR"),
			},
		})
		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.DedicatedHost;
import com.pulumi.azurenative.compute.DedicatedHostArgs;
import com.pulumi.azurenative.compute.inputs.SkuArgs;
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 dedicatedHost = new DedicatedHost("dedicatedHost", DedicatedHostArgs.builder()
            .hostGroupName("myDedicatedHostGroup")
            .hostName("myDedicatedHost")
            .location("westus")
            .platformFaultDomain(1)
            .resourceGroupName("myResourceGroup")
            .sku(SkuArgs.builder()
                .name("DSv3-Type1")
                .build())
            .tags(Map.of("department", "HR"))
            .build());
    }
}

Import

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

$ pulumi import azure-native:compute:DedicatedHost myDedicatedHost /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}/hosts/{hostName}

Properties

autoReplaceOnFailure

val autoReplaceOnFailure: Output<Boolean>?

Specifies whether the dedicated host should be replaced automatically in case of a failure. The value is defaulted to 'true' when not provided.

azureApiVersion

val azureApiVersion: Output<String>

The Azure API version of the resource.

hostId

val hostId: Output<String>

A unique id generated and assigned to the dedicated host by the platform. Does not change throughout the lifetime of the host.

val id: Output<String>

instanceView

val instanceView: Output<DedicatedHostInstanceViewResponse>

The dedicated host instance view.

licenseType

val licenseType: Output<String>?

Specifies the software license type that will be applied to the VMs deployed on the dedicated host. Possible values are: None, Windows_Server_Hybrid, Windows_Server_Perpetual. The default value is: None.

location

val location: Output<String>

Resource location

name

val name: Output<String>

Resource name

platformFaultDomain

val platformFaultDomain: Output<Int>?

Fault domain of the dedicated host within a dedicated host group.

provisioningState

val provisioningState: Output<String>

The provisioning state, which only appears in the response.

provisioningTime

val provisioningTime: Output<String>

The date when the host was first provisioned.

pulumiChildResources

val pulumiChildResources: Set<KotlinResource>

pulumiResourceName

val pulumiResourceName: String

pulumiResourceType

val pulumiResourceType: String

sku

val sku: Output<SkuResponse>

SKU of the dedicated host for Hardware Generation and VM family. Only name is required to be set. List Microsoft.Compute SKUs for a list of possible values.