List container recommendations with additional details
curl --request GET \
--url 'https://{host}/api/v2/kubernetes/clusters/{clusterName}/containers?details=true' \
--header 'Authorization: Bearer <token>'import requests
url = "https://{host}/api/v2/kubernetes/clusters/{clusterName}/containers?details=true"
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?details=true', 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?details=true",
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?details=true"
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?details=true")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{host}/api/v2/kubernetes/clusters/{clusterName}/containers?details=true")
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
},
"predictedUptime": 123,
"configLastChangedOn": "2023-11-07T05:31:56Z",
"nodeGroup": [
"<string>"
],
"oomKills_last7days": 123,
"dateFirstAudited": "2023-11-07T05:31:56Z",
"dateLastAudited": "2023-11-07T05:31:56Z"
}
]{
"status": 123,
"message": "<string>"
}{
"status": 123,
"message": "<string>"
}{
"status": 123,
"message": "<string>"
}Kubernetes Clusters Results
List container recommendations with additional details
Returns recommendation details for container manifests in the specified cluster with additional fields. This endpoint includes all base fields plus: predictedUptime, configLastChangedOn, nodeGroup, oomKills_last7days, dateFirstAudited, and dateLastAudited. Fields with no value may be omitted from the response.
GET
/
kubernetes
/
clusters
/
{clusterName}
/
containers?details=true
List container recommendations with additional details
curl --request GET \
--url 'https://{host}/api/v2/kubernetes/clusters/{clusterName}/containers?details=true' \
--header 'Authorization: Bearer <token>'import requests
url = "https://{host}/api/v2/kubernetes/clusters/{clusterName}/containers?details=true"
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?details=true', 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?details=true",
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?details=true"
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?details=true")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{host}/api/v2/kubernetes/clusters/{clusterName}/containers?details=true")
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
},
"predictedUptime": 123,
"configLastChangedOn": "2023-11-07T05:31:56Z",
"nodeGroup": [
"<string>"
],
"oomKills_last7days": 123,
"dateFirstAudited": "2023-11-07T05:31:56Z",
"dateLastAudited": "2023-11-07T05:31:56Z"
}
]{
"status": 123,
"message": "<string>"
}{
"status": 123,
"message": "<string>"
}{
"status": 123,
"message": "<string>"
}Overview
This endpoint returns container recommendation details for a specific cluster with additional fields whendetails=true is included.
For the base response format without additional details, see getKubernetesClusterContainers.
Additional Fields with details=true
When you includedetails=true in the query parameters, the following additional fields are included in each container recommendation:
Additional Fields Reference
Additional Fields Reference
| Field | Type | Description |
|---|---|---|
predictedUptime | number (float) | Predicted uptime percentage for the container |
configLastChangedOn | string (date-time) | Timestamp of the most recent change to requests/limits |
nodeGroup | array of strings | Names of associated node groups |
oomKills_last7days | integer | Number of OOM (Out Of Memory) events in the last 7 days |
dateFirstAudited | string (date-time) | When this container was first audited (from workload history) |
dateLastAudited | string (date-time) | When this container was last audited (from workload history) |
Example Request
curl -X GET "https://api.example.com/api/v2/kubernetes/clusters/my-cluster/containers?details=true" \
-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,
// Additional fields when details=true
"predictedUptime": 99.8,
"configLastChangedOn": "2026-05-15T14:20:00Z",
"nodeGroup": ["node-group-1", "node-group-2"],
"oomKills_last7days": 2,
"dateFirstAudited": "2026-01-10T08:00:00Z",
"dateLastAudited": "2026-06-08T10:30:00Z"
}
]
Use Cases
The detailed fields are particularly useful for:- Stability Monitoring:
oomKills_last7dayshelps identify containers experiencing memory pressure - Change Tracking:
configLastChangedOnshows when resource configurations were last modified - Historical Analysis:
dateFirstAuditedanddateLastAuditedprovide audit timeline context - Infrastructure Planning:
nodeGroupinformation helps with placement and scaling decisions - Reliability Metrics:
predictedUptimeaids in understanding container availability patterns
Fields without values may be omitted from the response. All timestamps are in UTC format (
YYYY-MM-DDTHH:mm:ssZ).Authorizations
Path Parameters
Query Parameters
Response
Array of container recommendations with additional details

