[Defender (RiskIQ) - EASM] Api version 2023-03-01-preview (#23147)

* Added new version that include data connector api.

* Update easm api version to include data connection

* Update readme

* Update version in readme, rename example DataConnections_Remove.json

* Address comments on easm api 2023-03-01-preview version

* Update List operations examples and add Assets_Observations example

* Update model of examples

* Update data connections examples

* Remove properties field from DataConnections_Get example

* add discriminator to data connection base classes

* Add properties to examples

* Fix typos

* Remove assets observations endpoint and its example

* the `value` property of a pageable responses is required

---------

Co-authored-by: Brian Zak <brianzak@microsoft.com>

Author: thang-bit

specification/riskiq/data-plane/Microsoft.Easm/preview/2023-03-01-preview/easm.json

@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "api-version": "2023-03-01-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "dummyrg",
+    "workspaceName": "ThisisaWorkspace",
+    "filter": "state%20%3D%20%22confirmed%22%20AND%20name%20%5E%3D%20%22contoso.com%22",
+    "body": {
+      "state": "confirmed",
+      "externalId": "contosoInternalId",
+      "labels": {
+        "contosoLabel": true
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "ThisisaTaskId",
+        "startedAt": "2022-05-02T19:30:14.432+00:00",
+        "completedAt": "2022-05-02T19:30:54.432+00:00",
+        "lastPolledAt": "2022-05-02T19:30:19.432+00:00",
+        "state": "complete",
+        "phase": "complete",
+        "reason": "This is a Task id"
+      }
+    }
+  }
+}

specification/riskiq/data-plane/Microsoft.Easm/preview/2023-03-01-preview/examples/Assets_Get.json

@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "api-version": "2023-03-01-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "dummyrg",
+    "workspaceName": "ThisisaWorkspace",
+    "dataConnectionName": "ThisisaDataConnection"
+  },
+  "responses": {
+    "204": {}
+  }
+}

specification/riskiq/data-plane/Microsoft.Easm/preview/2023-03-01-preview/examples/Assets_List.json

@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "api-version": "2023-03-01-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "dummyrg",
+    "workspaceName": "ThisisaWorkspace",
+    "dataConnectionName": "ThisisaDataConnection"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "ThisisaDataConnection",
+        "name": "ThisisaDataConnection",
+        "displayName": "ThisisaDataConnection",
+        "kind": "logAnalytics",
+        "frequency": "weekly",
+        "frequencyOffset": 1,
+        "properties": {
+          "apiKey": "ThisisApiKey",
+          "workspaceId": "ThisisWorkspaceId"
+        },
+        "createdDate": "2022-05-02T19:30:14.432+00:00",
+        "updatedDate": "2022-05-02T19:30:14.432+00:00"
+      }
+    }
+  }
+}

specification/riskiq/data-plane/Microsoft.Easm/preview/2023-03-01-preview/examples/Assets_Update.json

@@ -0,0 +1,47 @@
+{
+  "parameters": {
+    "api-version": "2023-03-01-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "dummyrg",
+    "workspaceName": "ThisisaWorkspace"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "totalElements": 2,
+        "nextLink": "https://<api-endpoint>/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/dummyrg/workspaces/ThisisaWorkspace/dataConnections?maxpagesize=25&api-version=2023-03-01-preview",
+        "value": [
+          {
+            "id": "ThisisaDataConnection",
+            "name": "ThisisaDataConnection",
+            "displayName": "ThisisaDataConnection",
+            "kind": "logAnalytics",
+            "frequency": "weekly",
+            "frequencyOffset": 1,
+            "properties": {
+              "apiKey": "ThisisApiKey",
+              "workspaceId": "ThisisWorkspaceId"
+            },
+            "createdDate": "2022-05-02T19:30:14.432+00:00",
+            "updatedDate": "2022-05-02T19:30:14.432+00:00"
+          },
+          {
+            "id": "ThisisaDataConnection2",
+            "name": "ThisisaDataConnection2",
+            "displayName": "ThisisaDataConnection2",
+            "kind": "azureDataExplorer",
+            "properties": {
+              "clusterName": "ThisisClusterName",
+              "region": "ThisisRegion",
+              "databaseName": "ThisisDatabaseName"
+            },
+            "frequency": "weekly",
+            "frequencyOffset": 1,
+            "createdDate": "2022-05-02T19:30:14.432+00:00",
+            "updatedDate": "2022-05-02T19:30:14.432+00:00"
+          }
+        ]
+      }
+    }
+  }
+}

specification/riskiq/data-plane/Microsoft.Easm/preview/2023-03-01-preview/examples/DataConnections_Delete.json

@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "api-version": "2023-03-01-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "dummyrg",
+    "workspaceName": "ThisisaWorkspace",
+    "dataConnectionName": "ThisisaDataConnection",
+    "body": {
+      "kind": "logAnalytics",
+      "properties": {
+        "apiKey": "ThisisApiKey",
+        "workspaceId": "ThisisWorkspaceId"
+      },
+      "frequency": "weekly",
+      "frequencyOffset": 1
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "ThisisaDataConnection",
+        "name": "ThisisaDataConnection",
+        "displayName": "ThisisaDataConnection",
+        "kind": "logAnalytics",
+        "properties": {
+          "apiKey": "ThisisApiKey",
+          "workspaceId": "ThisisWorkspaceId"
+        },
+        "createdDate": "2022-05-02T19:30:14.432+00:00",
+        "updatedDate": "2022-05-02T19:30:14.432+00:00"
+      }
+    }
+  }
+}

specification/riskiq/data-plane/Microsoft.Easm/preview/2023-03-01-preview/examples/DataConnections_Get.json

@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "api-version": "2023-03-01-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "dummyrg",
+    "workspaceName": "ThisisaWorkspace",
+    "body": {
+      "kind": "logAnalytics",
+      "properties": {
+        "apiKey": "ThisisApiKey",
+        "workspaceId": "ThisisWorkspaceId"
+      },
+      "frequency": "weekly",
+      "frequencyOffset": 1,
+      "name": "ThisisaDataConnection"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "error": null
+      }
+    }
+  }
+}

specification/riskiq/data-plane/Microsoft.Easm/preview/2023-03-01-preview/examples/DataConnections_List.json

@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "api-version": "2023-03-01-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "dummyrg",
+    "workspaceName": "ThisisaWorkspace",
+    "groupName": "ThisisaDiscoGroup"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "ThisisaDiscoGroup",
+        "name": "ThisisaDiscoGroup",
+        "displayName": "ThisisaDiscoGroup",
+        "description": "This is a disco group",
+        "tier": "advanced",
+        "frequencyMilliseconds": 604800000,
+        "seeds": [
+          {
+            "name": "thisisatest.microsoft.com",
+            "kind": "host"
+          }
+        ],
+        "excludes": [],
+        "templateId": "123",
+        "latestRun": {
+          "startedDate": "2022-05-02T19:30:14.432+00:00",
+          "state": "completed"
+        },
+        "createdDate": "2022-05-02T19:30:14.432+00:00"
+      }
+    }
+  }
+}