Add example usage for budget resource

Author: zeinageb

docs/resources/cost_budget.md

@@ -10,7 +10,90 @@ description: |-
 
 Provides a Datadog Cost Budget resource.
 
-
+## Example Usage
+
+```terraform
+resource "datadog_cost_budget" "example" {
+  name          = "My AWS Cost Budget"
+  metrics_query = "sum:aws.cost.amortized{*}"
+  start_month   = 202401
+  end_month     = 202412
+
+  entries {
+    amount = 1000
+    month  = 202401
+  }
+  entries {
+    amount = 1000
+    month  = 202402
+  }
+  entries {
+    amount = 1000
+    month  = 202403
+  }
+  entries {
+    amount = 1000
+    month  = 202404
+  }
+  entries {
+    amount = 1000
+    month  = 202405
+  }
+  entries {
+    amount = 1000
+    month  = 202406
+  }
+  entries {
+    amount = 1000
+    month  = 202407
+  }
+  entries {
+    amount = 1000
+    month  = 202408
+  }
+  entries {
+    amount = 1000
+    month  = 202409
+  }
+  entries {
+    amount = 1000
+    month  = 202410
+  }
+  entries {
+    amount = 1000
+    month  = 202411
+  }
+  entries {
+    amount = 1000
+    month  = 202412
+  }
+}
+
+# Budget with tag filters
+resource "datadog_cost_budget" "example_with_filters" {
+  name          = "My Filtered Budget"
+  metrics_query = "sum:aws.cost.amortized{*}"
+  start_month   = 202401
+  end_month     = 202412
+
+  entries {
+    amount = 500
+    month  = 202401
+    tag_filters {
+      tag_key   = "team"
+      tag_value = "engineering"
+    }
+  }
+  entries {
+    amount = 500
+    month  = 202402
+    tag_filters {
+      tag_key   = "team"
+      tag_value = "engineering"
+    }
+  }
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema
@@ -50,3 +133,13 @@ Required:
 
 - `tag_key` (String)
 - `tag_value` (String)
+
+## Import
+
+Import is supported using the following syntax:
+
+The [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import) can be used, for example:
+
+```shell
+terraform import datadog_cost_budget.example budget-id-123
+```

examples/resources/datadog_cost_budget/import.sh

@@ -0,0 +1,2 @@
+terraform import datadog_cost_budget.example budget-id-123
+

examples/resources/datadog_cost_budget/resource.tf

@@ -0,0 +1,81 @@
+resource "datadog_cost_budget" "example" {
+  name          = "My AWS Cost Budget"
+  metrics_query = "sum:aws.cost.amortized{*}"
+  start_month   = 202401
+  end_month     = 202412
+
+  entries {
+    amount = 1000
+    month  = 202401
+  }
+  entries {
+    amount = 1000
+    month  = 202402
+  }
+  entries {
+    amount = 1000
+    month  = 202403
+  }
+  entries {
+    amount = 1000
+    month  = 202404
+  }
+  entries {
+    amount = 1000
+    month  = 202405
+  }
+  entries {
+    amount = 1000
+    month  = 202406
+  }
+  entries {
+    amount = 1000
+    month  = 202407
+  }
+  entries {
+    amount = 1000
+    month  = 202408
+  }
+  entries {
+    amount = 1000
+    month  = 202409
+  }
+  entries {
+    amount = 1000
+    month  = 202410
+  }
+  entries {
+    amount = 1000
+    month  = 202411
+  }
+  entries {
+    amount = 1000
+    month  = 202412
+  }
+}
+
+# Budget with tag filters
+resource "datadog_cost_budget" "example_with_filters" {
+  name          = "My Filtered Budget"
+  metrics_query = "sum:aws.cost.amortized{*}"
+  start_month   = 202401
+  end_month     = 202412
+
+  entries {
+    amount = 500
+    month  = 202401
+    tag_filters {
+      tag_key   = "account"
+      tag_value = "ec2"
+    }
+  }
+  entries {
+    amount = 500
+    month  = 202402
+    tag_filters {
+      tag_key   = "account"
+      tag_value = "ec2"
+    }
+  }
+}
+