Edit a Cluster on Microsoft Azure

PUT /api/v2/clusters/<cluster-id>/<cluster label>

Use this API to edit a cluster that is on Microsoft Azure.

Required Role

The following users can make this API call:

  • Users who belong to the system-user or system-admin group.

  • Users who belong to a group associated with a role that allows creating a cluster. See Managing Groups and Managing Roles for more information.

Parameters

Parameters describes the list of parameters of a cluster on Microsoft Azure. You can change the name of the cluster.

While editing a cluster, all parameters are optional.

Request API Syntax

Request API Syntax explains the entire syntax for creating a cluster. You can add the configuration that needs modification of an existing cluster in the Edit API payload.

Sample API Requests

Here is a sample API request to edit a cluster with 1223 as its ID.

curl -X PUT -H "X-AUTH-TOKEN:$X_AUTH_TOKEN" -H "Content-Type:application/json" -H "Accept: application/json" \
-d '{
 "cluster_info": {
          "min_nodes": 1,
          "max_nodes": 6
          }
 }' \ "https://azure.qubole.com/api/v2/clusters/1223"

Here is a sample API request to add Presto overrides.

curl -X PUT -H "X-AUTH-TOKEN:$AUTH-TOKEN" -H "Content-Type:application/json" -H "Accept: application/json" \
-d '{"engine_config":{
         "flavour":"presto",
         "presto_settings":{
               "custom_presto_config":"jvm.config:\n-Xmx16G \nconfig.properties:\ndatasources=jmx,hive,sqlservercatalog\nascm.enabled=false\ncatalog/sqlservercatalog.properties:\nconnector.name=sqlserver\nconnection-url=jdbc:sqlserver://xxx.xx.xx.xx:xxxx;databaseName=HadoopData\nconnection-user=username\nconnection-password=password",
               "presto_version":"0.180"
         }
         }
     }' \ "https://azure.qubole.com/api/v2/clusters/cluster-id"