Patch reservations microsoft.capacity 2022 11 01 (Azure#22622)

* Add 200 responses for Return to fix SDK

* Add additional non required property and extra info in description

* Add p3Y, p5Y for msrp response. Fix typo

* update example to use reservationOrder call

* remove instanceFlexibility which will be deprecated in the near future

* add final state schema in long running operations field instead of introduce 200

* add 200 back since azure cli and powershell currently still doesn't support final-state-schema

Author: chchen3

specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/examples/Return.json

@@ -15,9 +15,33 @@
     }
   },
   "responses": {
+    "200": {
+      "body": {
+        "id": "/providers/microsoft.capacity/reservationOrders/50000000-aaaa-bbbb-cccc-100000000004",
+        "type": "Microsoft.Capacity/reservationOrders",
+        "name": "50000000-aaaa-bbbb-cccc-100000000004",
+        "etag": 7,
+        "properties": {
+          "displayName": "cabri",
+          "requestDateTime": "2017-08-30T03:49:19.0252126Z",
+          "createdDateTime": "2017-08-30T03:51:49.8083758Z",
+          "expiryDate": "2018-08-30",
+          "expiryDateTime": "2018-08-30T03:51:49.8083758Z",
+          "term": "P1Y",
+          "billingPlan": "Monthly",
+          "provisioningState": "Succeeded",
+          "reservations": [
+            {
+              "id": "/providers/microsoft.capacity/reservationOrders/50000000-aaaa-bbbb-cccc-100000000004/reservations/40000000-aaaa-bbbb-cccc-100000000000"
+            }
+          ],
+          "originalQuantity": 7
+        }
+      }
+    },
     "202": {
       "headers": {
-        "Location": "https://management.azure.com/providers/Microsoft.Capacity/reservationorders/50000000-aaaa-bbbb-cccc-100000000004/reservations/40000000-aaaa-bbbb-cccc-100000000000?api-version=2022-11-01"
+        "Location": "https://management.azure.com/providers/Microsoft.Capacity/reservationorders/50000000-aaaa-bbbb-cccc-100000000004?api-version=2022-11-01"
       },
       "body": {
         "id": "/providers/Microsoft.Capacity/reservationOrders/50000000-aaaa-bbbb-cccc-100000000004/reservations/40000000-aaaa-bbbb-cccc-100000000000",

specification/reservations/resource-manager/Microsoft.Capacity/stable/2022-11-01/reservations.json

@@ -867,6 +867,12 @@
           "Return"
         ],
         "responses": {
+          "200": {
+            "description": "The resource has been returned",
+            "schema": {
+              "$ref": "#/definitions/ReservationOrderResponse"
+            }
+          },
           "202": {
             "description": "Detailed refund info of a reservation",
             "headers": {
@@ -1586,6 +1592,16 @@
               "type": "object",
               "$ref": "#/definitions/Price",
               "description": "Amount in pricing currency. Tax not included."
+            },
+            "p3Y": {
+              "type": "object",
+              "$ref": "#/definitions/Price",
+              "description": "Amount in pricing currency. Tax not included."
+            },
+            "p5Y": {
+              "type": "object",
+              "$ref": "#/definitions/Price",
+              "description": "Amount in pricing currency. Tax not included."
             }
           }
         },
@@ -3258,7 +3274,7 @@
     },
     "AppliedScopes": {
       "type": "array",
-      "description": "List of the subscriptions that the benefit will be applied. Do not specify if AppliedScopeType is Shared.",
+      "description": "List of the subscriptions that the benefit will be applied. Do not specify if AppliedScopeType is Shared. This property will be deprecated and replaced by appliedScopeProperties instead for Single AppliedScopeType.",
       "items": {
         "type": "string",
         "minItems": 1,