Managed Service for Trino API, REST: Catalog.List

Статья создана

Обновлена 3 октября 2025 г.

HTTP request
Path parameters
Query parameters
Response
Catalog
Connector
HiveConnector
Metastore
HiveMetastore
FileSystem
ExternalS3FileSystem
IcebergConnector
DeltaLakeConnector
PostgresqlConnector
PostgresqlConnection
OnPremise
ConnectionManager
ClickhouseConnector
ClickhouseConnection
OnPremise
ConnectionManager
TPCHConnector
TPCDSConnector
OracleConnector
OracleConnection
OnPremise
SQLServerConnector
SQLServerConnection
OnPremise
HudiConnector

Retrieves a list of Trino Catalog resources.

HTTP request

GET https://trino.api.cloud.yandex.net/managed-trino/v1/clusters/{clusterId}/catalogs

Path parameters

Field

Description

clusterId

string

Required field. ID of the cluster to list Trino Catalogs in.

Query parameters

Field	Description
pageSize	string (int64) The maximum number of results per page to return. If the number of available results is larger than `pageSize`, the service returns a ListCatalogsResponse.nextPageToken that can be used to get the next page of results in subsequent list requests.
pageToken	string Page token. To get the next page of results, set `pageToken` to the ListCatalogsResponse.nextPageToken returned by the previous list request.
filter	string A filter expression that filters resources listed in the response. The expression must specify: The field name. Currently you can only use filtering with the Catalog.name field. An `=` operator. The value in double quotes (`"`). Must be 1-63 characters long and match the regular expression `[a-zA-Z0-9_-]+`.

Response

HTTP Code: 200 - OK

{
  "catalogs": [
    {
      "id": "string",
      "name": "string",
      "connector": {
        // Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`
        "hive": {
          "metastore": {
            // Includes only one of the fields `hive`
            "hive": {
              // Includes only one of the fields `uri`
              "uri": "string"
              // end of the list of possible fields
            }
            // end of the list of possible fields
          },
          "filesystem": {
            // Includes only one of the fields `s3`, `externalS3`
            "s3": "object",
            "externalS3": {
              "awsAccessKey": "string",
              "awsSecretKey": "string",
              "awsEndpoint": "string",
              "awsRegion": "string"
            }
            // end of the list of possible fields
          },
          "additionalProperties": "object"
        },
        "iceberg": {
          "metastore": {
            // Includes only one of the fields `hive`
            "hive": {
              // Includes only one of the fields `uri`
              "uri": "string"
              // end of the list of possible fields
            }
            // end of the list of possible fields
          },
          "filesystem": {
            // Includes only one of the fields `s3`, `externalS3`
            "s3": "object",
            "externalS3": {
              "awsAccessKey": "string",
              "awsSecretKey": "string",
              "awsEndpoint": "string",
              "awsRegion": "string"
            }
            // end of the list of possible fields
          },
          "additionalProperties": "object"
        },
        "deltaLake": {
          "metastore": {
            // Includes only one of the fields `hive`
            "hive": {
              // Includes only one of the fields `uri`
              "uri": "string"
              // end of the list of possible fields
            }
            // end of the list of possible fields
          },
          "filesystem": {
            // Includes only one of the fields `s3`, `externalS3`
            "s3": "object",
            "externalS3": {
              "awsAccessKey": "string",
              "awsSecretKey": "string",
              "awsEndpoint": "string",
              "awsRegion": "string"
            }
            // end of the list of possible fields
          },
          "additionalProperties": "object"
        },
        "postgresql": {
          "connection": {
            // Includes only one of the fields `onPremise`, `connectionManager`
            "onPremise": {
              "connectionUrl": "string",
              "userName": "string",
              "password": "string"
            },
            "connectionManager": {
              "connectionId": "string",
              "database": "string",
              "connectionProperties": "object"
            }
            // end of the list of possible fields
          },
          "additionalProperties": "object"
        },
        "clickhouse": {
          "connection": {
            // Includes only one of the fields `onPremise`, `connectionManager`
            "onPremise": {
              "connectionUrl": "string",
              "userName": "string",
              "password": "string"
            },
            "connectionManager": {
              "connectionId": "string",
              "database": "string",
              "connectionProperties": "object"
            }
            // end of the list of possible fields
          },
          "additionalProperties": "object"
        },
        "tpch": {
          "additionalProperties": "object"
        },
        "tpcds": {
          "additionalProperties": "object"
        },
        "oracle": {
          "connection": {
            // Includes only one of the fields `onPremise`
            "onPremise": {
              "connectionUrl": "string",
              "userName": "string",
              "password": "string"
            }
            // end of the list of possible fields
          },
          "additionalProperties": "object"
        },
        "sqlserver": {
          "connection": {
            // Includes only one of the fields `onPremise`
            "onPremise": {
              "connectionUrl": "string",
              "userName": "string",
              "password": "string"
            }
            // end of the list of possible fields
          },
          "additionalProperties": "object"
        },
        "hudi": {
          "metastore": {
            // Includes only one of the fields `hive`
            "hive": {
              // Includes only one of the fields `uri`
              "uri": "string"
              // end of the list of possible fields
            }
            // end of the list of possible fields
          },
          "filesystem": {
            // Includes only one of the fields `s3`, `externalS3`
            "s3": "object",
            "externalS3": {
              "awsAccessKey": "string",
              "awsSecretKey": "string",
              "awsEndpoint": "string",
              "awsRegion": "string"
            }
            // end of the list of possible fields
          },
          "additionalProperties": "object"
        }
        // end of the list of possible fields
      },
      "description": "string",
      "labels": "object"
    }
  ],
  "nextPageToken": "string"
}

Field

Description

catalogs[]

Catalog

List of Trino Catalog resources.

nextPageToken

string

This token allows you to get the next page of results for list requests. If the number of results
is larger than ListCatalogsRequest.pageSize, use the nextPageToken as the value
for the ListCatalogsRequest.pageToken parameter in the next list request. Each subsequent
list request will have its own nextPageToken to continue paging through the results.

Catalog

Catalog is a logical Trino catalog backed by a specific connector.

Field	Description
id	string ID of the catalog.
name	string Name of the catalog.
connector	Connector Connector backing this catalog.
description	string Description of the catalog.
labels	object (map<string, string>) Labels associated with the catalog.

Connector

Connector configuration. Exactly one connector type must be specified.

Field	Description
hive	HiveConnector Hive connector configuration. Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`.
iceberg	IcebergConnector Iceberg connector configuration. Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`.
deltaLake	DeltaLakeConnector Delta Lake connector configuration. Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`.
postgresql	PostgresqlConnector PostgreSQL connector configuration. Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`.
clickhouse	ClickhouseConnector ClickHouse connector configuration. Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`.
tpch	TPCHConnector TPC-H connector for synthetic benchmarking. Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`.
tpcds	TPCDSConnector TPC-DS connector for synthetic benchmarking. Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`.
oracle	OracleConnector Oracle connector configuration for connecting to Oracle Database instances. Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`.
sqlserver	SQLServerConnector SQLServer connector configuration for connecting to SQLServer Database instances. Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`.
hudi	HudiConnector Hudi connector configuration. Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`.

HiveConnector

Field	Description
metastore	Metastore Required field. Metastore configuration.
filesystem	FileSystem Required field. File system configuration.
additionalProperties	object (map<string, string>) Additional properties.

Metastore

Metastore configuration.

Field

Description

hive

HiveMetastore

Includes only one of the fields hive.

HiveMetastore

Configuration of Hive's metastore type.

Field

Description

uri

string

URI or cluster ID of the Hive Metastore.

Includes only one of the fields uri.

FileSystem

Configuration of file system used by a connector.

Field

Description

object

Includes only one of the fields s3, externalS3.

externalS3

ExternalS3FileSystem

Includes only one of the fields s3, externalS3.

ExternalS3FileSystem

Describes External S3 compatible file system.

Field	Description
awsAccessKey	string Required field.
awsSecretKey	string Required field.
awsEndpoint	string Required field.
awsRegion	string Required field.

IcebergConnector

Field	Description
metastore	Metastore Required field. Metastore configuration.
filesystem	FileSystem Required field. File system configuration.
additionalProperties	object (map<string, string>) Additional properties.

DeltaLakeConnector

Field	Description
metastore	Metastore Required field. Metastore configuration.
filesystem	FileSystem Required field. File system configuration.
additionalProperties	object (map<string, string>) Additional properties.

PostgresqlConnector

Field

Description

connection

PostgresqlConnection

Connection configuration.

additionalProperties

object (map<string, string>)

Additional properties.

PostgresqlConnection

Field

Description

onPremise

OnPremise

Includes only one of the fields onPremise, connectionManager.

connectionManager

ConnectionManager

Includes only one of the fields onPremise, connectionManager.

OnPremise

Field	Description
connectionUrl	string Required field. Connection to the Postgresql.
userName	string Required field. Name of the Postgresql user.
password	string Required field. Password of the Postgresql user.

ConnectionManager

Field	Description
connectionId	string Required field. Connection ID.
database	string Required field. Database.
connectionProperties	object (map<string, string>) Additional connection properties.

ClickhouseConnector

Field

Description

connection

ClickhouseConnection

Connection configuration.

additionalProperties

object (map<string, string>)

Additional properties.

ClickhouseConnection

Field

Description

onPremise

OnPremise

Includes only one of the fields onPremise, connectionManager.

connectionManager

ConnectionManager

Includes only one of the fields onPremise, connectionManager.

OnPremise

Field	Description
connectionUrl	string Required field. Connection to the Clickhouse.
userName	string Required field. Name of the Clickhouse user.
password	string Required field. Password of the Clickhouse user.

ConnectionManager

Field	Description
connectionId	string Required field. Connection ID.
database	string Required field. Database.
connectionProperties	object (map<string, string>) Additional connection properties.

TPCHConnector

Field

Description

additionalProperties

object (map<string, string>)

Additional properties.

TPCDSConnector

Field

Description

additionalProperties

object (map<string, string>)

Additional properties.

OracleConnector

Field

Description

connection

OracleConnection

Connection configuration.

additionalProperties

object (map<string, string>)

Additional properties.

OracleConnection

Field

Description

onPremise

OnPremise

Includes only one of the fields onPremise.

OnPremise

Field	Description
connectionUrl	string Required field. Connection to the Oracle.
userName	string Required field. Name of the Oracle user.
password	string Required field. Password of the Oracle user.

SQLServerConnector

Field

Description

connection

SQLServerConnection

Connection configuration.

additionalProperties

object (map<string, string>)

Additional properties.

SQLServerConnection

Field

Description

onPremise

OnPremise

Includes only one of the fields onPremise.

OnPremise

Field	Description
connectionUrl	string Required field. Connection to the SQLServer.
userName	string Required field. Name of the SQLServer user.
password	string Required field. Password of the SQLServer user.

HudiConnector

Field	Description
metastore	Metastore Required field. Metastore configuration.
filesystem	FileSystem Required field. File system configuration.
additionalProperties	object (map<string, string>) Additional properties.

Managed Service for Trino API, REST: Catalog.List

HTTP requestHTTP request

Path parametersPath parameters

Query parametersQuery parameters

ResponseResponse

CatalogCatalog

ConnectorConnector

HiveConnectorHiveConnector

MetastoreMetastore

HiveMetastoreHiveMetastore

FileSystemFileSystem

ExternalS3FileSystemExternalS3FileSystem

IcebergConnectorIcebergConnector

DeltaLakeConnectorDeltaLakeConnector

PostgresqlConnectorPostgresqlConnector

PostgresqlConnectionPostgresqlConnection

OnPremiseOnPremise

ConnectionManagerConnectionManager

ClickhouseConnectorClickhouseConnector

ClickhouseConnectionClickhouseConnection

OnPremiseOnPremise

ConnectionManagerConnectionManager

TPCHConnectorTPCHConnector

TPCDSConnectorTPCDSConnector

OracleConnectorOracleConnector

OracleConnectionOracleConnection

OnPremiseOnPremise

SQLServerConnectorSQLServerConnector

SQLServerConnectionSQLServerConnection

OnPremiseOnPremise

HudiConnectorHudiConnector

Была ли статья полезна?

HTTP request

Path parameters

Query parameters

Response

Catalog

Connector

HiveConnector

Metastore

HiveMetastore

FileSystem

ExternalS3FileSystem

IcebergConnector

DeltaLakeConnector

PostgresqlConnector

PostgresqlConnection

OnPremise

ConnectionManager

ClickhouseConnector

ClickhouseConnection

OnPremise

ConnectionManager

TPCHConnector

TPCDSConnector

OracleConnector

OracleConnection

OnPremise

SQLServerConnector

SQLServerConnection

OnPremise

HudiConnector