Merge branch 'Azure:main' into main

Commands/acat/_onboard.md

@@ -1,9 +1,16 @@
-# [Command] _acat onboard_
-
-Onboard given subscriptions to Microsoft.AppComplianceAutomation provider.
-
-## Versions
-
-### [2024-06-27](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXBwY29tcGxpYW5jZWF1dG9tYXRpb24vb25ib2FyZA==/2024-06-27.xml) **Stable**
-
-<!-- mgmt-plane /providers/microsoft.appcomplianceautomation/onboard 2024-06-27 -->
+# [Command] _acat onboard_
+
+Onboard given subscriptions to Microsoft.AppComplianceAutomation provider.
+
+## Versions
+
+### [2024-06-27](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXBwY29tcGxpYW5jZWF1dG9tYXRpb24vb25ib2FyZA==/2024-06-27.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.appcomplianceautomation/onboard 2024-06-27 -->
+
+#### examples
+
+- Onboard
+    ```bash
+        acat onboard --subscription-ids "[00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000001]"
+    ```

Commands/acat/_trigger-evaluation.md

@@ -1,9 +1,16 @@
-# [Command] _acat trigger-evaluation_
-
-Trigger quick evaluation for the given subscriptions.
-
-## Versions
-
-### [2024-06-27](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXBwY29tcGxpYW5jZWF1dG9tYXRpb24vdHJpZ2dlcmV2YWx1YXRpb24=/2024-06-27.xml) **Stable**
-
-<!-- mgmt-plane /providers/microsoft.appcomplianceautomation/triggerevaluation 2024-06-27 -->
+# [Command] _acat trigger-evaluation_
+
+Trigger quick evaluation for the given subscriptions.
+
+## Versions
+
+### [2024-06-27](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXBwY29tcGxpYW5jZWF1dG9tYXRpb24vdHJpZ2dlcmV2YWx1YXRpb24=/2024-06-27.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.appcomplianceautomation/triggerevaluation 2024-06-27 -->
+
+#### examples
+
+- TriggerEvaluation
+    ```bash
+        acat trigger-evaluation --resource-ids "[/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/Microsoft.SignalRService/SignalR/mySignalRService]"
+    ```

Commands/acat/readme.md

@@ -1,16 +1,16 @@
-# [Group] _acat_
-
-ACAT command group
-
-## Subgroups
-
-- [report](/Commands/acat/report/readme.md)
-: manage ACAT reports
-
-## Commands
-
-- [onboard](/Commands/acat/_onboard.md)
-: Onboard given subscriptions to Microsoft.AppComplianceAutomation provider.
-
-- [trigger-evaluation](/Commands/acat/_trigger-evaluation.md)
-: Trigger quick evaluation for the given subscriptions.
+# [Group] _acat_
+
+ACAT command group
+
+## Subgroups
+
+- [report](/Commands/acat/report/readme.md)
+: manage ACAT reports
+
+## Commands
+
+- [onboard](/Commands/acat/_onboard.md)
+: Onboard given subscriptions to Microsoft.AppComplianceAutomation provider.
+
+- [trigger-evaluation](/Commands/acat/_trigger-evaluation.md)
+: Trigger quick evaluation for the given subscriptions.

Commands/acat/report/_create.md

@@ -1,9 +1,22 @@
-# [Command] _acat report create_
-
-Create a new AppComplianceAutomation report or update an exiting AppComplianceAutomation report.
-
-## Versions
-
-### [2024-06-27](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXBwY29tcGxpYW5jZWF1dG9tYXRpb24vcmVwb3J0cy97fQ==/2024-06-27.xml) **Stable**
-
-<!-- mgmt-plane /providers/microsoft.appcomplianceautomation/reports/{} 2024-06-27 -->
+# [Command] _acat report create_
+
+Create a new AppComplianceAutomation report or update an exiting AppComplianceAutomation report.
+
+## Versions
+
+### [2024-06-27](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXBwY29tcGxpYW5jZWF1dG9tYXRpb24vcmVwb3J0cy97fQ==/2024-06-27.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.appcomplianceautomation/reports/{} 2024-06-27 -->
+
+#### examples
+
+- Report_CreateOrUpdate
+    ```bash
+        acat report create --report-name testReportName --offer-guid 00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002 --resources "[{resource-id:/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/Microsoft.SignalRService/SignalR/mySignalRService,resource-origin:Azure,resource-type:Microsoft.SignalRService/SignalR}]" --storage-info "{account-name:testStorageAccount,location:'East US',resource-group:testResourceGroup,subscription-id:00000000-0000-0000-0000-000000000000}" --time-zone GMT Standard Time --trigger-time 2022-03-04T05:00:00.000Z
+    ```
+
+- Report_CreateOrUpdate
+    ```bash
+        acat report create --report-nameddd testReportName --offer-guid 00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002 --resources "[{resource-id:/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/Microsoft.SignalRService/SignalR/mySignalRService,resource-origin:Azure,resource-type:Microsoft.SignalRService/SignalR}]" --storage-info "{account-name:testStorageAccount,location:'East US',resource-group:testResourceGroup,subscription-id:00000000-0000-0000-0000-000000000000}" --time-zone GMT Standard Time --trigger-time 2022-03-04T05:00:00.000Z
+        acat report create --report-nameddd testReportName  --resources "[{resource-id:/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/Microsoft.SignalRService/SignalR/mySignalRService,resource-origin:Azure,resource-type:Microsoft.SignalRService/SignalR}]"
+    ```

Commands/acat/report/_delete.md

@@ -1,9 +1,16 @@
-# [Command] _acat report delete_
-
-Delete an AppComplianceAutomation report.
-
-## Versions
-
-### [2024-06-27](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXBwY29tcGxpYW5jZWF1dG9tYXRpb24vcmVwb3J0cy97fQ==/2024-06-27.xml) **Stable**
-
-<!-- mgmt-plane /providers/microsoft.appcomplianceautomation/reports/{} 2024-06-27 -->
+# [Command] _acat report delete_
+
+Delete an AppComplianceAutomation report.
+
+## Versions
+
+### [2024-06-27](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXBwY29tcGxpYW5jZWF1dG9tYXRpb24vcmVwb3J0cy97fQ==/2024-06-27.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.appcomplianceautomation/reports/{} 2024-06-27 -->
+
+#### examples
+
+- Report_Delete
+    ```bash
+        acat report delete --report-name testReportName
+    ```

Commands/acat/report/_list.md

@@ -1,9 +1,17 @@
-# [Command] _acat report list_
-
-List the AppComplianceAutomation report list for the tenant.
-
-## Versions
-
-### [2024-06-27](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXBwY29tcGxpYW5jZWF1dG9tYXRpb24vcmVwb3J0cw==/2024-06-27.xml) **Stable**
-
-<!-- mgmt-plane /providers/microsoft.appcomplianceautomation/reports 2024-06-27 -->
+# [Command] _acat report list_
+
+List the AppComplianceAutomation report list for the tenant.
+
+## Versions
+
+### [2024-06-27](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXBwY29tcGxpYW5jZWF1dG9tYXRpb24vcmVwb3J0cw==/2024-06-27.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.appcomplianceautomation/reports 2024-06-27 -->
+
+#### examples
+
+- Report_List
+    ```bash
+        acat report list --skip-token 1 --top 100 --offer-guid 00000000-0000-0000-0000-000000000000 --tenant 00000000-0000-0000-0000-000000000000
+        acat report list
+    ```

Commands/acat/report/_show.md

@@ -1,9 +1,16 @@
-# [Command] _acat report show_
-
-Get the AppComplianceAutomation report and its properties.
-
-## Versions
-
-### [2024-06-27](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXBwY29tcGxpYW5jZWF1dG9tYXRpb24vcmVwb3J0cy97fQ==/2024-06-27.xml) **Stable**
-
-<!-- mgmt-plane /providers/microsoft.appcomplianceautomation/reports/{} 2024-06-27 -->
+# [Command] _acat report show_
+
+Get the AppComplianceAutomation report and its properties.
+
+## Versions
+
+### [2024-06-27](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXBwY29tcGxpYW5jZWF1dG9tYXRpb24vcmVwb3J0cy97fQ==/2024-06-27.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.appcomplianceautomation/reports/{} 2024-06-27 -->
+
+#### examples
+
+- Report_Get
+    ```bash
+        acat report show --report-name testReport
+    ```

Commands/acat/report/_update.md

@@ -1,9 +1,21 @@
-# [Command] _acat report update_
-
-Update a new AppComplianceAutomation report or update an exiting AppComplianceAutomation report.
-
-## Versions
-
-### [2024-06-27](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXBwY29tcGxpYW5jZWF1dG9tYXRpb24vcmVwb3J0cy97fQ==/2024-06-27.xml) **Stable**
-
-<!-- mgmt-plane /providers/microsoft.appcomplianceautomation/reports/{} 2024-06-27 -->
+# [Command] _acat report update_
+
+Update a new AppComplianceAutomation report or update an exiting AppComplianceAutomation report.
+
+## Versions
+
+### [2024-06-27](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXBwY29tcGxpYW5jZWF1dG9tYXRpb24vcmVwb3J0cy97fQ==/2024-06-27.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.appcomplianceautomation/reports/{} 2024-06-27 -->
+
+#### examples
+
+- update acat report
+    ```bash
+        acat report update --reportName testName     --offer-guid "00000000-0000-0000-0000-000000000001"
+    ```
+
+- update resource list
+    ```bash
+        acat report update  --report-name youReportName  --resources test.json
+    ```

Commands/acat/report/readme.md

@@ -1,28 +1,28 @@
-# [Group] _acat report_
-
-manage ACAT reports
-
-## Subgroups
-
-- [snapshot](/Commands/acat/report/snapshot/readme.md)
-: manage ACAT report snapshots
-
-- [webhook](/Commands/acat/report/webhook/readme.md)
-: manage ACAT report webhooks
-
-## Commands
-
-- [create](/Commands/acat/report/_create.md)
-: Create a new AppComplianceAutomation report or update an exiting AppComplianceAutomation report.
-
-- [delete](/Commands/acat/report/_delete.md)
-: Delete an AppComplianceAutomation report.
-
-- [list](/Commands/acat/report/_list.md)
-: List the AppComplianceAutomation report list for the tenant.
-
-- [show](/Commands/acat/report/_show.md)
-: Get the AppComplianceAutomation report and its properties.
-
-- [update](/Commands/acat/report/_update.md)
-: Update a new AppComplianceAutomation report or update an exiting AppComplianceAutomation report.
+# [Group] _acat report_
+
+manage ACAT reports
+
+## Subgroups
+
+- [snapshot](/Commands/acat/report/snapshot/readme.md)
+: manage ACAT report snapshots
+
+- [webhook](/Commands/acat/report/webhook/readme.md)
+: manage ACAT report webhooks
+
+## Commands
+
+- [create](/Commands/acat/report/_create.md)
+: Create a new AppComplianceAutomation report or update an exiting AppComplianceAutomation report.
+
+- [delete](/Commands/acat/report/_delete.md)
+: Delete an AppComplianceAutomation report.
+
+- [list](/Commands/acat/report/_list.md)
+: List the AppComplianceAutomation report list for the tenant.
+
+- [show](/Commands/acat/report/_show.md)
+: Get the AppComplianceAutomation report and its properties.
+
+- [update](/Commands/acat/report/_update.md)
+: Update a new AppComplianceAutomation report or update an exiting AppComplianceAutomation report.

Commands/acat/report/snapshot/_download.md

@@ -1,9 +1,16 @@
-# [Command] _acat report snapshot download_
-
-Download compliance needs from snapshot, like: Compliance Report, Resource List.
-
-## Versions
-
-### [2024-06-27](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXBwY29tcGxpYW5jZWF1dG9tYXRpb24vcmVwb3J0cy97fS9zbmFwc2hvdHMve30vZG93bmxvYWQ=/2024-06-27.xml) **Stable**
-
-<!-- mgmt-plane /providers/microsoft.appcomplianceautomation/reports/{}/snapshots/{}/download 2024-06-27 -->
+# [Command] _acat report snapshot download_
+
+Download compliance needs from snapshot, like: Compliance Report, Resource List.
+
+## Versions
+
+### [2024-06-27](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXBwY29tcGxpYW5jZWF1dG9tYXRpb24vcmVwb3J0cy97fS9zbmFwc2hvdHMve30vZG93bmxvYWQ=/2024-06-27.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.appcomplianceautomation/reports/{}/snapshots/{}/download 2024-06-27 -->
+
+#### examples
+
+- Snapshot_Download_ComplianceDetailedPdfReport
+    ```bash
+        acat report snapshot download --report-name testReportName  --download-type ComplianceDetailedPdfReport
+    ```

Commands/acat/report/snapshot/_list.md

@@ -1,9 +1,9 @@
-# [Command] _acat report snapshot list_
-
-List the AppComplianceAutomation snapshot list.
-
-## Versions
-
-### [2024-06-27](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXBwY29tcGxpYW5jZWF1dG9tYXRpb24vcmVwb3J0cy97fS9zbmFwc2hvdHM=/2024-06-27.xml) **Stable**
-
-<!-- mgmt-plane /providers/microsoft.appcomplianceautomation/reports/{}/snapshots 2024-06-27 -->
+# [Command] _acat report snapshot list_
+
+List the AppComplianceAutomation snapshot list.
+
+## Versions
+
+### [2024-06-27](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXBwY29tcGxpYW5jZWF1dG9tYXRpb24vcmVwb3J0cy97fS9zbmFwc2hvdHM=/2024-06-27.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.appcomplianceautomation/reports/{}/snapshots 2024-06-27 -->

Commands/acat/report/snapshot/readme.md

@@ -1,11 +1,11 @@
-# [Group] _acat report snapshot_
-
-manage ACAT report snapshots
-
-## Commands
-
-- [download](/Commands/acat/report/snapshot/_download.md)
-: Download compliance needs from snapshot, like: Compliance Report, Resource List.
-
-- [list](/Commands/acat/report/snapshot/_list.md)
-: List the AppComplianceAutomation snapshot list.
+# [Group] _acat report snapshot_
+
+manage ACAT report snapshots
+
+## Commands
+
+- [download](/Commands/acat/report/snapshot/_download.md)
+: Download compliance needs from snapshot, like: Compliance Report, Resource List.
+
+- [list](/Commands/acat/report/snapshot/_list.md)
+: List the AppComplianceAutomation snapshot list.

Commands/acat/report/webhook/_create.md

@@ -1,9 +1,22 @@
-# [Command] _acat report webhook create_
-
-Create a new AppComplianceAutomation webhook or update an exiting AppComplianceAutomation webhook.
-
-## Versions
-
-### [2024-06-27](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXBwY29tcGxpYW5jZWF1dG9tYXRpb24vcmVwb3J0cy97fS93ZWJob29rcy97fQ==/2024-06-27.xml) **Stable**
-
-<!-- mgmt-plane /providers/microsoft.appcomplianceautomation/reports/{}/webhooks/{} 2024-06-27 -->
+# [Command] _acat report webhook create_
+
+Create a new AppComplianceAutomation webhook or update an exiting AppComplianceAutomation webhook.
+
+## Versions
+
+### [2024-06-27](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXBwY29tcGxpYW5jZWF1dG9tYXRpb24vcmVwb3J0cy97fS93ZWJob29rcy97fQ==/2024-06-27.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.appcomplianceautomation/reports/{}/webhooks/{} 2024-06-27 -->
+
+#### examples
+
+- Webhook_CreateOrUpdate
+    ```bash
+        acat report webhook create --report-name testReportName --webhook-name testWebhookName --content-type application/json --enable-ssl-verification true --events "[generate_snapshot_failed]" --payload-url https://example.com --send-all-events false --status Enabled --update-webhook-key true --webhook-key 00000000-0000-0000-0000-000000000000
+    ```
+
+- Webhook_CreateOrUpdate
+    ```bash
+        acat report webhook create --report-name testReportName --webhook-name testWebhookName --content-type application/json --enable-ssl true --events "[generate_snapshot_failed]" --payload-url https://example.com --send-all-events false --status Enabled --update-webhook-key true --secret 00000000-0000-0000-0000-000000000000
+        acat report webhook create --report-name testReportName --webhook-name testWebhookName --payload-url https://example.com  --secret 00000000-0000-0000-0000-000000000000
+    ```