[Consumption] Update to API 2024-08-01 with refined args and examples

- Update consumption commands to API 2024-08-01.
- Expose --budget-name as --name/-n on budget show/delete/create/update.
- Move --start-date/--end-date and --etag to default arg group on
  budget create/update.
- Rename --e-tag to --etag.
- Add curated examples for budget, marketplace, pricesheet, usage,
  and reservation detail/summary list commands.
- Strip swagger markdown link from 'usage list' help to satisfy aaz
  md verification.

Author: khang-11

Commands/consumption/budget/_create.md

@@ -1,9 +1,20 @@
 # [Command] _consumption budget create_
 
-Create operation to create or update a budget. Update operation requires latest eTag to be set in the request mandatorily. You may obtain the latest eTag by performing a get operation. Create operation does not require eTag.
+Create operation to create or update a budget. You can optionally provide an eTag if desired as a form of concurrency control. To obtain the latest eTag for a given budget, perform a get operation prior to your put operation.
 
 ## Versions
 
 ### [2018-01-31](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb25zdW1wdGlvbi9idWRnZXRzL3t9/2018-01-31.xml) **Preview**
 
 <!-- mgmt-plane /subscriptions/{}/providers/microsoft.consumption/budgets/{} 2018-01-31 -->
+
+### [2024-08-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5jb25zdW1wdGlvbi9idWRnZXRzL3t9/2024-08-01.xml) **Stable**
+
+<!-- mgmt-plane /{scope}/providers/microsoft.consumption/budgets/{} 2024-08-01 -->
+
+#### examples
+
+- Create a monthly cost budget
+    ```bash
+        consumption budget create -n my-budget --amount 100 --category Cost --time-grain Monthly --start-date 2025-01-01T00:00:00Z --end-date 2025-12-31T00:00:00Z --scope subscriptions/00000000-0000-0000-0000-000000000000
+    ```

Commands/consumption/budget/_delete.md

@@ -7,3 +7,14 @@ Delete operation to delete a budget.
 ### [2018-01-31](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb25zdW1wdGlvbi9idWRnZXRzL3t9/2018-01-31.xml) **Preview**
 
 <!-- mgmt-plane /subscriptions/{}/providers/microsoft.consumption/budgets/{} 2018-01-31 -->
+
+### [2024-08-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5jb25zdW1wdGlvbi9idWRnZXRzL3t9/2024-08-01.xml) **Stable**
+
+<!-- mgmt-plane /{scope}/providers/microsoft.consumption/budgets/{} 2024-08-01 -->
+
+#### examples
+
+- DeleteBudget
+    ```bash
+        consumption budget delete --scope subscriptions/00000000-0000-0000-0000-000000000000 --name TestBudget
+    ```

Commands/consumption/budget/_list.md

@@ -1,10 +1,21 @@
 # [Command] _consumption budget list_
 
-List budgets for an Azure subscription.
+List all budgets for the defined scope.
 
 ## Versions
 
 ### [2018-01-31](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb25zdW1wdGlvbi9idWRnZXRz/2018-01-31.xml) **Preview**
 
 <!-- mgmt-plane /subscriptions/{}/providers/microsoft.consumption/budgets 2018-01-31 -->
 <!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.consumption/budgets 2018-01-31 -->
+
+### [2024-08-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5jb25zdW1wdGlvbi9idWRnZXRz/2024-08-01.xml) **Stable**
+
+<!-- mgmt-plane /{scope}/providers/microsoft.consumption/budgets 2024-08-01 -->
+
+#### examples
+
+- BudgetsList
+    ```bash
+        consumption budget list --scope subscriptions/00000000-0000-0000-0000-000000000000
+    ```

Commands/consumption/budget/_show.md

@@ -1,9 +1,20 @@
 # [Command] _consumption budget show_
 
-Get the budget for a subscription by budget name.
+Get the budget for the scope by budget name.
 
 ## Versions
 
 ### [2018-01-31](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb25zdW1wdGlvbi9idWRnZXRzL3t9/2018-01-31.xml) **Preview**
 
 <!-- mgmt-plane /subscriptions/{}/providers/microsoft.consumption/budgets/{} 2018-01-31 -->
+
+### [2024-08-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5jb25zdW1wdGlvbi9idWRnZXRzL3t9/2024-08-01.xml) **Stable**
+
+<!-- mgmt-plane /{scope}/providers/microsoft.consumption/budgets/{} 2024-08-01 -->
+
+#### examples
+
+- Budget
+    ```bash
+        consumption budget show --scope subscriptions/00000000-0000-0000-0000-000000000000 --budget-name TestBudget
+    ```

Commands/consumption/budget/_update.md

@@ -1,9 +1,25 @@
 # [Command] _consumption budget update_
 
-Update operation to create or update a budget. Update operation requires latest eTag to be set in the request mandatorily. You may obtain the latest eTag by performing a get operation. Create operation does not require eTag.
+Update operation to create or update a budget. You can optionally provide an eTag if desired as a form of concurrency control. To obtain the latest eTag for a given budget, perform a get operation prior to your put operation.
 
 ## Versions
 
 ### [2018-01-31](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb25zdW1wdGlvbi9idWRnZXRzL3t9/2018-01-31.xml) **Preview**
 
 <!-- mgmt-plane /subscriptions/{}/providers/microsoft.consumption/budgets/{} 2018-01-31 -->
+
+### [2024-08-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5jb25zdW1wdGlvbi9idWRnZXRzL3t9/2024-08-01.xml) **Stable**
+
+<!-- mgmt-plane /{scope}/providers/microsoft.consumption/budgets/{} 2024-08-01 -->
+
+#### examples
+
+- Update budget amount
+    ```bash
+        consumption budget update --scope subscriptions/00000000-0000-0000-0000-000000000000 --name TestBudget --amount 200
+    ```
+
+- Update budget end date
+    ```bash
+        consumption budget update --scope subscriptions/00000000-0000-0000-0000-000000000000 --name TestBudget --end-date 2026-12-31T00:00:00Z
+    ```

Commands/consumption/budget/readme.md

@@ -5,7 +5,7 @@ Manage budgets for an Azure subscription.
 ## Commands
 
 - [create](/Commands/consumption/budget/_create.md)
-: Create operation to create or update a budget. Update operation requires latest eTag to be set in the request mandatorily. You may obtain the latest eTag by performing a get operation. Create operation does not require eTag.
+: Create operation to create or update a budget. You can optionally provide an eTag if desired as a form of concurrency control. To obtain the latest eTag for a given budget, perform a get operation prior to your put operation.
 
 - [create-with-rg](/Commands/consumption/budget/_create-with-rg.md)
 : Create operation to create or update a budget. Update operation requires latest eTag to be set in the request mandatorily. You may obtain the latest eTag by performing a get operation. Create operation does not require eTag.
@@ -17,16 +17,16 @@ Manage budgets for an Azure subscription.
 : Delete operation to delete a budget.
 
 - [list](/Commands/consumption/budget/_list.md)
-: List budgets for an Azure subscription.
+: List all budgets for the defined scope.
 
 - [show](/Commands/consumption/budget/_show.md)
-: Get the budget for a subscription by budget name.
+: Get the budget for the scope by budget name.
 
 - [show-with-rg](/Commands/consumption/budget/_show-with-rg.md)
 : Get the budget for a resource group under a subscription by budget name.
 
 - [update](/Commands/consumption/budget/_update.md)
-: Update operation to create or update a budget. Update operation requires latest eTag to be set in the request mandatorily. You may obtain the latest eTag by performing a get operation. Create operation does not require eTag.
+: Update operation to create or update a budget. You can optionally provide an eTag if desired as a form of concurrency control. To obtain the latest eTag for a given budget, perform a get operation prior to your put operation.
 
 - [update-with-rg](/Commands/consumption/budget/_update-with-rg.md)
 : Update operation to create or update a budget. Update operation requires latest eTag to be set in the request mandatorily. You may obtain the latest eTag by performing a get operation. Create operation does not require eTag.

Commands/consumption/marketplace/_list.md

@@ -1,10 +1,31 @@
 # [Command] _consumption marketplace list_
 
-List the marketplace for an Azure subscription within a billing period.
+List the marketplaces for a scope at the defined scope. Marketplaces are available via this API only for May 1, 2014 or later.
 
 ## Versions
 
 ### [2018-01-31](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5iaWxsaW5nL2JpbGxpbmdwZXJpb2RzL3t9L3Byb3ZpZGVycy9taWNyb3NvZnQuY29uc3VtcHRpb24vbWFya2V0cGxhY2Vz/2018-01-31.xml) **Preview**
 
 <!-- mgmt-plane /subscriptions/{}/providers/microsoft.billing/billingperiods/{}/providers/microsoft.consumption/marketplaces 2018-01-31 -->
 <!-- mgmt-plane /subscriptions/{}/providers/microsoft.consumption/marketplaces 2018-01-31 -->
+
+### [2024-08-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5jb25zdW1wdGlvbi9tYXJrZXRwbGFjZXM=/2024-08-01.xml) **Stable**
+
+<!-- mgmt-plane /{scope}/providers/microsoft.consumption/marketplaces 2024-08-01 -->
+
+#### examples
+
+- List marketplaces for a subscription
+    ```bash
+        consumption marketplace list --scope subscriptions/00000000-0000-0000-0000-000000000000
+    ```
+
+- List marketplaces for a billing account
+    ```bash
+        consumption marketplace list --scope providers/Microsoft.Billing/billingAccounts/123456
+    ```
+
+- List marketplaces for a management group
+    ```bash
+        consumption marketplace list --scope providers/Microsoft.Management/managementGroups/MyMgmtGroup
+    ```

Commands/consumption/marketplace/readme.md

@@ -5,4 +5,4 @@ Inspect the marketplace usage data of an Azure subscription within a billing per
 ## Commands
 
 - [list](/Commands/consumption/marketplace/_list.md)
-: List the marketplace for an Azure subscription within a billing period.
+: List the marketplaces for a scope at the defined scope. Marketplaces are available via this API only for May 1, 2014 or later.

Commands/consumption/pricesheet/_show.md

@@ -1,10 +1,21 @@
 # [Command] _consumption pricesheet show_
 
-Show the price sheet for an Azure subscription within a billing period.
+Get the price sheet for a subscription. Price sheet is available via this API only for May 1, 2014 or later.
 
 ## Versions
 
 ### [2018-01-31](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5iaWxsaW5nL2JpbGxpbmdwZXJpb2RzL3t9L3Byb3ZpZGVycy9taWNyb3NvZnQuY29uc3VtcHRpb24vcHJpY2VzaGVldHMvZGVmYXVsdA==/2018-01-31.xml) **Preview**
 
 <!-- mgmt-plane /subscriptions/{}/providers/microsoft.billing/billingperiods/{}/providers/microsoft.consumption/pricesheets/default 2018-01-31 -->
 <!-- mgmt-plane /subscriptions/{}/providers/microsoft.consumption/pricesheets/default 2018-01-31 -->
+
+### [2024-08-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb25zdW1wdGlvbi9wcmljZXNoZWV0cy9kZWZhdWx0/2024-08-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/providers/microsoft.consumption/pricesheets/default 2024-08-01 -->
+
+#### examples
+
+- PriceSheet
+    ```bash
+        consumption pricesheet show
+    ```

Commands/consumption/pricesheet/default/readme.md

@@ -0,0 +1,3 @@
+# [Group] _consumption pricesheet default_
+
+Manage Default