v1

latestOpenAPI 3.0.0raw.githubusercontent.com2024-06-14254049.0 KB
Volumes

List Volumes

Gets an array of available volumes under the parent catalog and schema. There is no guarantee of a specific ordering of the elements in the array.

get/volumes

Query parameters

catalog_namestring required

The identifier of the catalog

schema_namestring required

The identifier of the schema

max_resultsinteger

Maximum number of volumes to return (page length).

If not set, the page length is set to a server configured value.

  • when set to a value greater than 0, the page length is the minimum of this value and a server configured value;
  • when set to 0, the page length is set to a server configured value;
  • when set to a value less than 0, an invalid parameter error is returned;

Note: this parameter controls only the maximum number of volumes to return. The actual number of volumes returned in a page may be smaller than this value, including 0, even if there are more pages.

page_tokenstring

Opaque token returned by a previous request. It must be included in the request to retrieve the next page of results (pagination).

Response

The volume list was successfully retrieved

next_page_tokenstring

Opaque token to retrieve the next page of results. Absent if there are no more pages. page_token should be set to this value for the next request to retrieve the next page of results.