---
title: "GET /projects/{project}/zones/{zone}/{association}/hosts/{host}"
method: GET
path: "/projects/{project}/zones/{zone}/{association}/hosts/{host}"
tags: ["hosts"]
---

# GET /projects/{project}/zones/{zone}/{association}/hosts/{host}

`GET /projects/{project}/zones/{zone}/{association}/hosts/{host}`

## Request

- Base URL: `https://compute.googleapis.com/compute/v1`
- URL: `https://compute.googleapis.com/compute/v1/projects/{project}/zones/{zone}/{association}/hosts/{host}`
- Auth: one of:
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/cloud-platform`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-platform`
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/compute`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/compute`
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/compute.readonly`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/compute.readonly`

Retrieves information about the specified host.

## Path parameters

- `project` string, required
- `zone` string, required
- `association` string, required
- `host` string, required

## Response `200`

Successful response

- Host: Represents a host resource.
  - `aliasLinks` string[]: Output only. All aliases for this resource. e.g. projects/123/zones/us-centra1-a/reservation/r1/reservationBlock/b1/hosts/h1
  - `creationTimestamp` string: Output only. The creation timestamp, formatted asRFC3339 text.
  - `description` string: An optional description of this resource.
  - `id` string, uint64: Output only. The unique identifier for this resource. This identifier is defined by the server.
  - `kind` string: Output only. The type of resource. Alwayscompute#host for hosts.
  - `name` string: Output only. The name of the host.
  - `selfLink` string: Output only. The self link of the host.
  - `selfLinkWithId` string: Output only. The self link with id of the host.
  - `state` 'ACTIVE' | 'CREATING' | 'DELETING' | 'STATE_UNSPECIFIED' | 'UNAVAILABLE': Output only. The state of the host.
  - `status` HostStatus
    - `physicalTopology` HostPhysicalTopology
      - `block` string: The unique identifier of the capacity block within the cluster.
      - `cluster` string: The cluster name of the reservation sub-block.
      - `host` string: The unique identifier of the capacity host within the capacity sub-block.
      - `subBlock` string: The unique identifier of the capacity sub-block within the capacity block.
    - `runningInstances` string[]: Output only. The URIs of the instances currently running on this host.
  - `zone` string: Output only. The zone in which the host resides.

## Changes

- **2026-10-30** `8b85e897d3dc`: 4 info
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was added to the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was added to the endpoint's security scheme `Oauth2c`
  - the security scope `https://www.googleapis.com/auth/compute.readonly` was removed from the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/compute.readonly` was removed from the endpoint's security scheme `Oauth2c`
- **2026-10-23** `48929bf89eeb`: 4 info
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was added to the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was added to the endpoint's security scheme `Oauth2c`
  - the security scope `https://www.googleapis.com/auth/compute.readonly` was removed from the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/compute.readonly` was removed from the endpoint's security scheme `Oauth2c`
- …earlier changes not shown

[Operation history](https://skmtc.dev/google/apis/compute/changes/projects/:project/zones/:zone/:association/hosts/:host/get.md)

---

[API](https://skmtc.dev/google/apis/compute.md) - [All operations](https://skmtc.dev/google/apis/compute/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/compute/revisions/8b85e897d3dc?raw)
