List container recommendations for a cluster
curl --request GET \
--url https://{host}/api/v2/kubernetes/clusters/{clusterName}/containers \
--header 'Authorization: Bearer <token>'import requests
url = "https://{host}/api/v2/kubernetes/clusters/{clusterName}/containers"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://{host}/api/v2/kubernetes/clusters/{clusterName}/containers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{host}/api/v2/kubernetes/clusters/{clusterName}/containers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://{host}/api/v2/kubernetes/clusters/{clusterName}/containers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{host}/api/v2/kubernetes/clusters/{clusterName}/containers")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{host}/api/v2/kubernetes/clusters/{clusterName}/containers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"cluster": "<string>",
"namespace": "<string>",
"podOwnerName": "<string>",
"podOwnerKind": "<string>",
"container": "<string>",
"entityId": "<string>",
"containerId": "<string>",
"avgContainerCount": 123,
"currentCpuRequestmCores": 123,
"currentCpuLimitmCores": 123,
"currentMemRequestBytes": 123,
"currentMemLimitBytes": 123,
"recommendedCpuRequestmCores": 123,
"recommendedCpuLimitmCores": 123,
"recommendedMemRequestBytes": 123,
"recommendedMemLimitBytes": 123,
"estimatedSavingsPerContainer": 123,
"analyzedOn": "2023-11-07T05:31:56Z",
"hpaMetricName": "<string>",
"hpaMetricThreshold": "<string>",
"currentEphemeralStorageRequestBytes": 123,
"currentEphemeralStorageLimitBytes": 123,
"recommendedEphemeralStorageRequestBytes": 123,
"recommendedEphemeralStorageLimitBytes": 123,
"gpu": {
"currentGpuModel": "<string>",
"currentGpuSharingStrategy": "<string>",
"currentGpuRequest": 123,
"gpuComputeOptimal": 123,
"gpuMemoryOptimalBytes": 123,
"gpuOverallOptimal": 123,
"recommendedGpuModel": "<string>",
"recommendedGpuSharingStrategy": "<string>",
"recommendedGpuRequest": 123
}
}
]{
"status": 123,
"message": "<string>"
}{
"status": 123,
"message": "<string>"
}{
"status": 123,
"message": "<string>"
}Kubernetes Clusters Results
List container recommendations for a cluster
Returns recommendation details for container manifests in the specified cluster. This endpoint returns the base set of fields. For additional details including uptime predictions, OOM kill counts, and audit history, use the detailed endpoint with details=true. Fields with no value may be omitted from the response.
GET
/
kubernetes
/
clusters
/
{clusterName}
/
containers
List container recommendations for a cluster
curl --request GET \
--url https://{host}/api/v2/kubernetes/clusters/{clusterName}/containers \
--header 'Authorization: Bearer <token>'import requests
url = "https://{host}/api/v2/kubernetes/clusters/{clusterName}/containers"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://{host}/api/v2/kubernetes/clusters/{clusterName}/containers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{host}/api/v2/kubernetes/clusters/{clusterName}/containers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://{host}/api/v2/kubernetes/clusters/{clusterName}/containers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{host}/api/v2/kubernetes/clusters/{clusterName}/containers")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{host}/api/v2/kubernetes/clusters/{clusterName}/containers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"cluster": "<string>",
"namespace": "<string>",
"podOwnerName": "<string>",
"podOwnerKind": "<string>",
"container": "<string>",
"entityId": "<string>",
"containerId": "<string>",
"avgContainerCount": 123,
"currentCpuRequestmCores": 123,
"currentCpuLimitmCores": 123,
"currentMemRequestBytes": 123,
"currentMemLimitBytes": 123,
"recommendedCpuRequestmCores": 123,
"recommendedCpuLimitmCores": 123,
"recommendedMemRequestBytes": 123,
"recommendedMemLimitBytes": 123,
"estimatedSavingsPerContainer": 123,
"analyzedOn": "2023-11-07T05:31:56Z",
"hpaMetricName": "<string>",
"hpaMetricThreshold": "<string>",
"currentEphemeralStorageRequestBytes": 123,
"currentEphemeralStorageLimitBytes": 123,
"recommendedEphemeralStorageRequestBytes": 123,
"recommendedEphemeralStorageLimitBytes": 123,
"gpu": {
"currentGpuModel": "<string>",
"currentGpuSharingStrategy": "<string>",
"currentGpuRequest": 123,
"gpuComputeOptimal": 123,
"gpuMemoryOptimalBytes": 123,
"gpuOverallOptimal": 123,
"recommendedGpuModel": "<string>",
"recommendedGpuSharingStrategy": "<string>",
"recommendedGpuRequest": 123
}
}
]{
"status": 123,
"message": "<string>"
}{
"status": 123,
"message": "<string>"
}{
"status": 123,
"message": "<string>"
}Overview
This endpoint returns container recommendation details for a specific cluster. This is the base response format without additional details. For extended information including uptime predictions, OOM kill counts, node group associations, and audit history, use the detailed endpoint withdetails=true. See getKubernetesClusterContainersDetailed for more information.
Example Request
curl -X GET "https://api.example.com/api/v2/kubernetes/clusters/my-cluster/containers" \
-H "Authorization: Bearer YOUR_API_TOKEN"
Example Response
[
{
"cluster": "my-cluster",
"namespace": "production",
"podOwnerName": "web-app",
"podOwnerKind": "Deployment",
"container": "nginx",
"entityId": "abc123",
"containerId": "def456",
"avgContainerCount": 3,
"currentCpuRequestmCores": 500,
"currentCpuLimitmCores": 1000,
"currentMemRequestBytes": 536870912,
"currentMemLimitBytes": 1073741824,
"recommendedCpuRequestmCores": 300,
"recommendedCpuLimitmCores": 600,
"recommendedMemRequestBytes": 268435456,
"recommendedMemLimitBytes": 536870912,
"estimatedSavingsPerContainer": 45.50,
"analyzedOn": "2026-06-08T10:30:00Z",
"hpaMetricName": "cpu",
"hpaMetricThreshold": "75%",
"currentEphemeralStorageRequestBytes": 1073741824,
"currentEphemeralStorageLimitBytes": 2147483648,
"recommendedEphemeralStorageRequestBytes": 536870912,
"recommendedEphemeralStorageLimitBytes": 1073741824
}
]
Fields without values may be omitted from the response. All timestamps are in UTC format (
YYYY-MM-DDTHH:mm:ssZ).Need More Details?
If you need additional fields such as:- Predicted uptime percentage
- Configuration change history
- Node group associations
- OOM kill events
- Audit timeline information
?details=true to your request.Authorizations
Path Parameters
Response
Array of container recommendations (base fields)
- Option 1
- Option 2
Returns ContainerRecommendation by default, or ContainerRecommendationDetailed when details=true

