Get timeseries utilization metrics for cloud commitment programs, including used and unused cost series over time.
This endpoint requires the cloud_cost_management_read permission.
OAuth apps require the cloud_cost_management_read authorization scope to access this endpoint.
Arguments
Query Strings
Name
Type
Description
provider [required]
enum
Cloud provider for commitment programs (aws or azure). Allowed enum values: aws, azure
product [required]
string
Cloud product identifier (for example, ec2, rds, virtualmachines).
start [required]
integer
Start of the query time range in Unix milliseconds.
end [required]
integer
End of the query time range in Unix milliseconds.
filterBy
string
Optional filter expression to narrow down results.
commitmentType
enum
Type of commitment to query. ri for Reserved Instances, sp for Savings Plans. Defaults to ri. Allowed enum values: ri, sp
# Required query arguments exportprovider="aws" exportproduct="ec2" exportstart="1.6935264e+12" exportend="1.6961184e+12" # Use a Personal Access Token or Service Access Token exportDD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"python3"example.py"
# Get commitments utilization (timeseries) returns "OK" responserequire"datadog_api_client"DatadogAPIClient.configuredo|config|config.access_token=ENV["DD_BEARER_TOKEN"]config.unstable_operations["v2.get_commitments_utilization_timeseries".to_sym]=trueendapi_instance=DatadogAPIClient::V2::CloudCostManagementAPI.newpapi_instance.get_commitments_utilization_timeseries(CommitmentsProvider::AWS,"product",9223372036854775807,9223372036854775807)
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"rb"example.rb"
// Get commitments utilization (timeseries) returns "OK" responsepackagemainimport("context""encoding/json""fmt""os""github.com/DataDog/datadog-api-client-go/v2/api/datadog""github.com/DataDog/datadog-api-client-go/v2/api/datadogV2")funcmain(){ctx:=datadog.NewDefaultContext(context.Background())ctx=context.WithValue(ctx,datadog.ContextAccessToken,os.Getenv("DD_BEARER_TOKEN"))configuration:=datadog.NewConfiguration()configuration.SetUnstableOperationEnabled("v2.GetCommitmentsUtilizationTimeseries",true)apiClient:=datadog.NewAPIClient(configuration)api:=datadogV2.NewCloudCostManagementApi(apiClient)resp,r,err:=api.GetCommitmentsUtilizationTimeseries(ctx,datadogV2.COMMITMENTSPROVIDER_AWS,"product",9223372036854775807,9223372036854775807,*datadogV2.NewGetCommitmentsUtilizationTimeseriesOptionalParameters())iferr!=nil{fmt.Fprintf(os.Stderr,"Error when calling `CloudCostManagementApi.GetCommitmentsUtilizationTimeseries`: %v\n",err)fmt.Fprintf(os.Stderr,"Full HTTP response: %v\n",r)}responseContent,_:=json.MarshalIndent(resp,""," ")fmt.Fprintf(os.Stdout,"Response from `CloudCostManagementApi.GetCommitmentsUtilizationTimeseries`:\n%s\n",responseContent)}
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"go run"main.go"
// Get commitments utilization (timeseries) returns "OK" responseimportcom.datadog.api.client.ApiClient;importcom.datadog.api.client.ApiException;importcom.datadog.api.client.v2.api.CloudCostManagementApi;importcom.datadog.api.client.v2.model.CommitmentsProvider;importcom.datadog.api.client.v2.model.CommitmentsUtilizationTimeseriesResponse;publicclassExample{publicstaticvoidmain(String[]args){ApiClientdefaultClient=ApiClient.getDefaultApiClient();defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN"));defaultClient.setUnstableOperationEnabled("v2.getCommitmentsUtilizationTimeseries",true);CloudCostManagementApiapiInstance=newCloudCostManagementApi(defaultClient);try{CommitmentsUtilizationTimeseriesResponseresult=apiInstance.getCommitmentsUtilizationTimeseries(CommitmentsProvider.AWS,"ec2",1693526400000L,1696118400000L);System.out.println(result);}catch(ApiExceptione){System.err.println("Exception when calling CloudCostManagementApi#getCommitmentsUtilizationTimeseries");System.err.println("Status code: "+e.getCode());System.err.println("Reason: "+e.getResponseBody());System.err.println("Response headers: "+e.getResponseHeaders());e.printStackTrace();}}}
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"java"Example.java"
// Get commitments utilization (timeseries) returns "OK" response
usedatadog_api_client::datadog;usedatadog_api_client::datadogV2::api_cloud_cost_management::CloudCostManagementAPI;usedatadog_api_client::datadogV2::api_cloud_cost_management::GetCommitmentsUtilizationTimeseriesOptionalParams;usedatadog_api_client::datadogV2::model::CommitmentsProvider;#[tokio::main]asyncfnmain(){letmutconfiguration=datadog::Configuration::new();configuration.set_unstable_operation_enabled("v2.GetCommitmentsUtilizationTimeseries",true);letapi=CloudCostManagementAPI::with_config(configuration);letresp=api.get_commitments_utilization_timeseries(CommitmentsProvider::AWS,"product".to_string(),9223372036854775807,9223372036854775807,GetCommitmentsUtilizationTimeseriesOptionalParams::default(),).await;ifletOk(value)=resp{println!("{:#?}",value);}else{println!("{:#?}",resp.unwrap_err());}}
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_API_KEY="<DD_API_KEY>"DD_APP_KEY="<DD_APP_KEY>"cargo run
/**
* Get commitments utilization (timeseries) returns "OK" response
*/import{client,v2}from"@datadog/datadog-api-client";constconfiguration=client.createConfiguration({authMethods:{AuthZ:{accessToken: process.env.DD_BEARER_TOKENasstring,},},});configuration.unstableOperations["v2.getCommitmentsUtilizationTimeseries"]=true;constapiInstance=newv2.CloudCostManagementApi(configuration);constparams: v2.CloudCostManagementApiGetCommitmentsUtilizationTimeseriesRequest={provider:"aws",product:"product",start: 9223372036854775807,end: 9223372036854775807,};apiInstance.getCommitmentsUtilizationTimeseries(params).then((data: v2.CommitmentsUtilizationTimeseriesResponse)=>{console.log("API called successfully. Returned data: "+JSON.stringify(data));}).catch((error: any)=>console.error(error));
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"tsc"example.ts"
Request a personalized demo
Get Started with Datadog
Ask AI
AI-generated responses may be inaccurate. Verify important info.