Querying Information of a Specified Cluster (Discarded)

Function

This API is used to query information about a specified cluster, including the name, description, and number of bound computing resources.

This API has been discarded and is not recommended.

URI

• URI format

  GET /v2.0/{project_id}/clusters/{cluster_name}

• Parameter description

  Table 1 URI parameters

  Parameter	Mandatory	Description
  project_id	Yes	Project ID, which is used for resource isolation. For details about how to obtain its value, see Obtaining a Project ID.
  cluster_name	Yes	Cluster name

Request

None

Response

• Return code

  Code 200 is returned if the operation is successful.

• Response parameters
  Table 2 describes the response parameters.

  Table 2 Response parameters

  Parameter	Mandatory	Type	Description
  create_time	Yes	Long	Time when a cluster is created. The timestamp is expressed in milliseconds.
  description	No	String	Description of a cluster.
  cu_count	Yes	Integer	Number of CUs that are bound to a cluster.
  owner	Yes	String	User who creates the cluster.
  cluster_name	Yes	String	Cluster name
  status	Yes	String	Cluster status. For details, see Table 3.
  resource_mode	Yes	Integer	Cluster type. 0: Shared cluster 1: Dedicated cluster

  Table 3 Cluster status

  Parameter	Description
  CREATING	The cluster is being created and is unavailable now.
  AVAILABLE	The cluster is available.
  SUSPENDED	The cluster is suspended because it is not used for a long time. You can reactivate the cluster by using the Creating a Batch Processing Job interface.
  RECOVERING	The cluster is being recovered from the suspending state. The cluster is available again after its status changes to AVAILABLE.

Example

• Example request

  None

• Example response (successful request)

  { 
      "create_time": 1508143955000, 
      "cu_count": 16, 
      "description": "test", 
      "owner": "tenant1", 
      "cluster_name": "cluster1",
      "status": "AVAILABLE",
      "resource_mode": 0
   }

  

  If an error occurs when this API is invoked, the system does not return the result similar to the preceding example, but returns the error code and error information. For details, see Error Codes.