---
title: "POST /#X-Amz-Target=com.amazonaws.codestar.connections.CodeStar_connections_20191201.GetHost"
method: POST
path: "/#X-Amz-Target=com.amazonaws.codestar.connections.CodeStar_connections_20191201.GetHost"
---

# POST /#X-Amz-Target=com.amazonaws.codestar.connections.CodeStar_connections_20191201.GetHost

`POST /#X-Amz-Target=com.amazonaws.codestar.connections.CodeStar_connections_20191201.GetHost`

Returns the host ARN and details such as status, provider type, endpoint, and, if applicable, the VPC configuration.

## Headers

- `X-Amz-Target` 'com.amazonaws.codestar.connections.CodeStar_connections_20191201.GetHost', required

## Request body

- GetHostInput
  - `HostArn` string, required — The Amazon Resource Name (ARN) of the requested host.

## Response `200`

Success

- GetHostOutput
  - `Name` string — The name of the requested host.
  - `Status` string — The status of the requested host.
  - `ProviderType` 'Bitbucket' | 'GitHub' | 'GitHubEnterpriseServer' — The provider type of the requested host, such as GitHub Enterprise Server.
  - `ProviderEndpoint` string — The endpoint of the infrastructure represented by the requested host.
  - `VpcConfiguration` object — The VPC configuration of the requested host.
    - `VpcId` string, required — The ID of the Amazon VPC connected to the infrastructure where your provider type is installed.
    - `SubnetIds` SubnetId[], required — The ID of the subnet or subnets associated with the Amazon VPC connected to the infrastructure where your provider type is installed.
    - `SecurityGroupIds` SecurityGroupId[], required — The ID of the security group or security groups associated with 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.

## Other responses

- `480` — ResourceNotFoundException
- `481` — ResourceUnavailableException

---

[API](https://skmtc.net/aws/apis/codestar-connections.md) · [All operations](https://skmtc.net/aws/apis/codestar-connections/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/codestar-connections/versions/4018814757c0/schema)