Merge pull request #269967 from mattmcinnes/patch-110

[Cost] Update tutorial-acm-create-budgets.md

Author: v-ccolin

articles/cost-management-billing/costs/cost-mgt-alerts-monitor-usage-spending.md

@@ -31,7 +31,7 @@ Budget alerts notify you when spending, based on usage or cost, reaches or excee
 
 In the Azure portal, budgets are defined by cost. Using the Azure Consumption API, budgets are defined by cost or by consumption usage. Budget alerts support both cost-based and usage-based budgets. Budget alerts are generated automatically whenever the budget alert conditions are met. You can view all cost alerts in the Azure portal. Whenever an alert is generated, it's shown in cost alerts. An alert email is also sent to the people in the alert recipients list of the budget.
 
-If you have an Enterprise Agreement, you can [Create and edit budgets with PowerShell](tutorial-acm-create-budgets.md#create-and-edit-budgets-with-powershell). Customers with a Microsoft Customer Agreement should use the [Budgets REST API](/rest/api/consumption/budgets/create-or-update) to create budgets programmatically.
+If you have an Enterprise Agreement, you can [Create and edit budgets](tutorial-acm-create-budgets.md#create-and-edit-budgets). Customers with a Microsoft Customer Agreement should use the [Budgets REST API](/rest/api/consumption/budgets/create-or-update) to create budgets programmatically.
 
 You can use the Budget API to send email alerts in a different language. For more information, see [Supported locales for budget alert emails](manage-automation.md#supported-locales-for-budget-alert-emails).
 

articles/cost-management-billing/costs/tutorial-acm-create-budgets.md

@@ -31,7 +31,7 @@ In this tutorial, you learn how to:
 
 > [!div class="checklist"]
 > * Create a budget in the Azure portal
-> * Create and edit budgets with PowerShell
+> * Create and edit budgets
 > * Create a budget with an Azure Resource Manager template
 
 ## Prerequisites
@@ -178,7 +178,9 @@ To receive mobile push notifications when your budget threshold is met, you can
 
 :::image type="content" source="./media/tutorial-acm-create-budgets/azure-app-budgets.png" alt-text="Screenshot showing budgets in the Azure app." lightbox="./media/tutorial-acm-create-budgets/azure-app-budgets.png" :::
 
-## Create and edit budgets with PowerShell
+## Create and edit budgets
+
+### [PowerShell](#tab/psbudget)
 
 If you're an EA customer, you can create and edit budgets programmatically using the Azure PowerShell module. However, we recommend that you use REST APIs to create and edit budgets because CLI commands might not support the latest version of the APIs.
 
@@ -191,7 +193,7 @@ To download the latest version of Azure PowerShell, run the following command:
 install-module -name Az
 ```
 
-The following example commands create a budget.
+The following example commands create a budget using PowerShell. Make sure to replace all example prompts with your own info.
 
 ```azurepowershell-interactive
 #Sign into Azure PowerShell with your account
@@ -213,10 +215,180 @@ Get-AzContext
 New-AzConsumptionBudget -Amount 100 -Name TestPSBudget -Category Cost -StartDate 2020-02-01 -TimeGrain Monthly -EndDate 2022-12-31 -ContactEmail [email protected] -NotificationKey Key1 -NotificationThreshold 0.8 -NotificationEnabled -ContactGroup $ActionGroupId
 ```
 
-## Create a budget with an Azure Resource Manager template
+### [CLI](#tab/clibudget)
+
+The following example creates a budget using Azure CLI. Make sure to replace all example prompts with your own info.
+
+```azurecli
+# Sign into Azure CLI with your account
+az login
+
+# Select a subscription to monitor with a budget
+az account set --subscription "Your Subscription"
+
+# Create an action group email receiver and corresponding action group
+email1=$(az monitor action-group receiver email create --email-address [email protected] --name EmailReceiver1 --resource-group YourResourceGroup --query id -o tsv)
+ActionGroupId=$(az monitor action-group create --resource-group YourResourceGroup --name TestAG --short-name TestAG --receiver $email1 --query id -o tsv)
+
+# Create a monthly budget that sends an email and triggers an Action Group to send a second email.
+# Make sure the StartDate for your monthly budget is set to the first day of the current month.
+# Note that Action Groups can also be used to trigger automation such as Azure Functions or Webhooks.
+az consumption budget create --amount 100 --name TestCLIBudget --category Cost --start-date "2020-02-01" --time-grain Monthly --end-date "2022-12-31" --contact-email [email protected] --notification-key Key1 --notification-threshold 0.8 --notification-enabled --contact-group $ActionGroupId
+```
+
+### [Terraform](#tab/tfbudget)
+
+Make sure to properly [install and configure Terraform](/azure/developer/terraform/quickstart-configure) before continuing. All examples are based on [HashiCorp's 'azurerm_subscription_cost_management_export' docs](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/subscription_cost_management_export).
+
+The following example creates a budget using Terraform. Make sure to replace all example prompts with your own info.
+
+1. Configure provider: Ensure you have the Azure provider configured.
+```
+provider "azurerm" {
+  features {}
+}
+```
+
+1. Select an Azure subscription: Specify the subscription ID in the provider configuration or via environment variables.
+```
+data "azurerm_subscription" "example" {}
+```
+
+1. Create a resource group.
+```
+resource "azurerm_resource_group" "example" {
+  name     = "example-resources"
+  location = "West Europe"
+}
+
+```
+1. Set up an action group for notifications.
+
+```
+resource "azurerm_monitor_action_group" "example" {
+  name                = "TestAG"
+  resource_group_name = azurerm_resource_group.example.name
+  short_name          = "TestAG"
+
+  email_receiver {
+    name                    = "EmailReceiver1"
+    email_address           = "[email protected]"
+    use_common_alert_schema = true
+  }
+}
+
+```
+
+1. Create a storage account.
+```
+resource "azurerm_storage_account" "example" {
+  name                     = "examplestoracc"
+  resource_group_name      = azurerm_resource_group.example.name
+  location                 = azurerm_resource_group.example.location
+  account_tier             = "Standard"
+  account_replication_type = "LRS"
+}
+
+```
+
+1. Create a storage container.
+```
+resource "azurerm_storage_container" "example" {
+  name                  = "examplecontainer"
+  storage_account_name  = azurerm_storage_account.example.name
+}
+```
+
+1. Set up subscription cost management export.
+```
+resource "azurerm_subscription_cost_management_export" "example" {
+  name                         = "exampleexport"
+  subscription_id              = data.azurerm_subscription.example.id
+  recurrence_type              = "Monthly"
+  recurrence_period_start_date = "2020-08-18T00:00:00Z"
+  recurrence_period_end_date   = "2020-09-18T00:00:00Z"
+
+  export_data_storage_location {
+    container_id     = azurerm_storage_container.example.resource_manager_id
+    root_folder_path = "/root/updated"
+  }
+
+  export_data_options {
+    type       = "Usage"
+    time_frame = "WeekToDate"
+  }
+}
+
+```
+
+1. Apply the terraform configuration
+
+Here's the full code if you'd like to modify it directly from source instead of piecing it together through the steps.
+
+```
+provider "azurerm" {
+  features {}
+}
+
+data "azurerm_subscription" "example" {}
+
+resource "azurerm_resource_group" "example" {
+  name     = "example-resources"
+  location = "West Europe"
+}
+
+resource "azurerm_monitor_action_group" "example" {
+  name                = "TestAG"
+  resource_group_name = azurerm_resource_group.example.name
+  short_name          = "TestAG"
+
+  email_receiver {
+    name                    = "EmailReceiver1"
+    email_address           = "[email protected]"
+    use_common_alert_schema = true
+  }
+}
+
+resource "azurerm_storage_account" "example" {
+  name                = "examplestoracc"
+  resource_group_name = azurerm_resource_group.example.name
+
+  location                 = azurerm_resource_group.example.location
+  account_tier             = "Standard"
+  account_replication_type = "LRS"
+}
+
+resource "azurerm_storage_container" "example" {
+  name                 = "examplecontainer"
+  storage_account_name = azurerm_storage_account.example.name
+}
+
+resource "azurerm_subscription_cost_management_export" "example" {
+  name                         = "exampleexport"
+  subscription_id              = data.azurerm_subscription.example.id
+  recurrence_type              = "Monthly"
+  recurrence_period_start_date = "2020-08-18T00:00:00Z"
+  recurrence_period_end_date   = "2020-09-18T00:00:00Z"
+
+  export_data_storage_location {
+    container_id     = azurerm_storage_container.example.resource_manager_id
+    root_folder_path = "/root/updated"
+  }
+
+  export_data_options {
+    type       = "Usage"
+    time_frame = "WeekToDate"
+  }
+}
+
+```
+
+### [Azure Resource Manager template](#tab/armbudget)
 
 You can create a budget using an Azure Resource Manager template. To use the template, see [Create a budget with an Azure Resource Manager template](quick-create-budget-template.md).
 
+---
+
 ## Clean up resources
 
 If you created a budget and you no longer need it, view its details and delete it.