Removing raw format & returning references only

Author: Milan Zolota

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

@@ -548,33 +548,6 @@
       "default": "xml",
       "x-ms-parameter-location": "method"
     },
-    "PolicyFragmentExportFormat": {
-      "name": "format",
-      "in": "query",
-      "required": false,
-      "type": "string",
-      "description": "Policy Fragment Export Format.",
-      "enum": [
-        "xml",
-        "rawxml"
-      ],
-      "x-ms-enum": {
-        "name": "PolicyFragmentExportFormat",
-        "modelAsString": true,
-        "values": [
-          {
-            "value": "xml",
-            "description": "The contents are inline and Content type is an XML document."
-          },
-          {
-            "value": "rawxml",
-            "description": "The contents are inline and Content type is a non XML encoded policy fragment document."
-          }
-        ]
-      },
-      "default": "xml",
-      "x-ms-parameter-location": "method"
-    },
     "PolicyFragmentIdParameter": {
       "name": "policyFragmentId",
       "in": "path",

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

@@ -132,9 +132,6 @@
         "x-ms-examples": {
           "ApiManagementGetPolicyFragment": {
             "$ref": "./examples/ApiManagementGetPolicyFragment.json"
-          },
-          "ApiManagementGetPolicyFragmentFormat": {
-            "$ref": "./examples/ApiManagementGetPolicyFragmentFormat.json"
           }
         },
         "parameters": [
@@ -147,9 +144,6 @@
           {
             "$ref": "./apimanagement.json#/parameters/PolicyFragmentIdParameter"
           },
-          {
-            "$ref": "./apimanagement.json#/parameters/PolicyFragmentExportFormat"
-          },
           {
             "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
           },
@@ -304,7 +298,7 @@
           "PolicyFragment"
         ],
         "operationId": "PolicyFragment_GetReferences",
-        "description": "Lists policy documents that reference the policy fragment of the Api Management service.",
+        "description": "Listsresources that reference the policy fragment of the Api Management service.",
         "x-ms-examples": {
           "ApiManagementListPolicyFragmentReferences": {
             "$ref": "./examples/ApiManagementListPolicyFragmentReferences.json"
@@ -329,9 +323,9 @@
         ],
         "responses": {
           "200": {
-            "description": "Returns an array of Policy Documents that reference the policy fragment.",
+            "description": "Returns an array of references to resources that include the policy fragment in their definitions.",
             "schema": {
-              "$ref": "./definitions.json#/definitions/PolicyCollection"
+              "$ref": "./definitions.json#/definitions/PolicyFragmentReferencesCollection"
             }
           },
           "default": {

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

@@ -3913,7 +3913,11 @@
         "value": {
           "type": "array",
           "items": {
-            "$ref": "#/definitions/PolicyFragmentContract"
+            "allOf": [
+              {
+                "$ref": "./apimanagement.json#/definitions/Resource"
+              }
+            ]
           },
           "description": "Policy Fragment Contract value."
         },
@@ -3929,65 +3933,30 @@
       },
       "description": "The response of the get policy fragments operation."
     },
-    "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": {
+    "PolicyFragmentReferencesCollection": {
       "properties": {
         "value": {
-          "type": "string",
-          "description": "Contents of the Policy Fragment as defined by the format."
-        },
-        "format": {
-          "type": "string",
-          "description": "Format of the policyFragmentContent.",
-          "enum": [
-            "xml",
-            "xml-link",
-            "rawxml",
-            "rawxml-link"
-          ],
-          "x-ms-enum": {
-            "name": "PolicyFragmentContentFormat",
-            "modelAsString": true,
-            "values": [
-              {
-                "value": "xml",
-                "description": "The contents are inline and Content type is an XML document."
-              },
-              {
-                "value": "xml-link",
-                "description": "The policy fragment XML document is hosted on a http endpoint accessible from the API Management service."
-              },
-              {
-                "value": "rawxml",
-                "description": "The contents are inline and Content type is a non XML encoded policy document."
-              },
+          "type": "array",
+          "items": {
+            "allOf": [
               {
-                "value": "rawxml-link",
-                "description": "The policy fragment document is not XML encoded and is hosted on a http endpoint accessible from the API Management service."
+                "$ref": "./apimanagement.json#/definitions/Resource"
               }
             ]
           },
-          "default": "xml"
+          "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."
         }
       },
-      "required": [
-        "value"
-      ],
-      "description": "Policy fragment contract Properties."
+      "description": "The response of the get policy fragment references operation."
     },
     "PortalDelegationSettings": {
       "properties": {

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

@@ -13,10 +13,7 @@
           {
             "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/policies/policy",
             "type": "Microsoft.ApiManagement/service/policies",
-            "name": "policy",
-            "properties": {
-              "value": "<!--\r\n    IMPORTANT:\r\n    - Policy elements can appear only within the <inbound>, <outbound>, <backend> section elements.\r\n    - Only the <forward-request> policy element can appear within the <backend> section element.\r\n    - To apply a policy to the incoming request (before it is forwarded to the backend service), place a corresponding policy element within the <inbound> section element.\r\n    - To apply a policy to the outgoing response (before it is sent back to the caller), place a corresponding policy element within the <outbound> section element.\r\n    - To add a policy position the cursor at the desired insertion point and click on the round button associated with the policy.\r\n    - To remove a policy, delete the corresponding policy statement from the policy document.\r\n    - Policies are applied in the order of their appearance, from the top down.\r\n-->\r\n<policies>\r\n  <inbound />\r\n  <backend>\r\n    <forward-request />\r\n  </backend>\r\n  <outbound />\r\n</policies>"
-            }
+            "name": "policy"
           }
         ],
         "count": 1,

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

@@ -12,10 +12,7 @@
           {
             "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/policyFragments/policyFragment1",
             "type": "Microsoft.ApiManagement/service/policyFragments",
-            "name": "policyFragment1",
-            "properties": {
-              "value": "<json-to-xml apply=\"always\" consider-accept-header=\"false\" />\r\n<rewrite-uri template=\"/resource\" />"
-            }
+            "name": "policyFragment1"
           }
         ],
         "count": 1,