Method: projects.locations.imageVersions.list

List ImageVersions for provided location.

HTTP request

GET https://composer.googleapis.com/v1/{parent=projects/*/locations/*}/imageVersions

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

List ImageVersions in the given project and location, in the form: "projects/{projectId}/locations/{locationId}"

Authorization requires the following IAM permission on the specified resource parent:

  • composer.imageversions.list

Query parameters

Parameters
pageSize

integer

The maximum number of imageVersions to return.
pageToken

string

The nextPageToken value returned from a previous List request, if any.
includePastReleases

boolean

Whether or not image versions from old releases should be included.

Request body

The request body must be empty.

Response body

The ImageVersions in a project and location.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "imageVersions": [
    {
      object (ImageVersion)
    }
  ],
  "nextPageToken": string
}
Fields
imageVersions[]

object (ImageVersion)

The list of supported ImageVersions in a location.
nextPageToken

string

The page token used to query for the next page if one exists.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

ImageVersion

ImageVersion information

JSON representation 
{
  "imageVersionId": string,
  "isDefault": boolean,
  "supportedPythonVersions": [
    string
  ],
  "releaseDate": {
    object (Date)
  },
  "creationDisabled": boolean,
  "upgradeDisabled": boolean
}
Fields
imageVersionId

string

The string identifier of the ImageVersion, in the form: "composer-x.y.z-airflow-a.b.c"
isDefault

boolean

Whether this is the default ImageVersion used by Composer during environment creation if no input ImageVersion is specified.
supportedPythonVersions[]

string

supported python versions
releaseDate

object (Date)

The date of the version release.
creationDisabled

boolean

Whether it is impossible to create an environment with the image version.
upgradeDisabled

boolean

Whether it is impossible to upgrade an environment running with the image version.