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

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

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

## Request

- Base URL: `https://compute.googleapis.com/compute/v1`
- URL: `https://compute.googleapis.com/compute/v1/projects/{project}/zones/{zone}/{association}/hosts`
- 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 a list of hosts.

## Path parameters

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

## Query parameters

- `filter` string
- `maxResults` integer
- `orderBy` string
- `pageToken` string
- `returnPartialSuccess` boolean

## Response `200`

Successful response

- HostsListResponse
  - `etag` string
  - `id` string: The unique identifier for the resource; defined by the server.
  - `items` Host[]: A list of host resources.
    - `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.
  - `kind` string: The type of resource. Always compute#host for a list of hosts.
  - `nextPageToken` string: This token allows you to get the next page of results for list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
  - `selfLink` string: The server-defined URL for this resource.
  - `unreachables` string[]: Unreachable resources. end_interface: MixerListResponseWithEtagBuilder
  - `warning` object: An informational warning message.
    - `code` 'CLEANUP_FAILED' | 'DEPRECATED_RESOURCE_USED' | 'DEPRECATED_TYPE_USED' | 'DISK_SIZE_LARGER_THAN_IMAGE_SIZE' | 'EXPERIMENTAL_TYPE_USED' | 'EXTERNAL_API_WARNING' | 'FIELD_VALUE_OVERRIDEN' | 'INJECTED_KERNELS_DEPRECATED' | 'INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB' | 'LARGE_DEPLOYMENT_WARNING' | 'LIST_OVERHEAD_QUOTA_EXCEED' | 'MISSING_TYPE_DEPENDENCY' | 'NEXT_HOP_ADDRESS_NOT_ASSIGNED' | 'NEXT_HOP_CANNOT_IP_FORWARD' | 'NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE' | 'NEXT_HOP_INSTANCE_NOT_FOUND' | 'NEXT_HOP_INSTANCE_NOT_ON_NETWORK' | 'NEXT_HOP_NOT_RUNNING' | 'NOT_CRITICAL_ERROR' | 'NO_RESULTS_ON_PAGE' | 'PARTIAL_SUCCESS' | 'QUOTA_INFO_UNAVAILABLE' | 'REQUIRED_TOS_AGREEMENT' | 'RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING' | 'RESOURCE_NOT_DELETED' | 'SCHEMA_VALIDATION_IGNORED' | 'SINGLE_INSTANCE_PROPERTY_TEMPLATE' | 'UNDECLARED_PROPERTIES' | 'UNREACHABLE': [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
    - `data` object[]: [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" }]
      - `key` string: [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
      - `value` string: [Output Only] A warning data value corresponding to the key.
    - `message` string: [Output Only] A human-readable description of the warning code.

## 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/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)