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

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

AWS Cloud Control v1.27.0 published on Monday, Apr 14, 2025 by Pulumi

aws-native.ec2.getHost

Explore with Pulumi AI

aws-native logo

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

AWS Cloud Control v1.27.0 published on Monday, Apr 14, 2025 by Pulumi

    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 string
    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 string
    Automatically allocates a new dedicated host and moves your instances on to it if a degradation is detected on your current host.
    HostRecovery string
    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 string
    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 string
    Automatically allocates a new dedicated host and moves your instances on to it if a degradation is detected on your current host.
    HostRecovery string
    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 String
    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 String
    Automatically allocates a new dedicated host and moves your instances on to it if a degradation is detected on your current host.
    hostRecovery String
    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 string
    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 string
    Automatically allocates a new dedicated host and moves your instances on to it if a degradation is detected on your current host.
    hostRecovery string
    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 str
    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 str
    Automatically allocates a new dedicated host and moves your instances on to it if a degradation is detected on your current host.
    host_recovery str
    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 String
    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 String
    Automatically allocates a new dedicated host and moves your instances on to it if a degradation is detected on your current host.
    hostRecovery String
    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

    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.

    AWS Cloud Control v1.27.0 published on Monday, Apr 14, 2025 by Pulumi