---
title: "Returns a collection of H2OEngineVersions."
method: GET
path: "/v1/{parent}/h2oEngineVersions"
tags: ["H2OEngineVersionService"]
---

# Returns a collection of H2OEngineVersions.

`GET /v1/{parent}/h2oEngineVersions`

## Request

- Base URL: `https://docs.h2o.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.h2o.ai/v1/{parent}/h2oEngineVersions`
- Auth: none declared
- TypeScript: <https://skmtc.dev/h2o/apis/ai-h2o-engine-sandbox-v1-filesystem-proto/docs/v1/:parent/h2oEngineVersions/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `parent` string, required

## Query parameters

- `pageSize` integer
- `pageToken` string

## Response `200`

A successful response.

- V1ListH2OEngineVersionsResponse: Response message for List method.
  - `h2oEngineVersions` V1H2OEngineVersion[]: Collection of H2OEngineVersions.
    - `name` string
    - `deprecated` boolean: Indicates whether H2OEngineVersion is deprecated.
    - `aliases` string[]: Optional. ResourceID aliases for this H2OEngineVersion. Aliases are unique within the workspace (two versions in the same workspace cannot have the same alias). Any alias must be in format: - contain 1-63 characters - contain only lowercase alphanumeric characters or hyphen ('-') - start with an alphabetic character - end with an alphanumeric character This matches a regular expression: ^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$ For example: when H2OEngineVersion with name "workspaces/global/h2oEngineVersions/3.38.0.1" has aliases={"latest", "prerelease"}, then "workspaces/global/h2oEngineVersions/latest" will refer to this H2OEngineVersion.
    - `image` string, required: Required. Name of the Docker image used when using this H2OEngineVersion.
    - `imagePullPolicy` 'IMAGE_PULL_POLICY_UNSPECIFIED' | 'IMAGE_PULL_POLICY_ALWAYS' | 'IMAGE_PULL_POLICY_NEVER' | 'IMAGE_PULL_POLICY_IF_NOT_PRESENT': Policy for downloading an image in K8s. - IMAGE_PULL_POLICY_UNSPECIFIED: Unspecified image pull policy. - IMAGE_PULL_POLICY_ALWAYS: Every time the container is launched, the container image registry is queried to resolve the name to an image digest. - IMAGE_PULL_POLICY_NEVER: Do not try to fetch the image. If the image is already present locally, the container will start. If the image is not present, container startup will fail. - IMAGE_PULL_POLICY_IF_NOT_PRESENT: The image is pulled only if it is not already present locally.
    - `imagePullSecrets` string[]: List of references to k8s secrets that can be used for pulling an image of this H2OEngineVersion from a private container image registry or repository.
    - `createTime` string, date-time: Output only. Time when the H2OEngineVersion was created.
    - `updateTime` string, date-time, nullable: Output only. Time when the H2OEngineVersion was last updated.
    - `creator` string: Output only. Name of entity that created the H2OEngineVersion.
    - `updater` string: Output only. Name of entity that last updated the H2OEngineVersion.
    - `creatorDisplayName` string: Output only. Human-readable name of entity that created the H2OEngineVersion.
    - `updaterDisplayName` string: Output only. Human-readable name of entity that last updated the H2OEngineVersion.
  - `nextPageToken` string: Used to retrieve the next page of results. When unset, no further items are available (this response was the last page).

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/h2o/apis/ai-h2o-engine-sandbox-v1-filesystem-proto.md) - [All operations](https://skmtc.dev/h2o/apis/ai-h2o-engine-sandbox-v1-filesystem-proto/llms.txt) - [OpenAPI document](https://skmtc.dev/h2o/apis/ai-h2o-engine-sandbox-v1-filesystem-proto/revisions/297cfadc1d39?raw)