Dedicated
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",
},
});
});package main
import (
compute "github.com/pulumi/pulumi-azure-native-sdk/compute/v3"
"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/v3"
"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
Enables or disables a capability on the dedicated host group. Minimum api-version: 2022-03-01.
The Azure API version of the resource.
A list of references to all dedicated hosts in the dedicated host group.
The dedicated host group instance view, which has the list of instance view of the dedicated hosts under the dedicated host group.
Number of fault domains that the host group can span.
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.