1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. codeconnections
  6. getHost

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

Viewing docs for AWS Cloud Control v1.79.0
published on Monday, Sep 14, 2026 by Pulumi
aws-native logo aws-native logo

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

Viewing docs for AWS Cloud Control v1.79.0
published on Monday, Sep 14, 2026 by Pulumi

    A resource that represents the infrastructure where a third-party provider is installed. You create one host for all connections to that provider.

    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?: InvokeOutputOptions): Output<GetHostResult>
    def get_host(host_arn: Optional[str] = None,
                 opts: Optional[InvokeOptions] = None) -> GetHostResult
    def get_host_output(host_arn: pulumi.Input[Optional[str]] = None,
                 opts: Optional[InvokeOutputOptions] = 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 Output<GetHostResult> Invoke(GetHostInvokeArgs args, InvokeOutputOptions opts)
    }
    public static CompletableFuture<GetHostResult> getHost(GetHostArgs args, InvokeOptions options)
    public static Output<GetHostResult> getHost(GetHostArgs args, InvokeOptions options)
    public static Output<GetHostResult> getHost(GetHostArgs args, InvokeOutputOptions options)
    
    fn::invoke:
      function: aws-native:codeconnections:getHost
      arguments:
        # arguments dictionary
    data "aws-native_codeconnections_get_host" "name" {
        # arguments
    }

    The following arguments are supported:

    HostArn string
    The Amazon Resource Name (ARN) of the host.
    HostArn string
    The Amazon Resource Name (ARN) of the host.
    host_arn string
    The Amazon Resource Name (ARN) of the host.
    hostArn String
    The Amazon Resource Name (ARN) of the host.
    hostArn string
    The Amazon Resource Name (ARN) of the host.
    host_arn str
    The Amazon Resource Name (ARN) of the host.
    hostArn String
    The Amazon Resource Name (ARN) of the host.

    getHost Result

    The following output properties are available:

    HostArn string
    The Amazon Resource Name (ARN) of the host.
    HostId string
    The server-generated unique identifier for the host.
    ProviderEndpoint string
    The endpoint of the infrastructure where your provider type is installed.
    Status string
    The status of the host.
    Tags List<Pulumi.AwsNative.Outputs.Tag>
    Tags to apply to the host.
    VpcConfiguration Pulumi.AwsNative.CodeConnections.Outputs.HostVpcConfiguration
    HostArn string
    The Amazon Resource Name (ARN) of the host.
    HostId string
    The server-generated unique identifier for the host.
    ProviderEndpoint string
    The endpoint of the infrastructure where your provider type is installed.
    Status string
    The status of the host.
    Tags Tag
    Tags to apply to the host.
    VpcConfiguration HostVpcConfiguration
    host_arn string
    The Amazon Resource Name (ARN) of the host.
    host_id string
    The server-generated unique identifier for the host.
    provider_endpoint string
    The endpoint of the infrastructure where your provider type is installed.
    status string
    The status of the host.
    tags list(object)
    Tags to apply to the host.
    vpc_configuration object
    hostArn String
    The Amazon Resource Name (ARN) of the host.
    hostId String
    The server-generated unique identifier for the host.
    providerEndpoint String
    The endpoint of the infrastructure where your provider type is installed.
    status String
    The status of the host.
    tags List<Tag>
    Tags to apply to the host.
    vpcConfiguration HostVpcConfiguration
    hostArn string
    The Amazon Resource Name (ARN) of the host.
    hostId string
    The server-generated unique identifier for the host.
    providerEndpoint string
    The endpoint of the infrastructure where your provider type is installed.
    status string
    The status of the host.
    tags Tag[]
    Tags to apply to the host.
    vpcConfiguration HostVpcConfiguration
    host_arn str
    The Amazon Resource Name (ARN) of the host.
    host_id str
    The server-generated unique identifier for the host.
    provider_endpoint str
    The endpoint of the infrastructure where your provider type is installed.
    status str
    The status of the host.
    tags Sequence[root_Tag]
    Tags to apply to the host.
    vpc_configuration HostVpcConfiguration
    hostArn String
    The Amazon Resource Name (ARN) of the host.
    hostId String
    The server-generated unique identifier for the host.
    providerEndpoint String
    The endpoint of the infrastructure where your provider type is installed.
    status String
    The status of the host.
    tags List<Property Map>
    Tags to apply to the host.
    vpcConfiguration Property Map

    Supporting Types

    HostVpcConfiguration

    SecurityGroupIds List<string>
    The ID of the security group or security groups associated with the Amazon VPC.
    SubnetIds List<string>
    The ID of the subnet or subnets associated with the Amazon VPC.
    VpcId string
    The ID of the Amazon VPC connected to the infrastructure where your provider type is installed.
    TlsCertificate string
    The value of the Transport Layer Security (TLS) certificate associated with the infrastructure where your provider type is installed.
    SecurityGroupIds []string
    The ID of the security group or security groups associated with the Amazon VPC.
    SubnetIds []string
    The ID of the subnet or subnets associated with the Amazon VPC.
    VpcId string
    The ID of the Amazon VPC connected to the infrastructure where your provider type is installed.
    TlsCertificate string
    The value of the Transport Layer Security (TLS) certificate associated with the infrastructure where your provider type is installed.
    security_group_ids list(string)
    The ID of the security group or security groups associated with the Amazon VPC.
    subnet_ids list(string)
    The ID of the subnet or subnets associated with the Amazon VPC.
    vpc_id string
    The ID of the Amazon VPC connected to the infrastructure where your provider type is installed.
    tls_certificate string
    The value of the Transport Layer Security (TLS) certificate associated with the infrastructure where your provider type is installed.
    securityGroupIds List<String>
    The ID of the security group or security groups associated with the Amazon VPC.
    subnetIds List<String>
    The ID of the subnet or subnets associated with the Amazon VPC.
    vpcId String
    The ID of the Amazon VPC connected to the infrastructure where your provider type is installed.
    tlsCertificate String
    The value of the Transport Layer Security (TLS) certificate associated with the infrastructure where your provider type is installed.
    securityGroupIds string[]
    The ID of the security group or security groups associated with the Amazon VPC.
    subnetIds string[]
    The ID of the subnet or subnets associated with the Amazon VPC.
    vpcId string
    The ID of the Amazon VPC connected to the infrastructure where your provider type is installed.
    tlsCertificate string
    The value of the Transport Layer Security (TLS) certificate associated with the infrastructure where your provider type is installed.
    security_group_ids Sequence[str]
    The ID of the security group or security groups associated with the Amazon VPC.
    subnet_ids Sequence[str]
    The ID of the subnet or subnets associated with the Amazon VPC.
    vpc_id str
    The ID of the Amazon VPC connected to the infrastructure where your provider type is installed.
    tls_certificate str
    The value of the Transport Layer Security (TLS) certificate associated with the infrastructure where your provider type is installed.
    securityGroupIds List<String>
    The ID of the security group or security groups associated with the Amazon VPC.
    subnetIds List<String>
    The ID of the subnet or subnets associated with the Amazon VPC.
    vpcId String
    The ID of the Amazon VPC connected to the infrastructure where your provider type is installed.
    tlsCertificate String
    The value of the Transport Layer Security (TLS) certificate associated with the infrastructure where your provider type is installed.

    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 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 aws-native logo

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

    Viewing docs for AWS Cloud Control v1.79.0
    published on Monday, Sep 14, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial