Updating an environment

Written by

Updated at September 9, 2026

After creating an environment, you can update its general information: name, description, and labels. If you want to change the list of packages or your Apache Spark™ version, create a new environment based on the existing one and make the necessary changes.

Management console

gRPC API

In the management console, select the folder.
Navigate to Managed Service for Apache Spark™.
In the left-hand panel, select Environments.
Select the required environment from the list, navigate to it, and click Edit on the top panel.
Under General information, update the environment name, description, and labels.
Click Save changes.

Get an IAM token for API authentication and put it into an environment variable:
```
export IAM_TOKEN="<IAM_token>"
```
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.

Use the EnvironmentService/Update call to update the environment:

grpcurl \
  -format json \
  -import-path ~/cloudapi/ \
  -import-path ~/cloudapi/third_party/googleapis/ \
  -proto ~/cloudapi/yandex/cloud/spark/v1/environment/environment_service.proto \
  -rpc-header "Authorization: Bearer $IAM_TOKEN" \
  -d '{
         "environment_id": "<environment_ID>",
         "update_mask": {
           "paths": [
             "name",
             "description"
           ]
         },
         "name": "<new_environment_name>",
         "description": "<new_environment_description>"
     }' \
  spark.api.cloud.yandex.net:443 \
  yandex.cloud.spark.v1.environment.EnvironmentService.Update

To get your environment ID, call the EnvironmentService/List method.

In update_mask, list the parameters to update. Provide new values in relevant fields.

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

Updating an environment

Was the article helpful?