getDedicatedHost

AWS v7.34.0, Jun 16 26

Viewing docs for AWS v7.34.0
published on Tuesday, Jun 16, 2026 by Pulumi

Schema (JSON)

pulumi/pulumi-aws

Viewing docs for AWS v7.34.0
published on Tuesday, Jun 16, 2026 by Pulumi

Schema (JSON)

pulumi/pulumi-aws

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const testDedicatedHost = new aws.ec2.DedicatedHost("test", {
    instanceType: "c5.18xlarge",
    availabilityZone: "us-west-2a",
});
const test = aws.ec2.getDedicatedHostOutput({
    hostId: testDedicatedHost.id,
});

import pulumi
import pulumi_aws as aws

test_dedicated_host = aws.ec2.DedicatedHost("test",
    instance_type="c5.18xlarge",
    availability_zone="us-west-2a")
test = aws.ec2.get_dedicated_host_output(host_id=test_dedicated_host.id)

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/ec2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		testDedicatedHost, err := ec2.NewDedicatedHost(ctx, "test", &ec2.DedicatedHostArgs{
			InstanceType:     pulumi.String("c5.18xlarge"),
			AvailabilityZone: pulumi.String("us-west-2a"),
		})
		if err != nil {
			return err
		}
		_ = ec2.LookupDedicatedHostOutput(ctx, ec2.GetDedicatedHostOutputArgs{
			HostId: testDedicatedHost.ID(),
		}, nil)
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var testDedicatedHost = new Aws.Ec2.DedicatedHost("test", new()
    {
        InstanceType = "c5.18xlarge",
        AvailabilityZone = "us-west-2a",
    });

    var test = Aws.Ec2.GetDedicatedHost.Invoke(new()
    {
        HostId = testDedicatedHost.Id,
    });

});

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 com.pulumi.aws.ec2.Ec2Functions;
import com.pulumi.aws.ec2.inputs.GetDedicatedHostArgs;
import java.util.ArrayList;
import java.util.Arrays;
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 testDedicatedHost = new DedicatedHost("testDedicatedHost", DedicatedHostArgs.builder()
            .instanceType("c5.18xlarge")
            .availabilityZone("us-west-2a")
            .build());

        final var test = Ec2Functions.getDedicatedHost(GetDedicatedHostArgs.builder()
            .hostId(testDedicatedHost.id())
            .build());

    }
}

resources:
  testDedicatedHost:
    type: aws:ec2:DedicatedHost
    name: test
    properties:
      instanceType: c5.18xlarge
      availabilityZone: us-west-2a
variables:
  test:
    fn::invoke:
      function: aws:ec2:getDedicatedHost
      arguments:
        hostId: ${testDedicatedHost.id}

pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

data "aws_ec2_getdedicatedhost" "test" {
  host_id = aws_ec2_dedicatedhost.test.id
}

resource "aws_ec2_dedicatedhost" "test" {
  instance_type     = "c5.18xlarge"
  availability_zone = "us-west-2a"
}

Filter Example

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const test = aws.ec2.getDedicatedHost({
    filters: [{
        name: "instance-type",
        values: ["c5.18xlarge"],
    }],
});

import pulumi
import pulumi_aws as aws

test = aws.ec2.get_dedicated_host(filters=[{
    "name": "instance-type",
    "values": ["c5.18xlarge"],
}])

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/ec2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ec2.LookupDedicatedHost(ctx, &ec2.LookupDedicatedHostArgs{
			Filters: []ec2.GetDedicatedHostFilter{
				{
					Name: "instance-type",
					Values: []string{
						"c5.18xlarge",
					},
				},
			},
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var test = Aws.Ec2.GetDedicatedHost.Invoke(new()
    {
        Filters = new[]
        {
            new Aws.Ec2.Inputs.GetDedicatedHostFilterInputArgs
            {
                Name = "instance-type",
                Values = new[]
                {
                    "c5.18xlarge",
                },
            },
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ec2.Ec2Functions;
import com.pulumi.aws.ec2.inputs.GetDedicatedHostArgs;
import com.pulumi.aws.ec2.inputs.GetDedicatedHostFilterArgs;
import java.util.ArrayList;
import java.util.Arrays;
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) {
        final var test = Ec2Functions.getDedicatedHost(GetDedicatedHostArgs.builder()
            .filters(GetDedicatedHostFilterArgs.builder()
                .name("instance-type")
                .values("c5.18xlarge")
                .build())
            .build());

    }
}

variables:
  test:
    fn::invoke:
      function: aws:ec2:getDedicatedHost
      arguments:
        filters:
          - name: instance-type
            values:
              - c5.18xlarge

pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

data "aws_ec2_getdedicatedhost" "test" {
  filters {
    name   = "instance-type"
    values = ["c5.18xlarge"]
  }
}

Using getDedicatedHost

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getDedicatedHost(args: GetDedicatedHostArgs, opts?: InvokeOptions): Promise<GetDedicatedHostResult>
function getDedicatedHostOutput(args: GetDedicatedHostOutputArgs, opts?: InvokeOptions): Output<GetDedicatedHostResult>

def get_dedicated_host(filters: Optional[Sequence[GetDedicatedHostFilter]] = None,
                       host_id: Optional[str] = None,
                       region: Optional[str] = None,
                       tags: Optional[Mapping[str, str]] = None,
                       opts: Optional[InvokeOptions] = None) -> GetDedicatedHostResult
def get_dedicated_host_output(filters: pulumi.Input[Optional[Sequence[pulumi.Input[GetDedicatedHostFilterArgs]]]] = None,
                       host_id: pulumi.Input[Optional[str]] = None,
                       region: pulumi.Input[Optional[str]] = None,
                       tags: pulumi.Input[Optional[Mapping[str, pulumi.Input[str]]]] = None,
                       opts: Optional[InvokeOptions] = None) -> Output[GetDedicatedHostResult]

func LookupDedicatedHost(ctx *Context, args *LookupDedicatedHostArgs, opts ...InvokeOption) (*LookupDedicatedHostResult, error)
func LookupDedicatedHostOutput(ctx *Context, args *LookupDedicatedHostOutputArgs, opts ...InvokeOption) LookupDedicatedHostResultOutput

> Note: This function is named LookupDedicatedHost in the Go SDK.

public static class GetDedicatedHost 
{
    public static Task<GetDedicatedHostResult> InvokeAsync(GetDedicatedHostArgs args, InvokeOptions? opts = null)
    public static Output<GetDedicatedHostResult> Invoke(GetDedicatedHostInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetDedicatedHostResult> getDedicatedHost(GetDedicatedHostArgs args, InvokeOptions options)
public static Output<GetDedicatedHostResult> getDedicatedHost(GetDedicatedHostArgs args, InvokeOptions options)

fn::invoke:
  function: aws:ec2/getDedicatedHost:getDedicatedHost
  arguments:
    # arguments dictionary

data "aws_ec2_getdedicatedhost" "name" {
    # arguments
}

The following arguments are supported:

Filters List<GetDedicatedHostFilter>

Configuration block. Detailed below.

HostId string

ID of the Dedicated Host.

The arguments of this data source act as filters for querying the available EC2 Hosts in the current region. The given filters must match exactly one host whose data will be exported as attributes.

Region string

Region where this resource will be managed. Defaults to the Region set in the provider configuration.

Tags Dictionary<string, string>

Filters []GetDedicatedHostFilter

Configuration block. Detailed below.

HostId string

ID of the Dedicated Host.

The arguments of this data source act as filters for querying the available EC2 Hosts in the current region. The given filters must match exactly one host whose data will be exported as attributes.

Region string

Region where this resource will be managed. Defaults to the Region set in the provider configuration.

Tags map[string]string

filters list(object)

Configuration block. Detailed below.

host_id string

ID of the Dedicated Host.

The arguments of this data source act as filters for querying the available EC2 Hosts in the current region. The given filters must match exactly one host whose data will be exported as attributes.

region string

Region where this resource will be managed. Defaults to the Region set in the provider configuration.

tags map(string)

filters List<GetDedicatedHostFilter>

Configuration block. Detailed below.

hostId String

ID of the Dedicated Host.

The arguments of this data source act as filters for querying the available EC2 Hosts in the current region. The given filters must match exactly one host whose data will be exported as attributes.

region String

Region where this resource will be managed. Defaults to the Region set in the provider configuration.

tags Map<String,String>

filters GetDedicatedHostFilter[]

Configuration block. Detailed below.

hostId string

ID of the Dedicated Host.

The arguments of this data source act as filters for querying the available EC2 Hosts in the current region. The given filters must match exactly one host whose data will be exported as attributes.

region string

Region where this resource will be managed. Defaults to the Region set in the provider configuration.

tags {[key: string]: string}

filters Sequence[GetDedicatedHostFilter]

Configuration block. Detailed below.

host_id str

ID of the Dedicated Host.

The arguments of this data source act as filters for querying the available EC2 Hosts in the current region. The given filters must match exactly one host whose data will be exported as attributes.

region str

Region where this resource will be managed. Defaults to the Region set in the provider configuration.

tags Mapping[str, str]

filters List<Property Map>

Configuration block. Detailed below.

hostId String

ID of the Dedicated Host.

The arguments of this data source act as filters for querying the available EC2 Hosts in the current region. The given filters must match exactly one host whose data will be exported as attributes.

region String

Region where this resource will be managed. Defaults to the Region set in the provider configuration.

tags Map<String>