PolicyFragmentContract & fixes

Author: Milan Zolota

specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2021-04-01-preview/apimpolicyfragments.json

@@ -62,9 +62,9 @@
         ],
         "responses": {
           "200": {
-            "description": "Returns an array of Policy Fragments.",
+            "description": "Returns an array of references to policy Fragments.",
             "schema": {
-              "$ref": "./definitions.json#/definitions/PolicyFragmentCollection"
+              "$ref": "./definitions.json#/definitions/PolicyFragmentReferenceCollection"
             }
           },
           "default": {
@@ -153,7 +153,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Get the Global policy definition of the Api Management service.",
+            "description": "Get the policy fragment definition of the Api Management service.",
             "schema": {
               "$ref": "./definitions.json#/definitions/PolicyFragmentContract"
             },
@@ -325,7 +325,7 @@
           "200": {
             "description": "Returns an array of references to resources that include the policy fragment in their definitions.",
             "schema": {
-              "$ref": "./definitions.json#/definitions/PolicyFragmentReferencesCollection"
+              "$ref": "./definitions.json#/definitions/PolicyFragmentReferenceCollection"
             }
           },
           "default": {

specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2021-04-01-preview/definitions.json

@@ -3908,7 +3908,7 @@
       },
       "description": "Descriptions of APIM policies."
     },
-    "PolicyFragmentCollection": {
+    "PolicyFragmentReferenceCollection": {
       "properties": {
         "value": {
           "type": "array",
@@ -3919,7 +3919,7 @@
               }
             ]
           },
-          "description": "Policy Fragment Contract value."
+          "description": "Resource references."
         },
         "count": {
           "type": "integer",
@@ -3931,32 +3931,34 @@
           "description": "Next page link if any."
         }
       },
-      "description": "The response of the get policy fragments operation."
+      "description": "The response of the get policy fragments and get policy fragment references operations."
     },
-    "PolicyFragmentReferencesCollection": {
+    "PolicyFragmentContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/PolicyFragmentContractProperties",
+          "description": "Properties of the Policy Fragment."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Policy Fragment Contract details."
+    },
+    "PolicyFragmentContractProperties": {
       "properties": {
         "value": {
-          "type": "array",
-          "items": {
-            "allOf": [
-              {
-                "$ref": "./apimanagement.json#/definitions/Resource"
-              }
-            ]
-          },
-          "description": "Policy Fragment References Contract value."
-        },
-        "count": {
-          "type": "integer",
-          "format": "int64",
-          "description": "Total record count number."
-        },
-        "nextLink": {
           "type": "string",
-          "description": "Next page link if any."
+          "description": "Contents of the Policy Fragment as defined by the format."
         }
       },
-      "description": "The response of the get policy fragment references operation."
+      "required": [
+        "value"
+      ],
+      "description": "Policy fragment contract Properties."
     },
     "PortalDelegationSettings": {
       "properties": {

specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2021-04-01-preview/examples/ApiManagementCreatePolicyFragment.json

@@ -7,7 +7,6 @@
     "policyFragmentId": "policyFragment1",
     "parameters": {
       "properties": {
-        "format": "xml",
         "value": "<json-to-xml apply=\"always\" consider-accept-header=\"false\" />\r\n<rewrite-uri template=\"/resource\" />"
       }
     }