[Consumption] Add --name/-n aliases, flatten --time-period, add examples

- Expose --budget-name also as --name and -n on budget show/delete/create/update.
- Flatten --time-period on budget create/update so users pass --start-date and
  --end-date directly.
- Add a manual example for 'budget create' and a swagger-generated example for
  'budget show'.

Author: khang-11

Commands/consumption/budget/_create.md

@@ -11,3 +11,10 @@ Create operation to create or update a budget. You can optionally provide an eTa
 ### [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/_show.md

@@ -11,3 +11,10 @@ Get the budget for the scope by budget name.
 ### [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 --name TestBudget
+    ```

Commands/consumption/usage/_list.md

@@ -4,6 +4,10 @@ List the usage details for the defined scope. Usage details are available via th
 
 **Note:Microsoft will be retiring the Consumption Usage Details API at some point in the future. We do not recommend that you take a new dependency on this API. Please use the Cost Details API instead. We will notify customers once a date for retirement has been determined.For Learn more,see [Generate Cost Details Report - Create Operation](https://learn.microsoft.com/en-us/rest/api/cost-management/generate-cost-details-report/create-operation?tabs=HTTP)**
 
+**Note:Microsoft will be retiring the Consumption Usage Details API at some point in the future. We do not recommend that you take a new dependency on this API. Please use the Cost Details API instead. We will notify customers once a date for retirement has been determined.For Learn more,see [Generate Cost Details Report - Create Operation](https://learn.microsoft.com/en-us/rest/api/cost-management/generate-cost-details-report/create-operation?tabs=HTTP)**
+
+**Note:Microsoft will be retiring the Consumption Usage Details API at some point in the future. We do not recommend that you take a new dependency on this API. Please use the Cost Details API instead. We will notify customers once a date for retirement has been determined.For Learn more,see [Generate Cost Details Report - Create Operation](https://learn.microsoft.com/en-us/rest/api/cost-management/generate-cost-details-report/create-operation?tabs=HTTP)**
+
 ## Versions
 
 ### [2018-01-31](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5iaWxsaW5nL2JpbGxpbmdwZXJpb2RzL3t9L3Byb3ZpZGVycy9taWNyb3NvZnQuY29uc3VtcHRpb24vdXNhZ2VkZXRhaWxz/2018-01-31.xml) **Preview**

Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5jb25zdW1wdGlvbi9idWRnZXRzL3t9/2024-08-01.json

@@ -5,7 +5,7 @@
     <command name="show" version="2024-08-01">
       <resource id="/{scope}/providers/microsoft.consumption/budgets/{}" version="2024-08-01" swagger="mgmt-plane/consumption/ResourceProviders/Microsoft.Consumption/Paths/L3tzY29wZX0vcHJvdmlkZXJzL01pY3Jvc29mdC5Db25zdW1wdGlvbi9idWRnZXRzL3tidWRnZXROYW1lfQ==/V/MjAyNC0wOC0wMQ=="/>
       <argGroup name="">
-        <arg type="string" var="$Path.budgetName" options="budget-name" required="True">
+        <arg type="string" var="$Path.budgetName" options="name n" required="True">
           <help short="Budget Name."/>
         </arg>
         <arg type="string" var="$Path.scope" options="scope" required="True">
@@ -194,7 +194,7 @@
     <command name="delete" version="2024-08-01" confirmation="Are you sure you want to perform this operation?">
       <resource id="/{scope}/providers/microsoft.consumption/budgets/{}" version="2024-08-01" swagger="mgmt-plane/consumption/ResourceProviders/Microsoft.Consumption/Paths/L3tzY29wZX0vcHJvdmlkZXJzL01pY3Jvc29mdC5Db25zdW1wdGlvbi9idWRnZXRzL3tidWRnZXROYW1lfQ==/V/MjAyNC0wOC0wMQ=="/>
       <argGroup name="">
-        <arg type="string" var="$Path.budgetName" options="budget-name" required="True">
+        <arg type="string" var="$Path.budgetName" options="name n" required="True">
           <help short="Budget Name."/>
         </arg>
         <arg type="string" var="$Path.scope" options="scope" required="True">
@@ -229,7 +229,7 @@
     <command name="create" version="2024-08-01">
       <resource id="/{scope}/providers/microsoft.consumption/budgets/{}" version="2024-08-01" swagger="mgmt-plane/consumption/ResourceProviders/Microsoft.Consumption/Paths/L3tzY29wZX0vcHJvdmlkZXJzL01pY3Jvc29mdC5Db25zdW1wdGlvbi9idWRnZXRzL3tidWRnZXROYW1lfQ==/V/MjAyNC0wOC0wMQ=="/>
       <argGroup name="">
-        <arg type="string" var="$Path.budgetName" options="budget-name" required="True">
+        <arg type="string" var="$Path.budgetName" options="name n" required="True">
           <help short="Budget Name."/>
         </arg>
         <arg type="string" var="$Path.scope" options="scope" required="True">
@@ -366,16 +366,15 @@
             <item name="Quarterly" value="&quot;Quarterly&quot;"/>
           </enum>
         </arg>
-        <arg type="object" var="$parameters.properties.timePeriod" options="time-period" group="Properties">
-          <help short="Has start and end date of the budget. The start date must be first of the month and should be less than the end date. Budget start date must be on or after June 1, 2017. Future start date should not be more than twelve months. Past start date should  be selected within the timegrain period. There are no restrictions on the end date."/>
-          <arg type="dateTime" var="$parameters.properties.timePeriod.endDate" options="end-date">
-            <help short="The end date for the budget. If not provided, we default this to 10 years from the start date."/>
-            <format protocol="iso"/>
-          </arg>
-          <arg type="dateTime" var="$parameters.properties.timePeriod.startDate" options="start-date" required="True">
-            <help short="The start date for the budget."/>
-            <format protocol="iso"/>
-          </arg>
+      </argGroup>
+      <argGroup name="TimePeriod">
+        <arg type="dateTime" var="$parameters.properties.timePeriod.endDate" options="end-date" group="TimePeriod">
+          <help short="The end date for the budget. If not provided, we default this to 10 years from the start date."/>
+          <format protocol="iso"/>
+        </arg>
+        <arg type="dateTime" var="$parameters.properties.timePeriod.startDate" options="start-date" group="TimePeriod">
+          <help short="The start date for the budget."/>
+          <format protocol="iso"/>
         </arg>
       </argGroup>
       <operation operationId="Budgets_CreateOrUpdate">
@@ -492,7 +491,7 @@
                         <item value="&quot;Quarterly&quot;"/>
                       </enum>
                     </prop>
-                    <prop type="object" name="timePeriod" arg="$parameters.properties.timePeriod" required="True">
+                    <prop type="object" name="timePeriod" required="True">
                       <prop type="dateTime" name="endDate" arg="$parameters.properties.timePeriod.endDate">
                         <format protocol="iso"/>
                       </prop>
@@ -673,7 +672,7 @@
     <command name="update" version="2024-08-01">
       <resource id="/{scope}/providers/microsoft.consumption/budgets/{}" version="2024-08-01" swagger="mgmt-plane/consumption/ResourceProviders/Microsoft.Consumption/Paths/L3tzY29wZX0vcHJvdmlkZXJzL01pY3Jvc29mdC5Db25zdW1wdGlvbi9idWRnZXRzL3tidWRnZXROYW1lfQ==/V/MjAyNC0wOC0wMQ=="/>
       <argGroup name="">
-        <arg type="string" var="$Path.budgetName" options="budget-name" required="True">
+        <arg type="string" var="$Path.budgetName" options="name n" required="True">
           <help short="Budget Name."/>
         </arg>
         <arg type="string" var="$Path.scope" options="scope" required="True">
@@ -809,16 +808,15 @@
             <item name="Quarterly" value="&quot;Quarterly&quot;"/>
           </enum>
         </arg>
-        <arg type="object" var="$parameters.properties.timePeriod" options="time-period" group="Properties">
-          <help short="Has start and end date of the budget. The start date must be first of the month and should be less than the end date. Budget start date must be on or after June 1, 2017. Future start date should not be more than twelve months. Past start date should  be selected within the timegrain period. There are no restrictions on the end date."/>
-          <arg nullable="True" type="dateTime" var="$parameters.properties.timePeriod.endDate" options="end-date">
-            <help short="The end date for the budget. If not provided, we default this to 10 years from the start date."/>
-            <format protocol="iso"/>
-          </arg>
-          <arg type="dateTime" var="$parameters.properties.timePeriod.startDate" options="start-date">
-            <help short="The start date for the budget."/>
-            <format protocol="iso"/>
-          </arg>
+      </argGroup>
+      <argGroup name="TimePeriod">
+        <arg nullable="True" type="dateTime" var="$parameters.properties.timePeriod.endDate" options="end-date" group="TimePeriod">
+          <help short="The end date for the budget. If not provided, we default this to 10 years from the start date."/>
+          <format protocol="iso"/>
+        </arg>
+        <arg type="dateTime" var="$parameters.properties.timePeriod.startDate" options="start-date" group="TimePeriod">
+          <help short="The start date for the budget."/>
+          <format protocol="iso"/>
         </arg>
       </argGroup>
       <operation operationId="Budgets_Get">
@@ -1100,7 +1098,7 @@
                     <item value="&quot;Quarterly&quot;"/>
                   </enum>
                 </prop>
-                <prop type="object" name="timePeriod" arg="$parameters.properties.timePeriod" required="True">
+                <prop type="object" name="timePeriod" required="True">
                   <prop type="dateTime" name="endDate" arg="$parameters.properties.timePeriod.endDate">
                     <format protocol="iso"/>
                   </prop>