Dedicated Host
Provides an EC2 Host resource. This allows Dedicated Hosts to be allocated, modified, and released.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
// Create a new host with instance type of c5.18xlarge with Auto Placement
// and Host Recovery enabled.
const test = new aws.ec2.DedicatedHost("test", {
instanceType: "c5.18xlarge",
availabilityZone: "us-west-2a",
hostRecovery: "on",
autoPlacement: "on",
});
import pulumi
import pulumi_aws as aws
# Create a new host with instance type of c5.18xlarge with Auto Placement
# and Host Recovery enabled.
test = aws.ec2.DedicatedHost("test",
instance_type="c5.18xlarge",
availability_zone="us-west-2a",
host_recovery="on",
auto_placement="on")
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
// Create a new host with instance type of c5.18xlarge with Auto Placement
// and Host Recovery enabled.
var test = new Aws.Ec2.DedicatedHost("test", new()
{
InstanceType = "c5.18xlarge",
AvailabilityZone = "us-west-2a",
HostRecovery = "on",
AutoPlacement = "on",
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ec2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
// Create a new host with instance type of c5.18xlarge with Auto Placement
// and Host Recovery enabled.
_, err := ec2.NewDedicatedHost(ctx, "test", &ec2.DedicatedHostArgs{
InstanceType: pulumi.String("c5.18xlarge"),
AvailabilityZone: pulumi.String("us-west-2a"),
HostRecovery: pulumi.String("on"),
AutoPlacement: pulumi.String("on"),
})
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.aws.ec2.DedicatedHost;
import com.pulumi.aws.ec2.DedicatedHostArgs;
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) {
// Create a new host with instance type of c5.18xlarge with Auto Placement
// and Host Recovery enabled.
var test = new DedicatedHost("test", DedicatedHostArgs.builder()
.instanceType("c5.18xlarge")
.availabilityZone("us-west-2a")
.hostRecovery("on")
.autoPlacement("on")
.build());
}
}
resources:
# Create a new host with instance type of c5.18xlarge with Auto Placement
# and Host Recovery enabled.
test:
type: aws:ec2:DedicatedHost
properties:
instanceType: c5.18xlarge
availabilityZone: us-west-2a
hostRecovery: on
autoPlacement: on
Import
Using pulumi import
, import hosts using the host id
. For example:
$ pulumi import aws:ec2/dedicatedHost:DedicatedHost example h-0385a99d0e4b20cbb
Properties
Indicates whether the host accepts any untargeted instance launches that match its instance type configuration, or if it only accepts Host tenancy instance launches that specify its unique host ID. Valid values: on
, off
. Default: on
.
The Availability Zone in which to allocate the Dedicated Host.
Indicates whether to enable or disable host recovery for the Dedicated Host. Valid values: on
, off
. Default: off
.
Specifies the instance family to be supported by the Dedicated Hosts. If you specify an instance family, the Dedicated Hosts support multiple instance types within that instance family. Exactly one of instance_family
or instance_type
must be specified.
Specifies the instance type to be supported by the Dedicated Hosts. If you specify an instance type, the Dedicated Hosts support instances of the specified instance type only. Exactly one of instance_family
or instance_type
must be specified.
The Amazon Resource Name (ARN) of the AWS Outpost on which to allocate the Dedicated Host.