Storage Task Assignment Swagger Updates (Azure#29050)

* SDK team improvements

* Report APIs contain filtering

* PR comment add more examples

* Fix example path

* Fix duplicate schema issue

---------

Co-authored-by: Tricia Rosario <trrosari@microsoft.com>

Author: 2 people

specification/storage/resource-manager/Microsoft.Storage/stable/2023-05-01/common.json

@@ -237,7 +237,7 @@
       },
       "allOf": [
         {
-          "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/ProxyResource"
+          "$ref": "../../../../../common-types/resource-management/v1/types.json#/definitions/ProxyResource"
         }
       ],
       "description": "Storage Tasks run report instance"

specification/storage/resource-manager/Microsoft.Storage/stable/2023-05-01/examples/storageTaskAssignmentsCrud/PutStorageTaskAssignmentRequiredProperties.json

@@ -0,0 +1,82 @@
+{
+  "parameters": {
+    "subscriptionId": "1f31ba14-ce16-4281-b9b4-3e78da6e1616",
+    "resourceGroupName": "res4228",
+    "accountName": "sto4445",
+    "storageTaskAssignmentName": "myassignment1",
+    "api-version": "2023-05-01",
+    "parameters": {
+      "properties": {
+        "taskId": "/subscriptions/1f31ba14-ce16-4281-b9b4-3e78da6e1616/resourceGroups/res4228/providers/Microsoft.StorageActions/storageTasks/mytask1",
+        "enabled": true,
+        "description": "My Storage task assignment",
+        "executionContext": {
+          "trigger": {
+            "type": "RunOnce",
+            "parameters": {
+              "startOn": "2022-11-15T21:52:47.8145095Z"
+            }
+          }
+        },
+        "report": {
+          "prefix": "container1"
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/1f31ba14-ce16-4281-b9b4-3e78da6e1616/resourceGroups/res4228/providers/Microsoft.Storage/storageAccounts/sto4445/storageTaskAssignments/myassignment1",
+        "name": "myassignment1",
+        "type": "Microsoft.Storage/storageAccounts/storageTaskAssignments",
+        "properties": {
+          "taskId": "/subscriptions/1f31ba14-ce16-4281-b9b4-3e78da6e1616/resourceGroups/res4228/providers/Microsoft.StorageActions/storageTasks/mytask1",
+          "enabled": true,
+          "description": "My Storage task assignment",
+          "executionContext": {
+            "trigger": {
+              "type": "RunOnce",
+              "parameters": {
+                "startOn": "2022-11-15T21:52:47.8145095Z"
+              }
+            }
+          },
+          "report": {
+            "prefix": "container1"
+          },
+          "provisioningState": "Succeeded"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/1f31ba14-ce16-4281-b9b4-3e78da6e1616/resourceGroups/res4228/providers/Microsoft.Storage/storageAccounts/sto4445/storageTaskAssignments/myassignment1",
+        "name": "myassignment1",
+        "type": "Microsoft.Storage/storageAccounts/storageTaskAssignments",
+        "properties": {
+          "taskId": "/subscriptions/1f31ba14-ce16-4281-b9b4-3e78da6e1616/resourceGroups/res4228/providers/Microsoft.StorageActions/storageTasks/mytask1",
+          "enabled": true,
+          "description": "My Storage task assignment",
+          "executionContext": {
+            "trigger": {
+              "type": "RunOnce",
+              "parameters": {
+                "startOn": "2022-11-15T21:52:47.8145095Z"
+              }
+            }
+          },
+          "report": {
+            "prefix": "container1"
+          },
+          "provisioningState": "Succeeded"
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9101/providers/Microsoft.Storage/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-05-01"
+      }
+    }
+  }
+}

specification/storage/resource-manager/Microsoft.Storage/stable/2023-05-01/storageTaskAssignments.json

@@ -26,6 +26,9 @@
         "x-ms-examples": {
           "PutStorageTaskAssignment": {
             "$ref": "./examples/storageTaskAssignmentsCrud/PutStorageTaskAssignment.json"
+          },
+          "PutStorageTaskAssignmentRequiredProperties": {
+            "$ref": "./examples/storageTaskAssignmentsCrud/PutStorageTaskAssignmentRequiredProperties.json"
           }
         },
         "parameters": [
@@ -275,12 +278,6 @@
             "type": "string",
             "description": "Optional, specifies the maximum number of storage task assignment Ids to be included in the list response."
           },
-          {
-            "name": "$filter",
-            "in": "query",
-            "type": "string",
-            "description": "Optional. When specified, it can be used to query using reporting properties."
-          },
           {
             "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter"
           }
@@ -336,7 +333,7 @@
             "name": "$filter",
             "in": "query",
             "type": "string",
-            "description": "Optional. When specified, it can be used to query using reporting properties."
+            "description": "Optional. When specified, it can be used to query using reporting properties. See [Constructing Filter Strings](https://learn.microsoft.com/en-us/rest/api/storageservices/querying-tables-and-entities#constructing-filter-strings) for details."
           },
           {
             "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter"
@@ -396,7 +393,7 @@
             "name": "$filter",
             "in": "query",
             "type": "string",
-            "description": "Optional. When specified, it can be used to query using reporting properties."
+            "description": "Optional. When specified, it can be used to query using reporting properties. See [Constructing Filter Strings](https://learn.microsoft.com/en-us/rest/api/storageservices/querying-tables-and-entities#constructing-filter-strings) for details."
           },
           {
             "$ref": "../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter"
@@ -433,9 +430,12 @@
       },
       "allOf": [
         {
-          "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/Resource"
+          "$ref": "../../../../../common-types/resource-management/v1/types.json#/definitions/Resource"
         }
       ],
+      "required": [
+        "properties"
+      ],
       "description": "The storage task assignment."
     },
     "StorageTaskAssignmentProperties": {
@@ -507,7 +507,6 @@
         }
       },
       "required": [
-        "target",
         "trigger"
       ],
       "description": "Execution context of the storage task assignment."
@@ -530,9 +529,6 @@
           "description": "List of object prefixes to be excluded from task execution. If there is a conflict between include and exclude prefixes, the exclude prefix will be the determining factor"
         }
       },
-      "required": [
-        "prefix"
-      ],
       "description": "Target helps provide filter parameters for the objects in the storage account and forms the execution context for the storage task"
     },
     "ExecutionTrigger": {
@@ -675,7 +671,7 @@
       "type": "object",
       "properties": {
         "target": {
-          "$ref": "#/definitions/ExecutionTargetUpdate",
+          "$ref": "#/definitions/ExecutionTarget",
           "description": "Execution target of the storage task assignment"
         },
         "trigger": {
@@ -685,26 +681,6 @@
       },
       "description": "Execution context of the storage task assignment update."
     },
-    "ExecutionTargetUpdate": {
-      "type": "object",
-      "properties": {
-        "prefix": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "description": "List of object prefixes to be included for task execution"
-        },
-        "excludePrefix": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "description": "List of object prefixes to be excluded from task execution. If there is a conflict between include and exclude prefixes, the exclude prefix will be the determining factor"
-        }
-      },
-      "description": "Target helps provide filter parameters for the objects in the storage account and forms the execution context for the storage task"
-    },
     "ExecutionTriggerUpdate": {
       "type": "object",
       "properties": {