[Документация Yandex Cloud](../../index.md) > [Yandex Managed Service for Sharded PostgreSQL](../index.md) > [Пошаговые инструкции](index.md) > Получение информации об имеющихся кластерах # Получение информации об имеющихся кластерах Sharded PostgreSQL Вы можете запросить детальную информацию о каждом созданном вами кластере Managed Service for Sharded PostgreSQL. ## Получить список кластеров в каталоге {#list-clusters} {% list tabs group=instructions %} - Консоль управления {#console} Перейдите в сервис **Yandex Managed Service for Sharded PostgreSQL**. - CLI {#cli} Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), [установите и инициализируйте его](../../cli/quickstart.md#install). По умолчанию используется каталог, указанный при [создании](../../cli/operations/profile/profile-create.md) профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду `yc config set folder-id <идентификатор_каталога>`. Также для любой команды вы можете указать другой каталог с помощью параметров `--folder-name` или `--folder-id`. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа. Чтобы запросить список кластеров Sharded PostgreSQL в каталоге по умолчанию, выполните команду: ```bash yc managed-sharded-postgresql cluster list ``` ```text +----------------------+---------------+-----------------------------+--------+---------+ | ID | NAME | CREATED AT | HEALTH | STATUS | +----------------------+---------------+-----------------------------+--------+---------+ | c9wlk4v14uq7******** | myspqr | 2025-11-02T10:04:14.645214Z | ALIVE | RUNNING | | ... | +----------------------+---------------+-----------------------------+--------+---------+ ``` - REST API {#api} 1. [Получите IAM-токен для аутентификации в API](../api-ref/authentication.md) и поместите токен в переменную среды окружения: ```bash export IAM_TOKEN="" ``` 1. Воспользуйтесь методом [Cluster.List](../api-ref/Cluster/list.md) и выполните запрос, например с помощью [cURL](https://curl.se/): ```bash curl \ --request GET \ --header "Authorization: Bearer $IAM_TOKEN" \ --url 'https://mdb.api.yandexcloud.kz/managed-spqr/v1/clusters' \ --url-query folderId=<идентификатор_каталога> ``` Идентификатор каталога можно запросить со [списком каталогов в облаке](../../resource-manager/operations/folder/get-id.md). 1. Убедитесь, что запрос был выполнен успешно, изучив [ответ сервера](../api-ref/Cluster/list.md#yandex.cloud.mdb.spqr.v1.ListClustersResponse). - gRPC API {#grpc-api} 1. [Получите IAM-токен для аутентификации в API](../api-ref/authentication.md) и поместите токен в переменную среды окружения: ```bash export IAM_TOKEN="" ``` 1. Клонируйте репозиторий [cloudapi](https://github.com/yandex-cloud/cloudapi): ```bash cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi ``` Далее предполагается, что содержимое репозитория находится в директории `~/cloudapi/`. 1. Воспользуйтесь вызовом [ClusterService.List](../api-ref/grpc/Cluster/list.md) и выполните запрос, например с помощью [gRPCurl](https://github.com/fullstorydev/grpcurl): ```bash grpcurl \ -format json \ -import-path ~/cloudapi/ \ -import-path ~/cloudapi/third_party/googleapis/ \ -proto ~/cloudapi/yandex/cloud/mdb/spqr/v1/cluster_service.proto \ -rpc-header "Authorization: Bearer $IAM_TOKEN" \ -d '{ "folder_id": "<идентификатор_каталога>" }' \ mdb.api.yandexcloud.kz:443 \ yandex.cloud.mdb.spqr.v1.ClusterService.List ``` Идентификатор каталога можно запросить со [списком каталогов в облаке](../../resource-manager/operations/folder/get-id.md). 1. Убедитесь, что запрос был выполнен успешно, изучив [ответ сервера](../api-ref/grpc/Cluster/list.md#yandex.cloud.mdb.spqr.v1.ListClustersResponse). {% endlist %} ## Получить детальную информацию о кластере {#get-cluster} {% list tabs group=instructions %} - Консоль управления {#console} 1. Перейдите в сервис **Yandex Managed Service for Sharded PostgreSQL**. 1. Нажмите на имя нужного кластера. - CLI {#cli} Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), [установите и инициализируйте его](../../cli/quickstart.md#install). По умолчанию используется каталог, указанный при [создании](../../cli/operations/profile/profile-create.md) профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду `yc config set folder-id <идентификатор_каталога>`. Также для любой команды вы можете указать другой каталог с помощью параметров `--folder-name` или `--folder-id`. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа. Чтобы получить информацию о кластере Sharded PostgreSQL, выполните команду: ```bash yc managed-sharded-postgresql cluster get <имя_или_идентификатор_кластера> ``` Имя и идентификатор кластера можно получить со [списком кластеров](cluster-list.md#list-clusters) в каталоге. - REST API {#api} 1. [Получите IAM-токен для аутентификации в API](../api-ref/authentication.md) и поместите токен в переменную среды окружения: ```bash export IAM_TOKEN="" ``` 1. Воспользуйтесь методом [Cluster.Get](../api-ref/Cluster/get.md) и выполните запрос, например с помощью [cURL](https://curl.se/): ```bash curl \ --request GET \ --header "Authorization: Bearer $IAM_TOKEN" \ --url 'https://mdb.api.yandexcloud.kz/managed-spqr/v1/clusters/<идентификатор_кластера>' ``` Идентификатор кластера можно получить со [списком кластеров](cluster-list.md#list-clusters) в каталоге. 1. Убедитесь, что запрос был выполнен успешно, изучив [ответ сервера](../api-ref/Cluster/get.md#yandex.cloud.mdb.spqr.v1.Cluster). - gRPC API {#grpc-api} 1. [Получите IAM-токен для аутентификации в API](../api-ref/authentication.md) и поместите токен в переменную среды окружения: ```bash export IAM_TOKEN="" ``` 1. Клонируйте репозиторий [cloudapi](https://github.com/yandex-cloud/cloudapi): ```bash cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi ``` Далее предполагается, что содержимое репозитория находится в директории `~/cloudapi/`. 1. Воспользуйтесь вызовом [ClusterService.Get](../api-ref/grpc/Cluster/get.md) и выполните запрос, например с помощью [gRPCurl](https://github.com/fullstorydev/grpcurl): ```bash grpcurl \ -format json \ -import-path ~/cloudapi/ \ -import-path ~/cloudapi/third_party/googleapis/ \ -proto ~/cloudapi/yandex/cloud/mdb/spqr/v1/cluster_service.proto \ -rpc-header "Authorization: Bearer $IAM_TOKEN" \ -d '{ "cluster_id": "<идентификатор_кластера>" }' \ mdb.api.yandexcloud.kz:443 \ yandex.cloud.mdb.spqr.v1.ClusterService.Get ``` Идентификатор кластера можно получить со [списком кластеров](cluster-list.md#list-clusters) в каталоге. 1. Убедитесь, что запрос был выполнен успешно, изучив [ответ сервера](../api-ref/grpc/Cluster/create.md#yandex.cloud.mdb.spqr.v1.Cluster). {% endlist %} ## Посмотреть операции с кластерами {#list-operations} Все действия с кластерами Managed Service for Sharded PostgreSQL сохраняются в виде списка операций. Каждой операции присваивается уникальный идентификатор. ### Получить список операций {#get-operations} {% list tabs group=instructions %} - Консоль управления {#console} Чтобы посмотреть операции со всеми кластерами Managed Service for Sharded PostgreSQL, на панели слева выберите ![image](../../_assets/console-icons/list-check.svg) **Операции**. В открывшемся списке также отображаются операции для ресурсов, которые были удалены. Чтобы получить список операций для существующего кластера: 1. В [консоли управления](https://kz.console.yandex.cloud) откройте каталог, в котором находится кластер. 1. Перейдите в сервис **Yandex Managed Service for Sharded PostgreSQL**. 1. На панели слева выберите ![image](../../_assets/console-icons/cubes-3.svg) **Кластеры**. 1. Выберите нужный кластер и перейдите на вкладку ![image](../../_assets/console-icons/list-check.svg) **Операции**. В открывшемся списке отображаются операции с выбранным кластером. - CLI {#cli} Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), [установите и инициализируйте его](../../cli/quickstart.md#install). По умолчанию используется каталог, указанный при [создании](../../cli/operations/profile/profile-create.md) профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду `yc config set folder-id <идентификатор_каталога>`. Также для любой команды вы можете указать другой каталог с помощью параметров `--folder-name` или `--folder-id`. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа. Чтобы получить список операций для кластера Managed Service for Sharded PostgreSQL, воспользуйтесь командой: ```bash yc managed-sharded-postgresql cluster list-operations <имя_или_идентификатор_кластера> ``` Результат: ```text +----------------------+---------------------+----------------------+---------------------+--------+--------------------------------+ | ID | CREATED AT | CREATED BY | MODIFIED AT | STATUS | DESCRIPTION | +----------------------+---------------------+----------------------+---------------------+--------+--------------------------------+ | c5m7ll6pq3j8******** | 2025-11-28 19:05:42 | ajeef73j5iq9******** | 2025-11-28 19:08:05 | DONE | Add shard to SPQR cluster | | c5mb0no66172******** | 2025-11-19 12:48:40 | ajeef73j5iq9******** | 2025-11-19 12:50:14 | DONE | Add shard to SPQR cluster | | c5m6of9he7op******** | 2025-11-13 19:25:21 | ajeef73j5iq9******** | 2025-11-13 19:32:00 | DONE | Create SPQR cluster | +----------------------+---------------------+----------------------+---------------------+---- ---+--------------------------------+ ``` Имя и идентификатор кластера можно получить со [списком кластеров](cluster-list.md#list-clusters) в каталоге. По умолчанию информация об операциях выводится в текстовом формате. Чтобы получить более подробную информацию, укажите формат `yaml` или `json` для выводимых данных с помощью параметра `--format`: ```bash yc managed-sharded-postgresql cluster list-operations c9qk2926qqu9******** --format yaml ``` Результат: ```text - id: c9q2m9jrootm******** description: Add shard to SPQR cluster created_at: "2025-12-11T09:14:15.564589Z" created_by: ajej2i98kcjd******** modified_at: "2025-12-11T09:15:20.619684Z" done: true metadata: '@type': type.googleapis.com/yandex.cloud.mdb.spqr.v1.AddClusterShardMetadata cluster_id: c9qk2926qqu9******** shard_name: shard2 response: '@type': type.googleapis.com/yandex.cloud.mdb.spqr.v1.Shard name: shard2 cluster_id: c9qk2926qqu9******** ... ``` - REST API {#api} 1. [Получите IAM-токен для аутентификации в API](../api-ref/authentication.md) и поместите токен в переменную среды окружения: ```bash export IAM_TOKEN="" ``` 1. Воспользуйтесь методом [Cluster.ListOperations](../api-ref/Cluster/listOperations.md) и выполните запрос, например с помощью [cURL](https://curl.se/): ```bash curl \ --request GET \ --header "Authorization: Bearer $IAM_TOKEN" \ --url 'https://mdb.api.yandexcloud.kz/managed-spqr/v1/clusters/<идентификатор_кластера>/operations' ``` Идентификатор кластера можно получить со [списком кластеров](cluster-list.md#list-clusters) в каталоге. 1. Убедитесь, что запрос был выполнен успешно, изучив [ответ сервера](../api-ref/Cluster/listOperations.md#yandex.cloud.mdb.spqr.v1.ListClusterOperationsResponse). - gRPC API {#grpc-api} 1. [Получите IAM-токен для аутентификации в API](../api-ref/authentication.md) и поместите токен в переменную среды окружения: ```bash export IAM_TOKEN="" ``` 1. Клонируйте репозиторий [cloudapi](https://github.com/yandex-cloud/cloudapi): ```bash cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi ``` Далее предполагается, что содержимое репозитория находится в директории `~/cloudapi/`. 1. Воспользуйтесь вызовом [ClusterService.ListOperations](../api-ref/grpc/Cluster/listOperations.md) и выполните запрос, например с помощью [gRPCurl](https://github.com/fullstorydev/grpcurl): ```bash grpcurl \ -format json \ -import-path ~/cloudapi/ \ -import-path ~/cloudapi/third_party/googleapis/ \ -proto ~/cloudapi/yandex/cloud/mdb/spqr/v1/cluster_service.proto \ -rpc-header "Authorization: Bearer $IAM_TOKEN" \ -d '{ "cluster_id": "<идентификатор_кластера>" }' \ mdb.api.yandexcloud.kz:443 \ yandex.cloud.mdb.spqr.v1.ClusterService.ListOperations ``` Идентификатор кластера можно получить со [списком кластеров](cluster-list.md#list-clusters) в каталоге. 1. Убедитесь, что запрос был выполнен успешно, изучив [ответ сервера](../api-ref/grpc/Cluster/listOperations.md#yandex.cloud.mdb.spqr.v1.ListClusterOperationsResponse). {% endlist %} ### Получить подробную информацию об операции {#get-operations-info} {% list tabs group=instructions %} - CLI {#cli} Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), [установите и инициализируйте его](../../cli/quickstart.md#install). По умолчанию используется каталог, указанный при [создании](../../cli/operations/profile/profile-create.md) профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду `yc config set folder-id <идентификатор_каталога>`. Также для любой команды вы можете указать другой каталог с помощью параметров `--folder-name` или `--folder-id`. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа. Чтобы получить подробную информацию об операции, выполните команду: ```bash yc operation get <идентификатор_операции> ``` Идентификатор операции можно получить со [списком операций](cluster-list.md#get-operations) для кластера. Пример выдачи для завершенной операции по созданию кластера: ```text id: e4umughncjh0msa6cbfi description: Create SPQR cluster created_at: "2026-03-10T16:43:46.013971Z" created_by: ajefhe0o8uas******** modified_at: "2026-03-10T16:51:08.736844Z" done: true metadata: '@type': type.googleapis.com/yandex.cloud.mdb.spqr.v1.CreateClusterMetadata cluster_id: c9qheabu83os******** response: '@type': type.googleapis.com/google.rpc.Status message: OK ``` - REST API {#api} 1. [Получите IAM-токен для аутентификации в API](../api-ref/authentication.md) и поместите токен в переменную среды окружения: ```bash export IAM_TOKEN="" ``` 1. Воспользуйтесь методом [Operation.Get](../api-ref/Operation/get.md) и выполните запрос, например с помощью [cURL](https://curl.se/): ```bash curl \ --request GET \ --header "Authorization: Bearer $IAM_TOKEN" \ --url 'https://operation.api.cloud.yandex.net/operations/<идентификатор_операции>' ``` Идентификатор операции можно получить со [списком операций](cluster-list.md#get-operations) для кластера. 1. Убедитесь, что запрос был выполнен успешно, изучив [ответ сервера](../api-ref/Operation/get.md#yandex.cloud.operation.Operation). - gRPC API {#grpc-api} 1. [Получите IAM-токен для аутентификации в API](../api-ref/authentication.md) и поместите токен в переменную среды окружения: ```bash export IAM_TOKEN="" ``` 1. Клонируйте репозиторий [cloudapi](https://github.com/yandex-cloud/cloudapi): ```bash cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi ``` Далее предполагается, что содержимое репозитория находится в директории `~/cloudapi/`. 1. Воспользуйтесь вызовом [OperationService.Get](../api-ref/grpc/Operation/get.md) и выполните запрос, например с помощью [gRPCurl](https://github.com/fullstorydev/grpcurl): ```bash 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 ``` Идентификатор операции можно получить со [списком операций](cluster-list.md#get-operations) для кластера. 1. Убедитесь, что запрос был выполнен успешно, изучив [ответ сервера](../api-ref/grpc/Operation/get.md#yandex.cloud.operation.Operation). {% endlist %} ### Полезные ссылки {#see-also} * [Работа с операциями](../../api-design-guide/concepts/about-async.md)