Retrieval of clusters (deprecated)
You use the GET
operation on the api/sam/clusters
element
to request information about clusters that group your host computer
systems. This information represents the current state of your environment
and does not include any historical data.
After you retrieve the IDs of your clusters, compare them with the
cluster_id
column retrieved by API for computer systems to recognize which of these systems belong to which
clusters. This information can also be viewed on the Hardware Inventory report in the user
interface.Important:
- To use this API, you must be assigned to the All Computers group and have the View Hardware Inventory permission.
- By default, the retrieved data is sorted by
id
.
Before you begin
Starting from application update 9.2.34, this REST API is disabled by default. To enable it, change the value of the expose_deprecated_api parameter on the Advanced Server Settings panel to true. For more information, see: Advanced server settings.
Important: Deprecated REST APIs are going to be removed at
the end of 2024. After that period, these REST APIs are going to be unsupported. Switch to version 2
of the REST APIs as soon as convenient.
Resource URL
To retrieve information about clusters, use the following URL:
https://hostname:port/api/sam/clusters
Resource information
Operation details | Description |
---|---|
Purpose | Returns a list of clusters. |
HTTP method | GET |
Resource URI | https://server_host_name:port_number/api/sam/clusters |
URI query parameters | For a list of applicable query parameters, see: Query parameters. |
Request headers |
|
Request payload | n/a |
Request Content-Type |
|
Response headers |
|
Response payload | Clusters element |
Response Content-Type |
|
Normal HTTP response codes |
|
Error HTTP response codes |
Message body includes an error message with details. |
Query parameters
You can use query parameters to narrow down the results of your search. The following table
presents query parameters that you can use for the api/sam/clusters
element.
Parameter | Description | Required | Value |
---|---|---|---|
columns[] | Specify which columns to retrieve. If you do not specify this parameter, a set
of default columns is retrieved. For available columns, see Response
body. Example: Retrieve the name and id
columns:
|
No | String |
order | Specify how to sort the returned data. The default direction for sorting
columns is ascending. If you want to specify a descending sort, append desc to the
column name. Example: Order by type
descending:
|
No | String |
limit | Specify the number of rows to retrieve. If you omit this parameter, all rows are retrieved. | No | Numeric |
offset | Specify the number of rows to skip for retrieving results. You can use it
together with the limit parameter to paginate results. Example: Retrieve 50 records starting
after record 150:
|
No | Numeric |
Example HTTP conversation
- Request
-
GET https://server_host_name:port_number/api/sam/clusters
- Request header
-
Accept: application/json Accept-Language: en-US Token: <token>
- Response header
-
HTTP/1.1 200 OK Content-Type: application/json Content-Language: en-US
- Response body (JSON)
-
{ "id": 1, "name": "Production Cluster 1", "cores_count": 24, "vm_manager_url": "https://<ip_address>/sdk", }