Providers
Overview
The Providers resource gives you scoped access to recommendations, savings, and spending data for a specific cloud provider. Provider IDs are: aws, gcp, azure, k8s.
Methods
List Providers
Returns all configured cloud providers for your account.
providers = client.providers.list()Get Top Recommendations
Returns the top 7 recommendations for a specific provider, sorted by savings.
top = client.providers.get_top_recommendations("aws")List Recommendations
Returns a paginated, filterable list of recommendations for a provider.
page = client.providers.list_recommendations(
"aws",
page=1,
page_size=50,
sort_by="monthly_savings",
sort_order="desc",
service=["EC2", "RDS"],
environment=["production"],
display_status=["available", "pending"],
)
for rec in page:
print(f"{rec.recommendation_id}: ${rec.monthly_savings}/mo")Parameters
| Parameter | Type | Description |
|---|---|---|
provider_id | string | Provider: aws, gcp, azure, k8s |
start | string | Start date (ISO 8601: YYYY-MM-DD) |
end | string | End date (ISO 8601: YYYY-MM-DD) |
page | int | Page number (1-indexed) |
page_size | int | Items per page (max 100) |
sort_by | string | Sort field: recommendation_id, service, environment, account, tag, monthly_savings, savings_percentage, status |
sort_order | string | asc or desc |
service | string[] | Filter by service(s) |
environment | string[] | Filter by environment(s) |
account | string[] | Filter by account(s) |
tag | string[] | Filter by tag(s) |
display_status | string[] | Filter by status: available, pending, processing, optimized, rejected, unavailable |
Get Recommendations Overview
Returns overview metrics for a provider: total spend, available savings, pending savings, and saved-to-date.
overview = client.providers.get_recommendations_overview("aws")Get Recommendation Filters
Returns the distinct values available for filtering: environments, accounts, and tags.
filters = client.providers.get_recommendation_filters("aws")List Realized Savings
Returns paginated realized savings for a provider with filtering.
page = client.providers.list_realized_savings(
"aws",
page=1,
page_size=50,
preset="6M",
service=["EC2"],
)Get Realized Savings Summary
Returns aggregate savings totals for a provider.
summary = client.providers.get_realized_savings_summary("aws")Get Costs Summary
Returns a costs summary for a specific provider.
spending = client.providers.get_costs_summary("aws")Get Costs Filters
Returns distinct services, regions, and accounts available for filtering within a date range.
filters = client.providers.get_costs_filters(
"aws",
start="2025-01-01T00:00:00.000Z",
end="2025-03-31T00:00:00.000Z",
)List Costs
Returns a cost breakdown for a provider in multiple formats: table, chart, csv, raw.
spending = client.providers.list_costs(
"aws",
format="table",
page=1,
page_size=50,
sort_by="cost",
sort_order="desc",
)Get Costs Timeline
Returns a costs timeline for a provider over a date range.
timeline = client.providers.get_costs_timeline(
"aws",
start="2025-01-01T00:00:00.000Z",
end="2025-03-31T00:00:00.000Z",
)Get Potential Savings Summary
Returns potential savings summary for a provider.
potential = client.providers.get_potential_savings_summary("aws")List Potential Savings
Returns paginated potential savings breakdown for a provider.
page = client.providers.list_potential_savings(
"aws",
page=1,
page_size=50,
)