Информация об имеющихся кластерах Yandex MPP Analytics for PostgreSQL

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

Yandex Cloud

Улучшена

mmerihsesh

Обновлена 21 мая 2026 г.

Получить список кластеров в каталоге
Получить детальную информацию о кластере
Получить информацию о хостах кластера

Вы можете запросить детальную информацию о каждом созданном вами кластере Yandex MPP Analytics for PostgreSQL.

Получить список кластеров в каталоге

Консоль управления

CLI

REST API

gRPC API

Перейдите на страницу каталога.
Перейдите в сервис Yandex MPP Analytics for PostgreSQL.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

Чтобы запросить список кластеров Yandex MPP Analytics for PostgreSQL в каталоге, выполните команду:

yc managed-greenplum cluster list

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Воспользуйтесь методом Cluster.List и выполните запрос, например, с помощью cURL:
```
curl \
    --request GET \
    --header "Authorization: Bearer $IAM_TOKEN" \
    --url 'https://mdb.api.cloud.yandex.net/managed-greenplum/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/mdb/greenplum/v1/cluster_service.proto \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
            "folder_id": "<идентификатор_каталога>"
        }' \
    mdb.api.cloud.yandex.net:443 \
    yandex.cloud.mdb.greenplum.v1.ClusterService.List

Идентификатор каталога можно запросить со списком каталогов в облаке.

Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Получить детальную информацию о кластере

Консоль управления

CLI

REST API

gRPC API

Перейдите на страницу каталога.
Перейдите в сервис Yandex MPP Analytics for PostgreSQL.
Нажмите на имя нужного кластера.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

Чтобы получить информацию о кластере Yandex MPP Analytics for PostgreSQL, выполните команду:

yc managed-greenplum cluster get <имя_или_идентификатор_кластера>

Идентификатор и имя кластера можно запросить со списком кластеров в каталоге.

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Воспользуйтесь методом Cluster.Get и выполните запрос, например, с помощью cURL:
```
curl \
    --request GET \
    --header "Authorization: Bearer $IAM_TOKEN" \
    --url 'https://mdb.api.cloud.yandex.net/managed-greenplum/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/mdb/greenplum/v1/cluster_service.proto \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
          "cluster_id": "<идентификатор_кластера>"
        }' \
    mdb.api.cloud.yandex.net:443 \
    yandex.cloud.mdb.greenplum.v1.ClusterService.Get

Идентификатор кластера можно запросить со списком кластеров в каталоге.

Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Получить информацию о хостах кластера

Консоль управления

CLI

REST API

gRPC API

Перейдите на страницу каталога.
Перейдите в сервис Yandex MPP Analytics for PostgreSQL.
Нажмите на имя нужного кластера, затем выберите вкладку Хосты.

В списке хостов в колонке Роль указывается роль каждого хоста:

MASTER — первичный хост-мастер (PRIMARY). Принимает пользовательские подключения.
REPLICA — резервный хост-мастер (STANDBY). Реплицирует данные первичного хоста-мастера.
SEGMENT — хост-сегмент. Хранит часть данных кластера.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

Чтобы получить список хостов-мастеров в кластере, выполните команду:

yc managed-greenplum hosts list master \
   --cluster-name=<имя_кластера>

Чтобы получить список хостов-сегментов в кластере, выполните команду:

yc managed-greenplum hosts list segment \
   --cluster-name=<имя_кластера>

Имя кластера можно запросить со списком кластеров в каталоге.

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Чтобы получить список хостов-мастеров в кластере:
1. Воспользуйтесь методом Cluster.ListMasterHosts и выполните запрос, например, с помощью cURL:
```
curl \
    --request GET \
    --header "Authorization: Bearer $IAM_TOKEN" \
    --url 'https://mdb.api.cloud.yandex.net/managed-greenplum/v1/clusters/<идентификатор_кластера>/master-hosts'
```
  Идентификатор кластера можно запросить со списком кластеров в каталоге.
2. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.
Чтобы получить список хостов-сегментов в кластере:
1. Воспользуйтесь методом Cluster.ListSegmentHosts и выполните запрос, например, с помощью cURL:
```
curl \
    --request GET \
    --header "Authorization: Bearer $IAM_TOKEN" \
    --url 'https://mdb.api.cloud.yandex.net/managed-greenplum/v1/clusters/<идентификатор_кластера>/segment-hosts'
```
  Идентификатор кластера можно запросить со списком кластеров в каталоге.
2. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Клонируйте репозиторий cloudapi:
```
cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
```
Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.
Чтобы получить список хостов-мастеров в кластере:
1. Воспользуйтесь вызовом ClusterService.ListMasterHosts и выполните запрос, например, с помощью gRPCurl:
```
grpcurl \
    -format json \
    -import-path ~/cloudapi/ \
    -import-path ~/cloudapi/third_party/googleapis/ \
    -proto ~/cloudapi/yandex/cloud/mdb/greenplum/v1/cluster_service.proto \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
          "cluster_id": "<идентификатор_кластера>"
        }' \
    mdb.api.cloud.yandex.net:443 \
    yandex.cloud.mdb.greenplum.v1.ClusterService.ListMasterHosts
```
  Идентификатор кластера можно запросить со списком кластеров в каталоге.
2. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.
Чтобы получить список хостов-сегментов в кластере:
1. Воспользуйтесь вызовом ClusterService.ListSegmentHosts и выполните запрос, например, с помощью gRPCurl:
```
grpcurl \
    -format json \
    -import-path ~/cloudapi/ \
    -import-path ~/cloudapi/third_party/googleapis/ \
    -proto ~/cloudapi/yandex/cloud/mdb/greenplum/v1/cluster_service.proto \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
          "cluster_id": "<идентификатор_кластера>"
        }' \
    mdb.api.cloud.yandex.net:443 \
    yandex.cloud.mdb.greenplum.v1.ClusterService.ListSegmentHosts
```
  Идентификатор кластера можно запросить со списком кластеров в каталоге.
2. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Информация об имеющихся кластерах Yandex MPP Analytics for PostgreSQL

Получить список кластеров в каталогеПолучить список кластеров в каталоге

Получить детальную информацию о кластереПолучить детальную информацию о кластере

Получить информацию о хостах кластераПолучить информацию о хостах кластера

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

Получить список кластеров в каталоге

Получить детальную информацию о кластере

Получить информацию о хостах кластера