Contact UsGet started
© 2025 Direct Cursus Technology L.L.C.

Managed Service for ClickHouse API, gRPC: VersionsService.List

Written by
Updated at November 26, 2024

Returns list of available ClickHouse 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 ListVersionsResponse.next_page_token that can be used
to get the next page of results in subsequent ListVersions requests.
Default value: 100.

page_token

string

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

ListVersionsResponse

{
  "version": [
    {
      "id": "string",
      "name": "string",
      "deprecated": "bool",
      "updatable_to": [
        "string"
      ]
    }
  ],
  "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 ListVersionsRequest.page_size specified in the request.
To get the next page, specify the value of next_page_token as a value for
the ListVersionsRequest.page_token parameter in the next ListVerions request. Subsequent ListVersions
requests will have their own next_page_token to continue paging through the results.

Version

Field

Description

id

string

ID of the version.

name

string

Name of the version.

deprecated

bool

Whether version is deprecated.

updatable_to[]

string

List of versions that can be updated from current.
Previous
Overview
Next
Overview