Get timeseries savings metrics for cloud commitment programs, including actual cost, on-demand equivalent cost, realized savings, and effective savings rate 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.
引数
クエリ文字列
名前
タイプ
説明
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.
# 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 savings (timeseries) returns "OK" responserequire"datadog_api_client"DatadogAPIClient.configuredo|config|config.access_token=ENV["DD_BEARER_TOKEN"]config.unstable_operations["v2.get_commitments_savings_timeseries".to_sym]=trueendapi_instance=DatadogAPIClient::V2::CloudCostManagementAPI.newpapi_instance.get_commitments_savings_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 savings (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.GetCommitmentsSavingsTimeseries",true)apiClient:=datadog.NewAPIClient(configuration)api:=datadogV2.NewCloudCostManagementApi(apiClient)resp,r,err:=api.GetCommitmentsSavingsTimeseries(ctx,datadogV2.COMMITMENTSPROVIDER_AWS,"product",9223372036854775807,9223372036854775807,*datadogV2.NewGetCommitmentsSavingsTimeseriesOptionalParameters())iferr!=nil{fmt.Fprintf(os.Stderr,"Error when calling `CloudCostManagementApi.GetCommitmentsSavingsTimeseries`: %v\n",err)fmt.Fprintf(os.Stderr,"Full HTTP response: %v\n",r)}responseContent,_:=json.MarshalIndent(resp,""," ")fmt.Fprintf(os.Stdout,"Response from `CloudCostManagementApi.GetCommitmentsSavingsTimeseries`:\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 savings (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.CommitmentsSavingsTimeseriesResponse;publicclassExample{publicstaticvoidmain(String[]args){ApiClientdefaultClient=ApiClient.getDefaultApiClient();defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN"));defaultClient.setUnstableOperationEnabled("v2.getCommitmentsSavingsTimeseries",true);CloudCostManagementApiapiInstance=newCloudCostManagementApi(defaultClient);try{CommitmentsSavingsTimeseriesResponseresult=apiInstance.getCommitmentsSavingsTimeseries(CommitmentsProvider.AWS,"ec2",1693526400000L,1696118400000L);System.out.println(result);}catch(ApiExceptione){System.err.println("Exception when calling CloudCostManagementApi#getCommitmentsSavingsTimeseries");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 savings (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::GetCommitmentsSavingsTimeseriesOptionalParams;usedatadog_api_client::datadogV2::model::CommitmentsProvider;#[tokio::main]asyncfnmain(){letmutconfiguration=datadog::Configuration::new();configuration.set_unstable_operation_enabled("v2.GetCommitmentsSavingsTimeseries",true);letapi=CloudCostManagementAPI::with_config(configuration);letresp=api.get_commitments_savings_timeseries(CommitmentsProvider::AWS,"product".to_string(),9223372036854775807,9223372036854775807,GetCommitmentsSavingsTimeseriesOptionalParams::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 savings (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.getCommitmentsSavingsTimeseries"]=true;constapiInstance=newv2.CloudCostManagementApi(configuration);constparams: v2.CloudCostManagementApiGetCommitmentsSavingsTimeseriesRequest={provider:"aws",product:"product",start: 9223372036854775807,end: 9223372036854775807,};apiInstance.getCommitmentsSavingsTimeseries(params).then((data: v2.CommitmentsSavingsTimeseriesResponse)=>{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"
パーソナライズされたデモをリクエスト
Datadog を始める
Ask AI
AI-generated responses may be inaccurate. Verify important info.