--- title: Create Cloud Cost Management Azure configs description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: Docs > API Reference > Cloud Cost Management --- # Create Cloud Cost Management Azure configs{% #create-cloud-cost-management-azure-configs %} Copy pageCopied {% tab title="v2" %} | Datadog site | API endpoint | | ----------------- | -------------------------------------------------------------- | | ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/cost/azure_uc_config | | ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/cost/azure_uc_config | | app.datadoghq.eu | POST https://api.datadoghq.eu/api/v2/cost/azure_uc_config | | app.ddog-gov.com | POST https://api.ddog-gov.com/api/v2/cost/azure_uc_config | | us2.ddog-gov.com | POST https://api.us2.ddog-gov.com/api/v2/cost/azure_uc_config | | app.datadoghq.com | POST https://api.datadoghq.com/api/v2/cost/azure_uc_config | | us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/cost/azure_uc_config | | us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/cost/azure_uc_config | ### Overview Create a Cloud Cost Management account for an Azure config. This endpoint requires the `cloud_cost_management_write` permission. OAuth apps require the `cloud_cost_management_write` authorization [scope](https://docs.datadoghq.com/api/latest/scopes.md#cloud-cost-management) to access this endpoint. ### Request #### Body Data (required) {% tab title="Model" %} | Parent field | Field | Type | Description | | --------------------- | --------------------------------------- | ------ | -------------------------------------------------------------------------------------- | | | data [*required*] | object | Azure config Post data. | | data | attributes | object | Attributes for Azure config Post Request. | | attributes | account_id [*required*] | string | The tenant ID of the Azure account. | | attributes | actual_bill_config [*required*] | object | Bill config. | | actual_bill_config | export_name [*required*] | string | The name of the configured Azure Export. | | actual_bill_config | export_path [*required*] | string | The path where the Azure Export is saved. | | actual_bill_config | storage_account [*required*] | string | The name of the storage account where the Azure Export is saved. | | actual_bill_config | storage_container [*required*] | string | The name of the storage container where the Azure Export is saved. | | attributes | amortized_bill_config [*required*] | object | Bill config. | | amortized_bill_config | export_name [*required*] | string | The name of the configured Azure Export. | | amortized_bill_config | export_path [*required*] | string | The path where the Azure Export is saved. | | amortized_bill_config | storage_account [*required*] | string | The name of the storage account where the Azure Export is saved. | | amortized_bill_config | storage_container [*required*] | string | The name of the storage container where the Azure Export is saved. | | attributes | client_id [*required*] | string | The client ID of the Azure account. | | attributes | scope [*required*] | string | The scope of your observed subscription. | | data | type [*required*] | enum | Type of Azure config Post Request. Allowed enum values: `azure_uc_config_post_request` | {% /tab %} {% tab title="Example" %} ```json { "data": { "attributes": { "account_id": "1234abcd-1234-abcd-1234-1234abcd1234", "actual_bill_config": { "export_name": "dd-actual-export", "export_path": "dd-export-path", "storage_account": "dd-storage-account", "storage_container": "dd-storage-container" }, "amortized_bill_config": { "export_name": "dd-actual-export", "export_path": "dd-export-path", "storage_account": "dd-storage-account", "storage_container": "dd-storage-container" }, "client_id": "1234abcd-1234-abcd-1234-1234abcd1234", "scope": "subscriptions/1234abcd-1234-abcd-1234-1234abcd1234" }, "type": "azure_uc_config_post_request" } } ``` {% /tab %} ### Response {% tab title="200" %} OK {% tab title="Model" %} Response of Azure config pair. | Parent field | Field | Type | Description | | ------------ | ----------------------------------- | -------- | -------------------------------------------------------------------- | | | data | object | Azure config pair. | | data | attributes [*required*] | object | Attributes for Azure config pair. | | attributes | configs [*required*] | [object] | An Azure config. | | configs | account_id [*required*] | string | The tenant ID of the Azure account. | | configs | client_id [*required*] | string | The client ID of the Azure account. | | configs | created_at | string | The timestamp when the Azure config was created. | | configs | dataset_type [*required*] | string | The dataset type of the Azure config. | | configs | error_messages | [string] | The error messages for the Azure config. | | configs | export_name [*required*] | string | The name of the configured Azure Export. | | configs | export_path [*required*] | string | The path where the Azure Export is saved. | | configs | id | string | The ID of the Azure config. | | configs | months | int32 | **DEPRECATED**: The number of months the report has been backfilled. | | configs | scope [*required*] | string | The scope of your observed subscription. | | configs | status [*required*] | string | The status of the Azure config. | | configs | status_updated_at | string | The timestamp when the Azure config status was last updated. | | configs | storage_account [*required*] | string | The name of the storage account where the Azure Export is saved. | | configs | storage_container [*required*] | string | The name of the storage container where the Azure Export is saved. | | configs | updated_at | string | The timestamp when the Azure config was last updated. | | attributes | id | string | The ID of the Azure config pair. | | data | id | string | The ID of Cloud Cost Management account. | | data | type [*required*] | enum | Type of Azure config pair. Allowed enum values: `azure_uc_configs` | {% /tab %} {% tab title="Example" %} ```json { "data": { "attributes": { "configs": [ { "account_id": "1234abcd-1234-abcd-1234-1234abcd1234", "client_id": "1234abcd-1234-abcd-1234-1234abcd1234", "created_at": "string", "dataset_type": "actual", "error_messages": [], "export_name": "dd-actual-export", "export_path": "dd-export-path", "id": "string", "months": "integer", "scope": "/subscriptions/1234abcd-1234-abcd-1234-1234abcd1234", "status": "active", "status_updated_at": "string", "storage_account": "dd-storage-account", "storage_container": "dd-storage-container", "updated_at": "string" } ], "id": "string" }, "id": "string", "type": "azure_uc_configs" } } ``` {% /tab %} {% /tab %} {% tab title="400" %} Bad Request {% tab title="Model" %} API error response. | Field | Type | Description | | ------------------------ | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} {% tab title="403" %} Forbidden {% tab title="Model" %} API error response. | Field | Type | Description | | ------------------------ | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} {% tab title="429" %} Too many requests {% tab title="Model" %} API error response. | Field | Type | Description | | ------------------------ | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} ### Code Example ##### \## default # \# Curl command curl -X POST "https://api.datadoghq.com/api/v2/cost/azure_uc_config" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "DD-API-KEY: ${DD_API_KEY}" \ -H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \ -d @- << EOF { "data": { "attributes": { "account_id": "1234abcd-1234-abcd-1234-1234abcd1234", "actual_bill_config": { "export_name": "dd-actual-export", "export_path": "dd-export-path", "storage_account": "dd-storage-account", "storage_container": "dd-storage-container" }, "amortized_bill_config": { "export_name": "dd-actual-export", "export_path": "dd-export-path", "storage_account": "dd-storage-account", "storage_container": "dd-storage-container" }, "client_id": "1234abcd-1234-abcd-1234-1234abcd1234", "scope": "/subscriptions/1234abcd-1234-abcd-1234-1234abcd1234" }, "type": "azure_uc_config_post_request" } } EOF ##### ```go // Create Cloud Cost Management Azure configs returns "OK" response package main import ( "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" ) func main() { body := datadogV2.AzureUCConfigPostRequest{ Data: datadogV2.AzureUCConfigPostData{ Attributes: &datadogV2.AzureUCConfigPostRequestAttributes{ AccountId: "1234abcd-1234-abcd-1234-1234abcd1234", ActualBillConfig: datadogV2.BillConfig{ ExportName: "dd-actual-export", ExportPath: "dd-export-path", StorageAccount: "dd-storage-account", StorageContainer: "dd-storage-container", }, AmortizedBillConfig: datadogV2.BillConfig{ ExportName: "dd-actual-export", ExportPath: "dd-export-path", StorageAccount: "dd-storage-account", StorageContainer: "dd-storage-container", }, ClientId: "1234abcd-1234-abcd-1234-1234abcd1234", Scope: "subscriptions/1234abcd-1234-abcd-1234-1234abcd1234", }, Type: datadogV2.AZUREUCCONFIGPOSTREQUESTTYPE_AZURE_UC_CONFIG_POST_REQUEST, }, } ctx := datadog.NewDefaultContext(context.Background()) configuration := datadog.NewConfiguration() apiClient := datadog.NewAPIClient(configuration) api := datadogV2.NewCloudCostManagementApi(apiClient) resp, r, err := api.CreateCostAzureUCConfigs(ctx, body) if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `CloudCostManagementApi.CreateCostAzureUCConfigs`: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r) } responseContent, _ := json.MarshalIndent(resp, "", " ") fmt.Fprintf(os.Stdout, "Response from `CloudCostManagementApi.CreateCostAzureUCConfigs`:\n%s\n", responseContent) } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=go) and then save the example to `main.go` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" go run "main.go" ##### ```java // Create Cloud Cost Management Azure configs returns "OK" response import com.datadog.api.client.ApiClient; import com.datadog.api.client.ApiException; import com.datadog.api.client.v2.api.CloudCostManagementApi; import com.datadog.api.client.v2.model.AzureUCConfigPairsResponse; import com.datadog.api.client.v2.model.AzureUCConfigPostData; import com.datadog.api.client.v2.model.AzureUCConfigPostRequest; import com.datadog.api.client.v2.model.AzureUCConfigPostRequestAttributes; import com.datadog.api.client.v2.model.AzureUCConfigPostRequestType; import com.datadog.api.client.v2.model.BillConfig; public class Example { public static void main(String[] args) { ApiClient defaultClient = ApiClient.getDefaultApiClient(); CloudCostManagementApi apiInstance = new CloudCostManagementApi(defaultClient); AzureUCConfigPostRequest body = new AzureUCConfigPostRequest() .data( new AzureUCConfigPostData() .attributes( new AzureUCConfigPostRequestAttributes() .accountId("1234abcd-1234-abcd-1234-1234abcd1234") .actualBillConfig( new BillConfig() .exportName("dd-actual-export") .exportPath("dd-export-path") .storageAccount("dd-storage-account") .storageContainer("dd-storage-container")) .amortizedBillConfig( new BillConfig() .exportName("dd-actual-export") .exportPath("dd-export-path") .storageAccount("dd-storage-account") .storageContainer("dd-storage-container")) .clientId("1234abcd-1234-abcd-1234-1234abcd1234") .scope("subscriptions/1234abcd-1234-abcd-1234-1234abcd1234")) .type(AzureUCConfigPostRequestType.AZURE_UC_CONFIG_POST_REQUEST)); try { AzureUCConfigPairsResponse result = apiInstance.createCostAzureUCConfigs(body); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling CloudCostManagementApi#createCostAzureUCConfigs"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=java) and then save the example to `Example.java` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" java "Example.java" ##### ```python """ Create Cloud Cost Management Azure configs returns "OK" response """ from datadog_api_client import ApiClient, Configuration from datadog_api_client.v2.api.cloud_cost_management_api import CloudCostManagementApi from datadog_api_client.v2.model.azure_uc_config_post_data import AzureUCConfigPostData from datadog_api_client.v2.model.azure_uc_config_post_request import AzureUCConfigPostRequest from datadog_api_client.v2.model.azure_uc_config_post_request_attributes import AzureUCConfigPostRequestAttributes from datadog_api_client.v2.model.azure_uc_config_post_request_type import AzureUCConfigPostRequestType from datadog_api_client.v2.model.bill_config import BillConfig body = AzureUCConfigPostRequest( data=AzureUCConfigPostData( attributes=AzureUCConfigPostRequestAttributes( account_id="1234abcd-1234-abcd-1234-1234abcd1234", actual_bill_config=BillConfig( export_name="dd-actual-export", export_path="dd-export-path", storage_account="dd-storage-account", storage_container="dd-storage-container", ), amortized_bill_config=BillConfig( export_name="dd-actual-export", export_path="dd-export-path", storage_account="dd-storage-account", storage_container="dd-storage-container", ), client_id="1234abcd-1234-abcd-1234-1234abcd1234", scope="subscriptions/1234abcd-1234-abcd-1234-1234abcd1234", ), type=AzureUCConfigPostRequestType.AZURE_UC_CONFIG_POST_REQUEST, ), ) configuration = Configuration() with ApiClient(configuration) as api_client: api_instance = CloudCostManagementApi(api_client) response = api_instance.create_cost_azure_uc_configs(body=body) print(response) ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=python) and then save the example to `example.py` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" python3 "example.py" ##### ```ruby # Create Cloud Cost Management Azure configs returns "OK" response require "datadog_api_client" api_instance = DatadogAPIClient::V2::CloudCostManagementAPI.new body = DatadogAPIClient::V2::AzureUCConfigPostRequest.new({ data: DatadogAPIClient::V2::AzureUCConfigPostData.new({ attributes: DatadogAPIClient::V2::AzureUCConfigPostRequestAttributes.new({ account_id: "1234abcd-1234-abcd-1234-1234abcd1234", actual_bill_config: DatadogAPIClient::V2::BillConfig.new({ export_name: "dd-actual-export", export_path: "dd-export-path", storage_account: "dd-storage-account", storage_container: "dd-storage-container", }), amortized_bill_config: DatadogAPIClient::V2::BillConfig.new({ export_name: "dd-actual-export", export_path: "dd-export-path", storage_account: "dd-storage-account", storage_container: "dd-storage-container", }), client_id: "1234abcd-1234-abcd-1234-1234abcd1234", scope: "subscriptions/1234abcd-1234-abcd-1234-1234abcd1234", }), type: DatadogAPIClient::V2::AzureUCConfigPostRequestType::AZURE_UC_CONFIG_POST_REQUEST, }), }) p api_instance.create_cost_azure_uc_configs(body) ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=ruby) and then save the example to `example.rb` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" rb "example.rb" ##### ```rust // Create Cloud Cost Management Azure configs returns "OK" response use datadog_api_client::datadog; use datadog_api_client::datadogV2::api_cloud_cost_management::CloudCostManagementAPI; use datadog_api_client::datadogV2::model::AzureUCConfigPostData; use datadog_api_client::datadogV2::model::AzureUCConfigPostRequest; use datadog_api_client::datadogV2::model::AzureUCConfigPostRequestAttributes; use datadog_api_client::datadogV2::model::AzureUCConfigPostRequestType; use datadog_api_client::datadogV2::model::BillConfig; #[tokio::main] async fn main() { let body = AzureUCConfigPostRequest::new( AzureUCConfigPostData::new(AzureUCConfigPostRequestType::AZURE_UC_CONFIG_POST_REQUEST) .attributes(AzureUCConfigPostRequestAttributes::new( "1234abcd-1234-abcd-1234-1234abcd1234".to_string(), BillConfig::new( "dd-actual-export".to_string(), "dd-export-path".to_string(), "dd-storage-account".to_string(), "dd-storage-container".to_string(), ), BillConfig::new( "dd-actual-export".to_string(), "dd-export-path".to_string(), "dd-storage-account".to_string(), "dd-storage-container".to_string(), ), "1234abcd-1234-abcd-1234-1234abcd1234".to_string(), "subscriptions/1234abcd-1234-abcd-1234-1234abcd1234".to_string(), )), ); let configuration = datadog::Configuration::new(); let api = CloudCostManagementAPI::with_config(configuration); let resp = api.create_cost_azure_uc_configs(body).await; if let Ok(value) = resp { println!("{:#?}", value); } else { println!("{:#?}", resp.unwrap_err()); } } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=rust) and then save the example to `src/main.rs` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" cargo run ##### ```typescript /** * Create Cloud Cost Management Azure configs returns "OK" response */ import { client, v2 } from "@datadog/datadog-api-client"; const configuration = client.createConfiguration(); const apiInstance = new v2.CloudCostManagementApi(configuration); const params: v2.CloudCostManagementApiCreateCostAzureUCConfigsRequest = { body: { data: { attributes: { accountId: "1234abcd-1234-abcd-1234-1234abcd1234", actualBillConfig: { exportName: "dd-actual-export", exportPath: "dd-export-path", storageAccount: "dd-storage-account", storageContainer: "dd-storage-container", }, amortizedBillConfig: { exportName: "dd-actual-export", exportPath: "dd-export-path", storageAccount: "dd-storage-account", storageContainer: "dd-storage-container", }, clientId: "1234abcd-1234-abcd-1234-1234abcd1234", scope: "subscriptions/1234abcd-1234-abcd-1234-1234abcd1234", }, type: "azure_uc_config_post_request", }, }, }; apiInstance .createCostAzureUCConfigs(params) .then((data: v2.AzureUCConfigPairsResponse) => { console.log( "API called successfully. Returned data: " + JSON.stringify(data) ); }) .catch((error: any) => console.error(error)); ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=typescript) and then save the example to `example.ts` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" tsc "example.ts" {% /tab %}