View a Cluster Configuration

GET /api/v1.3/clusters/<Cluster ID> or <Cluster Label>

This API is used to get the configuration details of a single cluster. Invoke this API with the cluster ID or a label that is assigned to it.

Note

List Clusters describes the API to list all clusters of a specific account.

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 viewing a cluster configuration. See Managing Groups and Managing Roles for more information.

Example

Get the configuration information of a single cluster

curl -X GET -H "X-AUTH-TOKEN:$X_AUTH_TOKEN" -H "Content-Type:application/json" -H "Accept: application/json" \
https://api.qubole.com/api/v1.3/clusters/1710

Note

The above syntax uses https://api.qubole.com as the endpoint. Qubole provides other endpoints to access QDS that are described in Supported Qubole Endpoints on Different Cloud Providers.

Response

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

    "security_settings":{
     "encrypted_ephemerals":false
   },
   "enable_ganglia_monitoring":false,
   "label":[
   "my_cluster"
   ],
   "ec2_settings":{
     "compute_validated":false,
     "compute_secret_key":"<your_ec2_compute_secret_key>",
     "aws_region":"us-west-2",
     "vpc_id":null,
     "aws_preferred_availability_zone":"Any",
     "compute_access_key":"<your_ec2_compute_access_key>",
     "subnet_id":null
   },
   "node_bootstrap_file":"node_bootstrap.sh",
   "hadoop_settings":{
   "use_hadoop2":false,
    "custom_config":null,
    "fairscheduler_settings":{
      "default_pool":null
    }
   },
   "disallow_cluster_termination":false,
   "presto_settings":{
   "enable_presto":false,
    "custom_config":null
   },
  "id":116,
  "state":"DOWN",
  "node_configuration":{
   "max_nodes":10,
   "master_instance_type":"m1.large",
   "slave_instance_type":"m1.xlarge",
   "use_stable_spot_nodes":false,
   "slave_request_type":"spot",
   "initial_nodes":1,
   "spot_instance_settings":{
     "maximum_bid_price_percentage":"100.0",
     "timeout_for_request":10,
     "maximum_spot_instance_percentage":60
    }
 }
}