Updating Microsoft.Security\Pricing API Documentation (Azure#19439)

* Updating Microsoft.Security\Pricing API Documentation

* Adding items property to replacedBy

Author: rejoron

specification/security/resource-manager/Microsoft.Security/stable/2022-03-01/examples/Pricings/ListPricings_example.json

@@ -59,7 +59,11 @@
             "type": "Microsoft.Security/pricings",
             "properties": {
               "pricingTier": "Free",
-              "freeTrialRemainingTime": "PT0S"
+              "freeTrialRemainingTime": "PT0S",
+              "deprecated": true,
+              "replacedBy": [
+                "Containers"
+              ]
             }
           },
           {
@@ -68,7 +72,11 @@
             "type": "Microsoft.Security/pricings",
             "properties": {
               "pricingTier": "Free",
-              "freeTrialRemainingTime": "PT0S"
+              "freeTrialRemainingTime": "PT0S",
+              "deprecated": true,
+              "replacedBy": [
+                "Containers"
+              ]
             }
           },
           {

specification/security/resource-manager/Microsoft.Security/stable/2022-03-01/pricings.json

@@ -217,6 +217,19 @@
           "format": "duration",
           "readOnly": true,
           "description": "The duration left for the subscriptions free trial period - in ISO 8601 format (e.g. P3Y6M4DT12H30M5S)."
+        },
+        "deprecated": {
+          "type": "boolean",
+          "readOnly": true,
+          "description": "Optional. True if the plan is deprecated. If there are replacing plans they will appear in `replacedBy` property"
+        },
+        "replacedBy": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "readOnly": true,
+          "description": "Optional. List of plans that replace this plan. This property exists only if this plan is deprecated."
         }
       },
       "required": [