import requests
url = "https://platform.ankra.app/api/v1/org/cloud-cost/waste"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://platform.ankra.app/api/v1/org/cloud-cost/waste', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request GET \
--url https://platform.ankra.app/api/v1/org/cloud-cost/waste \
--header 'Authorization: Bearer <token>'{
"credential_errors": [
{
"credential_name": "<string>",
"credential_outside_projects": true,
"error": "<string>",
"provider": "<string>",
"scanned_at": "2023-11-07T05:31:56Z"
}
],
"currency": "<string>",
"findings": [
{
"cluster_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"cluster_name": "<string>",
"credential_name": "<string>",
"details": {},
"external_id": "<string>",
"first_seen_at": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kind": "<string>",
"last_seen_at": "2023-11-07T05:31:56Z",
"monthly_cost_cents": 123,
"provider": "<string>",
"region": "<string>",
"resource_name": "<string>",
"origin_namespace": "<string>",
"is_shared": true,
"counts_toward_savings": true,
"cleanup_refusal": {
"code": "<string>",
"message": "<string>"
}
}
],
"has_data": true,
"scanned_at": "2023-11-07T05:31:56Z",
"total_monthly_cost_cents": 123,
"unpriced_finding_count": 123,
"shared_not_counted_monthly_cost_cents": 123,
"shared_not_counted_finding_count": 123,
"consent": {
"kinds": [
"<string>"
],
"min_unattached_days": 123,
"minimum_days_by_kind": {},
"sentence_by_kind": {},
"consent_by_kind": {},
"snapshot_retention_days": 123
},
"scope": {
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"project_name": "<string>",
"all_projects": true,
"partial": true
},
"unattributed_finding_count": 123,
"unattributed_monthly_cost_cents": 123
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}List open cloud waste findings
The organisation’s open waste findings from the latest scan, with the credentials whose sweep failed so an incomplete scan never reads as zero waste. A caller limited to some projects (a token pinned to a project, or a member who only holds roles on projects) is told only about the credentials those projects can use: their failed sweeps, a scanned_at taken from their scans alone (null when there are none), and their names on findings; a finding whose credential is outside those projects carries an empty credential_name. When a credential outside those projects failed its scan and had seen findings in those projects or on their clusters, the caller gets one extra credential_errors entry with credential_outside_projects true that names no credential, so an incomplete scan still never reads as complete. Bearer-PAT twin of the browser route of the same name under /org; the console’s session cookie is not accepted here and the browser route answers a token with a login redirect.
import requests
url = "https://platform.ankra.app/api/v1/org/cloud-cost/waste"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://platform.ankra.app/api/v1/org/cloud-cost/waste', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request GET \
--url https://platform.ankra.app/api/v1/org/cloud-cost/waste \
--header 'Authorization: Bearer <token>'{
"credential_errors": [
{
"credential_name": "<string>",
"credential_outside_projects": true,
"error": "<string>",
"provider": "<string>",
"scanned_at": "2023-11-07T05:31:56Z"
}
],
"currency": "<string>",
"findings": [
{
"cluster_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"cluster_name": "<string>",
"credential_name": "<string>",
"details": {},
"external_id": "<string>",
"first_seen_at": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kind": "<string>",
"last_seen_at": "2023-11-07T05:31:56Z",
"monthly_cost_cents": 123,
"provider": "<string>",
"region": "<string>",
"resource_name": "<string>",
"origin_namespace": "<string>",
"is_shared": true,
"counts_toward_savings": true,
"cleanup_refusal": {
"code": "<string>",
"message": "<string>"
}
}
],
"has_data": true,
"scanned_at": "2023-11-07T05:31:56Z",
"total_monthly_cost_cents": 123,
"unpriced_finding_count": 123,
"shared_not_counted_monthly_cost_cents": 123,
"shared_not_counted_finding_count": 123,
"consent": {
"kinds": [
"<string>"
],
"min_unattached_days": 123,
"minimum_days_by_kind": {},
"sentence_by_kind": {},
"consent_by_kind": {},
"snapshot_retention_days": 123
},
"scope": {
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"project_name": "<string>",
"all_projects": true,
"partial": true
},
"unattributed_finding_count": 123,
"unattributed_monthly_cost_cents": 123
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}Authorizations
Query Parameters
Response
Successful response
The priced monthly cost of the listed findings with counts_toward_savings false (findings Ankra treats as shared with another Ankra organisation (see is_shared), or whose sharing Ankra cannot tell), which Ankra cleans up from no organisation; it is not in total_monthly_cost_cents.
The kinds this platform cleans up only with a person's written consent because the cleanup cannot be undone (a volume with no snapshot, a stopped server and its disks, a released address or load balancer), the minimum age each kind must have been seen idle before it may be cleaned up, and the sentence a person agrees to.
Show child attributes
Show child attributes