Contact UsGet started

Information about existing clusters in Managed Service for Trino

Written by
Updated at May 14, 2025

Note

The service is at the Preview stage.

You can request detailed information about each Managed Service for Trino cluster you created.

Getting a list of clusters in a folder

  1. In the management console, go to the relevant folder.
  2. In the list of services, select Managed Service for Trino.

  1. Get an IAM token for API authentication and put it into the environment variable:

    export IAM_TOKEN="<IAM_token>"

  2. Use the Cluster.list method and send the following request, e.g., via cURL:

    curl \
    --request GET \
    --header "Authorization: Bearer $IAM_TOKEN" \
    --url 'https://trino.api.cloud.yandex.net/managed-trino/v1/clusters' \
    --url-query folderId=<folder_ID>

    You can request the folder ID with the list of folders in the cloud.

  3. View the server response to make sure the request was successful.

  1. Get an IAM token for API authentication and put it into the environment variable:

    export IAM_TOKEN="<IAM_token>"

  2. Clone the cloudapi repository:

    cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi

    Below, we assume the repository contents are stored in the ~/cloudapi/ directory.

  3. Use the ClusterService/List call and send the following request, e.g., via gRPCurl:

    grpcurl \
    -format json \
    -import-path ~/cloudapi/ \
    -import-path ~/cloudapi/third_party/googleapis/ \
    -proto ~/cloudapi/yandex/cloud/trino/v1/cluster_service.proto \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
            "folder_id": "<folder_ID>"
        }' \
    trino.api.cloud.yandex.net:443 \
    yandex.cloud.trino.v1.ClusterService.List

    You can request the folder ID with the list of folders in the cloud.

  4. View the server response to make sure the request was successful.

Getting detailed information about a cluster

  1. In the management console, go to the relevant folder.
  2. In the list of services, select Managed Service for Trino.
  3. Click the cluster name.

  1. Get an IAM token for API authentication and put it into the environment variable:

    export IAM_TOKEN="<IAM_token>"

  2. Use the Cluster.get method and send the following request, e.g., via cURL:

    curl \
    --request GET \
    --header "Authorization: Bearer $IAM_TOKEN" \
    --url 'https://trino.api.cloud.yandex.net/managed-trino/v1/clusters/<cluster_ID>'

    You can request the cluster ID with the list of clusters in the folder.

  3. View the server response to make sure the request was successful.

  1. Get an IAM token for API authentication and put it into the environment variable:

    export IAM_TOKEN="<IAM_token>"

  2. Clone the cloudapi repository:

    cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi

    Below, we assume the repository contents are stored in the ~/cloudapi/ directory.

  3. Use the ClusterService/Get call and send the following request, e.g., via gRPCurl:

    grpcurl \
    -format json \
    -import-path ~/cloudapi/ \
    -import-path ~/cloudapi/third_party/googleapis/ \
    -proto ~/cloudapi/yandex/cloud/trino/v1/cluster_service.proto \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
            "cluster_id": "<cluster_ID>"
        }' \
    trino.api.cloud.yandex.net:443 \
    yandex.cloud.trino.v1.ClusterService.Get

    You can request the cluster ID with the list of clusters in the folder.

  4. View the server response to make sure the request was successful.

Viewing operations with clusters

All actions with Managed Service for Trino clusters are logged as a list of operations. Each operation gets its own unique ID.

Getting a list of operations

To get a list of operations for a Managed Service for Trino cluster:

  1. In the management console, open the folder with the cluster.

  2. Select Managed Service for Trino.

  3. In the left-hand panel, select Clusters.

  4. Select the cluster.

  5. Go to the Operations panel for the selected cluster.

    You will see a list of operations with the selected cluster.

  1. Get an IAM token for API authentication and put it into the environment variable:

    export IAM_TOKEN="<IAM_token>"

  2. Use the Cluster.listOperations method and send the following request, e.g., via cURL:

    curl \
    --request GET \
    --header "Authorization: Bearer $IAM_TOKEN" \
    --url 'https://trino.api.cloud.yandex.net/managed-trino/v1/clusters/<cluster_ID>/operations'

    You can request the cluster ID with the list of clusters in the folder.

  3. View the server response to make sure the request was successful.

  1. Get an IAM token for API authentication and put it into the environment variable:

    export IAM_TOKEN="<IAM_token>"

  2. Clone the cloudapi repository:

    cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi

    Below, we assume the repository contents are stored in the ~/cloudapi/ directory.

  3. Use the ClusterService/ListOperations call and send the following request, e.g., via gRPCurl:

    grpcurl \
    -format json \
    -import-path ~/cloudapi/ \
    -import-path ~/cloudapi/third_party/googleapis/ \
    -proto ~/cloudapi/yandex/cloud/trino/v1/cluster_service.proto \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
            "cluster_id": "<cluster_ID>"
        }' \
    trino.api.cloud.yandex.net:443 \
    yandex.cloud.trino.v1.ClusterService.ListOperations

    You can request the cluster ID with the list of clusters in the folder.

  4. View the server response to make sure the request was successful.

See also

Previous
All guides
Next
Creating a cluster