SQL Server / Datadog API Collection / Get estimated cost across your account
Back to Collection Items
-- Important: See this note about string length limitations for strings returned by sp_OAMethod calls.
--
CREATE PROCEDURE ChilkatSample
AS
BEGIN
DECLARE @hr int
DECLARE @iTmp0 int
-- Important: Do not use nvarchar(max). See the warning about using nvarchar(max).
DECLARE @sTmp0 nvarchar(4000)
-- This example assumes the Chilkat API to have been previously unlocked.
-- See Global Unlock Sample for sample code.
DECLARE @http int
-- Use "Chilkat_9_5_0.Http" for versions of Chilkat < 10.0.0
EXEC @hr = sp_OACreate 'Chilkat.Http', @http OUT
IF @hr <> 0
BEGIN
PRINT 'Failed to create ActiveX component'
RETURN
END
DECLARE @success int
DECLARE @queryParams int
-- Use "Chilkat_9_5_0.JsonObject" for versions of Chilkat < 10.0.0
EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @queryParams OUT
EXEC sp_OAMethod @queryParams, 'UpdateString', @success OUT, 'view', '<string>'
EXEC sp_OAMethod @queryParams, 'UpdateString', @success OUT, 'start_month', '<dateTime>'
EXEC sp_OAMethod @queryParams, 'UpdateString', @success OUT, 'end_month', '<dateTime>'
EXEC sp_OAMethod @queryParams, 'UpdateString', @success OUT, 'start_date', '<dateTime>'
EXEC sp_OAMethod @queryParams, 'UpdateString', @success OUT, 'end_date', '<dateTime>'
EXEC sp_OAMethod @http, 'SetRequestHeader', NULL, 'Accept', 'application/json;datetime-format=rfc3339'
DECLARE @resp int
EXEC sp_OAMethod @http, 'QuickRequestParams', @resp OUT, 'GET', 'https://api.app.ddog-gov.com/api/v2/usage/estimated_cost', @queryParams
EXEC sp_OAGetProperty @http, 'LastMethodSuccess', @iTmp0 OUT
IF @iTmp0 = 0
BEGIN
EXEC sp_OAGetProperty @http, 'LastErrorText', @sTmp0 OUT
PRINT @sTmp0
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @queryParams
RETURN
END
DECLARE @sbResponseBody int
-- Use "Chilkat_9_5_0.StringBuilder" for versions of Chilkat < 10.0.0
EXEC @hr = sp_OACreate 'Chilkat.StringBuilder', @sbResponseBody OUT
EXEC sp_OAMethod @resp, 'GetBodySb', @success OUT, @sbResponseBody
DECLARE @jResp int
-- Use "Chilkat_9_5_0.JsonObject" for versions of Chilkat < 10.0.0
EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @jResp OUT
EXEC sp_OAMethod @jResp, 'LoadSb', @success OUT, @sbResponseBody
EXEC sp_OASetProperty @jResp, 'EmitCompact', 0
PRINT 'Response Body:'
EXEC sp_OAMethod @jResp, 'Emit', @sTmp0 OUT
PRINT @sTmp0
DECLARE @respStatusCode int
EXEC sp_OAGetProperty @resp, 'StatusCode', @respStatusCode OUT
PRINT 'Response Status Code = ' + @respStatusCode
IF @respStatusCode >= 400
BEGIN
PRINT 'Response Header:'
EXEC sp_OAGetProperty @resp, 'Header', @sTmp0 OUT
PRINT @sTmp0
PRINT 'Failed.'
EXEC @hr = sp_OADestroy @resp
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @queryParams
EXEC @hr = sp_OADestroy @sbResponseBody
EXEC @hr = sp_OADestroy @jResp
RETURN
END
EXEC @hr = sp_OADestroy @resp
-- Sample JSON response:
-- (Sample code for parsing the JSON response is shown below)
-- {
-- "data": [
-- {
-- "attributes": {
-- "charges": [
-- {
-- "charge_type": "<string>",
-- "cost": "<double>",
-- "product_name": "<string>"
-- },
-- {
-- "charge_type": "<string>",
-- "cost": "<double>",
-- "product_name": "<string>"
-- }
-- ],
-- "date": "<dateTime>",
-- "org_name": "<string>",
-- "public_id": "<string>",
-- "region": "<string>",
-- "total_cost": "<double>"
-- },
-- "id": "<string>",
-- "type": "cost_by_org"
-- },
-- {
-- "attributes": {
-- "charges": [
-- {
-- "charge_type": "<string>",
-- "cost": "<double>",
-- "product_name": "<string>"
-- },
-- {
-- "charge_type": "<string>",
-- "cost": "<double>",
-- "product_name": "<string>"
-- }
-- ],
-- "date": "<dateTime>",
-- "org_name": "<string>",
-- "public_id": "<string>",
-- "region": "<string>",
-- "total_cost": "<double>"
-- },
-- "id": "<string>",
-- "type": "cost_by_org"
-- }
-- ]
-- }
-- Sample code for parsing the JSON response...
-- Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code
DECLARE @Date nvarchar(4000)
DECLARE @Org_name nvarchar(4000)
DECLARE @Public_id nvarchar(4000)
DECLARE @Region nvarchar(4000)
DECLARE @Total_cost nvarchar(4000)
DECLARE @id nvarchar(4000)
DECLARE @v_type nvarchar(4000)
DECLARE @j int
DECLARE @count_j int
DECLARE @charge_type nvarchar(4000)
DECLARE @cost nvarchar(4000)
DECLARE @product_name nvarchar(4000)
DECLARE @i int
SELECT @i = 0
DECLARE @count_i int
EXEC sp_OAMethod @jResp, 'SizeOfArray', @count_i OUT, 'data'
WHILE @i < @count_i
BEGIN
EXEC sp_OASetProperty @jResp, 'I', @i
EXEC sp_OAMethod @jResp, 'StringOf', @Date OUT, 'data[i].attributes.date'
EXEC sp_OAMethod @jResp, 'StringOf', @Org_name OUT, 'data[i].attributes.org_name'
EXEC sp_OAMethod @jResp, 'StringOf', @Public_id OUT, 'data[i].attributes.public_id'
EXEC sp_OAMethod @jResp, 'StringOf', @Region OUT, 'data[i].attributes.region'
EXEC sp_OAMethod @jResp, 'StringOf', @Total_cost OUT, 'data[i].attributes.total_cost'
EXEC sp_OAMethod @jResp, 'StringOf', @id OUT, 'data[i].id'
EXEC sp_OAMethod @jResp, 'StringOf', @v_type OUT, 'data[i].type'
SELECT @j = 0
EXEC sp_OAMethod @jResp, 'SizeOfArray', @count_j OUT, 'data[i].attributes.charges'
WHILE @j < @count_j
BEGIN
EXEC sp_OASetProperty @jResp, 'J', @j
EXEC sp_OAMethod @jResp, 'StringOf', @charge_type OUT, 'data[i].attributes.charges[j].charge_type'
EXEC sp_OAMethod @jResp, 'StringOf', @cost OUT, 'data[i].attributes.charges[j].cost'
EXEC sp_OAMethod @jResp, 'StringOf', @product_name OUT, 'data[i].attributes.charges[j].product_name'
SELECT @j = @j + 1
END
SELECT @i = @i + 1
END
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @queryParams
EXEC @hr = sp_OADestroy @sbResponseBody
EXEC @hr = sp_OADestroy @jResp
END
GO
Curl Command
curl -G -d "view=%3Cstring%3E"
-d "start_month=%3CdateTime%3E"
-d "end_month=%3CdateTime%3E"
-d "start_date=%3CdateTime%3E"
-d "end_date=%3CdateTime%3E"
-H "Accept: application/json;datetime-format=rfc3339"
https://api.app.ddog-gov.com/api/v2/usage/estimated_cost
Postman Collection Item JSON
{
"name": "Get estimated cost across your account",
"request": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json;datetime-format=rfc3339"
}
],
"url": {
"raw": "{{baseUrl}}/api/v2/usage/estimated_cost?view=<string>&start_month=<dateTime>&end_month=<dateTime>&start_date=<dateTime>&end_date=<dateTime>",
"host": [
"{{baseUrl}}"
],
"path": [
"api",
"v2",
"usage",
"estimated_cost"
],
"query": [
{
"key": "view",
"value": "<string>",
"description": "String to specify whether cost is broken down at a parent-org level or at the sub-org level. Available views are `summary` and `sub-org`. Defaults to `summary`."
},
{
"key": "start_month",
"value": "<dateTime>",
"description": "Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost beginning this month. Either start_month or start_date should be specified, but not both. (start_month cannot go beyond two months in the past). Provide an `end_month` to view month-over-month cost."
},
{
"key": "end_month",
"value": "<dateTime>",
"description": "Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost ending this month."
},
{
"key": "start_date",
"value": "<dateTime>",
"description": "Datetime in ISO-8601 format, UTC, precise to day: `[YYYY-MM-DD]` for cost beginning this day. Either start_month or start_date should be specified, but not both. (start_date cannot go beyond two months in the past). Provide an `end_date` to view day-over-day cumulative cost."
},
{
"key": "end_date",
"value": "<dateTime>",
"description": "Datetime in ISO-8601 format, UTC, precise to day: `[YYYY-MM-DD]` for cost ending this day."
}
]
},
"description": "Get estimated cost across multi-org and single root-org accounts.\nEstimated cost data is only available for the current month and previous month\nand is delayed by up to 72 hours from when it was incurred.\nTo access historical costs prior to this, use the `/historical_cost` endpoint."
},
"response": [
{
"name": "OK",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json;datetime-format=rfc3339"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "DD-API-KEY",
"value": "<API Key>"
}
],
"url": {
"raw": "{{baseUrl}}/api/v2/usage/estimated_cost?view=<string>&start_month=<dateTime>&end_month=<dateTime>&start_date=<dateTime>&end_date=<dateTime>",
"host": [
"{{baseUrl}}"
],
"path": [
"api",
"v2",
"usage",
"estimated_cost"
],
"query": [
{
"key": "view",
"value": "<string>",
"description": "String to specify whether cost is broken down at a parent-org level or at the sub-org level. Available views are `summary` and `sub-org`. Defaults to `summary`."
},
{
"key": "start_month",
"value": "<dateTime>",
"description": "Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost beginning this month. Either start_month or start_date should be specified, but not both. (start_month cannot go beyond two months in the past). Provide an `end_month` to view month-over-month cost."
},
{
"key": "end_month",
"value": "<dateTime>",
"description": "Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost ending this month."
},
{
"key": "start_date",
"value": "<dateTime>",
"description": "Datetime in ISO-8601 format, UTC, precise to day: `[YYYY-MM-DD]` for cost beginning this day. Either start_month or start_date should be specified, but not both. (start_date cannot go beyond two months in the past). Provide an `end_date` to view day-over-day cumulative cost."
},
{
"key": "end_date",
"value": "<dateTime>",
"description": "Datetime in ISO-8601 format, UTC, precise to day: `[YYYY-MM-DD]` for cost ending this day."
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json;datetime-format=rfc3339"
}
],
"cookie": [
],
"body": "{\n \"data\": [\n {\n \"attributes\": {\n \"charges\": [\n {\n \"charge_type\": \"<string>\",\n \"cost\": \"<double>\",\n \"product_name\": \"<string>\"\n },\n {\n \"charge_type\": \"<string>\",\n \"cost\": \"<double>\",\n \"product_name\": \"<string>\"\n }\n ],\n \"date\": \"<dateTime>\",\n \"org_name\": \"<string>\",\n \"public_id\": \"<string>\",\n \"region\": \"<string>\",\n \"total_cost\": \"<double>\"\n },\n \"id\": \"<string>\",\n \"type\": \"cost_by_org\"\n },\n {\n \"attributes\": {\n \"charges\": [\n {\n \"charge_type\": \"<string>\",\n \"cost\": \"<double>\",\n \"product_name\": \"<string>\"\n },\n {\n \"charge_type\": \"<string>\",\n \"cost\": \"<double>\",\n \"product_name\": \"<string>\"\n }\n ],\n \"date\": \"<dateTime>\",\n \"org_name\": \"<string>\",\n \"public_id\": \"<string>\",\n \"region\": \"<string>\",\n \"total_cost\": \"<double>\"\n },\n \"id\": \"<string>\",\n \"type\": \"cost_by_org\"\n }\n ]\n}"
},
{
"name": "Bad Request",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json;datetime-format=rfc3339"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "DD-API-KEY",
"value": "<API Key>"
}
],
"url": {
"raw": "{{baseUrl}}/api/v2/usage/estimated_cost?view=<string>&start_month=<dateTime>&end_month=<dateTime>&start_date=<dateTime>&end_date=<dateTime>",
"host": [
"{{baseUrl}}"
],
"path": [
"api",
"v2",
"usage",
"estimated_cost"
],
"query": [
{
"key": "view",
"value": "<string>",
"description": "String to specify whether cost is broken down at a parent-org level or at the sub-org level. Available views are `summary` and `sub-org`. Defaults to `summary`."
},
{
"key": "start_month",
"value": "<dateTime>",
"description": "Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost beginning this month. Either start_month or start_date should be specified, but not both. (start_month cannot go beyond two months in the past). Provide an `end_month` to view month-over-month cost."
},
{
"key": "end_month",
"value": "<dateTime>",
"description": "Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost ending this month."
},
{
"key": "start_date",
"value": "<dateTime>",
"description": "Datetime in ISO-8601 format, UTC, precise to day: `[YYYY-MM-DD]` for cost beginning this day. Either start_month or start_date should be specified, but not both. (start_date cannot go beyond two months in the past). Provide an `end_date` to view day-over-day cumulative cost."
},
{
"key": "end_date",
"value": "<dateTime>",
"description": "Datetime in ISO-8601 format, UTC, precise to day: `[YYYY-MM-DD]` for cost ending this day."
}
]
}
},
"status": "Bad Request",
"code": 400,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json;datetime-format=rfc3339"
}
],
"cookie": [
],
"body": "{\n \"errors\": [\n \"<string>\",\n \"<string>\"\n ]\n}"
},
{
"name": "Forbidden - User is not authorized",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json;datetime-format=rfc3339"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "DD-API-KEY",
"value": "<API Key>"
}
],
"url": {
"raw": "{{baseUrl}}/api/v2/usage/estimated_cost?view=<string>&start_month=<dateTime>&end_month=<dateTime>&start_date=<dateTime>&end_date=<dateTime>",
"host": [
"{{baseUrl}}"
],
"path": [
"api",
"v2",
"usage",
"estimated_cost"
],
"query": [
{
"key": "view",
"value": "<string>",
"description": "String to specify whether cost is broken down at a parent-org level or at the sub-org level. Available views are `summary` and `sub-org`. Defaults to `summary`."
},
{
"key": "start_month",
"value": "<dateTime>",
"description": "Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost beginning this month. Either start_month or start_date should be specified, but not both. (start_month cannot go beyond two months in the past). Provide an `end_month` to view month-over-month cost."
},
{
"key": "end_month",
"value": "<dateTime>",
"description": "Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost ending this month."
},
{
"key": "start_date",
"value": "<dateTime>",
"description": "Datetime in ISO-8601 format, UTC, precise to day: `[YYYY-MM-DD]` for cost beginning this day. Either start_month or start_date should be specified, but not both. (start_date cannot go beyond two months in the past). Provide an `end_date` to view day-over-day cumulative cost."
},
{
"key": "end_date",
"value": "<dateTime>",
"description": "Datetime in ISO-8601 format, UTC, precise to day: `[YYYY-MM-DD]` for cost ending this day."
}
]
}
},
"status": "Forbidden",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json;datetime-format=rfc3339"
}
],
"cookie": [
],
"body": "{\n \"errors\": [\n \"<string>\",\n \"<string>\"\n ]\n}"
},
{
"name": "Too many requests",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json;datetime-format=rfc3339"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "DD-API-KEY",
"value": "<API Key>"
}
],
"url": {
"raw": "{{baseUrl}}/api/v2/usage/estimated_cost?view=<string>&start_month=<dateTime>&end_month=<dateTime>&start_date=<dateTime>&end_date=<dateTime>",
"host": [
"{{baseUrl}}"
],
"path": [
"api",
"v2",
"usage",
"estimated_cost"
],
"query": [
{
"key": "view",
"value": "<string>",
"description": "String to specify whether cost is broken down at a parent-org level or at the sub-org level. Available views are `summary` and `sub-org`. Defaults to `summary`."
},
{
"key": "start_month",
"value": "<dateTime>",
"description": "Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost beginning this month. Either start_month or start_date should be specified, but not both. (start_month cannot go beyond two months in the past). Provide an `end_month` to view month-over-month cost."
},
{
"key": "end_month",
"value": "<dateTime>",
"description": "Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost ending this month."
},
{
"key": "start_date",
"value": "<dateTime>",
"description": "Datetime in ISO-8601 format, UTC, precise to day: `[YYYY-MM-DD]` for cost beginning this day. Either start_month or start_date should be specified, but not both. (start_date cannot go beyond two months in the past). Provide an `end_date` to view day-over-day cumulative cost."
},
{
"key": "end_date",
"value": "<dateTime>",
"description": "Datetime in ISO-8601 format, UTC, precise to day: `[YYYY-MM-DD]` for cost ending this day."
}
]
}
},
"status": "Too Many Requests",
"code": 429,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json;datetime-format=rfc3339"
}
],
"cookie": [
],
"body": "{\n \"errors\": [\n \"<string>\",\n \"<string>\"\n ]\n}"
}
]
}
