DedicatedHostArgs

data class DedicatedHostArgs(val assetId: Output<String>? = null, val autoPlacement: Output<String>? = null, val availabilityZone: Output<String>? = null, val hostRecovery: Output<String>? = null, val instanceFamily: Output<String>? = null, val instanceType: Output<String>? = null, val outpostArn: Output<String>? = null, val tags: Output<Map<String, String>>? = null) : ConvertibleToJava<DedicatedHostArgs>

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

Constructors

Link copied to clipboard
constructor(assetId: Output<String>? = null, autoPlacement: Output<String>? = null, availabilityZone: Output<String>? = null, hostRecovery: Output<String>? = null, instanceFamily: Output<String>? = null, instanceType: Output<String>? = null, outpostArn: Output<String>? = null, tags: Output<Map<String, String>>? = null)

Properties

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

The ID of the Outpost hardware asset on which to allocate the Dedicated Hosts. This parameter is supported only if you specify OutpostArn. If you are allocating the Dedicated Hosts in a Region, omit this parameter.

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

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.

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

The Availability Zone in which to allocate the Dedicated Host.

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

Indicates whether to enable or disable host recovery for the Dedicated Host. Valid values: on, off. Default: off.

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

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.

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

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.

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

The Amazon Resource Name (ARN) of the AWS Outpost on which to allocate the Dedicated Host.

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

Map of tags to assign to this resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

Functions

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