Информация об имеющихся кластерах в Managed Service for Trino
Примечание
Сервис находится на стадии Preview.
Вы можете запросить детальную информацию о каждом созданном вами кластере Managed Service for Trino.
Получить список кластеров в каталоге
- В консоли управления
перейдите в нужный каталог. - В списке сервисов выберите Managed Service for Trino.
Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>
. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name
или --folder-id
.
Чтобы запросить список кластеров Managed Service for Trino в каталоге по умолчанию, выполните команду:
yc managed-trino cluster list
Результат:
+----------------------+----------+---------------------+--------+---------+
| ID | NAME | CREATED AT | HEALTH | STATUS |
+----------------------+----------+---------------------+--------+---------+
| c9qsfvqeio90******** | my-trino | 2025-06-02 05:25:20 | ALIVE | RUNNING |
+----------------------+----------+---------------------+--------+---------+
-
Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
export IAM_TOKEN="<IAM-токен>"
-
Воспользуйтесь методом Cluster.list и выполните запрос, например, с помощью cURL
:curl \ --request GET \ --header "Authorization: Bearer $IAM_TOKEN" \ --url 'https://trino.api.cloud.yandex.net/managed-trino/v1/clusters' \ --url-query folderId=<идентификатор_каталога>
Идентификатор каталога можно запросить со списком каталогов в облаке.
-
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.
-
Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
export IAM_TOKEN="<IAM-токен>"
-
Клонируйте репозиторий cloudapi
:cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
Далее предполагается, что содержимое репозитория находится в директории
~/cloudapi/
. -
Воспользуйтесь вызовом ClusterService/List и выполните запрос, например, с помощью 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": "<идентификатор_каталога>" }' \ trino.api.cloud.yandex.net:443 \ yandex.cloud.trino.v1.ClusterService.List
Идентификатор каталога можно запросить со списком каталогов в облаке.
-
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.
Получить детальную информацию о кластере
- В консоли управления
перейдите в нужный каталог. - В списке сервисов выберите Managed Service for Trino.
- Нажмите на имя нужного кластера.
Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>
. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name
или --folder-id
.
Чтобы получить информацию о кластере Managed Service for Trino, выполните команду:
yc managed-trino cluster get <имя_или_идентификатор_кластера>
Идентификатор и имя кластера можно запросить со списком кластеров в каталоге.
-
Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
export IAM_TOKEN="<IAM-токен>"
-
Воспользуйтесь методом Cluster.get и выполните запрос, например, с помощью cURL
:curl \ --request GET \ --header "Authorization: Bearer $IAM_TOKEN" \ --url 'https://trino.api.cloud.yandex.net/managed-trino/v1/clusters/<идентификатор_кластера>'
Идентификатор кластера можно запросить со списком кластеров в каталоге.
-
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.
-
Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
export IAM_TOKEN="<IAM-токен>"
-
Клонируйте репозиторий cloudapi
:cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
Далее предполагается, что содержимое репозитория находится в директории
~/cloudapi/
. -
Воспользуйтесь вызовом ClusterService/Get и выполните запрос, например, с помощью 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": "<идентификатор_кластера>" }' \ trino.api.cloud.yandex.net:443 \ yandex.cloud.trino.v1.ClusterService.Get
Идентификатор кластера можно запросить со списком кластеров в каталоге.
-
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.
Посмотреть операции с кластерами
Все действия с кластерами Managed Service for Trino сохраняются в виде списка операций. Каждой операции присваивается уникальный идентификатор.
Получить список операций
Чтобы получить список операций для кластера Managed Service for Trino:
-
В консоли управления
откройте каталог, в котором находится кластер. -
Выберите сервис Managed Service for Trino.
-
На панели слева выберите
Кластеры. -
Выберите нужный кластер.
-
Перейдите на панель
Операции для выбранного кластера.В открывшемся списке отображаются операции с выбранным кластером.
Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>
. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name
или --folder-id
.
Чтобы получить список операций для кластера Managed Service for Trino, выполните команду:
yc managed-trino cluster list-operations <имя_или_идентификатор_кластера>
Результат:
+----------------------+---------------------+----------------------+---------------------+--------+------------------------------+
| ID | CREATED AT | CREATED BY | MODIFIED AT | STATUS | DESCRIPTION |
+----------------------+---------------------+----------------------+---------------------+--------+------------------------------+
| trc854fqfa8t******** | 2025-06-02 05:25:20 | ajejut7dk2dp******** | 2025-06-02 05:28:57 | DONE | Create Managed Trino cluster |
+----------------------+---------------------+----------------------+---------------------+--------+------------------------------+
Идентификатор и имя кластера можно запросить со списком кластеров в каталоге.
По умолчанию информация об операциях выводится в текстовом формате. Чтобы получить более подробную информацию, укажите формат yaml
или json
для выводимых данных с помощью параметра --format
. Например:
yc managed-trino cluster list-operations <имя_или_идентификатор_кластера> --format yaml
Результат:
- id: trc854fqfa8t********
description: Create Managed Trino cluster
created_at: "2025-06-02T05:25:20.147498Z"
created_by: ajejut7dk2dp********
modified_at: "2025-06-02T05:28:57.284775Z"
done: true
metadata:
'@type': type.googleapis.com/yandex.cloud.trino.v1.CreateClusterMetadata
cluster_id: trc854fqfa8t********
...
-
Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
export IAM_TOKEN="<IAM-токен>"
-
Воспользуйтесь методом Cluster.listOperations и выполните запрос, например, с помощью cURL
:curl \ --request GET \ --header "Authorization: Bearer $IAM_TOKEN" \ --url 'https://trino.api.cloud.yandex.net/managed-trino/v1/clusters/<идентификатор_кластера>/operations'
Идентификатор кластера можно запросить со списком кластеров в каталоге.
-
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.
-
Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
export IAM_TOKEN="<IAM-токен>"
-
Клонируйте репозиторий cloudapi
:cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
Далее предполагается, что содержимое репозитория находится в директории
~/cloudapi/
. -
Воспользуйтесь вызовом ClusterService/ListOperations и выполните запрос, например, с помощью 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": "<идентификатор_кластера>" }' \ trino.api.cloud.yandex.net:443 \ yandex.cloud.trino.v1.ClusterService.ListOperations
Идентификатор кластера можно запросить со списком кластеров в каталоге.
-
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.
Получить подробную информацию об операции
-
Получите список операций для кластера.
-
Скопируйте идентификатор нужной операции.
-
Получите подробную информацию об операции:
CLIREST APIgRPC APIЕсли у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду
yc config set folder-id <идентификатор_каталога>
. Также для любой команды вы можете указать другой каталог с помощью параметров--folder-name
или--folder-id
.Выполните команду:
yc operation get <идентификатор_операции>
Результат:
id: trcippp3rvn7******** description: Update Managed Trino cluster created_at: "2025-06-11T10:36:37.278776Z" created_by: ajejut7dk2dp******** modified_at: "2025-06-11T10:36:37.278776Z" done: true metadata: '@type': type.googleapis.com/yandex.cloud.trino.v1.UpdateClusterMetadata cluster_id: c9q3jaob16gp******** response: '@type': type.googleapis.com/yandex.cloud.trino.v1.Cluster ...
-
Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
export IAM_TOKEN="<IAM-токен>"
-
Воспользуйтесь методом Operation.Get и выполните запрос, например с помощью cURL
:curl \ --request GET \ --header "Authorization: Bearer $IAM_TOKEN" \ --url 'https://operation.api.cloud.yandex.net/operations/<идентификатор_операции>'
-
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.
-
Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
export IAM_TOKEN="<IAM-токен>"
-
Клонируйте репозиторий cloudapi
:cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
Далее предполагается, что содержимое репозитория находится в директории
~/cloudapi/
. -
Воспользуйтесь вызовом OperationService.Get и выполните запрос, например с помощью gRPCurl
:grpcurl \ -format json \ -import-path ~/cloudapi/ \ -import-path ~/cloudapi/third_party/googleapis/ \ -proto ~/cloudapi/yandex/cloud/operation/operation_service.proto \ -rpc-header "Authorization: Bearer $IAM_TOKEN" \ -d '{ "operation_id": "<идентификатор_операции>" }' \ operation.api.cloud.yandex.net:443 \ yandex.cloud.operation.OperationService.Get
-
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.
-