[Billing] update readme as feature request

specification/billing/resource-manager/Microsoft.Billing/preview/2019-10-01-preview/billing.json

@@ -766,7 +766,7 @@
           "Customers"
         ],
         "x-ms-examples": {
-          "CustomersListByBillingAccount": {
+          "CustomersListByBillingProfile": {
             "$ref": "./examples/CustomersListByBillingProfile.json"
           }
         },

specification/billing/resource-manager/Microsoft.Billing/stable/2020-05-01/billing.json

@@ -607,7 +607,7 @@
           "Customers"
         ],
         "x-ms-examples": {
-          "CustomersListByBillingAccount": {
+          "CustomersListByBillingProfile": {
             "$ref": "./examples/CustomersListByBillingProfile.json"
           }
         },

specification/billing/resource-manager/readme.az.md

@@ -0,0 +1,208 @@
+## AZ
+These settings apply only when `--az` is specified on the command line.
+``` yaml $(az) && $(target-mode) != 'core'
+az:
+  extensions: billing
+  namespace: azure.mgmt.billing
+  package-name: azure-mgmt-billing
+az-output-folder: $(azure-cli-extension-folder)/src/billing
+python-sdk-output-folder: "$(az-output-folder)/azext_billing/vendored_sdks/billing"
+#cli:
+#    cli-directive:
+#      - where:
+#            group: MachineLearningCompute
+#            op: CreateOrUpdate
+#            param: properties
+#        poly-resource: true
+```
+``` yaml $(az) && $(target-mode) == 'core'
+az:
+  extensions: billing
+  namespace: azure.mgmt.billing
+  package-name: azure-mgmt-billing
+az-output-folder: $(azure-cli-folder)/src/azure-cli/azure/cli/command_modules/billing
+python-sdk-output-folder: "$(az-output-folder)/vendored_sdks/billing"
+```
+
+# Az.Billing
+This directory contains the Cli common model for the Billing service.
+
+> Metadata
+``` yaml
+# Migrated from Powershell's readme
+
+extension-mode: stable
+
+directive:
+  - where:
+      group: billing invoice-section
+    set:
+      group: billing invoice section
+
+cli:
+    cli-directive:
+# -------- DO NOT generate those command groups --------
+      - select: 'operationGroup'
+        where:
+          operationGroup: BillingPeriods|EnrollmentAccounts|Agreements|BillingPermissions|BillingRoleAssignments|BillingRoleDefinitions|Instructions|Address.*$
+        hidden: true
+
+      # rename --billing-profile-name to --profile-name
+      - where:
+          param: billingProfileName
+        name: profile_name
+
+ # -------- BillingAccounts --------
+      # rename --billing-account-name to --account-name globally
+      - where:
+          param: billingAccountName
+        name: account_name
+      # shorten the name in billing account command group
+      - where:
+          group: billingAccounts
+          param: billingAccountName
+        alias:
+          - name
+          - n
+      - where:
+          operationGroup: billingAccounts
+        set:
+          groupExtensionMode: preview
+      - where:
+          operationGroup: BillingAccounts
+        name: account
+      # Shouldn't appear in accounts command group, the responses is not related to BollingAccount
+      - where:
+          group: BillingAccounts
+          op: ListInvoiceSectionsByCreateSubscriptionPermission
+        hidden: true
+
+# -------- BillingProfile --------
+      - where:
+          operationGroup: BillingProfiles
+        set:
+          groupExtensionMode: preview
+      - where:
+          operationGroup: BillingProfiles
+        name: profile
+      - where:
+          group: billingProfiles
+          param: billingProfileName
+        alias:
+          - name
+          - n
+      - select: 'property'
+        where:
+            objectSchema: 'billingProfileCreationRequest'
+            property: 'poNumber'
+        set:
+            name: 'purchase_order_number'
+
+# -------- Balance --------
+      - where:
+            group: 'availableBalances'
+        set:
+            name: 'balance'
+      - where:
+          group: availableBalances
+        set:
+          groupExtensionMode: preview
+
+# -------- Customer --------
+      - where:
+          group: Customers
+        set:
+          groupExtensionMode: preview
+
+# -------- Invoice --------
+      # customize for download command by manual for ungraceful implmentation by default
+      - where:
+          group: Invoices
+          op: DownloadInvoice
+        hidden: true
+      - where:
+          group: Invoices
+          op: DownloadMultipleBillingProfileInvoices
+        hidden: true
+      - where:
+          group: Invoices
+          op: DownloadBillingSubscriptionInvoice
+        hidden: true
+      - where:
+          group: Invoices
+          op: DownloadMultipleBillingSubscriptionInvoices
+        hidden: true
+      # customize for series of get commands by manual for ungraceful implmentation by default
+      - where:
+          group: Invoices
+          op: GetById
+        hidden: true
+      - where:
+          group: Invoices
+          op: GetBySubscriptionAndInvoiceId
+        hidden: true
+      - where:
+          group: Invoices
+          param: invoiceName
+        name: name
+        alias:  # --invoice-name is unnecessary under "billing invoice" command group
+          - name
+          - n
+
+# -------- InvoiceSection --------
+      - where:
+          group: InvoiceSections
+        set:
+          groupExtensionMode: preview # bug, won't take effect
+
+# -------- Policy -------
+      - where:
+          group: Policies
+        set:
+          groupExtensionMode: preview
+      # GetByBillingProfile and GetByCustomer will be implemented in manually customized show command
+      - where:
+          group: Policies
+          op: GetByBillingProfile
+        hidden: true
+      - where:
+          group: Policies
+          op: GetByCustomer
+        hidden: true
+      - where:
+          group: Policies
+          op: UpdateCustomer
+        hidden: true
+
+# ------ Product ------
+      - where:
+          group: Products
+        set:
+          groupExtensionMode: preview
+
+# ------ Subscription ------
+      - where:
+          group: BillingSubscriptions
+        set:
+          name: subscription
+          groupExtensionMode: preview
+
+# ------ Property ------
+      - where:
+          group: BillingProperty
+        set:
+          name: property
+          groupExtensionMode: preview
+      - select: 'property'
+        where:
+            objectSchema: 'BillingProfileProperties'
+            property: 'poNumber'
+        set:
+            name: 'purchase_order_number'
+
+# ------ Transaction ------
+      - where:
+          group: Transactions
+        set:
+          groupExtensionMode: preview
+```

specification/billing/resource-manager/readme.cli.md

@@ -1,33 +1,9 @@
 <!-- region Generated -->
-# Az.Aks
-This directory contains the Cli common model for the Aks service.
+# Az.Billing
+This directory contains the Cli common model for the Billing service.
 
 > Metadata
 ``` yaml
 # Migrated from Powershell's readme
-title: Billing
 
-cli:
-    cli-directive:
-      - select: 'property'
-        where:
-            objectSchema: 'billingProfileCreationRequest'
-            property: 'poNumber'
-        set:
-            name: 'purchase_order_number'
-      - select: 'operationGroup'
-        where: 
-            operationGroup: 'availableBalances'
-        set:
-            name: 'available_credit_balance'
-      - select: 'property'
-        where:
-            objectSchema: 'BillingProfileProperties'
-            property: 'poNumber'
-        set:
-            name: 'purchase_order_number'
-      - select: 'operationGroup'
-        where:
-          operationGroup: ^(?!^billingPeriod$)(?!^budget$)(?!^enrollmentAccounts$)(?!^invoices$)(?!^marketplace$)(?!^priceSheet$)(?!^reservationDetail$)(?!^reservationSummary$)(?!^usageAggregate$)(?!^usageDetail$).*$
-        hidden: true
 ```

specification/billing/resource-manager/readme.md

@@ -102,6 +102,7 @@ swagger-to-sdk:
   - repo: azure-sdk-for-js
   - repo: azure-sdk-for-node
   - repo: azure-sdk-for-ruby
+  - repo: azure-cli-extensions
     after_scripts:
       - bundle install && rake arm:regen_all_profiles['azure_mgmt_billing']
   - repo: azure-resource-manager-schemas
@@ -237,4 +238,3 @@ generate-interface: true
 ## AzureResourceSchema
 
 See configuration in [readme.azureresourceschema.md](./readme.azureresourceschema.md)
-