- 필수 기능
- 시작하기
- Glossary
- 표준 속성
- Guides
- Agent
- 통합
- 개방형텔레메트리
- 개발자
- Administrator's Guide
- API
- Datadog Mobile App
- CoScreen
- Cloudcraft
- 앱 내
- 서비스 관리
- 인프라스트럭처
- 애플리케이션 성능
- APM
- Continuous Profiler
- 스팬 시각화
- 데이터 스트림 모니터링
- 데이터 작업 모니터링
- 디지털 경험
- 소프트웨어 제공
- 보안
- AI Observability
- 로그 관리
- 관리
The Cloud Cost Management API allows you to set up, edit, and delete Cloud Cost Management accounts for AWS and Azure. You can query your cost data by using the Metrics endpoint and the cloud_cost
data source. For more information, see the Cloud Cost Management documentation.
GET https://api.ap1.datadoghq.com/api/v2/cost/aws_cur_confighttps://api.datadoghq.eu/api/v2/cost/aws_cur_confighttps://api.ddog-gov.com/api/v2/cost/aws_cur_confighttps://api.datadoghq.com/api/v2/cost/aws_cur_confighttps://api.us3.datadoghq.com/api/v2/cost/aws_cur_confighttps://api.us5.datadoghq.com/api/v2/cost/aws_cur_config
List the AWS CUR configs.
This endpoint requires the cloud_cost_management_read
permission.
OAuth apps require the cloud_cost_management_read
authorization scope to access this endpoint.
OK
List of AWS CUR configs.
항목
유형
설명
data
[object]
An AWS CUR config.
attributes [required]
object
Attributes for An AWS CUR config.
account_filters
object
The account filtering configuration.
excluded_accounts
[string]
The AWS account IDs to be excluded from your billing dataset. This field is used when include_new_accounts
is true
.
include_new_accounts
boolean
Whether or not to automatically include new member accounts by default in your billing dataset.
included_accounts
[string]
The AWS account IDs to be included in your billing dataset. This field is used when include_new_accounts
is false
.
account_id [required]
string
The AWS account ID.
bucket_name [required]
string
The AWS bucket name used to store the Cost and Usage Report.
bucket_region [required]
string
The region the bucket is located in.
created_at
string
The timestamp when the AWS CUR config was created.
error_messages
[string]
The error messages for the AWS CUR config.
months
int32
DEPRECATED: The number of months the report has been backfilled.
report_name [required]
string
The name of the Cost and Usage Report.
report_prefix [required]
string
The report prefix used for the Cost and Usage Report.
status [required]
string
The status of the AWS CUR.
status_updated_at
string
The timestamp when the AWS CUR config status was updated.
updated_at
string
The timestamp when the AWS CUR config status was updated.
id
int64
The ID of the AWS CUR config.
type [required]
enum
Type of AWS CUR config.
Allowed enum values: aws_cur_config
default: aws_cur_config
{
"data": [
{
"attributes": {
"account_filters": {
"excluded_accounts": [
"123456789123",
"123456789143"
],
"include_new_accounts": true,
"included_accounts": [
"123456789123",
"123456789143"
]
},
"account_id": "123456789123",
"bucket_name": "dd-cost-bucket",
"bucket_region": "us-east-1",
"created_at": "string",
"error_messages": [],
"months": "integer",
"report_name": "dd-report-name",
"report_prefix": "dd-report-prefix",
"status": "active",
"status_updated_at": "string",
"updated_at": "string"
},
"id": "integer",
"type": "aws_cur_config"
}
]
}
Forbidden
API error response.
{
"errors": [
"Bad Request"
]
}
Too many requests
API error response.
{
"errors": [
"Bad Request"
]
}
# Curl command
curl -X GET "https://api.ap1.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/cost/aws_cur_config" \
-H "Accept: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"
PATCH https://api.ap1.datadoghq.com/api/v2/cost/aws_cur_config/{cloud_account_id}https://api.datadoghq.eu/api/v2/cost/aws_cur_config/{cloud_account_id}https://api.ddog-gov.com/api/v2/cost/aws_cur_config/{cloud_account_id}https://api.datadoghq.com/api/v2/cost/aws_cur_config/{cloud_account_id}https://api.us3.datadoghq.com/api/v2/cost/aws_cur_config/{cloud_account_id}https://api.us5.datadoghq.com/api/v2/cost/aws_cur_config/{cloud_account_id}
Update the status (active/archived) and/or account filtering configuration of an AWS CUR config.
This endpoint requires the cloud_cost_management_write
permission.
OAuth apps require the cloud_cost_management_write
authorization scope to access this endpoint.
이름
유형
설명
cloud_account_id [required]
string
Cloud Account id.
항목
유형
설명
data [required]
object
AWS CUR config Patch data.
attributes [required]
object
Attributes for AWS CUR config Patch Request.
account_filters
object
The account filtering configuration.
excluded_accounts
[string]
The AWS account IDs to be excluded from your billing dataset. This field is used when include_new_accounts
is true
.
include_new_accounts
boolean
Whether or not to automatically include new member accounts by default in your billing dataset.
included_accounts
[string]
The AWS account IDs to be included in your billing dataset. This field is used when include_new_accounts
is false
.
is_enabled
boolean
Whether or not the Cloud Cost Management account is enabled.
type [required]
enum
Type of AWS CUR config Patch Request.
Allowed enum values: aws_cur_config_patch_request
default: aws_cur_config_patch_request
{
"data": {
"attributes": {
"is_enabled": true
},
"type": "aws_cur_config_patch_request"
}
}
OK
List of AWS CUR configs.
항목
유형
설명
data
[object]
An AWS CUR config.
attributes [required]
object
Attributes for An AWS CUR config.
account_filters
object
The account filtering configuration.
excluded_accounts
[string]
The AWS account IDs to be excluded from your billing dataset. This field is used when include_new_accounts
is true
.
include_new_accounts
boolean
Whether or not to automatically include new member accounts by default in your billing dataset.
included_accounts
[string]
The AWS account IDs to be included in your billing dataset. This field is used when include_new_accounts
is false
.
account_id [required]
string
The AWS account ID.
bucket_name [required]
string
The AWS bucket name used to store the Cost and Usage Report.
bucket_region [required]
string
The region the bucket is located in.
created_at
string
The timestamp when the AWS CUR config was created.
error_messages
[string]
The error messages for the AWS CUR config.
months
int32
DEPRECATED: The number of months the report has been backfilled.
report_name [required]
string
The name of the Cost and Usage Report.
report_prefix [required]
string
The report prefix used for the Cost and Usage Report.
status [required]
string
The status of the AWS CUR.
status_updated_at
string
The timestamp when the AWS CUR config status was updated.
updated_at
string
The timestamp when the AWS CUR config status was updated.
id
int64
The ID of the AWS CUR config.
type [required]
enum
Type of AWS CUR config.
Allowed enum values: aws_cur_config
default: aws_cur_config
{
"data": [
{
"attributes": {
"account_filters": {
"excluded_accounts": [
"123456789123",
"123456789143"
],
"include_new_accounts": true,
"included_accounts": [
"123456789123",
"123456789143"
]
},
"account_id": "123456789123",
"bucket_name": "dd-cost-bucket",
"bucket_region": "us-east-1",
"created_at": "string",
"error_messages": [],
"months": "integer",
"report_name": "dd-report-name",
"report_prefix": "dd-report-prefix",
"status": "active",
"status_updated_at": "string",
"updated_at": "string"
},
"id": "integer",
"type": "aws_cur_config"
}
]
}
Forbidden
API error response.
{
"errors": [
"Bad Request"
]
}
Too many requests
API error response.
{
"errors": [
"Bad Request"
]
}
# Path parameters
export cloud_account_id="CHANGE_ME"
# Curl command
curl -X PATCH "https://api.ap1.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/cost/aws_cur_config/${cloud_account_id}" \
-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": {
"is_enabled": true
},
"type": "aws_cur_config_patch_request"
}
}
EOF
POST https://api.ap1.datadoghq.com/api/v2/cost/aws_cur_confighttps://api.datadoghq.eu/api/v2/cost/aws_cur_confighttps://api.ddog-gov.com/api/v2/cost/aws_cur_confighttps://api.datadoghq.com/api/v2/cost/aws_cur_confighttps://api.us3.datadoghq.com/api/v2/cost/aws_cur_confighttps://api.us5.datadoghq.com/api/v2/cost/aws_cur_config
Create a Cloud Cost Management account for an AWS CUR config.
This endpoint requires the cloud_cost_management_write
permission.
OAuth apps require the cloud_cost_management_write
authorization scope to access this endpoint.
항목
유형
설명
data [required]
object
AWS CUR config Post data.
attributes [required]
object
Attributes for AWS CUR config Post Request.
account_filters
object
The account filtering configuration.
excluded_accounts
[string]
The AWS account IDs to be excluded from your billing dataset. This field is used when include_new_accounts
is true
.
include_new_accounts
boolean
Whether or not to automatically include new member accounts by default in your billing dataset.
included_accounts
[string]
The AWS account IDs to be included in your billing dataset. This field is used when include_new_accounts
is false
.
account_id [required]
string
The AWS account ID.
bucket_name [required]
string
The AWS bucket name used to store the Cost and Usage Report.
bucket_region
string
The region the bucket is located in.
is_enabled
boolean
Whether or not the Cloud Cost Management account is enabled.
months
int32
The month of the report.
report_name [required]
string
The name of the Cost and Usage Report.
report_prefix [required]
string
The report prefix used for the Cost and Usage Report.
type [required]
enum
Type of AWS CUR config Post Request.
Allowed enum values: aws_cur_config_post_request
default: aws_cur_config_post_request
{
"data": {
"attributes": {
"account_id": "123456789123",
"bucket_name": "dd-cost-bucket",
"bucket_region": "us-east-1",
"report_name": "dd-report-name",
"report_prefix": "dd-report-prefix"
},
"type": "aws_cur_config_post_request"
}
}
OK
Response of AWS CUR config.
항목
유형
설명
data
object
AWS CUR config.
attributes [required]
object
Attributes for An AWS CUR config.
account_filters
object
The account filtering configuration.
excluded_accounts
[string]
The AWS account IDs to be excluded from your billing dataset. This field is used when include_new_accounts
is true
.
include_new_accounts
boolean
Whether or not to automatically include new member accounts by default in your billing dataset.
included_accounts
[string]
The AWS account IDs to be included in your billing dataset. This field is used when include_new_accounts
is false
.
account_id [required]
string
The AWS account ID.
bucket_name [required]
string
The AWS bucket name used to store the Cost and Usage Report.
bucket_region [required]
string
The region the bucket is located in.
created_at
string
The timestamp when the AWS CUR config was created.
error_messages
[string]
The error messages for the AWS CUR config.
months
int32
DEPRECATED: The number of months the report has been backfilled.
report_name [required]
string
The name of the Cost and Usage Report.
report_prefix [required]
string
The report prefix used for the Cost and Usage Report.
status [required]
string
The status of the AWS CUR.
status_updated_at
string
The timestamp when the AWS CUR config status was updated.
updated_at
string
The timestamp when the AWS CUR config status was updated.
id
int64
The ID of the AWS CUR config.
type [required]
enum
Type of AWS CUR config.
Allowed enum values: aws_cur_config
default: aws_cur_config
{
"data": {
"attributes": {
"account_filters": {
"excluded_accounts": [
"123456789123",
"123456789143"
],
"include_new_accounts": true,
"included_accounts": [
"123456789123",
"123456789143"
]
},
"account_id": "123456789123",
"bucket_name": "dd-cost-bucket",
"bucket_region": "us-east-1",
"created_at": "string",
"error_messages": [],
"months": "integer",
"report_name": "dd-report-name",
"report_prefix": "dd-report-prefix",
"status": "active",
"status_updated_at": "string",
"updated_at": "string"
},
"id": "integer",
"type": "aws_cur_config"
}
}
Bad Request
API error response.
{
"errors": [
"Bad Request"
]
}
Forbidden
API error response.
{
"errors": [
"Bad Request"
]
}
Too many requests
API error response.
{
"errors": [
"Bad Request"
]
}
# Curl command
curl -X POST "https://api.ap1.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/cost/aws_cur_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": "123456789123",
"bucket_name": "dd-cost-bucket",
"bucket_region": "us-east-1",
"report_name": "dd-report-name",
"report_prefix": "dd-report-prefix"
},
"type": "aws_cur_config_post_request"
}
}
EOF
DELETE https://api.ap1.datadoghq.com/api/v2/cost/aws_cur_config/{cloud_account_id}https://api.datadoghq.eu/api/v2/cost/aws_cur_config/{cloud_account_id}https://api.ddog-gov.com/api/v2/cost/aws_cur_config/{cloud_account_id}https://api.datadoghq.com/api/v2/cost/aws_cur_config/{cloud_account_id}https://api.us3.datadoghq.com/api/v2/cost/aws_cur_config/{cloud_account_id}https://api.us5.datadoghq.com/api/v2/cost/aws_cur_config/{cloud_account_id}
Archive a Cloud Cost Management Account.
This endpoint requires the cloud_cost_management_write
permission.
OAuth apps require the cloud_cost_management_write
authorization scope to access this endpoint.
이름
유형
설명
cloud_account_id [required]
string
Cloud Account id.
No Content
Bad Request
API error response.
{
"errors": [
"Bad Request"
]
}
Not Found
API error response.
{
"errors": [
"Bad Request"
]
}
Too many requests
API error response.
{
"errors": [
"Bad Request"
]
}
# Path parameters
export cloud_account_id="CHANGE_ME"
# Curl command
curl -X DELETE "https://api.ap1.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/cost/aws_cur_config/${cloud_account_id}" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"
GET https://api.ap1.datadoghq.com/api/v2/cost/azure_uc_confighttps://api.datadoghq.eu/api/v2/cost/azure_uc_confighttps://api.ddog-gov.com/api/v2/cost/azure_uc_confighttps://api.datadoghq.com/api/v2/cost/azure_uc_confighttps://api.us3.datadoghq.com/api/v2/cost/azure_uc_confighttps://api.us5.datadoghq.com/api/v2/cost/azure_uc_config
List the Azure configs.
This endpoint requires the cloud_cost_management_read
permission.
OAuth apps require the cloud_cost_management_read
authorization scope to access this endpoint.
OK
List of Azure accounts with configs.
항목
유형
설명
data
[object]
An Azure config pair.
attributes [required]
object
Attributes for Azure config pair.
configs [required]
[object]
An Azure config.
account_id [required]
string
The tenant ID of the azure account.
client_id [required]
string
The client ID of the Azure account.
created_at
string
The timestamp when the Azure config was created.
dataset_type [required]
string
The dataset type of the Azure config.
error_messages
[string]
The error messages for the Azure config.
export_name [required]
string
The name of the configured Azure Export.
export_path [required]
string
The path where the Azure Export is saved.
id
int64
The ID of the Azure config.
months
int32
DEPRECATED: The number of months the report has been backfilled.
scope [required]
string
The scope of your observed subscription.
status [required]
string
The status of the Azure config.
status_updated_at
string
The timestamp when the Azure config status was last updated.
storage_account [required]
string
The name of the storage account where the Azure Export is saved.
storage_container [required]
string
The name of the storage container where the Azure Export is saved.
updated_at
string
The timestamp when the Azure config was last updated.
id
int64
The ID of the Azure config pair.
id
int64
The ID of Cloud Cost Management account.
type [required]
enum
Type of Azure config pair.
Allowed enum values: azure_uc_configs
default: azure_uc_configs
{
"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": "integer",
"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": "integer"
},
"id": "integer",
"type": "azure_uc_configs"
}
]
}
Forbidden
API error response.
{
"errors": [
"Bad Request"
]
}
Too many requests
API error response.
{
"errors": [
"Bad Request"
]
}
# Curl command
curl -X GET "https://api.ap1.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/cost/azure_uc_config" \
-H "Accept: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"
PATCH https://api.ap1.datadoghq.com/api/v2/cost/azure_uc_config/{cloud_account_id}https://api.datadoghq.eu/api/v2/cost/azure_uc_config/{cloud_account_id}https://api.ddog-gov.com/api/v2/cost/azure_uc_config/{cloud_account_id}https://api.datadoghq.com/api/v2/cost/azure_uc_config/{cloud_account_id}https://api.us3.datadoghq.com/api/v2/cost/azure_uc_config/{cloud_account_id}https://api.us5.datadoghq.com/api/v2/cost/azure_uc_config/{cloud_account_id}
Update the status of an Azure config (active/archived).
This endpoint requires the cloud_cost_management_write
permission.
OAuth apps require the cloud_cost_management_write
authorization scope to access this endpoint.
이름
유형
설명
cloud_account_id [required]
string
Cloud Account id.
항목
유형
설명
data [required]
object
Azure config Patch data.
attributes [required]
object
Attributes for Azure config Patch Request.
is_enabled [required]
boolean
Whether or not the Cloud Cost Management account is enabled.
type [required]
enum
Type of Azure config Patch Request.
Allowed enum values: azure_uc_config_patch_request
default: azure_uc_config_patch_request
{
"data": {
"attributes": {
"is_enabled": true
},
"type": "azure_uc_config_patch_request"
}
}
OK
Response of Azure config pair.
항목
유형
설명
data
object
Azure config pair.
attributes [required]
object
Attributes for Azure config pair.
configs [required]
[object]
An Azure config.
account_id [required]
string
The tenant ID of the azure account.
client_id [required]
string
The client ID of the Azure account.
created_at
string
The timestamp when the Azure config was created.
dataset_type [required]
string
The dataset type of the Azure config.
error_messages
[string]
The error messages for the Azure config.
export_name [required]
string
The name of the configured Azure Export.
export_path [required]
string
The path where the Azure Export is saved.
id
int64
The ID of the Azure config.
months
int32
DEPRECATED: The number of months the report has been backfilled.
scope [required]
string
The scope of your observed subscription.
status [required]
string
The status of the Azure config.
status_updated_at
string
The timestamp when the Azure config status was last updated.
storage_account [required]
string
The name of the storage account where the Azure Export is saved.
storage_container [required]
string
The name of the storage container where the Azure Export is saved.
updated_at
string
The timestamp when the Azure config was last updated.
id
int64
The ID of the Azure config pair.
id
int64
The ID of Cloud Cost Management account.
type [required]
enum
Type of Azure config pair.
Allowed enum values: azure_uc_configs
default: azure_uc_configs
{
"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": "integer",
"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": "integer"
},
"id": "integer",
"type": "azure_uc_configs"
}
}
Bad Request
API error response.
{
"errors": [
"Bad Request"
]
}
Forbidden
API error response.
{
"errors": [
"Bad Request"
]
}
Too many requests
API error response.
{
"errors": [
"Bad Request"
]
}
# Path parameters
export cloud_account_id="CHANGE_ME"
# Curl command
curl -X PATCH "https://api.ap1.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/cost/azure_uc_config/${cloud_account_id}" \
-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": {
"is_enabled": true
},
"type": "azure_uc_config_patch_request"
}
}
EOF
POST https://api.ap1.datadoghq.com/api/v2/cost/azure_uc_confighttps://api.datadoghq.eu/api/v2/cost/azure_uc_confighttps://api.ddog-gov.com/api/v2/cost/azure_uc_confighttps://api.datadoghq.com/api/v2/cost/azure_uc_confighttps://api.us3.datadoghq.com/api/v2/cost/azure_uc_confighttps://api.us5.datadoghq.com/api/v2/cost/azure_uc_config
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 to access this endpoint.
항목
유형
설명
data [required]
object
Azure config Post data.
attributes [required]
object
Attributes for Azure config Post Request.
account_id [required]
string
The tenant ID of the azure account.
actual_bill_config [required]
object
Bill config.
export_name [required]
string
The name of the configured Azure Export.
export_path [required]
string
The path where the Azure Export is saved.
storage_account [required]
string
The name of the storage account where the Azure Export is saved.
storage_container [required]
string
The name of the storage container where the Azure Export is saved.
amortized_bill_config [required]
object
Bill config.
export_name [required]
string
The name of the configured Azure Export.
export_path [required]
string
The path where the Azure Export is saved.
storage_account [required]
string
The name of the storage account where the Azure Export is saved.
storage_container [required]
string
The name of the storage container where the Azure Export is saved.
client_id [required]
string
The client ID of the azure account.
is_enabled
boolean
Whether or not the Cloud Cost Management account is enabled.
scope [required]
string
The scope of your observed subscription.
type [required]
enum
Type of Azure config Post Request.
Allowed enum values: azure_uc_config_post_request
default: azure_uc_config_post_request
{
"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",
"is_enabled": true,
"scope": "subscriptions/1234abcd-1234-abcd-1234-1234abcd1234"
},
"type": "azure_uc_config_post_request"
}
}
OK
Response of Azure config pair.
항목
유형
설명
data
object
Azure config pair.
attributes [required]
object
Attributes for Azure config pair.
configs [required]
[object]
An Azure config.
account_id [required]
string
The tenant ID of the azure account.
client_id [required]
string
The client ID of the Azure account.
created_at
string
The timestamp when the Azure config was created.
dataset_type [required]
string
The dataset type of the Azure config.
error_messages
[string]
The error messages for the Azure config.
export_name [required]
string
The name of the configured Azure Export.
export_path [required]
string
The path where the Azure Export is saved.
id
int64
The ID of the Azure config.
months
int32
DEPRECATED: The number of months the report has been backfilled.
scope [required]
string
The scope of your observed subscription.
status [required]
string
The status of the Azure config.
status_updated_at
string
The timestamp when the Azure config status was last updated.
storage_account [required]
string
The name of the storage account where the Azure Export is saved.
storage_container [required]
string
The name of the storage container where the Azure Export is saved.
updated_at
string
The timestamp when the Azure config was last updated.
id
int64
The ID of the Azure config pair.
id
int64
The ID of Cloud Cost Management account.
type [required]
enum
Type of Azure config pair.
Allowed enum values: azure_uc_configs
default: azure_uc_configs
{
"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": "integer",
"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": "integer"
},
"id": "integer",
"type": "azure_uc_configs"
}
}
Bad Request
API error response.
{
"errors": [
"Bad Request"
]
}
Forbidden
API error response.
{
"errors": [
"Bad Request"
]
}
Too many requests
API error response.
{
"errors": [
"Bad Request"
]
}
# Curl command
curl -X POST "https://api.ap1.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.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",
"is_enabled": true,
"scope": "subscriptions/1234abcd-1234-abcd-1234-1234abcd1234"
},
"type": "azure_uc_config_post_request"
}
}
EOF
DELETE https://api.ap1.datadoghq.com/api/v2/cost/azure_uc_config/{cloud_account_id}https://api.datadoghq.eu/api/v2/cost/azure_uc_config/{cloud_account_id}https://api.ddog-gov.com/api/v2/cost/azure_uc_config/{cloud_account_id}https://api.datadoghq.com/api/v2/cost/azure_uc_config/{cloud_account_id}https://api.us3.datadoghq.com/api/v2/cost/azure_uc_config/{cloud_account_id}https://api.us5.datadoghq.com/api/v2/cost/azure_uc_config/{cloud_account_id}
Archive a Cloud Cost Management Account.
This endpoint requires the cloud_cost_management_write
permission.
OAuth apps require the cloud_cost_management_write
authorization scope to access this endpoint.
이름
유형
설명
cloud_account_id [required]
string
Cloud Account id.
No Content
Bad Request
API error response.
{
"errors": [
"Bad Request"
]
}
Not Found
API error response.
{
"errors": [
"Bad Request"
]
}
Too many requests
API error response.
{
"errors": [
"Bad Request"
]
}
# Path parameters
export cloud_account_id="CHANGE_ME"
# Curl command
curl -X DELETE "https://api.ap1.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/cost/azure_uc_config/${cloud_account_id}" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"
GET https://api.ap1.datadoghq.com/api/v2/cost/custom_costshttps://api.datadoghq.eu/api/v2/cost/custom_costshttps://api.ddog-gov.com/api/v2/cost/custom_costshttps://api.datadoghq.com/api/v2/cost/custom_costshttps://api.us3.datadoghq.com/api/v2/cost/custom_costshttps://api.us5.datadoghq.com/api/v2/cost/custom_costs
List the Custom Costs files.
OAuth apps require the cloud_cost_management_read
authorization scope to access this endpoint.
OK
Response for List Custom Costs files.
항목
유형
설명
data
[object]
List of Custom Costs files.
attributes
object
Schema of a Custom Costs metadata.
billed_cost
double
Total cost in the cost file.
billing_currency
string
Currency used in the Custom Costs file.
charge_period
object
Usage charge period of a Custom Costs file.
end
double
End of the usage of the Custom Costs file.
start
double
Start of the usage of the Custom Costs file.
name
string
Name of the Custom Costs file.
provider_names
[string]
Providers contained in the Custom Costs file.
status
string
Status of the Custom Costs file.
uploaded_at
double
Timestamp, in millisecond, of the upload time of the Custom Costs file.
uploaded_by
object
Metadata of the user that has uploaded the Custom Costs file.
string
The name of the Custom Costs file.
icon
string
The name of the Custom Costs file.
name
string
Name of the user.
id
string
ID of the Custom Costs metadata.
type
string
Type of the Custom Costs file metadata.
meta
object
Meta for the response from the List Custom Costs endpoints.
total_filtered_count
int64
Number of Custom Costs files returned by the List Custom Costs endpoint
version
string
Version of Custom Costs file
{
"data": [
{
"attributes": {
"billed_cost": 100.5,
"billing_currency": "USD",
"charge_period": {
"end": 1706745600000,
"start": 1704067200000
},
"name": "my_file.json",
"provider_names": [
"my_provider"
],
"status": "active",
"uploaded_at": 1704067200000,
"uploaded_by": {
"email": "email.test@datadohq.com",
"icon": "icon.png",
"name": "Test User"
}
},
"id": "string",
"type": "string"
}
],
"meta": {
"total_filtered_count": "integer",
"version": "string"
}
}
Forbidden
API error response.
{
"errors": [
"Bad Request"
]
}
Too many requests
API error response.
{
"errors": [
"Bad Request"
]
}
# Curl command
curl -X GET "https://api.ap1.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/cost/custom_costs" \
-H "Accept: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"
PUT https://api.ap1.datadoghq.com/api/v2/cost/custom_costshttps://api.datadoghq.eu/api/v2/cost/custom_costshttps://api.ddog-gov.com/api/v2/cost/custom_costshttps://api.datadoghq.com/api/v2/cost/custom_costshttps://api.us3.datadoghq.com/api/v2/cost/custom_costshttps://api.us5.datadoghq.com/api/v2/cost/custom_costs
Upload a Custom Costs file.
OAuth apps require the cloud_cost_management_write
authorization scope to access this endpoint.
항목
유형
설명
BilledCost
double
Total cost in the cost file.
BillingCurrency
string
Currency used in the Custom Costs file.
ChargeDescription
string
Description for the line item cost.
ChargePeriodEnd
string
End date of the usage charge.
ChargePeriodStart
string
Start date of the usage charge.
ProviderName
string
Name of the provider for the line item.
Tags
object
Additional tags for the line item.
<any-key>
string
[
{
"ProviderName": "my_provider",
"ChargePeriodStart": "2023-05-06",
"ChargePeriodEnd": "2023-06-06",
"ChargeDescription": "my_description",
"BilledCost": 250,
"BillingCurrency": "USD",
"Tags": {
"key": "value"
}
}
]
Accepted
Response for Uploaded Custom Costs files.
항목
유형
설명
data
object
JSON API format for a Custom Costs file.
attributes
object
Schema of a Custom Costs metadata.
billed_cost
double
Total cost in the cost file.
billing_currency
string
Currency used in the Custom Costs file.
charge_period
object
Usage charge period of a Custom Costs file.
end
double
End of the usage of the Custom Costs file.
start
double
Start of the usage of the Custom Costs file.
name
string
Name of the Custom Costs file.
provider_names
[string]
Providers contained in the Custom Costs file.
status
string
Status of the Custom Costs file.
uploaded_at
double
Timestamp, in millisecond, of the upload time of the Custom Costs file.
uploaded_by
object
Metadata of the user that has uploaded the Custom Costs file.
string
The name of the Custom Costs file.
icon
string
The name of the Custom Costs file.
name
string
Name of the user.
id
string
ID of the Custom Costs metadata.
type
string
Type of the Custom Costs file metadata.
meta
object
Meta for the response from the Upload Custom Costs endpoints.
version
string
Version of Custom Costs file
{
"data": {
"attributes": {
"billed_cost": 100.5,
"billing_currency": "USD",
"charge_period": {
"end": 1706745600000,
"start": 1704067200000
},
"name": "my_file.json",
"provider_names": [
"my_provider"
],
"status": "active",
"uploaded_at": 1704067200000,
"uploaded_by": {
"email": "email.test@datadohq.com",
"icon": "icon.png",
"name": "Test User"
}
},
"id": "string",
"type": "string"
},
"meta": {
"version": "string"
}
}
Forbidden
API error response.
{
"errors": [
"Bad Request"
]
}
Too many requests
API error response.
{
"errors": [
"Bad Request"
]
}
# Curl command
curl -X PUT "https://api.ap1.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/cost/custom_costs" \
-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
[
{
"ProviderName": "my_provider",
"ChargePeriodStart": "2023-05-06",
"ChargePeriodEnd": "2023-06-06",
"ChargeDescription": "my_description",
"BilledCost": 250,
"BillingCurrency": "USD",
"Tags": {
"key": "value"
}
}
]
EOF
GET https://api.ap1.datadoghq.com/api/v2/cost/custom_costs/{file_id}https://api.datadoghq.eu/api/v2/cost/custom_costs/{file_id}https://api.ddog-gov.com/api/v2/cost/custom_costs/{file_id}https://api.datadoghq.com/api/v2/cost/custom_costs/{file_id}https://api.us3.datadoghq.com/api/v2/cost/custom_costs/{file_id}https://api.us5.datadoghq.com/api/v2/cost/custom_costs/{file_id}
Fetch the specified Custom Costs file.
OAuth apps require the cloud_cost_management_read
authorization scope to access this endpoint.
이름
유형
설명
file_id [required]
string
File ID.
OK
Response for Get Custom Costs files.
항목
유형
설명
data
object
JSON API format of for a Custom Costs file with content.
attributes
object
Schema of a cost file's metadata.
billed_cost
double
Total cost in the cost file.
billing_currency
string
Currency used in the Custom Costs file.
charge_period
object
Usage charge period of a Custom Costs file.
end
double
End of the usage of the Custom Costs file.
start
double
Start of the usage of the Custom Costs file.
content
[object]
Detail of the line items from the Custom Costs file.
BilledCost
double
Total cost in the cost file.
BillingCurrency
string
Currency used in the Custom Costs file.
ChargeDescription
string
Description for the line item cost.
ChargePeriodEnd
string
End date of the usage charge.
ChargePeriodStart
string
Start date of the usage charge.
ProviderName
string
Name of the provider for the line item.
Tags
object
Additional tags for the line item.
<any-key>
string
name
string
Name of the Custom Costs file.
provider_names
[string]
Providers contained in the Custom Costs file.
status
string
Status of the Custom Costs file.
uploaded_at
double
Timestamp in millisecond of the upload time of the Custom Costs file.
uploaded_by
object
Metadata of the user that has uploaded the Custom Costs file.
string
The name of the Custom Costs file.
icon
string
The name of the Custom Costs file.
name
string
Name of the user.
id
string
ID of the Custom Costs metadata.
type
string
Type of the Custom Costs file metadata.
meta
object
Meta for the response from the Get Custom Costs endpoints.
version
string
Version of Custom Costs file
{
"data": {
"attributes": {
"billed_cost": 100.5,
"billing_currency": "USD",
"charge_period": {
"end": 1706745600000,
"start": 1704067200000
},
"content": [
{
"BilledCost": 100.5,
"BillingCurrency": "USD",
"ChargeDescription": "Monthly usage charge for my service",
"ChargePeriodEnd": "2023-02-28",
"ChargePeriodStart": "2023-02-01",
"ProviderName": "string",
"Tags": {
"<any-key>": "string"
}
}
],
"name": "my_file.json",
"provider_names": [
"my_provider"
],
"status": "active",
"uploaded_at": 1704067200000,
"uploaded_by": {
"email": "email.test@datadohq.com",
"icon": "icon.png",
"name": "Test User"
}
},
"id": "string",
"type": "string"
},
"meta": {
"version": "string"
}
}
Forbidden
API error response.
{
"errors": [
"Bad Request"
]
}
Too many requests
API error response.
{
"errors": [
"Bad Request"
]
}
# Path parameters
export file_id="CHANGE_ME"
# Curl command
curl -X GET "https://api.ap1.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/cost/custom_costs/${file_id}" \
-H "Accept: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"
DELETE https://api.ap1.datadoghq.com/api/v2/cost/custom_costs/{file_id}https://api.datadoghq.eu/api/v2/cost/custom_costs/{file_id}https://api.ddog-gov.com/api/v2/cost/custom_costs/{file_id}https://api.datadoghq.com/api/v2/cost/custom_costs/{file_id}https://api.us3.datadoghq.com/api/v2/cost/custom_costs/{file_id}https://api.us5.datadoghq.com/api/v2/cost/custom_costs/{file_id}
Delete the specified Custom Costs file.
OAuth apps require the cloud_cost_management_write
authorization scope to access this endpoint.
이름
유형
설명
file_id [required]
string
File ID.
No Content
Forbidden
API error response.
{
"errors": [
"Bad Request"
]
}
Too many requests
API error response.
{
"errors": [
"Bad Request"
]
}
# Path parameters
export file_id="CHANGE_ME"
# Curl command
curl -X DELETE "https://api.ap1.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/cost/custom_costs/${file_id}" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"