Contact UsTry it for free
© 2026 Direct Cursus Technology L.L.C.

Information about existing clusters

Written by
Updated at January 22, 2026

You can get detailed information about each Apache Spark™ cluster you created.

Getting a list of clusters in a folder

  1. In the management console, navigate to the relevant folder.
  2. Go to Managed Service for Apache Spark™.

  1. Get an IAM token for API authentication and put it into an 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 that the repository contents reside in the ~/cloudapi/ directory.

  3. Call the ClusterService/List method, e.g., via the following gRPCurl request:

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

You can get the folder ID with the [list of folders in the cloud](../../resource-manager/operations/folder/get-id.md).

  4. Check the server response to make sure your request was successful.

Getting detailed information about a cluster

  1. In the management console, navigate to the relevant folder.
  2. Go to Managed Service for Apache Spark™.
  3. Click the cluster name.

  1. Get an IAM token for API authentication and put it into an 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 that the repository contents reside in the ~/cloudapi/ directory.

  3. Call the ClusterService/Get method, e.g., via the following gRPCurl request:

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

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

  4. Check the server response to make sure your request was successful.

Viewing operations with clusters

All actions with Apache Spark™ 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 Apache Spark™ cluster:

  1. In the management console, open the folder containing your cluster.

  2. Go to Managed Service for Apache Spark™.

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

  4. Select the cluster you need.

  5. Navigate to the Operations panel for the cluster you selected.

    You will see the list of operations with this cluster.

  1. Get an IAM token for API authentication and put it into an 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 that the repository contents reside in the ~/cloudapi/ directory.

  3. Call the ClusterService/ListOperations method, e.g., via the following gRPCurl request:

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

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

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

See also

Previous
All guides
Next
Creating a cluster