1. Packages
  2. AWS Cloud Control
  3. API Docs
  4. ec2
  5. getHost

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.57.0
published on Monday, Mar 9, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

aws-native.ec2.getHost

aws-native logo

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.57.0
published on Monday, Mar 9, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

    Resource Type definition for AWS::EC2::Host

    Using getHost

    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 getHost(args: GetHostArgs, opts?: InvokeOptions): Promise<GetHostResult>
function getHostOutput(args: GetHostOutputArgs, opts?: InvokeOptions): Output<GetHostResult>
    def get_host(host_id: Optional[str] = None,
             opts: Optional[InvokeOptions] = None) -> GetHostResult
def get_host_output(host_id: Optional[pulumi.Input[str]] = None,
             opts: Optional[InvokeOptions] = None) -> Output[GetHostResult]
    func LookupHost(ctx *Context, args *LookupHostArgs, opts ...InvokeOption) (*LookupHostResult, error)
func LookupHostOutput(ctx *Context, args *LookupHostOutputArgs, opts ...InvokeOption) LookupHostResultOutput

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

    public static class GetHost 
{
    public static Task<GetHostResult> InvokeAsync(GetHostArgs args, InvokeOptions? opts = null)
    public static Output<GetHostResult> Invoke(GetHostInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetHostResult> getHost(GetHostArgs args, InvokeOptions options)
public static Output<GetHostResult> getHost(GetHostArgs args, InvokeOptions options)

    fn::invoke:
  function: aws-native:ec2:getHost
  arguments:
    # arguments dictionary

    The following arguments are supported:

    HostId string
    ID of the host created.
    HostId string
    ID of the host created.
    hostId String
    ID of the host created.
    hostId string
    ID of the host created.
    host_id str
    ID of the host created.
    hostId String
    ID of the host created.

    getHost Result

    The following output properties are available:

    AutoPlacement Pulumi.AwsNative.Ec2.HostAutoPlacement
    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.
    HostId string
    ID of the host created.
    HostMaintenance Pulumi.AwsNative.Ec2.HostMaintenance
    Automatically allocates a new dedicated host and moves your instances on to it if a degradation is detected on your current host.
    HostRecovery Pulumi.AwsNative.Ec2.HostRecovery
    Indicates whether to enable or disable host recovery for the Dedicated Host. Host recovery is disabled by default.
    Tags List<Pulumi.AwsNative.Outputs.Tag>
    Any tags assigned to the Host.
    AutoPlacement HostAutoPlacement
    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.
    HostId string
    ID of the host created.
    HostMaintenance HostMaintenance
    Automatically allocates a new dedicated host and moves your instances on to it if a degradation is detected on your current host.
    HostRecovery HostRecovery
    Indicates whether to enable or disable host recovery for the Dedicated Host. Host recovery is disabled by default.
    Tags Tag
    Any tags assigned to the Host.
    autoPlacement HostAutoPlacement
    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.
    hostId String
    ID of the host created.
    hostMaintenance HostMaintenance
    Automatically allocates a new dedicated host and moves your instances on to it if a degradation is detected on your current host.
    hostRecovery HostRecovery
    Indicates whether to enable or disable host recovery for the Dedicated Host. Host recovery is disabled by default.
    tags List<Tag>
    Any tags assigned to the Host.
    autoPlacement HostAutoPlacement
    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.
    hostId string
    ID of the host created.
    hostMaintenance HostMaintenance
    Automatically allocates a new dedicated host and moves your instances on to it if a degradation is detected on your current host.
    hostRecovery HostRecovery
    Indicates whether to enable or disable host recovery for the Dedicated Host. Host recovery is disabled by default.
    tags Tag[]
    Any tags assigned to the Host.
    auto_placement HostAutoPlacement
    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.
    host_id str
    ID of the host created.
    host_maintenance HostMaintenance
    Automatically allocates a new dedicated host and moves your instances on to it if a degradation is detected on your current host.
    host_recovery HostRecovery
    Indicates whether to enable or disable host recovery for the Dedicated Host. Host recovery is disabled by default.
    tags Sequence[root_Tag]
    Any tags assigned to the Host.
    autoPlacement "on" | "off"
    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.
    hostId String
    ID of the host created.
    hostMaintenance "on" | "off"
    Automatically allocates a new dedicated host and moves your instances on to it if a degradation is detected on your current host.
    hostRecovery "on" | "off"
    Indicates whether to enable or disable host recovery for the Dedicated Host. Host recovery is disabled by default.
    tags List<Property Map>
    Any tags assigned to the Host.

    Supporting Types

    HostAutoPlacement

    HostMaintenance

    HostRecovery

    Tag

    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.57.0
    published on Monday, Mar 9, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws-native
      Try Pulumi Cloud free. Your team will thank you.