Discuss with expertTry it for free
© 2026 Direct Cursus Technology L.L.C.

Managed Service for PostgreSQL API, gRPC: VersionsService.List

Written by
Updated at June 15, 2026

Returns list of available PostgreSQL versions.

gRPC request

rpc List (ListVersionsRequest) returns (ListVersionsResponse)

ListVersionsRequest

{
  "page_size": "int64",
  "page_token": "string"
}

Field

Description

page_size

int64

The maximum number of results per page that should be returned. If the number of available
results is larger than page_size, the service returns a next_page_token that can be used
to get the next page of results in subsequent ListVersions requests.
Acceptable values are 0 to 1000, inclusive. Default value: 100.

Acceptable values are 0 to 1000, inclusive.

page_token

string

Page token. Set page_token to the next_page_token returned by a previous ListVersions
request to get the next page of results.

The maximum string length in characters is 100.

ListVersionsResponse

{
  "version": [
    {
      "id": "string",
      "name": "string",
      "status": "Status",
      "updatable_to": [
        "string"
      ],
      "deprecated_at": "google.protobuf.Timestamp",
      "eol_at": "google.protobuf.Timestamp"
    }
  ],
  "next_page_token": "string"
}

Field

Description

version[]

Version

Requested list of available versions.

next_page_token

string

This token allows you to get the next page of results for ListVersions requests,
if the number of results is larger than page_size specified in the request.
To get the next page, specify the value of next_page_token as a value for
the page_token parameter in the next ListVersions request. Subsequent ListVersions
requests will have their own next_page_token to continue paging through the results.

Version

Common message for describing a Managed Database version.

Field

Description

id

string

Version ID

name

string

Version name

status

enum Status

Version status

  • NEW: Newly released version. New clusters can be created.
    Support may not yet be available in full scope.
  • ACTUAL: Newly released version. New clusters can be created.
  • SUPPORTED: Fully supported version.
  • DEPRECATED: Version approaching end of support. New cluster creation is not allowed.
    Existing clusters continue to operate. Restore from backups is available.
  • LEGACY: Deprecated version billed at an increased rate.
    New cluster creation and restore from backups are not allowed.
    Existing clusters continue to operate; automatic upgrade may be scheduled.
  • EOL: End-of-life version. Clusters are forcibly upgraded to a supported version or shut down.

updatable_to[]

string

List of version IDs that the current version can be updated to

deprecated_at

google.protobuf.Timestamp

Optional. Date when the version enters an appropriate status (day precision)

eol_at

google.protobuf.Timestamp

Optional. Date when the version reaches an appropriate status (day precision)
Previous
Overview
Next
Overview