diff --git a/.azure-pipelines-preproduction/package-lock.json b/.azure-pipelines-preproduction/package-lock.json
index 59a143c83f23..3a5bb0080589 100644
--- a/.azure-pipelines-preproduction/package-lock.json
+++ b/.azure-pipelines-preproduction/package-lock.json
@@ -88,9 +88,9 @@
       }
     },
     "@azure/rest-api-specs-scripts": {
-      "version": "0.6.8",
-      "resolved": "https://registry.npmjs.org/@azure/rest-api-specs-scripts/-/rest-api-specs-scripts-0.6.8.tgz",
-      "integrity": "sha512-hXS8qWzzRMzJVRJEge7XKH3t9BUEILsx4DyVBAV+4T8ru/B5NQeg+YX0+nUABVwstFUnJAfTPwqB7QT2eYDoKA==",
+      "version": "0.7.1",
+      "resolved": "https://registry.npmjs.org/@azure/rest-api-specs-scripts/-/rest-api-specs-scripts-0.7.1.tgz",
+      "integrity": "sha512-HCBbg78O2eMQcaboneXns4LibWQ1vPK6tzh6BqJ+JYBleaVDiuFlvx2Jf8YwWxroxN0QRIh408OdNW3SWQPRQg==",
       "dev": true,
       "requires": {
         "@azure/avocado": "^0.4.1",
@@ -101,7 +101,7 @@
         "fs-extra": "^7.0.1",
         "glob": "^7.1.3",
         "js-yaml": "^3.13.1",
-        "oav": "0.20.9",
+        "oav": "0.21.3",
         "request": "^2.88.0"
       },
       "dependencies": {
@@ -187,9 +187,9 @@
       }
     },
     "@octokit/endpoint": {
-      "version": "5.5.3",
-      "resolved": "https://registry.npmjs.org/@octokit/endpoint/-/endpoint-5.5.3.tgz",
-      "integrity": "sha512-EzKwkwcxeegYYah5ukEeAI/gYRLv2Y9U5PpIsseGSFDk+G3RbipQGBs8GuYS1TLCtQaqoO66+aQGtITPalxsNQ==",
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/@octokit/endpoint/-/endpoint-6.0.0.tgz",
+      "integrity": "sha512-3nx+MEYoZeD0uJ+7F/gvELLvQJzLXhep2Az0bBSXagbApDvDW0LWwpnAIY/hb0Jwe17A0fJdz0O12dPh05cj7A==",
       "dev": true,
       "requires": {
         "@octokit/types": "^2.0.0",
@@ -234,13 +234,13 @@
       }
     },
     "@octokit/request": {
-      "version": "5.3.2",
-      "resolved": "https://registry.npmjs.org/@octokit/request/-/request-5.3.2.tgz",
-      "integrity": "sha512-7NPJpg19wVQy1cs2xqXjjRq/RmtSomja/VSWnptfYwuBxLdbYh2UjhGi0Wx7B1v5Iw5GKhfFDQL7jM7SSp7K2g==",
+      "version": "5.3.4",
+      "resolved": "https://registry.npmjs.org/@octokit/request/-/request-5.3.4.tgz",
+      "integrity": "sha512-qyj8G8BxQyXjt9Xu6NvfvOr1E0l35lsXtwm3SopsYg/JWXjlsnwqLc8rsD2OLguEL/JjLfBvrXr4az7z8Lch2A==",
       "dev": true,
       "requires": {
-        "@octokit/endpoint": "^5.5.0",
-        "@octokit/request-error": "^1.0.1",
+        "@octokit/endpoint": "^6.0.0",
+        "@octokit/request-error": "^2.0.0",
         "@octokit/types": "^2.0.0",
         "deprecation": "^2.0.0",
         "is-plain-object": "^3.0.0",
@@ -249,6 +249,17 @@
         "universal-user-agent": "^5.0.0"
       },
       "dependencies": {
+        "@octokit/request-error": {
+          "version": "2.0.0",
+          "resolved": "https://registry.npmjs.org/@octokit/request-error/-/request-error-2.0.0.tgz",
+          "integrity": "sha512-rtYicB4Absc60rUv74Rjpzek84UbVHGHJRu4fNVlZ1mCcyUPPuzFfG9Rn6sjHrd95DEsmjSt1Axlc699ZlbDkw==",
+          "dev": true,
+          "requires": {
+            "@octokit/types": "^2.0.0",
+            "deprecation": "^2.0.0",
+            "once": "^1.4.0"
+          }
+        },
         "universal-user-agent": {
           "version": "5.0.0",
           "resolved": "https://registry.npmjs.org/universal-user-agent/-/universal-user-agent-5.0.0.tgz",
@@ -296,9 +307,9 @@
       }
     },
     "@octokit/types": {
-      "version": "2.5.0",
-      "resolved": "https://registry.npmjs.org/@octokit/types/-/types-2.5.0.tgz",
-      "integrity": "sha512-KEnLwOfdXzxPNL34fj508bhi9Z9cStyN7qY1kOfVahmqtAfrWw6Oq3P4R+dtsg0lYtZdWBpUrS/Ixmd5YILSww==",
+      "version": "2.5.1",
+      "resolved": "https://registry.npmjs.org/@octokit/types/-/types-2.5.1.tgz",
+      "integrity": "sha512-q4Wr7RexkPRrkQpXzUYF5Fj/14Mr65RyOHj6B9d/sQACpqGcStkHZj4qMEtlMY5SnD/69jlL9ItGPbDM0dR/dA==",
       "dev": true,
       "requires": {
         "@types/node": ">= 8"
@@ -3222,13 +3233,13 @@
       "dev": true
     },
     "json-schema-faker": {
-      "version": "0.5.0-rc23",
-      "resolved": "https://registry.npmjs.org/json-schema-faker/-/json-schema-faker-0.5.0-rc23.tgz",
-      "integrity": "sha512-lRzFEnp55TihRzMvUBrtvTlM/aHGhCwfes0/T9bN9OiB2n36/SUFxtMn7anYoES+f95eU3viJ/foXKosCwsiJw==",
+      "version": "0.5.0-rcv.24",
+      "resolved": "https://registry.npmjs.org/json-schema-faker/-/json-schema-faker-0.5.0-rcv.24.tgz",
+      "integrity": "sha512-qwuRwv7dnUdqdwuifb6kJAVUKm0mzi4h/mzvMwDKxyWUzjxFCdVH/g9IfKxvc4M7rvAavr8pcx9uO1PNIIWE0g==",
       "dev": true,
       "requires": {
         "json-schema-ref-parser": "^6.1.0",
-        "jsonpath-plus": "^1.0.0",
+        "jsonpath-plus": "^2.0.0",
         "randexp": "^0.5.3"
       }
     },
@@ -3284,9 +3295,9 @@
       }
     },
     "jsonpath-plus": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/jsonpath-plus/-/jsonpath-plus-1.1.0.tgz",
-      "integrity": "sha512-ydqTBOuLcFCUr9e7AxJlKCFgxzEQ03HjnIim0hJSdk2NxD8MOsaMOrRgP6XWEm5q3VuDY5+cRT1DM9vLlGo/qA==",
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/jsonpath-plus/-/jsonpath-plus-2.0.0.tgz",
+      "integrity": "sha512-ksXaz9+3SIZ5BMxgr7MQueYcR515VRZPuoDhIymUd1JcF6BnVaYJS7k4NJni4EHhvJaOIGGiPqT8+ifsGp6mBw==",
       "dev": true
     },
     "jsonschema": {
@@ -3715,9 +3726,9 @@
       "dev": true
     },
     "ms-rest": {
-      "version": "2.5.3",
-      "resolved": "https://registry.npmjs.org/ms-rest/-/ms-rest-2.5.3.tgz",
-      "integrity": "sha512-p0CnzrTzEkS8UTEwgCqT2O5YVK9E8KGBBlJVm3hFtMZvf0dmncKYXWFPyUa4PAsfBL7h4jfu39tOIFTu6exntg==",
+      "version": "2.5.4",
+      "resolved": "https://registry.npmjs.org/ms-rest/-/ms-rest-2.5.4.tgz",
+      "integrity": "sha512-VeqCbawxRM6nhw0RKNfj7TWL7SL8PB6MypqwgylXCi+u412uvYoyY/kSmO8n06wyd8nIcnTbYToCmSKFMI1mCg==",
       "dev": true,
       "requires": {
         "duplexer": "^0.1.1",
@@ -3838,21 +3849,21 @@
       "dev": true
     },
     "oav": {
-      "version": "0.20.9",
-      "resolved": "https://registry.npmjs.org/oav/-/oav-0.20.9.tgz",
-      "integrity": "sha512-ObCpH+R1hBL60cqicybo/XgH89J7+Vi1PS215UZRzcDKvf0Km0EyycVfdfRtvdrrUVdC8AugH3RlXYn5esqKfA==",
+      "version": "0.21.3",
+      "resolved": "https://registry.npmjs.org/oav/-/oav-0.21.3.tgz",
+      "integrity": "sha512-awuRELCkelWdrGFpvEwH4Oi4Wwe9fm8677UM36grRMdaLbNOxXkvG4VhywbD7g8fVhk17vahOiXiEQ4iMx0e7A==",
       "dev": true,
       "requires": {
-        "@azure/openapi-markdown": "^0.9.0",
+        "@azure/openapi-markdown": "^0.9.2",
         "@microsoft.azure/autorest-extension-base": "1.0.13",
         "@ts-common/commonmark-to-markdown": "^1.2.0",
         "@ts-common/iterator": "^0.3.6",
         "@ts-common/json": "^0.3.1",
-        "@ts-common/json-parser": "^0.8.0",
+        "@ts-common/json-parser": "^0.9.0",
         "@ts-common/property-set": "^0.1.0",
         "@ts-common/source-map": "^0.5.0",
         "@ts-common/string-map": "^0.3.0",
-        "@ts-common/virtual-fs": "^0.2.0",
+        "@ts-common/virtual-fs": "^0.3.0",
         "@types/jsonpath": "^0.2.0",
         "commonmark": "^0.29.0",
         "glob": "^5.0.15",
@@ -3873,11 +3884,78 @@
         "vscode-jsonrpc": "^3.6.2",
         "winston": "^3.2.1",
         "yargs": "^6.6.0",
-        "yasway": "^1.8.11",
+        "yasway": "^1.9.3",
         "yuml2svg": "^4.2.1",
         "z-schema": "^4.2.2"
       },
       "dependencies": {
+        "@azure/openapi-markdown": {
+          "version": "0.9.2",
+          "resolved": "https://registry.npmjs.org/@azure/openapi-markdown/-/openapi-markdown-0.9.2.tgz",
+          "integrity": "sha512-EhjABbBzHAPK8K88Ya7yHdIKjcU2WSiclIuXSDqs/mYAUym4Z9o7lvIi0Li+mUhFaLAh2V4+OzdIVUdTzJa0Fg==",
+          "dev": true,
+          "requires": {
+            "@ts-common/commonmark-to-markdown": "^1.2.0",
+            "@ts-common/iterator": "^0.3.1",
+            "@ts-common/string-map": "^0.3.0",
+            "@ts-common/virtual-fs": "^0.3.0",
+            "commonmark": "^0.28.1",
+            "js-yaml": "^3.13.1",
+            "tslib": "^1.9.3"
+          },
+          "dependencies": {
+            "commonmark": {
+              "version": "0.28.1",
+              "resolved": "https://registry.npmjs.org/commonmark/-/commonmark-0.28.1.tgz",
+              "integrity": "sha1-Buq41SM4uDn6Gi11rwCF7tGxvq4=",
+              "dev": true,
+              "requires": {
+                "entities": "~ 1.1.1",
+                "mdurl": "~ 1.0.1",
+                "minimist": "~ 1.2.0",
+                "string.prototype.repeat": "^0.2.0"
+              }
+            }
+          }
+        },
+        "@ts-common/json-parser": {
+          "version": "0.9.0",
+          "resolved": "https://registry.npmjs.org/@ts-common/json-parser/-/json-parser-0.9.0.tgz",
+          "integrity": "sha512-how0z/Ak7Bay+feIYfJFVV8UMw8Ky2Czoo5XwN7QigCOlN4HyW6wSNup4zrZ7t6NUB0002tW/+IOKCH2lAVJOg==",
+          "dev": true,
+          "requires": {
+            "@ts-common/add-position": "0.0.2",
+            "@ts-common/iterator": "^0.3.5",
+            "@ts-common/json": "^0.3.1",
+            "@ts-common/source-map": "^0.5.0",
+            "@ts-common/string-map": "^0.3.0",
+            "tslib": "^1.9.3"
+          }
+        },
+        "@ts-common/virtual-fs": {
+          "version": "0.3.0",
+          "resolved": "https://registry.npmjs.org/@ts-common/virtual-fs/-/virtual-fs-0.3.0.tgz",
+          "integrity": "sha512-ryoXw52FTLhiexoNBA/hcAlW8gxPhrKEuZODgpCiF0wswNJdg/j+rCb9k1VppJdeIJ30b0Wg+2vPsrOrdnYTIw==",
+          "dev": true,
+          "requires": {
+            "@ts-common/fs": "^0.2.0",
+            "@ts-common/iterator": "^0.3.0",
+            "@types/async-retry": "^1.4.1",
+            "@types/node-fetch": "^2.5.5",
+            "async-retry": "^1.3.1",
+            "node-fetch": "^2.6.0"
+          }
+        },
+        "@types/node-fetch": {
+          "version": "2.5.5",
+          "resolved": "https://registry.npmjs.org/@types/node-fetch/-/node-fetch-2.5.5.tgz",
+          "integrity": "sha512-IWwjsyYjGw+em3xTvWVQi5MgYKbRs0du57klfTaZkv/B24AEQ/p/IopNeqIYNy3EsfHOpg8ieQSDomPcsYMHpA==",
+          "dev": true,
+          "requires": {
+            "@types/node": "*",
+            "form-data": "^3.0.0"
+          }
+        },
         "ansi-regex": {
           "version": "2.1.1",
           "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-2.1.1.tgz",
@@ -3893,6 +3971,15 @@
             "lodash": "^4.17.14"
           }
         },
+        "async-retry": {
+          "version": "1.3.1",
+          "resolved": "https://registry.npmjs.org/async-retry/-/async-retry-1.3.1.tgz",
+          "integrity": "sha512-aiieFW/7h3hY0Bq5d+ktDBejxuwR78vRu9hDUdR8rNhSaQ29VzPL4AoIRG7D/c7tdenwOcKvgPM6tIxB3cB6HA==",
+          "dev": true,
+          "requires": {
+            "retry": "0.12.0"
+          }
+        },
         "camelcase": {
           "version": "3.0.0",
           "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-3.0.0.tgz",
@@ -3910,6 +3997,17 @@
             "wrap-ansi": "^2.0.0"
           }
         },
+        "form-data": {
+          "version": "3.0.0",
+          "resolved": "https://registry.npmjs.org/form-data/-/form-data-3.0.0.tgz",
+          "integrity": "sha512-CKMFDglpbMi6PyN+brwB9Q/GOw0eAnsrEZDgcsH5Krhz5Od/haKHAX0NmQfha2zPPz0JpWzA7GJHGSnvCRLWsg==",
+          "dev": true,
+          "requires": {
+            "asynckit": "^0.4.0",
+            "combined-stream": "^1.0.8",
+            "mime-types": "^2.1.12"
+          }
+        },
         "get-caller-file": {
           "version": "1.0.3",
           "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-1.0.3.tgz",
@@ -4426,9 +4524,9 @@
       "dev": true
     },
     "psl": {
-      "version": "1.7.0",
-      "resolved": "https://registry.npmjs.org/psl/-/psl-1.7.0.tgz",
-      "integrity": "sha512-5NsSEDv8zY70ScRnOTn7bK7eanl2MvFrOrS/R6x+dBt5g1ghnj9Zv90kO8GwT8gxcu2ANyFprnFYB85IogIJOQ==",
+      "version": "1.8.0",
+      "resolved": "https://registry.npmjs.org/psl/-/psl-1.8.0.tgz",
+      "integrity": "sha512-RIdOzyoavK+hA18OGGWDqUTsCLhtA7IcZ/6NCs4fFJaHBDab+pDDmDIByWFRQJq2Cd7r1OoQxBGKOaztq+hjIQ==",
       "dev": true
     },
     "pump": {
@@ -4448,9 +4546,9 @@
       "dev": true
     },
     "qs": {
-      "version": "6.9.1",
-      "resolved": "https://registry.npmjs.org/qs/-/qs-6.9.1.tgz",
-      "integrity": "sha512-Cxm7/SS/y/Z3MHWSxXb8lIFqgqBowP5JMlTUFyJN88y0SGQhVmZnqFK/PeuMX9LzUyWsqqhNxIyg0jlzq946yA==",
+      "version": "6.9.3",
+      "resolved": "https://registry.npmjs.org/qs/-/qs-6.9.3.tgz",
+      "integrity": "sha512-EbZYNarm6138UKKq46tdx08Yo/q9ZhFoAXAI1meAFd2GtbRDhbZY2WQSICskT0c5q99aFzLG1D4nvTk9tqfXIw==",
       "dev": true
     },
     "randexp": {
@@ -5390,9 +5488,9 @@
       "dev": true
     },
     "uglify-js": {
-      "version": "3.8.0",
-      "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-3.8.0.tgz",
-      "integrity": "sha512-ugNSTT8ierCsDHso2jkBHXYrU8Y5/fY2ZUprfrJUiD7YpuFvV4jODLFmb3h4btQjqr5Nh4TX4XtgDfCU1WdioQ==",
+      "version": "3.8.1",
+      "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-3.8.1.tgz",
+      "integrity": "sha512-W7KxyzeaQmZvUFbGj4+YFshhVrMBGSg2IbcYAjGWGvx8DHvJMclbTDMpffdxFUGPBHjIytk7KJUR/KUXstUGDw==",
       "dev": true,
       "optional": true,
       "requires": {
@@ -5815,9 +5913,9 @@
       }
     },
     "yasway": {
-      "version": "1.8.11",
-      "resolved": "https://registry.npmjs.org/yasway/-/yasway-1.8.11.tgz",
-      "integrity": "sha512-LhMkY455qHEV7rKMjfvwgXkoB26JJkuK4hqQnbjNXjpuT/lfEpbYJiPMjFOvZTf2VmJqCoM7sej6P+7LJyxM1Q==",
+      "version": "1.9.3",
+      "resolved": "https://registry.npmjs.org/yasway/-/yasway-1.9.3.tgz",
+      "integrity": "sha512-yXyP2XFcUljK1/mbQ0lOS815+CtCQr/yjKc9NGNjAbz9sabMACwQtYV66nC4T93P6K83uGxP5QKcmXWC15eVPA==",
       "dev": true,
       "requires": {
         "@ts-common/json": "^0.3.0",
diff --git a/.azure-pipelines-preproduction/package.json b/.azure-pipelines-preproduction/package.json
index 30162f6f947b..e7a02a56675c 100644
--- a/.azure-pipelines-preproduction/package.json
+++ b/.azure-pipelines-preproduction/package.json
@@ -11,7 +11,7 @@
   "license": "MIT",
   "devDependencies": {
     "@azure/avocado": "^0.6.2",
-    "@azure/rest-api-specs-scripts": "^0.6.8",
+    "@azure/rest-api-specs-scripts": "^0.7.1",
     "@ts-common/commonmark-to-markdown": "^1.2.0",
     "@ts-common/fs": "0.2.0",
     "@ts-common/iterator": "^0.3.6",
diff --git a/.github/assignment.yml b/.github/assignment.yml
index a03e22c1bc10..c9323278abd1 100644
--- a/.github/assignment.yml
+++ b/.github/assignment.yml
@@ -83,6 +83,12 @@
       - fengzhou-msft 
       - yungezz
 
+- rule:
+    paths:
+      - "specification/mixedreality/**"
+    reviewers:
+      - leni-msft
+
 - rule:
     paths:
       - "specification/portal/**"
diff --git a/cSpell.json b/cSpell.json
index 170b1c683d28..8cf7fe1c77ee 100644
--- a/cSpell.json
+++ b/cSpell.json
@@ -188,6 +188,12 @@
                 "Exprired"
             ]
         },
+        {
+            "filename": "**/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/integrationRuntime.json",
+            "words": [
+                "Exprired"
+            ]
+        },
         {
             "filename": "**/specification/datamigration/resource-manager/Microsoft.DataMigration/preview/2018-07-15-preview/definitions/TasksCommon.json",
             "words": [
diff --git a/custom-words.txt b/custom-words.txt
index 0a6cfc7f50bf..3ec327a39ea6 100644
--- a/custom-words.txt
+++ b/custom-words.txt
@@ -491,6 +491,7 @@ entrypoint
 environmentsettings
 errordetail
 errored
+ErrorMesssage
 ErrorSchema
 Español
 estaba
@@ -1733,4 +1734,6 @@ bsls
 sessionids
 Dsms
 cloudManifestFiles
-highestcriticalimpact
\ No newline at end of file
+highestcriticalimpact
+apiserver
+kubeadmin
diff --git a/documentation/ci-fix.md b/documentation/ci-fix.md
index caa88d0ad563..38fc8d40ab9a 100644
--- a/documentation/ci-fix.md
+++ b/documentation/ci-fix.md
@@ -4,7 +4,9 @@ Here are guides to fix some of the CI failure.
 
 ## Spell check
 
-Please add your words to `./custom-words.txt` if you think you have the correct spell
+Please add your words to `./custom-words.txt` if you think you have the correct spell.
+
+If your problem is some existing error name that is not a word and need to supress the error in that file (and don't want to add to custom-words.txt), you can add it to `./cSpell.txt`.
 
 ## Prettier check
 
@@ -21,3 +23,24 @@ npm install; npm run prettier -- --write "specification/<service>/**/*.json"
 ```
 
 Then please commit and push changes made by prettier.
+
+## Model Validation
+
+Run Model Validation locally:
+```
+npm install -g oav
+oav validate-example <swagger-spec-path>
+```
+Please see [readme](https://github.com/Azure/oav/blob/master/README.md) for how to install or run tool in details.
+Or you can run it in [OpenAPI Hub](https://portal.azure-devex-tools.com/tools/static-validation/static/errors/default)
+Refer to [Semantic and Model Violations Reference](https://github.com/Azure/azure-rest-api-specs/blob/master/documentation/Semantic-and-Model-Violations-Reference.md) for detailed description of validations and how-to-fix guidance.
+
+## Semantic Validation
+Run Semantic Validation locally:
+```
+npm install -g oav
+oav validate-spec <swagger-spec-path>
+```
+Please see [readme](https://github.com/Azure/oav/blob/master/README.md) for how to install or run tool in details.
+Or you can run it in [OpenAPI Hub](https://portal.azure-devex-tools.com/tools/static-validation/static/errors/default)
+Refer to [Semantic and Model Violations Reference](https://github.com/Azure/azure-rest-api-specs/blob/master/documentation/Semantic-and-Model-Violations-Reference.md) for detailed description of validations and how-to-fix guidance.
diff --git a/documentation/openapi-authoring-automated-guidelines.md b/documentation/openapi-authoring-automated-guidelines.md
index 43e926810d8a..5427d2fc57ce 100644
--- a/documentation/openapi-authoring-automated-guidelines.md
+++ b/documentation/openapi-authoring-automated-guidelines.md
@@ -50,6 +50,9 @@ We request OpenAPI(Swagger) spec authoring be assigned to engineers who have an
 | [R3028](#r3028) | [TrackedResourceListBySubscription](#r3028) | ARM OpenAPI(swagger) specs |
 | [R3011](#r3011) | [DescriptionMustNotBeNodeName](#r3011) | ARM and Data plane OpenAPI(swagger) specs |
 | [R2020](#r2020) | [RequiredPropertiesMissingInResourceModel](#r2020) | ARM OpenAPI(swagger) specs |
+| [R3020](#r3020) | [PathResourceProviderNamePascalCase](#r3020) | ARM OpenAPI(swagger) specs |
+| [R3021](#r3021) | [PathResouceTypeNameCamelCase](#r3021) | ARM OpenAPI(swagger) specs |
+| [R4004](#r4004) | [OperationIdRequired](#r4004) | ARM OpenAPI(swagger) specs |
 
 #### ARM Warnings
 
@@ -60,12 +63,6 @@ We request OpenAPI(Swagger) spec authoring be assigned to engineers who have an
 | [R2057](#r2057) | [InvalidSkuModel](#r2057) | ARM OpenAPI(swagger) specs |
 | [R3010](#r3010) | [TrackedResourceListByImmediateParent](#r3010) | ARM OpenAPI(swagger) specs |
 | [R2004](#r2004) | [NonApplicationJsonType](#r2004) | ARM OpenAPI(swagger) specs |
-| [R4004](#r4004) | [OperationIdRequired](#r4004) | ARM OpenAPI(swagger) specs |
-| [R3020](#r3020) | [PathResourceProviderNamePascalCase](#r3020) | ARM OpenAPI(swagger) specs |
-| [R3021](#r3021) | [PathResourceTypeNameCamelCase](#r3021) | ARM OpenAPI(swagger) specs |
-| [R3015](#r3015) | [EnumMustHaveType](#r3015) | ARM OpenAPI(swagger) specs |
-| [R3024](#r3024) | [EnumUniqueValue](#r3024) | ARM OpenAPI(swagger) specs |
-| [R3029](#r3029) | [EnumMustNotHaveEmptyValue](#r3024) | ARM OpenAPI(swagger) specs |
 
 ### SDK Violations
 
@@ -96,6 +93,10 @@ We request OpenAPI(Swagger) spec authoring be assigned to engineers who have an
 | [R2009](#r2009) | [ArraySchemaMustHaveItems](#r2009) | ARM and Data plane OpenAPI(swagger) specs |
 | [R3013](#r3013) | [DeleteMustNotHaveRequestBody](#r3013) | ARM and Data plane OpenAPI(swagger) specs |
 | [R4001](#r4001) | [XmsParameterLocation](#r4001) | ARM and Data plan OpenAPI(swagger) specs |
+| [R3015](#r3015) | [EnumMustHaveType](#r3015) | ARM and Data plan OpenAPI(swagger) specs |
+| [R3024](#r3024) | [EnumUniqueValue](#r3024) | ARM and Data plan OpenAPI(swagger) specs |
+| [R3029](#r3029) | [EnumMustNotHaveEmptyValue](#r3024) | ARM and Data plan OpenAPI(swagger) specs |
+| [R4005](#r4005) | [UniqueXmsEnumName](#r4005) | ARM and Data plane OpenAPI(swagger) specs |
 
 #### SDK Warnings
 
@@ -126,6 +127,7 @@ We request OpenAPI(Swagger) spec authoring be assigned to engineers who have an
 | [R2010](#r2010) | [LongRunningOperationsOptionsValidator](#r2010) | ARM and Data plane OpenAPI(swagger) specs |
 | [R2007](#r2007) | [LongRunningOperationsWithLongRunningExtension](#r2007) | ARM OpenAPI(swagger) specs |
 | [R2029](#r2029) | [PageableOperation](#r2029) | ARM and Data plane OpenAPI(swagger) specs |
+| [R4006](#r4006) | [DeprecatedXmsCodeGenerationSetting](#r4006) | ARM and Data plane OpenAPI(swagger) specs |
   
 ### Documentation
 
@@ -1898,13 +1900,13 @@ Links: [Index](#index) | [Error vs. Warning](#error-vs-warning) | [Automated Rul
 
 ### <a name="r4004" ></a>R4004 OperationIdRequired
 
-**Category** : ARM Warning
+**Category** : ARM Error
 
 **Applies to** : ARM OpenAPI(swagger) specs
 
 **Output Message** : Missing operationId. path:'${operation path}' operation:'${operation}'.
 
-**Description** : Each operation must has a unique operationId.
+**Description** : Each operation must haave a unique operationId.
 
 **CreatedAt** : February 18, 2020
 
@@ -1914,6 +1916,8 @@ Links: [Index](#index) | [Error vs. Warning](#error-vs-warning) | [Automated Rul
 
 **How to fix the violation**: Add the right operationId for each operation
 
+Links: [Index](#index) | [Error vs. Warning](#error-vs-warning) | [Automated Rules](#automated-rules) | [ARM](#arm-violations): [Errors](#arm-errors) or [Warnings](#arm-warnings) | [SDK](#sdk-violations): [Errors](#sdk-errors) or [Warnings](#sdk-warnings)
+
 ### <a name="r3020" ></a>R3020 PathResourceProviderNamePascalCase
 
 **Category** : ARM Warning
@@ -1978,9 +1982,7 @@ Links: [Index](#index) | [Error vs. Warning](#error-vs-warning) | [Automated Rul
 
 **Output Message** : Resource type naming SHOULD follow camel case. Path: {your path}
 
-**Description** :
-
-Resource type or other identifiers (include: namespace, entityTypes) SHOULD follow camel case. (e.g. Microsoft.Insights/components/proactiveDetectionConfigs, not ProactiveDetectionConfig)
+**Description** : Resource type or other identifiers (include: namespace, entityTypes) SHOULD follow camel case. (e.g. Microsoft.Insights/components/proactiveDetectionConfigs, not ProactiveDetectionConfig)
 
 For more detail, pls refer to https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#172-casing 
 
@@ -2028,13 +2030,13 @@ Links: [Index](#index) | [Error vs. Warning](#error-vs-warning) | [Automated Rul
 
 ### <a name="r3024" ></a>R3024 EnumUniqueValue
 
-**Category** : ARM Warning
+**Category** : SDK Error
 
 **Applies to** : ARM and Data Plane OpenAPI(swagger) specs
 
-**Output Message** : Enum must not contain case-insensitive duplicated value and make sure every value in enum unique.
+**Output Message** : Enum must not contain duplicated value (case insentive).
 
-**Description** : Case-insensitive value in enum mean the same value. 
+**Description** : Enum must not contain duplicated value (case insentive).
 
 **CreatedAt**: February 18, 2020
 
@@ -2071,17 +2073,17 @@ Links: [Index](#index) | [Error vs. Warning](#error-vs-warning) | [Automated Rul
 
 ### <a name="r3015" ></a>R3015 EnumMustHaveType
 
-**Category** : ARM Warning
+**Category** : SDK Error
 
 **Applies to** : ARM and Data Plane OpenAPI(swagger) specs
 
 **Output Message** : Enum must define its type. All values in an enum must adhere to the specified type. 
 
-**Description** : Enum must define its type object or string. If not it will block SDK generation.
+**Description** : Enum must define type, and type must not be object. Or it will fail SDK auto-generation.
 
 **CreatedAt**: February 18, 2020
 
-**LastModifiedAt**: February 18, 2020
+**LastModifiedAt**: February 20, 2020
 
 **How to fix the violation**: 
 
@@ -2128,13 +2130,13 @@ Links: [Index](#index) | [Error vs. Warning](#error-vs-warning) | [Automated Rul
 
 ### <a name="r3029" ></a>R3029 EnumMustNotHaveEmptyValue
 
-**Category** : ARM Warning
+**Category** : SDK Error
 
 **Applies to** : ARM and Data Plane OpenAPI(swagger) specs
 
 **Output Message** : Enum value must not contain empty value.
 
-**Description** : Empty value is not allowed in enum value and meanless.
+**Description** : Emum must not be empty, or contain special character, like space, tab, etc. It will lead to code generation failure in downstream pipeline.
 
 **CreatedAt**: February 18, 2020
 
@@ -2234,3 +2236,83 @@ Eg:
 ```
 
 Links: [Index](#index) | [Error vs. Warning](#error-vs-warning) | [Automated Rules](#automated-rules) | [ARM](#arm-violations): [Errors](#arm-errors) or [Warnings](#arm-warnings) | [SDK](#sdk-violations): [Errors](#sdk-errors) or [Warnings](#sdk-warnings)
+
+### <a name="r4005" ></a>R4005 UniqueXmsEnumName
+
+**Category** : SDK Error
+
+**Applies to** : ARM and Data plane OpenAPI(swagger) specs
+
+**Output Message** : Must not have duplicate name in x-ms-enum extension , make sure every x-ms-enum name unique.  
+
+**Description** : Must not have duplicate name in x-ms-enum extension.
+
+**CreatedAt**: March 18, 2020
+
+**LastModifiedAt**: March 18, 2020
+
+**How to fix the violation**: Update the duplicate x-ms-enum name :
+
+The following would be invalid:
+```json
+    "State": {
+        "description": "The state of the configuration store.",
+        "enum": [
+            "Failed",
+            "Canceled"
+        ],
+        "type": "string",
+        "readOnly": true,
+        "x-ms-enum": {
+            "name": "DuplicateName",
+            "modelAsString": true
+        }
+    },
+    "status": {
+        "description": "The state code.",
+        "enum": [
+            "Success",
+            "FAILED"
+        ],
+        "readOnly": true,
+        "type": "string",
+        "x-ms-enum": {
+            "name": "DuplicateName",
+            "modelAsString": true
+        }
+    }
+}
+```
+
+Links: [Index](#index) | [Error vs. Warning](#error-vs-warning) | [Automated Rules](#automated-rules) | [ARM](#arm-violations): [Errors](#arm-errors) or [Warnings](#arm-warnings) | [SDK](#sdk-violations): [Errors](#sdk-errors) or [Warnings](#sdk-warnings)
+
+### <a name="r4006" ></a>R4006 DeprecatedXmsCodeGenerationSetting
+
+**Category** : SDK Warning
+
+**Applies to** : ARM and Data plane OpenAPI(swagger) specs
+
+**Output Message** : The x-ms-code-generation-setting extension is being deprecated. Please remove it and move settings to readme file for code generation.
+
+**Description** : The x-ms-code-generation-settings is being deprecated. AutoRest (v3) is using settings in readme file for code generation and will stop supporting it inside the swagger file. Please ensure to remove the parameter from swagger spec and move settings to readme.
+
+**CreatedAt**: March 18, 2020
+
+**LastModifiedAt**: March 18, 2020
+
+**How to fix the violation**: Since the only value of this extension today is to override the client name, which could be done with a 'title' line in the readme file,you could remove the extension from swagger spec and move settings to readme.
+
+The following would be invalid:
+
+```json
+ "info": {
+    "version": "2016-05-16",
+    "x-ms-code-generation-settings": {
+      "name": "AnalysisServicesManagementClient"
+    }
+  }
+```
+
+Links: [Index](#index) | [Error vs. Warning](#error-vs-warning) | [Automated Rules](#automated-rules) | [ARM](#arm-violations): [Errors](#arm-errors) or [Warnings](#arm-warnings) | [SDK](#sdk-violations): [Errors](#sdk-errors) or [Warnings](#sdk-warnings)
+
+
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimanagement.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimanagement.json
new file mode 100644
index 000000000000..c7000c981ff8
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimanagement.json
@@ -0,0 +1,718 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on entities like API, Product, and Subscription associated with your Azure API Management deployment.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {},
+  "definitions": {
+    "ErrorFieldContract": {
+      "properties": {
+        "code": {
+          "type": "string",
+          "description": "Property level error code."
+        },
+        "message": {
+          "type": "string",
+          "description": "Human-readable representation of property-level error."
+        },
+        "target": {
+          "type": "string",
+          "description": "Property name."
+        }
+      },
+      "description": "Error Field contract."
+    },
+    "ErrorResponse": {
+      "properties": {
+        "error": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ErrorResponseBody",
+          "description": "Properties of the Error Response."
+        }
+      },
+      "description": "Error Response."
+    },
+    "ErrorResponseBody": {
+      "properties": {
+        "code": {
+          "type": "string",
+          "description": "Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response."
+        },
+        "message": {
+          "type": "string",
+          "description": "Human-readable representation of the error."
+        },
+        "details": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ErrorFieldContract"
+          },
+          "description": "The list of invalid fields send in request, in case of validation error."
+        }
+      },
+      "description": "Error Body contract."
+    },
+    "RegionContract": {
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Region name.",
+          "readOnly": true
+        },
+        "isMasterRegion": {
+          "description": "whether Region is the master region.",
+          "type": "boolean"
+        },
+        "isDeleted": {
+          "description": "whether Region is deleted.",
+          "type": "boolean"
+        }
+      },
+      "description": "Region profile."
+    },
+    "RegionListResult": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/RegionContract"
+          },
+          "description": "Lists of Regions."
+        },
+        "count": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total record count number across all pages."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Lists Regions operation response details."
+    },
+    "Resource": {
+      "description": "The Resource definition.",
+      "x-ms-azure-resource": true,
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Resource ID."
+        },
+        "name": {
+          "type": "string",
+          "description": "Resource name.",
+          "readOnly": true
+        },
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Resource type for API Management resource."
+        }
+      }
+    }
+  },
+  "parameters": {
+    "AccessParameter": {
+      "name": "accessName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "enum": [
+        "access"
+      ],
+      "x-ms-enum": {
+        "modelAsString": true,
+        "name": "AccessIdName"
+      },
+      "description": "The identifier of the Access configuration.",
+      "x-ms-parameter-location": "method"
+    },
+    "ApiIdParameter": {
+      "name": "apiId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "API identifier. Must be unique in the current API Management service instance.",
+      "minLength": 1,
+      "maxLength": 80,
+      "x-ms-parameter-location": "method"
+    },
+    "ApiIdRevParameter": {
+      "name": "apiId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number.",
+      "minLength": 1,
+      "maxLength": 256,
+      "pattern": "^[^*#&+:<>?]+$",
+      "x-ms-parameter-location": "method"
+    },
+    "ApiVersionParameter": {
+      "name": "api-version",
+      "in": "query",
+      "required": true,
+      "type": "string",
+      "description": "Version of the API to be used with the client request."
+    },
+    "ApiVersionSetIdParameter": {
+      "name": "versionSetId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Api Version Set identifier. Must be unique in the current API Management service instance.",
+      "minLength": 1,
+      "maxLength": 80,
+      "pattern": "^[^*#&+:<>?]+$",
+      "x-ms-parameter-location": "method"
+    },
+    "AttachmentIdParameter": {
+      "name": "attachmentId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Attachment identifier within an Issue. Must be unique in the current Issue.",
+      "minLength": 1,
+      "maxLength": 256,
+      "pattern": "^[^*#&+:<>?]+$",
+      "x-ms-parameter-location": "method"
+    },
+    "AuthenticationServerIdParameter": {
+      "name": "authsid",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Identifier of the authorization server.",
+      "minLength": 1,
+      "maxLength": 80,
+      "pattern": "^[^*#&+:<>?]+$",
+      "x-ms-parameter-location": "method"
+    },
+    "BackendIdParameter": {
+      "name": "backendId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Identifier of the Backend entity. Must be unique in the current API Management service instance.",
+      "minLength": 1,
+      "maxLength": 80,
+      "x-ms-parameter-location": "method"
+    },
+    "CacheIdParameter": {
+      "name": "cacheId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Identifier of the Cache entity. Cache identifier (should be either 'default' or valid Azure region identifier).",
+      "minLength": 1,
+      "maxLength": 80,
+      "pattern": "^[^*#&+:<>?]+$",
+      "x-ms-parameter-location": "method"
+    },
+    "CertificateIdParameter": {
+      "name": "certificateId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Identifier of the certificate entity. Must be unique in the current API Management service instance.",
+      "minLength": 1,
+      "maxLength": 80,
+      "pattern": "^[^*#&+:<>?]+$",
+      "x-ms-parameter-location": "method"
+    },
+    "CommentIdParameter": {
+      "name": "commentId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Comment identifier within an Issue. Must be unique in the current Issue.",
+      "minLength": 1,
+      "maxLength": 256,
+      "pattern": "^[^*#&+:<>?]+$",
+      "x-ms-parameter-location": "method"
+    },
+    "ConfigurationParameter": {
+      "name": "configurationName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "enum": [
+        "configuration"
+      ],
+      "x-ms-enum": {
+        "modelAsString": true,
+        "name": "configurationIdName"
+      },
+      "description": "The identifier of the Git Configuration Operation.",
+      "x-ms-parameter-location": "method"
+    },
+    "DiagnosticIdParameter": {
+      "name": "diagnosticId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Diagnostic identifier. Must be unique in the current API Management service instance.",
+      "minLength": 1,
+      "maxLength": 80,
+      "pattern": "^[^*#&+:<>?]+$",
+      "x-ms-parameter-location": "method"
+    },
+    "EmailParameter": {
+      "name": "email",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Email identifier.",
+      "x-ms-parameter-location": "method"
+    },
+    "GroupIdParameter": {
+      "name": "groupId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Group identifier. Must be unique in the current API Management service instance.",
+      "minLength": 1,
+      "maxLength": 256,
+      "x-ms-parameter-location": "method"
+    },
+    "IdentityProviderNameParameter": {
+      "name": "identityProviderName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "enum": [
+        "facebook",
+        "google",
+        "microsoft",
+        "twitter",
+        "aad",
+        "aadB2C"
+      ],
+      "x-ms-enum": {
+        "name": "IdentityProviderType",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "facebook",
+            "description": "Facebook as Identity provider."
+          },
+          {
+            "value": "google",
+            "description": "Google as Identity provider."
+          },
+          {
+            "value": "microsoft",
+            "description": "Microsoft Live as Identity provider."
+          },
+          {
+            "value": "twitter",
+            "description": "Twitter as Identity provider."
+          },
+          {
+            "value": "aad",
+            "description": "Azure Active Directory as Identity provider."
+          },
+          {
+            "value": "aadB2C",
+            "description": "Azure Active Directory B2C as Identity provider."
+          }
+        ]
+      },
+      "description": "Identity Provider Type identifier.",
+      "x-ms-parameter-location": "method"
+    },
+    "IfMatchOptionalParameter": {
+      "name": "If-Match",
+      "in": "header",
+      "required": false,
+      "description": "ETag of the Entity. Not required when creating an entity, but required when updating an entity.",
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "IfMatchRequiredParameter": {
+      "name": "If-Match",
+      "in": "header",
+      "required": true,
+      "description": "ETag of the Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update.",
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "IssueIdParameter": {
+      "name": "issueId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Issue identifier. Must be unique in the current API Management service instance.",
+      "minLength": 1,
+      "maxLength": 256,
+      "pattern": "^[^*#&+:<>?]+$",
+      "x-ms-parameter-location": "method"
+    },
+    "LocationNameParameter": {
+      "name": "locationName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Location in which the API Management service is deployed. This is one of the Azure Regions like West US, East US, South Central US.",
+      "minLength": 1,
+      "x-ms-parameter-location": "method"
+    },
+    "LoggerIdParameter": {
+      "name": "loggerId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "maxLength": 256,
+      "pattern": "^[^*#&+:<>?]+$",
+      "description": "Logger identifier. Must be unique in the API Management service instance.",
+      "x-ms-parameter-location": "method"
+    },
+    "NotificationNameParameter": {
+      "name": "notificationName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "enum": [
+        "RequestPublisherNotificationMessage",
+        "PurchasePublisherNotificationMessage",
+        "NewApplicationNotificationMessage",
+        "BCC",
+        "NewIssuePublisherNotificationMessage",
+        "AccountClosedPublisher",
+        "QuotaLimitApproachingPublisherNotificationMessage"
+      ],
+      "x-ms-enum": {
+        "name": "NotificationName",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "RequestPublisherNotificationMessage",
+            "description": "The following email recipients and users will receive email notifications about subscription requests for API products requiring approval."
+          },
+          {
+            "value": "PurchasePublisherNotificationMessage",
+            "description": "The following email recipients and users will receive email notifications about new API product subscriptions."
+          },
+          {
+            "value": "NewApplicationNotificationMessage",
+            "description": "The following email recipients and users will receive email notifications when new applications are submitted to the application gallery."
+          },
+          {
+            "value": "BCC",
+            "description": "The following recipients will receive blind carbon copies of all emails sent to developers."
+          },
+          {
+            "value": "NewIssuePublisherNotificationMessage",
+            "description": "The following email recipients and users will receive email notifications when a new issue or comment is submitted on the developer portal."
+          },
+          {
+            "value": "AccountClosedPublisher",
+            "description": "The following email recipients and users will receive email notifications when developer closes his account."
+          },
+          {
+            "value": "QuotaLimitApproachingPublisherNotificationMessage",
+            "description": "The following email recipients and users will receive email notifications when subscription usage gets close to usage quota."
+          }
+        ]
+      },
+      "description": "Notification Name Identifier.",
+      "x-ms-parameter-location": "method"
+    },
+    "NotifySubscriptionStateChangeParameter": {
+      "name": "notify",
+      "in": "query",
+      "required": false,
+      "type": "boolean",
+      "description": "Notify change in Subscription State. \n - If false, do not send any email notification for change of state of subscription \n - If true, send email notification of change of state of subscription ",
+      "x-ms-parameter-location": "method"
+    },
+    "OpenIdConnectIdParameter": {
+      "name": "opid",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Identifier of the OpenID Connect Provider.",
+      "maxLength": 256,
+      "pattern": "^[^*#&+:<>?]+$",
+      "x-ms-parameter-location": "method"
+    },
+    "OperationIdParameter": {
+      "name": "operationId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Operation identifier within an API. Must be unique in the current API Management service instance.",
+      "minLength": 1,
+      "maxLength": 80,
+      "x-ms-parameter-location": "method"
+    },
+    "PolicyExportFormat": {
+      "name": "format",
+      "in": "query",
+      "required": false,
+      "type": "string",
+      "description": "Policy Export Format.",
+      "enum": [
+        "xml",
+        "rawxml"
+      ],
+      "x-ms-enum": {
+        "name": "PolicyExportFormat",
+        "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 document."
+          }
+        ]
+      },
+      "default": "xml",
+      "x-ms-parameter-location": "method"
+    },
+    "PolicyIdParameter": {
+      "name": "policyId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "enum": [
+        "policy"
+      ],
+      "description": "The identifier of the Policy.",
+      "x-ms-enum": {
+        "modelAsString": true,
+        "name": "PolicyIdName"
+      },
+      "x-ms-parameter-location": "method"
+    },
+    "ProductIdParameter": {
+      "name": "productId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Product identifier. Must be unique in the current API Management service instance.",
+      "minLength": 1,
+      "maxLength": 256,
+      "x-ms-parameter-location": "method"
+    },
+    "NamedValueIdParameter": {
+      "name": "namedValueId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Identifier of the NamedValue.",
+      "maxLength": 256,
+      "pattern": "^[^*#&+:<>?]+$",
+      "x-ms-parameter-location": "method"
+    },
+    "QuotaCounterKeyParameter": {
+      "name": "quotaCounterKey",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Quota counter key identifier.This is the result of expression defined in counter-key attribute of the quota-by-key policy.For Example, if you specify counter-key=\"boo\" in the policy, then it’s accessible by \"boo\" counter key. But if it’s defined as counter-key=\"@(\"b\"+\"a\")\" then it will be accessible by \"ba\" key",
+      "x-ms-parameter-location": "method"
+    },
+    "QuotaPeriodKeyParameter": {
+      "name": "quotaPeriodKey",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Quota period key identifier.",
+      "x-ms-parameter-location": "method"
+    },
+    "ReleaseIdParameter": {
+      "name": "releaseId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Release identifier within an API. Must be unique in the current API Management service instance.",
+      "minLength": 1,
+      "maxLength": 80,
+      "pattern": "^[^*#&+:<>?]+$",
+      "x-ms-parameter-location": "method"
+    },
+    "ResourceGroupNameParameter": {
+      "name": "resourceGroupName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The name of the resource group.",
+      "x-ms-parameter-location": "method"
+    },
+    "SchemaIdParameter": {
+      "name": "schemaId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Schema identifier within an API. Must be unique in the current API Management service instance.",
+      "minLength": 1,
+      "maxLength": 80,
+      "pattern": "^[^*#&+:<>?]+$",
+      "x-ms-parameter-location": "method"
+    },
+    "ServiceNameParameter": {
+      "name": "serviceName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The name of the API Management service.",
+      "minLength": 1,
+      "maxLength": 50,
+      "pattern": "^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$",
+      "x-ms-parameter-location": "method"
+    },
+    "SkipQueryParameter": {
+      "name": "$skip",
+      "in": "query",
+      "required": false,
+      "type": "integer",
+      "format": "int32",
+      "description": "Number of records to skip.",
+      "minimum": 0,
+      "x-ms-parameter-location": "method"
+    },
+    "SubscriptionEntityIdParameter": {
+      "name": "sid",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Subscription entity Identifier. The entity represents the association between a user and a product in API Management.",
+      "maxLength": 256,
+      "pattern": "^[^*#&+:<>?]+$",
+      "x-ms-parameter-location": "method"
+    },
+    "SubscriptionIdParameter": {
+      "name": "subscriptionId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
+    },
+    "TagIdParameter": {
+      "name": "tagId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Tag identifier. Must be unique in the current API Management service instance.",
+      "minLength": 1,
+      "maxLength": 80,
+      "pattern": "^[^*#&+:<>?]+$",
+      "x-ms-parameter-location": "method"
+    },
+    "TagDescriptionIdParameter": {
+      "name": "tagDescriptionId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Tag description identifier. Used when creating tagDescription for API/Tag association. Based on API and Tag names.",
+      "minLength": 1,
+      "maxLength": 80,
+      "pattern": "^[^*#&+:<>?]+$",
+      "x-ms-parameter-location": "method"
+    },
+    "TemplateNameParameter": {
+      "name": "templateName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "enum": [
+        "applicationApprovedNotificationMessage",
+        "accountClosedDeveloper",
+        "quotaLimitApproachingDeveloperNotificationMessage",
+        "newDeveloperNotificationMessage",
+        "emailChangeIdentityDefault",
+        "inviteUserNotificationMessage",
+        "newCommentNotificationMessage",
+        "confirmSignUpIdentityDefault",
+        "newIssueNotificationMessage",
+        "purchaseDeveloperNotificationMessage",
+        "passwordResetIdentityDefault",
+        "passwordResetByAdminNotificationMessage",
+        "rejectDeveloperNotificationMessage",
+        "requestDeveloperNotificationMessage"
+      ],
+      "x-ms-enum": {
+        "name": "TemplateName",
+        "modelAsString": true
+      },
+      "description": "Email Template Name Identifier.",
+      "x-ms-parameter-location": "method"
+    },
+    "TopQueryParameter": {
+      "name": "$top",
+      "in": "query",
+      "required": false,
+      "type": "integer",
+      "format": "int32",
+      "description": "Number of records to return.",
+      "minimum": 1,
+      "x-ms-parameter-location": "method"
+    },
+    "UserIdParameter": {
+      "name": "userId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "User identifier. Must be unique in the current API Management service instance.",
+      "minLength": 1,
+      "maxLength": 80,
+      "x-ms-parameter-location": "method"
+    },
+    "GatewayIdParameter": {
+      "name": "gatewayId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Gateway entity identifier. Must be unique in the current API Management service instance. Must not have value 'managed'",
+      "minLength": 1,
+      "maxLength": 80,
+      "x-ms-parameter-location": "method"
+    },
+    "GatewayHostnameConfigurationIdParameter": {
+      "name": "hcId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Gateway hostname configuration identifier. Must be unique in the scope of parent Gateway entity.",
+      "minLength": 1,
+      "maxLength": 80,
+      "x-ms-parameter-location": "method"
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimapis.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimapis.json
new file mode 100644
index 000000000000..9a765712e354
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimapis.json
@@ -0,0 +1,4470 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on API entity and their Operations associated with your Azure API Management deployment.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis": {
+      "get": {
+        "tags": [
+          "Api"
+        ],
+        "operationId": "Api_ListByService",
+        "description": "Lists all APIs of the API Management service instance.",
+        "externalDocs": {
+          "url": "https://docs.microsoft.com/en-us/azure/api-management/api-management-howto-create-apis"
+        },
+        "x-ms-examples": {
+          "ApiManagementListApis": {
+            "$ref": "./examples/ApiManagementListApis.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| description | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| serviceUrl | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| path | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "name": "tags",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "Include tags in the response."
+          },
+          {
+            "name": "expandApiVersionSet",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "description": "Include full ApiVersionSet resource in response"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Paged Result response of Apis.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/ApiContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}": {
+      "head": {
+        "tags": [
+          "Api"
+        ],
+        "operationId": "Api_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the API specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadApi": {
+            "$ref": "./examples/ApiManagementHeadApi.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified API entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "Api"
+        ],
+        "operationId": "Api_Get",
+        "description": "Gets the details of the API specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetApiContract": {
+            "$ref": "./examples/ApiManagementGetApiContract.json"
+          },
+          "ApiManagementGetApiRevisionContract": {
+            "$ref": "./examples/ApiManagementGetApiRevision.json"
+          }
+        },
+        "produces": [
+          "application/json",
+          "application/vnd.sun.wadl+xml",
+          "application/vnd.swagger.doc+json",
+          "application/wsdl+xml",
+          "application/vnd.oai.openapi",
+          "application/vnd.oai.openapi+json"
+        ],
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified API entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Api"
+        ],
+        "operationId": "Api_CreateOrUpdate",
+        "description": "Creates new or updates existing specified API of the API Management service instance.",
+        "x-ms-examples": {
+          "ApiManagementCreateApiUsingOai3Import": {
+            "$ref": "./examples/ApiManagementCreateApiUsingOai3Import.json"
+          },
+          "ApiManagementCreateApiUsingSwaggerImport": {
+            "$ref": "./examples/ApiManagementCreateApiUsingSwaggerImport.json"
+          },
+          "ApiManagementCreateApiUsingWadlImport": {
+            "$ref": "./examples/ApiManagementCreateApiUsingWadlImport.json"
+          },
+          "ApiManagementCreateSoapToRestApiUsingWsdlImport": {
+            "$ref": "./examples/ApiManagementCreateSoapToRestApiUsingWsdlImport.json"
+          },
+          "ApiManagementCreateSoapPassThroughApiUsingWsdlImport": {
+            "$ref": "./examples/ApiManagementCreateSoapPassThroughApiUsingWsdlImport.json"
+          },
+          "ApiManagementCreateApi": {
+            "$ref": "./examples/ApiManagementCreateApi.json"
+          },
+          "ApiManagementCreateApiRevisionFromExistingApi": {
+            "$ref": "./examples/ApiManagementCreateApiRevisionFromExistingApi.json"
+          },
+          "ApiManagementCreateApiNewVersionUsingExistingApi": {
+            "$ref": "./examples/ApiManagementCreateApiNewVersionUsingExistingApi.json"
+          },
+          "ApiManagementCreateApiClone": {
+            "$ref": "./examples/ApiManagementCreateApiClone.json"
+          },
+          "ApiManagementCreateApiWithOpenIdConnect": {
+            "$ref": "./examples/ApiManagementCreateApiWithOpenIdConnect.json"
+          },
+          "ApiManagementCreateApiUsingImportOverrideServiceUrl": {
+            "$ref": "./examples/ApiManagementCreateApiUsingImportOverrideServiceUrl.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiCreateOrUpdateParameter"
+            },
+            "description": "Create or update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "API was successfully created.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "202": {
+            "description": "Request to create or update API was accepted. Location header contains the URL where the status of the long running operation can be checked."
+          },
+          "200": {
+            "description": "API was successfully updated.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "location"
+        }
+      },
+      "patch": {
+        "tags": [
+          "Api"
+        ],
+        "operationId": "Api_Update",
+        "description": "Updates the specified API of the API Management service instance.",
+        "x-ms-examples": {
+          "ApiManagementUpdateApi": {
+            "$ref": "./examples/ApiManagementUpdateApi.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiUpdateContract"
+            },
+            "description": "API Update Contract parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The API was successfully updated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Api"
+        ],
+        "operationId": "Api_Delete",
+        "description": "Deletes the specified API of the API Management service instance.",
+        "x-ms-examples": {
+          "ApiManagementDeleteApi": {
+            "$ref": "./examples/ApiManagementDeleteApi.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "name": "deleteRevisions",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "description": "Delete all revisions of the Api."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The API was successfully deleted."
+          },
+          "204": {
+            "description": "The API was successfully deleted."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/revisions": {
+      "get": {
+        "tags": [
+          "ApiRevision"
+        ],
+        "operationId": "ApiRevision_ListByService",
+        "description": "Lists all revisions of an API.",
+        "x-ms-examples": {
+          "ApiManagementListApiRevisions": {
+            "$ref": "./examples/ApiManagementListApiRevisions.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| apiRevision | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation returns a list of revision details.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiRevisionCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/ApiRevisionContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/releases": {
+      "get": {
+        "tags": [
+          "ApiRelease"
+        ],
+        "operationId": "ApiRelease_ListByService",
+        "description": "Lists all releases of an API. An API release is created when making an API Revision current. Releases are also used to rollback to previous revisions. Results will be paged and can be constrained by the $top and $skip parameters.",
+        "x-ms-examples": {
+          "ApiManagementListApiReleases": {
+            "$ref": "./examples/ApiManagementListApiReleases.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| notes | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation returns a list of API Releases.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiReleaseCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/ApiReleaseContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/releases/{releaseId}": {
+      "head": {
+        "tags": [
+          "ApiRelease"
+        ],
+        "operationId": "ApiRelease_GetEntityTag",
+        "description": "Returns the etag of an API release.",
+        "x-ms-examples": {
+          "ApiManagementHeadApiRelease": {
+            "$ref": "./examples/ApiManagementHeadApiRelease.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ReleaseIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Gets the entity state (Etag) version of the api release as specified by its identifier.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "ApiRelease"
+        ],
+        "operationId": "ApiRelease_Get",
+        "description": "Returns the details of an API release.",
+        "x-ms-examples": {
+          "ApiManagementGetApiRelease": {
+            "$ref": "./examples/ApiManagementGetApiRelease.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ReleaseIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation returns the details of an API Release.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiReleaseContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "ApiRelease"
+        ],
+        "operationId": "ApiRelease_CreateOrUpdate",
+        "description": "Creates a new Release for the API.",
+        "x-ms-examples": {
+          "ApiManagementCreateApiRelease": {
+            "$ref": "./examples/ApiManagementCreateApiRelease.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ReleaseIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiReleaseContract"
+            },
+            "description": "Create parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Release was successfully created.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiReleaseContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "200": {
+            "description": "Release was successfully updated.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiReleaseContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "ApiRelease"
+        ],
+        "operationId": "ApiRelease_Update",
+        "description": "Updates the details of the release of the API specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementUpdateApiRelease": {
+            "$ref": "./examples/ApiManagementUpdateApiRelease.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ReleaseIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiReleaseContract"
+            },
+            "description": "API Release Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Release successfully updated"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ApiRelease"
+        ],
+        "operationId": "ApiRelease_Delete",
+        "description": "Deletes the specified release in the API.",
+        "x-ms-examples": {
+          "ApiManagementDeleteApiRelease": {
+            "$ref": "./examples/ApiManagementDeleteApiRelease.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ReleaseIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "API release successfully removed"
+          },
+          "204": {
+            "description": "API release successfully removed by previous request or does not exist"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations": {
+      "get": {
+        "tags": [
+          "ApiOperation"
+        ],
+        "operationId": "ApiOperation_ListByApi",
+        "description": "Lists a collection of the operations for the specified API.",
+        "x-ms-examples": {
+          "ApiManagementListApiOperations": {
+            "$ref": "./examples/ApiManagementListApiOperations.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| method | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| description | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| urlTemplate | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "name": "tags",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "Include tags in the response."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A collection of operation summary entities at the API level.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/OperationCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/OperationContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}": {
+      "head": {
+        "tags": [
+          "ApiOperation"
+        ],
+        "operationId": "ApiOperation_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the API operation specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadApiOperation": {
+            "$ref": "./examples/ApiManagementHeadApiOperation.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/OperationIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified API operation entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "ApiOperation"
+        ],
+        "operationId": "ApiOperation_Get",
+        "description": "Gets the details of the API Operation specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetApiOperation": {
+            "$ref": "./examples/ApiManagementGetApiOperation.json"
+          },
+          "ApiManagementGetApiOperationPetStore": {
+            "$ref": "./examples/ApiManagementGetApiOperationPetStore.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/OperationIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified Operation entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/OperationContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "ApiOperation"
+        ],
+        "operationId": "ApiOperation_CreateOrUpdate",
+        "description": "Creates a new operation in the API or updates an existing one.",
+        "x-ms-examples": {
+          "ApiManagementCreateApiOperation": {
+            "$ref": "./examples/ApiManagementCreateApiOperation.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/OperationIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/OperationContract"
+            },
+            "description": "Create parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Operation was successfully created.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/OperationContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "200": {
+            "description": "Operation was successfully updated.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/OperationContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "ApiOperation"
+        ],
+        "operationId": "ApiOperation_Update",
+        "description": "Updates the details of the operation in the API specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementUpdateApiOperation": {
+            "$ref": "./examples/ApiManagementUpdateApiOperation.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/OperationIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/OperationUpdateContract"
+            },
+            "description": "API Operation Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The operation was successfully updated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ApiOperation"
+        ],
+        "operationId": "ApiOperation_Delete",
+        "description": "Deletes the specified operation in the API.",
+        "x-ms-examples": {
+          "ApiManagementDeleteApiOperation": {
+            "$ref": "./examples/ApiManagementDeleteApiOperation.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/OperationIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "API operation successfully removed"
+          },
+          "204": {
+            "description": "API operation successfully removed by previous request or does not exist"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/policies": {
+      "get": {
+        "tags": [
+          "ApiOperationPolicy"
+        ],
+        "operationId": "ApiOperationPolicy_ListByOperation",
+        "description": "Get the list of policy configuration at the API Operation level.",
+        "x-ms-examples": {
+          "ApiManagementListApiOperationPolicies": {
+            "$ref": "./examples/ApiManagementListApiOperationPolicies.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/OperationIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Api Operations Policy Collection.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PolicyCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/policies/{policyId}": {
+      "head": {
+        "tags": [
+          "ApiOperationPolicy"
+        ],
+        "operationId": "ApiOperationPolicy_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the API operation policy specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadApiOperationPolicy": {
+            "$ref": "./examples/ApiManagementHeadApiOperationPolicy.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/OperationIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/PolicyIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified API operation policy entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "ApiOperationPolicy"
+        ],
+        "operationId": "ApiOperationPolicy_Get",
+        "description": "Get the policy configuration at the API Operation level.",
+        "x-ms-examples": {
+          "ApiManagementGetApiOperationPolicy": {
+            "$ref": "./examples/ApiManagementGetApiOperationPolicy.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/OperationIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/PolicyExportFormat"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/PolicyIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Api Operation Policy information.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PolicyContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "ApiOperationPolicy"
+        ],
+        "operationId": "ApiOperationPolicy_CreateOrUpdate",
+        "description": "Creates or updates policy configuration for the API Operation level.",
+        "x-ms-examples": {
+          "ApiManagementCreateApiOperationPolicy": {
+            "$ref": "./examples/ApiManagementCreateApiOperationPolicy.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/OperationIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/PolicyIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PolicyContract"
+            },
+            "description": "The policy contents to apply."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Api Operation policy configuration was successfully created.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PolicyContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "200": {
+            "description": "Api Operation policy configuration of the tenant was successfully updated.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PolicyContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ApiOperationPolicy"
+        ],
+        "operationId": "ApiOperationPolicy_Delete",
+        "description": "Deletes the policy configuration at the Api Operation.",
+        "x-ms-examples": {
+          "ApiManagementDeleteApiOperationPolicy": {
+            "$ref": "./examples/ApiManagementDeleteApiOperationPolicy.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/OperationIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/PolicyIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Policy successfully removed"
+          },
+          "204": {
+            "description": "Policy successfully removed by previous request or does not exist"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/tags": {
+      "get": {
+        "tags": [
+          "ApiOperationTag"
+        ],
+        "operationId": "Tag_ListByOperation",
+        "description": "Lists all Tags associated with the Operation.",
+        "x-ms-examples": {
+          "ApiManagementListApiOperationTags": {
+            "$ref": "./examples/ApiManagementListApiOperationTags.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/OperationIdParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation returns a collection of tags associated with the Operation entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/TagContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/tags/{tagId}": {
+      "head": {
+        "tags": [
+          "ApiOperationTag"
+        ],
+        "operationId": "Tag_GetEntityStateByOperation",
+        "description": "Gets the entity state version of the tag specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadApiOperationTag": {
+            "$ref": "./examples/ApiManagementHeadApiOperationTag.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/OperationIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TagIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Empty response body, ETag header entity state version.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "ApiOperationTag"
+        ],
+        "operationId": "Tag_GetByOperation",
+        "description": "Get tag associated with the Operation.",
+        "x-ms-examples": {
+          "ApiManagementGetApiOperationTag": {
+            "$ref": "./examples/ApiManagementGetApiOperationTag.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/OperationIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TagIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Gets the details of the tag specified by its identifier.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "ApiOperationTag"
+        ],
+        "operationId": "Tag_AssignToOperation",
+        "description": "Assign tag to the Operation.",
+        "x-ms-examples": {
+          "ApiManagementCreateApiOperationTag": {
+            "$ref": "./examples/ApiManagementCreateApiOperationTag.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/OperationIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TagIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Tag was assigned to the Operation.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagContract"
+            }
+          },
+          "200": {
+            "description": "Tag is already assigned to the Operation.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ApiOperationTag"
+        ],
+        "operationId": "Tag_DetachFromOperation",
+        "description": "Detach the tag from the Operation.",
+        "x-ms-examples": {
+          "ApiManagementDeleteApiOperationTag": {
+            "$ref": "./examples/ApiManagementDeleteApiOperationTag.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/OperationIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TagIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Tag was successfully removed from Operation"
+          },
+          "204": {
+            "description": "Tag successfully removed by previous request or does not exist in Operation"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/products": {
+      "get": {
+        "tags": [
+          "ApiProduct"
+        ],
+        "operationId": "ApiProduct_ListByApis",
+        "description": "Lists all Products, which the API is part of.",
+        "x-ms-examples": {
+          "ApiManagementListApiProducts": {
+            "$ref": "./examples/ApiManagementListApiProducts.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation returns a collection of products which have the Api entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ProductCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/ProductContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/policies": {
+      "get": {
+        "tags": [
+          "ApiPolicy"
+        ],
+        "operationId": "ApiPolicy_ListByApi",
+        "description": "Get the policy configuration at the API level.",
+        "x-ms-examples": {
+          "ApiManagementListApiPolicies": {
+            "$ref": "./examples/ApiManagementListApiPolicies.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Apis Policy Collection.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PolicyCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/policies/{policyId}": {
+      "head": {
+        "tags": [
+          "ApiPolicy"
+        ],
+        "operationId": "ApiPolicy_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the API policy specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadApiPolicy": {
+            "$ref": "./examples/ApiManagementHeadApiPolicy.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/PolicyIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified API Policy entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "ApiPolicy"
+        ],
+        "operationId": "ApiPolicy_Get",
+        "description": "Get the policy configuration at the API level.",
+        "x-ms-examples": {
+          "ApiManagementGetApiPolicy": {
+            "$ref": "./examples/ApiManagementGetApiPolicy.json"
+          }
+        },
+        "produces": [
+          "application/json",
+          "application/vnd.ms-azure-apim.policy+xml",
+          "application/vnd.ms-azure-apim.policy.raw+xml"
+        ],
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/PolicyIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/PolicyExportFormat"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Api Policy information.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PolicyContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "ApiPolicy"
+        ],
+        "operationId": "ApiPolicy_CreateOrUpdate",
+        "description": "Creates or updates policy configuration for the API.",
+        "x-ms-examples": {
+          "ApiManagementCreateApiPolicy": {
+            "$ref": "./examples/ApiManagementCreateApiPolicy.json"
+          },
+          "ApiManagementCreateApiPolicyNonXmlEncoded": {
+            "$ref": "./examples/ApiManagementCreateApiPolicyNonXmlEncoded.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/PolicyIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PolicyContract"
+            },
+            "description": "The policy contents to apply."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Api policy configuration was successfully created.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PolicyContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "200": {
+            "description": "Api policy configuration of the tenant was successfully updated.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PolicyContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ApiPolicy"
+        ],
+        "operationId": "ApiPolicy_Delete",
+        "description": "Deletes the policy configuration at the Api.",
+        "x-ms-examples": {
+          "ApiManagementDeleteApiPolicy": {
+            "$ref": "./examples/ApiManagementDeleteApiPolicy.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/PolicyIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successfully deleted the policy configuration at the API level."
+          },
+          "204": {
+            "description": "Successfully deleted the policy configuration at the API level."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/schemas": {
+      "get": {
+        "tags": [
+          "ApiSchema"
+        ],
+        "operationId": "ApiSchema_ListByApi",
+        "description": "Get the schema configuration at the API level.",
+        "x-ms-examples": {
+          "ApiManagementListApiSchemas": {
+            "$ref": "./examples/ApiManagementListApiSchemas.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| contentType | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Apis Schema Collection.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/SchemaCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/schemas/{schemaId}": {
+      "head": {
+        "tags": [
+          "ApiSchema"
+        ],
+        "operationId": "ApiSchema_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the schema specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadApiSchema": {
+            "$ref": "./examples/ApiManagementHeadApiSchema.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SchemaIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified schema entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "ApiSchema"
+        ],
+        "operationId": "ApiSchema_Get",
+        "description": "Get the schema configuration at the API level.",
+        "x-ms-examples": {
+          "ApiManagementGetApiSchema": {
+            "$ref": "./examples/ApiManagementGetApiSchema.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SchemaIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Api Schema information.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/SchemaContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "ApiSchema"
+        ],
+        "operationId": "ApiSchema_CreateOrUpdate",
+        "description": "Creates or updates schema configuration for the API.",
+        "x-ms-examples": {
+          "ApiManagementCreateApiSchema": {
+            "$ref": "./examples/ApiManagementCreateApiSchema.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SchemaIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/SchemaContract"
+            },
+            "description": "The schema contents to apply."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Request to create or update Api schema configuration was accepted. Location header contains the URL where the status of the long running operation can be checked."
+          },
+          "201": {
+            "description": "Api schema configuration was successfully created.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/SchemaContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "200": {
+            "description": "Api schema configuration of the tenant was successfully updated.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/SchemaContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "location"
+        }
+      },
+      "delete": {
+        "tags": [
+          "ApiSchema"
+        ],
+        "operationId": "ApiSchema_Delete",
+        "description": "Deletes the schema configuration at the Api.",
+        "x-ms-examples": {
+          "ApiManagementDeleteApiSchema": {
+            "$ref": "./examples/ApiManagementDeleteApiSchema.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SchemaIdParameter"
+          },
+          {
+            "name": "force",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "description": "If true removes all references to the schema before deleting it."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successfully deleted the schema configuration at the API level."
+          },
+          "204": {
+            "description": "Successfully deleted the schema configuration at the API level."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics": {
+      "get": {
+        "tags": [
+          "ApiDiagnostic"
+        ],
+        "operationId": "ApiDiagnostic_ListByService",
+        "description": "Lists all diagnostics of an API.",
+        "x-ms-examples": {
+          "ApiManagementListApiDiagnostics": {
+            "$ref": "./examples/ApiManagementListApiDiagnostics.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Paged Result response of diagnostics for an API.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/DiagnosticCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/DiagnosticContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}": {
+      "head": {
+        "tags": [
+          "ApiDiagnostic"
+        ],
+        "operationId": "ApiDiagnostic_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the Diagnostic for an API specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadApiDiagnostic": {
+            "$ref": "./examples/ApiManagementHeadApiDiagnostic.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/DiagnosticIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Operation completed successfully.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "ApiDiagnostic"
+        ],
+        "operationId": "ApiDiagnostic_Get",
+        "description": "Gets the details of the Diagnostic for an API specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetApiDiagnostic": {
+            "$ref": "./examples/ApiManagementGetApiDiagnostic.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/DiagnosticIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified Diagnostic entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/DiagnosticContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "ApiDiagnostic"
+        ],
+        "operationId": "ApiDiagnostic_CreateOrUpdate",
+        "description": "Creates a new Diagnostic for an API or updates an existing one.",
+        "x-ms-examples": {
+          "ApiManagementCreateApiDiagnostic": {
+            "$ref": "./examples/ApiManagementCreateApiDiagnostic.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/DiagnosticIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/DiagnosticContract"
+            },
+            "description": "Create parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Diagnostic was successfully created.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/DiagnosticContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "200": {
+            "description": "Diagnostic was successfully updated.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/DiagnosticContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "ApiDiagnostic"
+        ],
+        "operationId": "ApiDiagnostic_Update",
+        "description": "Updates the details of the Diagnostic for an API specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementUpdateApiDiagnostic": {
+            "$ref": "./examples/ApiManagementUpdateApiDiagnostic.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/DiagnosticIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/DiagnosticContract"
+            },
+            "description": "Diagnostic Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The Diagnostic was successfully updated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ApiDiagnostic"
+        ],
+        "operationId": "ApiDiagnostic_Delete",
+        "description": "Deletes the specified Diagnostic from an API.",
+        "x-ms-examples": {
+          "ApiManagementDeleteApiDiagnostic": {
+            "$ref": "./examples/ApiManagementDeleteApiDiagnostic.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/DiagnosticIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Diagnostic successfully removed"
+          },
+          "204": {
+            "description": "Diagnostic successfully removed by previous request or does not exist"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues": {
+      "get": {
+        "tags": [
+          "ApiIssue"
+        ],
+        "operationId": "ApiIssue_ListByService",
+        "description": "Lists all issues associated with the specified API.",
+        "x-ms-examples": {
+          "ApiManagementListApiIssues": {
+            "$ref": "./examples/ApiManagementListApiIssues.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| userId | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| state | filter | eq |     | </br>"
+          },
+          {
+            "name": "expandCommentsAttachments",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "description": "Expand the comment attachments. "
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Paged Result response of issues for the API.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IssueCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/IssueContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}": {
+      "head": {
+        "tags": [
+          "ApiIssue"
+        ],
+        "operationId": "ApiIssue_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the Issue for an API specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadApiIssue": {
+            "$ref": "./examples/ApiManagementHeadApiIssue.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IssueIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Operation completed successfully.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "ApiIssue"
+        ],
+        "operationId": "ApiIssue_Get",
+        "description": "Gets the details of the Issue for an API specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetApiIssue": {
+            "$ref": "./examples/ApiManagementGetApiIssue.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IssueIdParameter"
+          },
+          {
+            "name": "expandCommentsAttachments",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "description": "Expand the comment attachments. "
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified Issue entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IssueContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "ApiIssue"
+        ],
+        "operationId": "ApiIssue_CreateOrUpdate",
+        "description": "Creates a new Issue for an API or updates an existing one.",
+        "x-ms-examples": {
+          "ApiManagementCreateApiIssue": {
+            "$ref": "./examples/ApiManagementCreateApiIssue.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IssueIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IssueContract"
+            },
+            "description": "Create parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "New api issue successfully added",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IssueContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "200": {
+            "description": "Api issue successfully updated",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IssueContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "ApiIssue"
+        ],
+        "operationId": "ApiIssue_Update",
+        "description": "Updates an existing issue for an API.",
+        "x-ms-examples": {
+          "ApiManagementUpdateApiIssue": {
+            "$ref": "./examples/ApiManagementUpdateApiIssue.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IssueIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IssueUpdateContract"
+            },
+            "description": "Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Api issue updated successfully"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ApiIssue"
+        ],
+        "operationId": "ApiIssue_Delete",
+        "description": "Deletes the specified Issue from an API.",
+        "x-ms-examples": {
+          "ApiManagementDeleteApiIssue": {
+            "$ref": "./examples/ApiManagementDeleteApiIssue.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IssueIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Issue successfully removed"
+          },
+          "204": {
+            "description": "Issue successfully removed by previous request or does not exist"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/comments": {
+      "get": {
+        "tags": [
+          "ApiIssueComment"
+        ],
+        "operationId": "ApiIssueComment_ListByService",
+        "description": "Lists all comments for the Issue associated with the specified API.",
+        "x-ms-examples": {
+          "ApiManagementListApiIssueComments": {
+            "$ref": "./examples/ApiManagementListApiIssueComments.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IssueIdParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| userId | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Paged Result response of issue comments for the API.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IssueCommentCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/IssueCommentContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/comments/{commentId}": {
+      "head": {
+        "tags": [
+          "ApiIssueComment"
+        ],
+        "operationId": "ApiIssueComment_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the issue Comment for an API specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadApiIssueComment": {
+            "$ref": "./examples/ApiManagementHeadApiIssueComment.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IssueIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/CommentIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Operation completed successfully.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "ApiIssueComment"
+        ],
+        "operationId": "ApiIssueComment_Get",
+        "description": "Gets the details of the issue Comment for an API specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetApiIssueComment": {
+            "$ref": "./examples/ApiManagementGetApiIssueComment.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IssueIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/CommentIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified issue Comment entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IssueCommentContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "ApiIssueComment"
+        ],
+        "operationId": "ApiIssueComment_CreateOrUpdate",
+        "description": "Creates a new Comment for the Issue in an API or updates an existing one.",
+        "x-ms-examples": {
+          "ApiManagementCreateApiIssueComment": {
+            "$ref": "./examples/ApiManagementCreateApiIssueComment.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IssueIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/CommentIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IssueCommentContract"
+            },
+            "description": "Create parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "New api issue comment successfully added",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IssueCommentContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "200": {
+            "description": "Api issue comment successfully updated",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IssueCommentContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ApiIssueComment"
+        ],
+        "operationId": "ApiIssueComment_Delete",
+        "description": "Deletes the specified comment from an Issue.",
+        "x-ms-examples": {
+          "ApiManagementDeleteApiIssueComment": {
+            "$ref": "./examples/ApiManagementDeleteApiIssueComment.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IssueIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/CommentIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Comment successfully removed"
+          },
+          "204": {
+            "description": "Comment successfully removed by previous request or does not exist"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/attachments": {
+      "get": {
+        "tags": [
+          "ApiIssueAttachment"
+        ],
+        "operationId": "ApiIssueAttachment_ListByService",
+        "description": "Lists all attachments for the Issue associated with the specified API.",
+        "x-ms-examples": {
+          "ApiManagementListApiIssueAttachments": {
+            "$ref": "./examples/ApiManagementListApiIssueAttachments.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IssueIdParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| userId | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Paged Result response of issue attachments for the API.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IssueAttachmentCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/IssueAttachmentContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/attachments/{attachmentId}": {
+      "head": {
+        "tags": [
+          "ApiIssueAttachment"
+        ],
+        "operationId": "ApiIssueAttachment_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the issue Attachment for an API specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadApiIssueAttachment": {
+            "$ref": "./examples/ApiManagementHeadApiIssueAttachment.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IssueIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AttachmentIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Operation completed successfully.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "ApiIssueAttachment"
+        ],
+        "operationId": "ApiIssueAttachment_Get",
+        "description": "Gets the details of the issue Attachment for an API specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetApiIssueAttachment": {
+            "$ref": "./examples/ApiManagementGetApiIssueAttachment.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IssueIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AttachmentIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified issue Attachment entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IssueAttachmentContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "ApiIssueAttachment"
+        ],
+        "operationId": "ApiIssueAttachment_CreateOrUpdate",
+        "description": "Creates a new Attachment for the Issue in an API or updates an existing one.",
+        "x-ms-examples": {
+          "ApiManagementCreateApiIssueAttachment": {
+            "$ref": "./examples/ApiManagementCreateApiIssueAttachment.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IssueIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AttachmentIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IssueAttachmentContract"
+            },
+            "description": "Create parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "New api issue attachment successfully added",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IssueAttachmentContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "200": {
+            "description": "Api issue attachment successfully updated",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IssueAttachmentContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ApiIssueAttachment"
+        ],
+        "operationId": "ApiIssueAttachment_Delete",
+        "description": "Deletes the specified comment from an Issue.",
+        "x-ms-examples": {
+          "ApiManagementDeleteApiIssueAttachment": {
+            "$ref": "./examples/ApiManagementDeleteApiIssueAttachment.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IssueIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AttachmentIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Attachment successfully removed"
+          },
+          "204": {
+            "description": "Attachment successfully removed by previous request or does not exist"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions": {
+      "get": {
+        "tags": [
+          "ApiTagDescription"
+        ],
+        "operationId": "ApiTagDescription_ListByService",
+        "description": "Lists all Tags descriptions in scope of API. Model similar to swagger - tagDescription is defined on API level but tag may be assigned to the Operations",
+        "x-ms-examples": {
+          "ApiManagementListApiTagDescriptions": {
+            "$ref": "./examples/ApiManagementListApiTagDescriptions.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation returns a collection of tagDescriptions associated with the Api entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagDescriptionCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/TagDescriptionContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions/{tagDescriptionId}": {
+      "head": {
+        "tags": [
+          "ApiTagDescription"
+        ],
+        "operationId": "ApiTagDescription_GetEntityTag",
+        "description": "Gets the entity state version of the tag specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadApiTagDescription": {
+            "$ref": "./examples/ApiManagementHeadApiTagDescription.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TagDescriptionIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Empty response body, ETag header entity state version.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "ApiTagDescription"
+        ],
+        "operationId": "ApiTagDescription_Get",
+        "description": "Get Tag description in scope of API",
+        "x-ms-examples": {
+          "ApiManagementGetApiTagDescription": {
+            "$ref": "./examples/ApiManagementGetApiTagDescription.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TagDescriptionIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Gets the description of the tag specified by its identifier in scope if the Api.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagDescriptionContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "ApiTagDescription"
+        ],
+        "operationId": "ApiTagDescription_CreateOrUpdate",
+        "description": "Create/Update tag description in scope of the Api.",
+        "x-ms-examples": {
+          "ApiManagementCreateApiTagDescription": {
+            "$ref": "./examples/ApiManagementCreateApiTagDescription.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TagDescriptionIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagDescriptionCreateParameters"
+            },
+            "description": "Create parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Tag Description was created for the Api.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagDescriptionContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "200": {
+            "description": "Tag Description was updated for the Api.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagDescriptionContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ApiTagDescription"
+        ],
+        "operationId": "ApiTagDescription_Delete",
+        "description": "Delete tag description for the Api.",
+        "x-ms-examples": {
+          "ApiManagementDeleteApiTagDescription": {
+            "$ref": "./examples/ApiManagementDeleteApiTagDescription.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TagDescriptionIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Tag description successfully removed"
+          },
+          "204": {
+            "description": "Tag description successfully removed by previous request or does not exist"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags": {
+      "get": {
+        "tags": [
+          "ApiTag"
+        ],
+        "operationId": "Tag_ListByApi",
+        "description": "Lists all Tags associated with the API.",
+        "x-ms-examples": {
+          "ApiManagementListApiTags": {
+            "$ref": "./examples/ApiManagementListApiTags.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation returns a collection of tags associated with the Api entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/TagContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags/{tagId}": {
+      "head": {
+        "tags": [
+          "ApiTag"
+        ],
+        "operationId": "Tag_GetEntityStateByApi",
+        "description": "Gets the entity state version of the tag specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadApiTag": {
+            "$ref": "./examples/ApiManagementHeadApiTag.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TagIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Empty response body, ETag header entity state version.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "ApiTag"
+        ],
+        "operationId": "Tag_GetByApi",
+        "description": "Get tag associated with the API.",
+        "x-ms-examples": {
+          "ApiManagementGetApiTag": {
+            "$ref": "./examples/ApiManagementGetApiTag.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TagIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Gets the details of the tag specified by its identifier.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "ApiTag"
+        ],
+        "operationId": "Tag_AssignToApi",
+        "description": "Assign tag to the Api.",
+        "x-ms-examples": {
+          "ApiManagementCreateApiTag": {
+            "$ref": "./examples/ApiManagementCreateApiTag.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TagIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Tag was assigned to the Api.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "200": {
+            "description": "Tag is already assigned to the Api.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ApiTag"
+        ],
+        "operationId": "Tag_DetachFromApi",
+        "description": "Detach the tag from the Api.",
+        "x-ms-examples": {
+          "ApiManagementDeleteApiTag": {
+            "$ref": "./examples/ApiManagementDeleteApiTag.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TagIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "API/Tag association successfully removed"
+          },
+          "204": {
+            "description": "API/Tag association successfully removed by previous request or does not exist"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operationsByTags": {
+      "get": {
+        "tags": [
+          "ApiOperationsByTag"
+        ],
+        "operationId": "Operation_ListByTags",
+        "description": "Lists a collection of operations associated with tags.",
+        "x-ms-examples": {
+          "ApiManagementListApiOperationsByTags": {
+            "$ref": "./examples/ApiManagementListApiOperationsByTags.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| apiName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| description | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| method | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| urlTemplate | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "name": "includeNotTaggedOperations",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "description": "Include not tagged Operations."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of TagResource entities.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagResourceCollection"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/TagResourceContract"
+      }
+    }
+  },
+  "x-ms-paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}?export=true": {
+      "get": {
+        "tags": [
+          "Apis"
+        ],
+        "operationId": "ApiExport_Get",
+        "description": "Gets the details of the API specified by its identifier in the format specified to the Storage Blob with SAS Key valid for 5 minutes.",
+        "x-ms-examples": {
+          "ApiManagementGetApiExportInOpenApi2dot0": {
+            "$ref": "./examples/ApiManagementGetApiExportInOpenApi2dot0.json"
+          },
+          "ApiManagementGetApiExportInOpenApi3dot0": {
+            "$ref": "./examples/ApiManagementGetApiExportInOpenApi3dot0.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "name": "format",
+            "in": "query",
+            "required": true,
+            "type": "string",
+            "enum": [
+              "swagger-link",
+              "wadl-link",
+              "wsdl-link",
+              "openapi-link",
+              "openapi+json-link"
+            ],
+            "x-ms-enum": {
+              "name": "ExportFormat",
+              "modelAsString": true,
+              "values": [
+                {
+                  "value": "swagger-link",
+                  "description": "Export the Api Definition in OpenApi Specification 2.0 format to the Storage Blob.",
+                  "name": "Swagger"
+                },
+                {
+                  "value": "wsdl-link",
+                  "description": "Export the Api Definition in WSDL Schema to Storage Blob. This is only supported for APIs of Type `soap`",
+                  "name": "Wsdl"
+                },
+                {
+                  "value": "wadl-link",
+                  "description": "Export the Api Definition in WADL Schema to Storage Blob.",
+                  "name": "Wadl"
+                },
+                {
+                  "value": "openapi-link",
+                  "description": "Export the Api Definition in OpenApi Specification 3.0 to Storage Blob.",
+                  "name": "Openapi"
+                },
+                {
+                  "value": "openapi+json-link",
+                  "description": "Export the Api Definition in OpenApi Specification 3.0 as JSON document to Storage Blob.",
+                  "name": "OpenapiJson"
+                }
+              ]
+            },
+            "description": "Format in which to export the Api Details to the Storage Blob with Sas Key valid for 5 minutes."
+          },
+          {
+            "name": "export",
+            "in": "query",
+            "required": true,
+            "type": "string",
+            "enum": [
+              "true"
+            ],
+            "x-ms-enum": {
+              "modelAsString": true,
+              "name": "ExportApi"
+            },
+            "description": "Query parameter required to export the API details."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response contains a stream with a full set of API metadata and includes API entity with an embedded array of operation entities.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiExportResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimapisByTags.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimapisByTags.json
new file mode 100644
index 000000000000..d258f00b3b84
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimapisByTags.json
@@ -0,0 +1,106 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing retrieve a collection of Apis associated with a tag in Azure API Management deployment.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apisByTags": {
+      "get": {
+        "tags": [
+          "ApisByTag"
+        ],
+        "operationId": "Api_ListByTags",
+        "description": "Lists a collection of apis associated with tags.",
+        "x-ms-examples": {
+          "ApiManagementListApisByTags": {
+            "$ref": "./examples/ApiManagementListApisByTags.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "| Field       | Supported operators    | Supported functions               |\n|-------------|------------------------|-----------------------------------|\n\r\n|name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith|\n|displayName | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith|\n|apiRevision | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith|\n|path | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith|\n|description | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith|\n|serviceUrl | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith|\n|isCurrent | eq |    |\n"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "name": "includeNotTaggedApis",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "description": "Include not tagged APIs."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of TagResource entities.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagResourceCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/TagResourceContract"
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimapiversionsets.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimapiversionsets.json
new file mode 100644
index 000000000000..10836b0067fe
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimapiversionsets.json
@@ -0,0 +1,367 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on the ApiVersionSet entity associated with your Azure API Management deployment. Using this entity you create and manage API Version Sets that are used to group APIs for consistent versioning.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apiVersionSets": {
+      "get": {
+        "tags": [
+          "ApiVersionSet"
+        ],
+        "operationId": "ApiVersionSet_ListByService",
+        "description": "Lists a collection of API Version Sets in the specified service instance.",
+        "x-ms-examples": {
+          "ApiManagementListApiVersionSets": {
+            "$ref": "./examples/ApiManagementListApiVersionSets.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of Api Version Set entities.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiVersionSetCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/ApiVersionSetContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apiVersionSets/{versionSetId}": {
+      "head": {
+        "tags": [
+          "ApiVersionSet"
+        ],
+        "operationId": "ApiVersionSet_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the Api Version Set specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadApiVersionSet": {
+            "$ref": "./examples/ApiManagementHeadApiVersionSet.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionSetIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified Api Version Set entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "ApiVersionSet"
+        ],
+        "operationId": "ApiVersionSet_Get",
+        "description": "Gets the details of the Api Version Set specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetApiVersionSet": {
+            "$ref": "./examples/ApiManagementGetApiVersionSet.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionSetIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Gets the specified Api Version Set entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiVersionSetContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "ApiVersionSet"
+        ],
+        "operationId": "ApiVersionSet_CreateOrUpdate",
+        "description": "Creates or Updates a Api Version Set.",
+        "x-ms-examples": {
+          "ApiManagementCreateApiVersionSet": {
+            "$ref": "./examples/ApiManagementCreateApiVersionSet.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionSetIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiVersionSetContract"
+            },
+            "description": "Create or update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Api Version Set was successfully created.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiVersionSetContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "200": {
+            "description": "Api Version Set was successfully updated.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiVersionSetContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "ApiVersionSet"
+        ],
+        "operationId": "ApiVersionSet_Update",
+        "description": "Updates the details of the Api VersionSet specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementUpdateApiVersionSet": {
+            "$ref": "./examples/ApiManagementUpdateApiVersionSet.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionSetIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiVersionSetUpdateParameters"
+            },
+            "description": "Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The Api Version Set details were successfully updated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ApiVersionSets"
+        ],
+        "operationId": "ApiVersionSet_Delete",
+        "description": "Deletes specific Api Version Set.",
+        "x-ms-examples": {
+          "ApiManagementDeleteApiVersionSet": {
+            "$ref": "./examples/ApiManagementDeleteApiVersionSet.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionSetIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The ApiVersion Set details were successfully deleted."
+          },
+          "204": {
+            "description": "The ApiVersion Set details were successfully deleted."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimauthorizationservers.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimauthorizationservers.json
new file mode 100644
index 000000000000..a2f12fb89edf
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimauthorizationservers.json
@@ -0,0 +1,412 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for managing OAuth2 servers configuration in your Azure API Management deployment. OAuth 2.0 can be used to authorize developer accounts for Azure API Management. For more information refer to [How to OAuth2](https://docs.microsoft.com/en-us/azure/api-management/api-management-howto-oauth2).",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers": {
+      "get": {
+        "tags": [
+          "AuthorizationServer"
+        ],
+        "operationId": "AuthorizationServer_ListByService",
+        "description": "Lists a collection of authorization servers defined within a service instance.",
+        "x-ms-examples": {
+          "ApiManagementListAuthorizationServers": {
+            "$ref": "./examples/ApiManagementListAuthorizationServers.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A Collection of the Authorization Server entities for the specified API Management service instance.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/AuthorizationServerCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/AuthorizationServerContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers/{authsid}": {
+      "head": {
+        "tags": [
+          "AuthorizationServer"
+        ],
+        "operationId": "AuthorizationServer_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the authorizationServer specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadAuthorizationServer": {
+            "$ref": "./examples/ApiManagementHeadAuthorizationServer.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AuthenticationServerIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified authorization server entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "AuthorizationServer"
+        ],
+        "operationId": "AuthorizationServer_Get",
+        "description": "Gets the details of the authorization server specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetAuthorizationServer": {
+            "$ref": "./examples/ApiManagementGetAuthorizationServer.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AuthenticationServerIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Gets the details of the specified authorization server.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/AuthorizationServerContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "AuthorizationServer"
+        ],
+        "operationId": "AuthorizationServer_CreateOrUpdate",
+        "description": "Creates new authorization server or updates an existing authorization server.",
+        "x-ms-examples": {
+          "ApiManagementCreateAuthorizationServer": {
+            "$ref": "./examples/ApiManagementCreateAuthorizationServer.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AuthenticationServerIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/AuthorizationServerContract"
+            },
+            "description": "Create or update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Authorization server was successfully registered.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/AuthorizationServerContract"
+            }
+          },
+          "200": {
+            "description": "Authorization server is already registered.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/AuthorizationServerContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "AuthorizationServer"
+        ],
+        "operationId": "AuthorizationServer_Update",
+        "description": "Updates the details of the authorization server specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementUpdateAuthorizationServer": {
+            "$ref": "./examples/ApiManagementUpdateAuthorizationServer.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AuthenticationServerIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/AuthorizationServerUpdateContract"
+            },
+            "description": "OAuth2 Server settings Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The authorization server settings were successfully updated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "AuthorizationServer"
+        ],
+        "operationId": "AuthorizationServer_Delete",
+        "description": "Deletes specific authorization server instance.",
+        "x-ms-examples": {
+          "ApiManagementDeleteAuthorizationServer": {
+            "$ref": "./examples/ApiManagementDeleteAuthorizationServer.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AuthenticationServerIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The authorization server settings were successfully deleted."
+          },
+          "204": {
+            "description": "The authorization server settings were successfully deleted."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers/{authsid}/listSecrets": {
+      "post": {
+        "tags": [
+          "AuthorizationServer"
+        ],
+        "operationId": "AuthorizationServer_ListSecrets",
+        "description": "Gets the client secret details of the authorization server.",
+        "x-ms-examples": {
+          "ApiManagementListSecretsAuthorizationServer": {
+            "$ref": "./examples/ApiManagementListSecretsAuthorizationServer.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AuthenticationServerIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the client secret.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ClientSecretContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimbackends.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimbackends.json
new file mode 100644
index 000000000000..db1988b2971e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimbackends.json
@@ -0,0 +1,421 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on Backend entity in Azure API Management deployment. The Backend entity in API Management represents a backend service that is configured to skip certification chain validation when using a self-signed certificate to test mutual certificate authentication.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backends": {
+      "get": {
+        "tags": [
+          "Backend"
+        ],
+        "operationId": "Backend_ListByService",
+        "description": "Lists a collection of backends in the specified service instance.",
+        "x-ms-examples": {
+          "ApiManagementListBackends": {
+            "$ref": "./examples/ApiManagementListBackends.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| title | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| url | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of Backend entities.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/BackendCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/BackendContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backends/{backendId}": {
+      "head": {
+        "tags": [
+          "Backend"
+        ],
+        "operationId": "Backend_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the backend specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadBackend": {
+            "$ref": "./examples/ApiManagementHeadBackend.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/BackendIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified backend entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "Backend"
+        ],
+        "operationId": "Backend_Get",
+        "description": "Gets the details of the backend specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetBackend": {
+            "$ref": "./examples/ApiManagementGetBackend.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/BackendIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified Backend entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/BackendContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Backend"
+        ],
+        "operationId": "Backend_CreateOrUpdate",
+        "description": "Creates or Updates a backend.",
+        "x-ms-examples": {
+          "ApiManagementCreateBackendServiceFabric": {
+            "$ref": "./examples/ApiManagementCreateBackendServiceFabric.json"
+          },
+          "ApiManagementCreateBackendProxyBackend": {
+            "$ref": "./examples/ApiManagementCreateBackendProxyBackend.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/BackendIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/BackendContract"
+            },
+            "description": "Create parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Backend was successfully created.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/BackendContract"
+            }
+          },
+          "200": {
+            "description": "The existing backend was successfully updated.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/BackendContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "Backend"
+        ],
+        "operationId": "Backend_Update",
+        "description": "Updates an existing backend.",
+        "x-ms-examples": {
+          "ApiManagementUpdateBackend": {
+            "$ref": "./examples/ApiManagementUpdateBackend.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/BackendIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/BackendUpdateParameters"
+            },
+            "description": "Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The existing backend was successfully updated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Backend"
+        ],
+        "operationId": "Backend_Delete",
+        "description": "Deletes the specified backend.",
+        "x-ms-examples": {
+          "ApiManagementDeleteBackend": {
+            "$ref": "./examples/ApiManagementDeleteBackend.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/BackendIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The backend was successfully deleted."
+          },
+          "204": {
+            "description": "The backend was successfully deleted."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backends/{backendId}/reconnect": {
+      "post": {
+        "tags": [
+          "BackendReconnect"
+        ],
+        "operationId": "Backend_Reconnect",
+        "description": "Notifies the APIM proxy to create a new connection to the backend after the specified timeout. If no timeout was specified, timeout of 2 minutes is used.",
+        "x-ms-examples": {
+          "ApiManagementBackendReconnect": {
+            "$ref": "./examples/ApiManagementBackendReconnect.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/BackendIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": false,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/BackendReconnectContract"
+            },
+            "description": "Reconnect request parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Reconnect request accepted."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimcaches.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimcaches.json
new file mode 100644
index 000000000000..96c03f0aa95b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimcaches.json
@@ -0,0 +1,363 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on Cache entity in your Azure API Management deployment. Azure API Management also allows for caching responses in an external Azure Cache for Redis. For more information refer to [External Redis Cache in ApiManagement](https://docs.microsoft.com/en-us/azure/api-management/api-management-howto-cache-external).",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/caches": {
+      "get": {
+        "tags": [
+          "Cache"
+        ],
+        "operationId": "Cache_ListByService",
+        "description": "Lists a collection of all external Caches in the specified service instance.",
+        "x-ms-examples": {
+          "ApiManagementListCaches": {
+            "$ref": "./examples/ApiManagementListCaches.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Returns a collection of Cache entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/CacheCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/caches/{cacheId}": {
+      "head": {
+        "tags": [
+          "Cache"
+        ],
+        "operationId": "Cache_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the Cache specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadCache": {
+            "$ref": "./examples/ApiManagementHeadCache.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/CacheIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified Cache entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "Cache"
+        ],
+        "operationId": "Cache_Get",
+        "description": "Gets the details of the Cache specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetCache": {
+            "$ref": "./examples/ApiManagementGetCache.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/CacheIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified Cache entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/CacheContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Cache"
+        ],
+        "operationId": "Cache_CreateOrUpdate",
+        "description": "Creates or updates an External Cache to be used in Api Management instance.",
+        "externalDocs": {
+          "description": "Use an external cache in Azure API Management",
+          "url": "https://docs.microsoft.com/en-us/azure/api-management/api-management-howto-cache-external"
+        },
+        "x-ms-examples": {
+          "ApiManagementCreateCache": {
+            "$ref": "./examples/ApiManagementCreateCache.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/CacheIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/CacheContract"
+            },
+            "description": "Create or Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "The new Cache was successfully added.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/CacheContract"
+            }
+          },
+          "200": {
+            "description": "The Cache details were successfully updated.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/CacheContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "Cache"
+        ],
+        "operationId": "Cache_Update",
+        "description": "Updates the details of the cache specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementUpdateCache": {
+            "$ref": "./examples/ApiManagementUpdateCache.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/CacheIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/CacheUpdateParameters"
+            },
+            "description": "Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The cache details were successfully updated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Cache"
+        ],
+        "operationId": "Cache_Delete",
+        "description": "Deletes specific Cache.",
+        "x-ms-examples": {
+          "ApiManagementDeleteCache": {
+            "$ref": "./examples/ApiManagementDeleteCache.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/CacheIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The Cache was successfully deleted."
+          },
+          "204": {
+            "description": "The Cache was successfully deleted."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimcertificates.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimcertificates.json
new file mode 100644
index 000000000000..feea7a9cd650
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimcertificates.json
@@ -0,0 +1,319 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on Certificate entity in your Azure API Management deployment. Certificates can be used to setup mutual authentication with your Backend in API Management. For more information refer to [How to secure backend using Mutual Auth Certificate](https://docs.microsoft.com/en-us/azure/api-management/api-management-howto-mutual-certificates).",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/certificates": {
+      "get": {
+        "tags": [
+          "Certificate"
+        ],
+        "operationId": "Certificate_ListByService",
+        "description": "Lists a collection of all certificates in the specified service instance.",
+        "x-ms-examples": {
+          "ApiManagementListCertificates": {
+            "$ref": "./examples/ApiManagementListCertificates.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| subject | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| thumbprint | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| expirationDate | filter | ge, le, eq, ne, gt, lt |     | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Returns a collection of Certificate entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/CertificateCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/CertificateContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/certificates/{certificateId}": {
+      "head": {
+        "tags": [
+          "Certificate"
+        ],
+        "operationId": "Certificate_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the certificate specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadCertificate": {
+            "$ref": "./examples/ApiManagementHeadCertificate.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/CertificateIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified certificate entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "Certificate"
+        ],
+        "operationId": "Certificate_Get",
+        "description": "Gets the details of the certificate specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetCertificate": {
+            "$ref": "./examples/ApiManagementGetCertificate.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/CertificateIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified Certificate entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/CertificateContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Certificate"
+        ],
+        "operationId": "Certificate_CreateOrUpdate",
+        "description": "Creates or updates the certificate being used for authentication with the backend.",
+        "externalDocs": {
+          "description": "How to secure back-end services using client certificate authentication in Azure API Management",
+          "url": "https://azure.microsoft.com/en-us/documentation/articles/api-management-howto-mutual-certificates/"
+        },
+        "x-ms-examples": {
+          "ApiManagementCreateCertificate": {
+            "$ref": "./examples/ApiManagementCreateCertificate.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/CertificateIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/CertificateCreateOrUpdateParameters"
+            },
+            "description": "Create or Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "The new certificate was successfully added.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/CertificateContract"
+            }
+          },
+          "200": {
+            "description": "The certificate details were successfully updated.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/CertificateContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Certificate"
+        ],
+        "operationId": "Certificate_Delete",
+        "description": "Deletes specific certificate.",
+        "x-ms-examples": {
+          "ApiManagementDeleteCertificate": {
+            "$ref": "./examples/ApiManagementDeleteCertificate.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/CertificateIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The certificate was successfully deleted."
+          },
+          "204": {
+            "description": "The certificate was successfully deleted."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimdeployment.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimdeployment.json
new file mode 100644
index 000000000000..ce8c693b268c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimdeployment.json
@@ -0,0 +1,1551 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs to manage Azure API Management deployment.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/providers/Microsoft.ApiManagement/operations": {
+      "get": {
+        "tags": [
+          "ApiManagementOperations"
+        ],
+        "description": "Lists all of the available REST API operations of the Microsoft.ApiManagement provider.",
+        "operationId": "ApiManagementOperations_List",
+        "x-ms-examples": {
+          "ApiManagementListOperations": {
+            "$ref": "./examples/ApiManagementListOperations.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success. The response describes the list of operations.",
+            "schema": {
+              "$ref": "#/definitions/OperationListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/skus": {
+      "get": {
+        "tags": [
+          "ApiManagementServiceSkus"
+        ],
+        "summary": "Gets available SKUs for API Management service",
+        "description": "Gets all available SKU for a given API Management service",
+        "operationId": "ApiManagementServiceSkus_ListAvailableServiceSkus",
+        "x-ms-examples": {
+          "ApiManagementListSKUs-Dedicated": {
+            "$ref": "./examples/ApiManagementListSKUs-Dedicated.json"
+          },
+          "ApiManagementListSKUs-Consumption": {
+            "$ref": "./examples/ApiManagementListSKUs-Consumption.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success. The response describes the list of SKUs.",
+            "schema": {
+              "$ref": "#/definitions/ResourceSkuResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/restore": {
+      "post": {
+        "tags": [
+          "ApiManagementService"
+        ],
+        "operationId": "ApiManagementService_Restore",
+        "description": "Restores a backup of an API Management service created using the ApiManagementService_Backup operation on the current service. This is a long running operation and could take several minutes to complete.",
+        "x-ms-examples": {
+          "ApiManagementRestoreService": {
+            "$ref": "./examples/ApiManagementRestoreService.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ApiManagementServiceBackupRestoreParameters"
+            },
+            "description": "Parameters supplied to the Restore API Management service from backup operation."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successfully restored the backup onto the API Management service.",
+            "schema": {
+              "$ref": "#/definitions/ApiManagementServiceResource"
+            }
+          },
+          "202": {
+            "description": "Accepted: Location header contains the URL where the status of the long running operation can be checked."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "location"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backup": {
+      "post": {
+        "tags": [
+          "ApiManagementService"
+        ],
+        "operationId": "ApiManagementService_Backup",
+        "description": "Creates a backup of the API Management service to the given Azure Storage Account. This is long running operation and could take several minutes to complete.",
+        "x-ms-examples": {
+          "ApiManagementCreateBackup": {
+            "$ref": "./examples/ApiManagementCreateBackup.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ApiManagementServiceBackupRestoreParameters"
+            },
+            "description": "Parameters supplied to the ApiManagementService_Backup operation."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successfully backed up the API Management service to the storage account.",
+            "schema": {
+              "$ref": "#/definitions/ApiManagementServiceResource"
+            }
+          },
+          "202": {
+            "description": "Accepted: Location header contains the URL where the status of the long running operation can be checked."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "location"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}": {
+      "put": {
+        "tags": [
+          "ApiManagementService"
+        ],
+        "operationId": "ApiManagementService_CreateOrUpdate",
+        "description": "Creates or updates an API Management service. This is long running operation and could take several minutes to complete.",
+        "x-ms-examples": {
+          "ApiManagementCreateService": {
+            "$ref": "./examples/ApiManagementCreateService.json"
+          },
+          "ApiManagementCreateMultiRegionServiceWithCustomHostname": {
+            "$ref": "./examples/ApiManagementCreateMultiRegionServiceWithCustomHostname.json"
+          },
+          "ApiManagementCreateServiceHavingMsi": {
+            "$ref": "./examples/ApiManagementCreateServiceHavingMsi.json"
+          },
+          "ApiManagementCreateServiceWithSystemCertificates": {
+            "$ref": "./examples/ApiManagementCreateServiceWithSystemCertificates.json"
+          },
+          "ApiManagementCreateServiceWithUserAssignedIdentity": {
+            "$ref": "./examples/ApiManagementCreateServiceWithUserAssignedIdentity.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ApiManagementServiceResource"
+            },
+            "description": "Parameters supplied to the CreateOrUpdate API Management service operation."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The service was successfully set up.",
+            "schema": {
+              "$ref": "#/definitions/ApiManagementServiceResource"
+            }
+          },
+          "201": {
+            "description": "Created",
+            "schema": {
+              "$ref": "#/definitions/ApiManagementServiceResource"
+            }
+          },
+          "202": {
+            "description": "Accepted the configuration change when updating the service."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "patch": {
+        "tags": [
+          "ApiManagementService"
+        ],
+        "operationId": "ApiManagementService_Update",
+        "description": "Updates an existing API Management service.",
+        "x-ms-examples": {
+          "ApiManagementUpdateServiceDisableTls10": {
+            "$ref": "./examples/ApiManagementUpdateServiceDisableTls10.json"
+          },
+          "ApiManagementUpdateServicePublisherDetails": {
+            "$ref": "./examples/ApiManagementUpdateServicePublisherDetails.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ApiManagementServiceUpdateParameters"
+            },
+            "description": "Parameters supplied to the CreateOrUpdate API Management service operation."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The service was successfully updated.",
+            "schema": {
+              "$ref": "#/definitions/ApiManagementServiceResource"
+            }
+          },
+          "202": {
+            "description": "The service update request was Accepted."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "get": {
+        "tags": [
+          "ApiManagementService"
+        ],
+        "operationId": "ApiManagementService_Get",
+        "description": "Gets an API Management service resource description.",
+        "x-ms-examples": {
+          "ApiManagementServiceGetService": {
+            "$ref": "./examples/ApiManagementServiceGetService.json"
+          },
+          "ApiManagementServiceGetServiceHavingMsi": {
+            "$ref": "./examples/ApiManagementServiceGetServiceHavingMsi.json"
+          },
+          "ApiManagementServiceGetMultiRegionInternalVnet": {
+            "$ref": "./examples/ApiManagementServiceGetMultiRegionInternalVnet.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successfully got the API Management Service Resource.",
+            "schema": {
+              "$ref": "#/definitions/ApiManagementServiceResource"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ApiManagementService"
+        ],
+        "operationId": "ApiManagementService_Delete",
+        "description": "Deletes an existing API Management service.",
+        "x-ms-examples": {
+          "ApiManagementServiceDeleteService": {
+            "$ref": "./examples/ApiManagementServiceDeleteService.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Service was successfully deleted."
+          },
+          "202": {
+            "description": "The service delete request was Accepted.",
+            "schema": {
+              "$ref": "#/definitions/ApiManagementServiceResource"
+            }
+          },
+          "204": {
+            "description": "The service does not exist."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service": {
+      "get": {
+        "tags": [
+          "ApiManagementService"
+        ],
+        "operationId": "ApiManagementService_ListByResourceGroup",
+        "description": "List all API Management services within a resource group.",
+        "x-ms-examples": {
+          "ApiManagementListServiceBySubscriptionAndResourceGroup": {
+            "$ref": "./examples/ApiManagementListServiceBySubscriptionAndResourceGroup.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The API Management service list.",
+            "schema": {
+              "$ref": "#/definitions/ApiManagementServiceListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.ApiManagement/service": {
+      "get": {
+        "tags": [
+          "ApiManagementService"
+        ],
+        "operationId": "ApiManagementService_List",
+        "description": "Lists all API Management services within an Azure subscription.",
+        "x-ms-examples": {
+          "ApiManagementListServiceBySubscription": {
+            "$ref": "./examples/ApiManagementListServiceBySubscription.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The API Management service list.",
+            "schema": {
+              "$ref": "#/definitions/ApiManagementServiceListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/getssotoken": {
+      "post": {
+        "tags": [
+          "ApiManagementService"
+        ],
+        "operationId": "ApiManagementService_GetSsoToken",
+        "description": "Gets the Single-Sign-On token for the API Management Service which is valid for 5 Minutes.",
+        "x-ms-examples": {
+          "ApiManagementServiceGetSsoToken": {
+            "$ref": "./examples/ApiManagementServiceGetSsoToken.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK if successful with the SSO Redirect URI.",
+            "schema": {
+              "x-ms-client-flatten": true,
+              "$ref": "#/definitions/ApiManagementServiceGetSsoTokenResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.ApiManagement/checkNameAvailability": {
+      "post": {
+        "tags": [
+          "ApiManagementService"
+        ],
+        "operationId": "ApiManagementService_CheckNameAvailability",
+        "description": "Checks availability and correctness of a name for an API Management service.",
+        "x-ms-examples": {
+          "ApiManagementServiceCheckNameAvailability": {
+            "$ref": "./examples/ApiManagementServiceCheckNameAvailability.json"
+          }
+        },
+        "parameters": [
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ApiManagementServiceCheckNameAvailabilityParameters"
+            },
+            "description": "Parameters supplied to the CheckNameAvailability operation."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The result of check name availability.",
+            "schema": {
+              "$ref": "#/definitions/ApiManagementServiceNameAvailabilityResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/applynetworkconfigurationupdates": {
+      "post": {
+        "tags": [
+          "ApiManagementService"
+        ],
+        "operationId": "ApiManagementService_ApplyNetworkConfigurationUpdates",
+        "description": "Updates the Microsoft.ApiManagement resource running in the Virtual network to pick the updated network settings.",
+        "x-ms-examples": {
+          "ApiManagementApplyNetworkConfigurationUpdates": {
+            "$ref": "./examples/ApiManagementApplyNetworkConfigurationUpdates.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": false,
+            "schema": {
+              "$ref": "#/definitions/ApiManagementServiceApplyNetworkConfigurationParameters"
+            },
+            "description": "Parameters supplied to the Apply Network Configuration operation. If the parameters are empty, all the regions in which the Api Management service is deployed will be updated sequentially without incurring downtime in the region."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Accepted: Location header contains the URL where the status of the long running operation can be checked."
+          },
+          "200": {
+            "description": "Network configuration updates were successfully applied on the Api Management service.",
+            "schema": {
+              "$ref": "#/definitions/ApiManagementServiceResource"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "location"
+        }
+      }
+    }
+  },
+  "definitions": {
+    "ResourceSkuResults": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ResourceSkuResult"
+          },
+          "description": "The list of skus available for the service."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "The uri to fetch the next page of API Management service Skus."
+        }
+      },
+      "required": [
+        "value"
+      ],
+      "description": "The API Management service SKUs operation response."
+    },
+    "ResourceSkuResult": {
+      "properties": {
+        "resourceType": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The type of resource the SKU applies to."
+        },
+        "sku": {
+          "$ref": "#/definitions/ResourceSku",
+          "readOnly": true,
+          "description": "Specifies API Management SKU."
+        },
+        "capacity": {
+          "$ref": "#/definitions/ResourceSkuCapacity",
+          "readOnly": true,
+          "description": "Specifies the number of API Management units."
+        }
+      },
+      "description": "Describes an available API Management service SKU."
+    },
+    "ResourceSkuCapacity": {
+      "properties": {
+        "minimum": {
+          "type": "integer",
+          "readOnly": true,
+          "format": "int32",
+          "description": "The minimum capacity."
+        },
+        "maximum": {
+          "type": "integer",
+          "readOnly": true,
+          "format": "int32",
+          "description": "The maximum capacity that can be set."
+        },
+        "default": {
+          "type": "integer",
+          "readOnly": true,
+          "format": "int32",
+          "description": "The default capacity."
+        },
+        "scaleType": {
+          "type": "string",
+          "readOnly": true,
+          "description": "The scale type applicable to the sku.",
+          "enum": [
+            "automatic",
+            "manual",
+            "none"
+          ],
+          "x-ms-enum": {
+            "name": "ResourceSkuCapacityScaleType",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "automatic",
+                "description": "Supported scale type automatic."
+              },
+              {
+                "value": "manual",
+                "description": "Supported scale type manual."
+              },
+              {
+                "value": "none",
+                "description": "Scaling not supported."
+              }
+            ]
+          }
+        }
+      },
+      "description": "Describes scaling information of a SKU."
+    },
+    "ResourceSku": {
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Name of the Sku.",
+          "externalDocs": {
+            "url": "https://azure.microsoft.com/en-us/pricing/details/api-management/"
+          },
+          "enum": [
+            "Developer",
+            "Standard",
+            "Premium",
+            "Basic",
+            "Consumption"
+          ],
+          "x-ms-enum": {
+            "name": "SkuType",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "Developer",
+                "description": "Developer SKU of Api Management."
+              },
+              {
+                "value": "Standard",
+                "description": "Standard SKU of Api Management."
+              },
+              {
+                "value": "Premium",
+                "description": "Premium SKU of Api Management."
+              },
+              {
+                "value": "Basic",
+                "description": "Basic SKU of Api Management."
+              },
+              {
+                "value": "Consumption",
+                "description": "Consumption SKU of Api Management."
+              }
+            ]
+          }
+        }
+      },
+      "description": "Describes an available API Management SKU."
+    },
+    "CertificateInformation": {
+      "properties": {
+        "expiry": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Expiration date of the certificate. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard."
+        },
+        "thumbprint": {
+          "type": "string",
+          "description": "Thumbprint of the certificate."
+        },
+        "subject": {
+          "type": "string",
+          "description": "Subject of the certificate."
+        }
+      },
+      "required": [
+        "expiry",
+        "thumbprint",
+        "subject"
+      ],
+      "description": "SSL certificate information."
+    },
+    "CertificateConfiguration": {
+      "properties": {
+        "encodedCertificate": {
+          "type": "string",
+          "description": "Base64 Encoded certificate."
+        },
+        "certificatePassword": {
+          "type": "string",
+          "description": "Certificate Password."
+        },
+        "storeName": {
+          "description": "The System.Security.Cryptography.x509certificates.StoreName certificate store location. Only Root and CertificateAuthority are valid locations.",
+          "type": "string",
+          "enum": [
+            "CertificateAuthority",
+            "Root"
+          ]
+        },
+        "certificate": {
+          "$ref": "#/definitions/CertificateInformation",
+          "description": "Certificate information."
+        }
+      },
+      "required": [
+        "storeName"
+      ],
+      "description": "Certificate configuration which consist of non-trusted intermediates and root certificates."
+    },
+    "HostnameConfiguration": {
+      "properties": {
+        "type": {
+          "type": "string",
+          "description": "Hostname type.",
+          "enum": [
+            "Proxy",
+            "Portal",
+            "Management",
+            "Scm",
+            "DeveloperPortal"
+          ],
+          "x-ms-enum": {
+            "name": "HostnameType",
+            "modelAsString": true
+          }
+        },
+        "hostName": {
+          "type": "string",
+          "description": "Hostname to configure on the Api Management service."
+        },
+        "keyVaultId": {
+          "type": "string",
+          "description": "Url to the KeyVault Secret containing the Ssl Certificate. If absolute Url containing version is provided, auto-update of ssl certificate will not work. This requires Api Management service to be configured with MSI. The secret should be of type *application/x-pkcs12*"
+        },
+        "encodedCertificate": {
+          "type": "string",
+          "description": "Base64 Encoded certificate."
+        },
+        "certificatePassword": {
+          "type": "string",
+          "description": "Certificate Password."
+        },
+        "defaultSslBinding": {
+          "type": "boolean",
+          "description": "Specify true to setup the certificate associated with this Hostname as the Default SSL Certificate. If a client does not send the SNI header, then this will be the certificate that will be challenged. The property is useful if a service has multiple custom hostname enabled and it needs to decide on the default ssl certificate. The setting only applied to Proxy Hostname Type.",
+          "default": false
+        },
+        "negotiateClientCertificate": {
+          "type": "boolean",
+          "description": "Specify true to always negotiate client certificate on the hostname. Default Value is false.",
+          "default": false
+        },
+        "certificate": {
+          "$ref": "#/definitions/CertificateInformation",
+          "description": "Certificate information."
+        }
+      },
+      "required": [
+        "type",
+        "hostName"
+      ],
+      "description": "Custom hostname configuration."
+    },
+    "VirtualNetworkConfiguration": {
+      "properties": {
+        "vnetid": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The virtual network ID. This is typically a GUID. Expect a null GUID by default."
+        },
+        "subnetname": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The name of the subnet."
+        },
+        "subnetResourceId": {
+          "type": "string",
+          "pattern": "^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$",
+          "description": "The full resource ID of a subnet in a virtual network to deploy the API Management service in."
+        }
+      },
+      "description": "Configuration of a virtual network to which API Management service is deployed."
+    },
+    "AdditionalLocation": {
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "The location name of the additional region among Azure Data center regions."
+        },
+        "sku": {
+          "$ref": "#/definitions/ApiManagementServiceSkuProperties",
+          "description": "SKU properties of the API Management service."
+        },
+        "publicIPAddresses": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "readOnly": true,
+          "description": "Public Static Load Balanced IP addresses of the API Management service in the additional location. Available only for Basic, Standard and Premium SKU."
+        },
+        "privateIPAddresses": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "readOnly": true,
+          "description": "Private Static Load Balanced IP addresses of the API Management service which is deployed in an Internal Virtual Network in a particular additional location. Available only for Basic, Standard and Premium SKU."
+        },
+        "virtualNetworkConfiguration": {
+          "$ref": "#/definitions/VirtualNetworkConfiguration",
+          "description": "Virtual network configuration for the location."
+        },
+        "gatewayRegionalUrl": {
+          "type": "string",
+          "description": "Gateway URL of the API Management service in the Region.",
+          "readOnly": true
+        },
+        "disableGateway": {
+          "type": "boolean",
+          "description": "Property only valid for an Api Management service deployed in multiple locations. This can be used to disable the gateway in this additional location.",
+          "default": false
+        }
+      },
+      "required": [
+        "location",
+        "sku"
+      ],
+      "description": "Description of an additional API Management resource location."
+    },
+    "ApiManagementServiceBackupRestoreParameters": {
+      "properties": {
+        "storageAccount": {
+          "type": "string",
+          "description": "Azure Cloud Storage account (used to place/retrieve the backup) name."
+        },
+        "accessKey": {
+          "type": "string",
+          "description": "Azure Cloud Storage account (used to place/retrieve the backup) access key."
+        },
+        "containerName": {
+          "type": "string",
+          "description": "Azure Cloud Storage blob container name used to place/retrieve the backup."
+        },
+        "backupName": {
+          "type": "string",
+          "description": "The name of the backup file to create."
+        }
+      },
+      "required": [
+        "storageAccount",
+        "accessKey",
+        "containerName",
+        "backupName"
+      ],
+      "description": "Parameters supplied to the Backup/Restore of an API Management service operation."
+    },
+    "ApiManagementServiceProperties": {
+      "properties": {
+        "publisherEmail": {
+          "type": "string",
+          "description": "Publisher email.",
+          "maxLength": 100
+        },
+        "publisherName": {
+          "type": "string",
+          "description": "Publisher name.",
+          "maxLength": 100
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApiManagementServiceBaseProperties"
+        }
+      ],
+      "required": [
+        "publisherEmail",
+        "publisherName"
+      ],
+      "description": "Properties of an API Management service resource description."
+    },
+    "ApiManagementServiceUpdateProperties": {
+      "properties": {
+        "publisherEmail": {
+          "type": "string",
+          "description": "Publisher email.",
+          "maxLength": 100
+        },
+        "publisherName": {
+          "type": "string",
+          "description": "Publisher name.",
+          "maxLength": 100
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApiManagementServiceBaseProperties"
+        }
+      ],
+      "description": "Properties of an API Management service resource description."
+    },
+    "ApiManagementServiceBaseProperties": {
+      "properties": {
+        "notificationSenderEmail": {
+          "type": "string",
+          "description": "Email address from which the notification will be sent.",
+          "maxLength": 100
+        },
+        "provisioningState": {
+          "type": "string",
+          "description": "The current provisioning state of the API Management service which can be one of the following: Created/Activating/Succeeded/Updating/Failed/Stopped/Terminating/TerminationFailed/Deleted.",
+          "readOnly": true
+        },
+        "targetProvisioningState": {
+          "type": "string",
+          "description": "The provisioning state of the API Management service, which is targeted by the long running operation started on the service.",
+          "readOnly": true
+        },
+        "createdAtUtc": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Creation UTC date of the API Management service.The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard.",
+          "readOnly": true
+        },
+        "gatewayUrl": {
+          "type": "string",
+          "description": "Gateway URL of the API Management service.",
+          "readOnly": true
+        },
+        "gatewayRegionalUrl": {
+          "type": "string",
+          "description": "Gateway URL of the API Management service in the Default Region.",
+          "readOnly": true
+        },
+        "portalUrl": {
+          "type": "string",
+          "description": "Publisher portal endpoint Url of the API Management service.",
+          "readOnly": true
+        },
+        "managementApiUrl": {
+          "type": "string",
+          "description": "Management API endpoint URL of the API Management service.",
+          "readOnly": true
+        },
+        "scmUrl": {
+          "type": "string",
+          "description": "SCM endpoint URL of the API Management service.",
+          "readOnly": true
+        },
+        "developerPortalUrl": {
+          "type": "string",
+          "description": "DEveloper Portal endpoint URL of the API Management service.",
+          "readOnly": true
+        },
+        "hostnameConfigurations": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/HostnameConfiguration"
+          },
+          "description": "Custom hostname configuration of the API Management service."
+        },
+        "publicIPAddresses": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "readOnly": true,
+          "description": "Public Static Load Balanced IP addresses of the API Management service in Primary region. Available only for Basic, Standard and Premium SKU."
+        },
+        "privateIPAddresses": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "readOnly": true,
+          "description": "Private Static Load Balanced IP addresses of the API Management service in Primary region which is deployed in an Internal Virtual Network. Available only for Basic, Standard and Premium SKU."
+        },
+        "virtualNetworkConfiguration": {
+          "$ref": "#/definitions/VirtualNetworkConfiguration",
+          "description": "Virtual network configuration of the API Management service."
+        },
+        "additionalLocations": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/AdditionalLocation"
+          },
+          "description": "Additional datacenter locations of the API Management service."
+        },
+        "customProperties": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Custom properties of the API Management service.</br>Setting `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168` will disable the cipher TLS_RSA_WITH_3DES_EDE_CBC_SHA for all TLS(1.0, 1.1 and 1.2).</br>Setting `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11` can be used to disable just TLS 1.1.</br>Setting `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10` can be used to disable TLS 1.0 on an API Management service.</br>Setting `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11` can be used to disable just TLS 1.1 for communications with backends.</br>Setting `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10` can be used to disable TLS 1.0 for communications with backends.</br>Setting `Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2` can be used to enable HTTP2 protocol on an API Management service.</br>Not specifying any of these properties on PATCH operation will reset omitted properties' values to their defaults. For all the settings except Http2 the default value is `True` if the service was created on or before April 1st 2018 and `False` otherwise. Http2 setting's default value is `False`.</br></br>You can disable any of next ciphers by using settings `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.[cipher_name]`: TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA, TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA, TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA, TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA, TLS_RSA_WITH_AES_128_GCM_SHA256, TLS_RSA_WITH_AES_256_CBC_SHA256, TLS_RSA_WITH_AES_128_CBC_SHA256, TLS_RSA_WITH_AES_256_CBC_SHA, TLS_RSA_WITH_AES_128_CBC_SHA. For example, `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_RSA_WITH_AES_128_CBC_SHA256`:`false`. The default value is `true` for them.  Note: next ciphers can't be disabled since they are required by Azure CloudService internal components: TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384,TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256,TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256,TLS_RSA_WITH_AES_256_GCM_SHA384"
+        },
+        "certificates": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/CertificateConfiguration"
+          },
+          "description": "List of Certificates that need to be installed in the API Management service. Max supported certificates that can be installed is 10."
+        },
+        "enableClientCertificate": {
+          "type": "boolean",
+          "description": "Property only meant to be used for Consumption SKU Service. This enforces a client certificate to be presented on each request to the gateway. This also enables the ability to authenticate the certificate in the policy on the gateway.",
+          "default": false
+        },
+        "disableGateway": {
+          "type": "boolean",
+          "description": "Property only valid for an Api Management service deployed in multiple locations. This can be used to disable the gateway in master region.",
+          "default": false
+        },
+        "virtualNetworkType": {
+          "type": "string",
+          "description": "The type of VPN in which API Management service needs to be configured in. None (Default Value) means the API Management service is not part of any Virtual Network, External means the API Management deployment is set up inside a Virtual Network having an Internet Facing Endpoint, and Internal means that API Management deployment is setup inside a Virtual Network having an Intranet Facing Endpoint only.",
+          "default": "None",
+          "enum": [
+            "None",
+            "External",
+            "Internal"
+          ],
+          "x-ms-enum": {
+            "name": "VirtualNetworkType",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "None",
+                "description": "The service is not part of any Virtual Network."
+              },
+              {
+                "value": "External",
+                "description": "The service is part of Virtual Network and it is accessible from Internet."
+              },
+              {
+                "value": "Internal",
+                "description": "The service is part of Virtual Network and it is only accessible from within the virtual network."
+              }
+            ]
+          }
+        },
+        "apiVersionConstraint": {
+          "$ref": "#/definitions/ApiVersionConstraint",
+          "description": "Control Plane Apis version constraint for the API Management service."
+        }
+      },
+      "description": "Base Properties of an API Management service resource description."
+    },
+    "ApiVersionConstraint": {
+      "properties": {
+        "minApiVersion": {
+          "type": "string",
+          "description": "Limit control plane API calls to API Management service with version equal to or newer than this value.",
+          "example": "2019-01-01"
+        }
+      },
+      "description": "Control Plane Apis version constraint for the API Management service."
+    },
+    "ApiManagementServiceSkuProperties": {
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Name of the Sku.",
+          "externalDocs": {
+            "url": "https://azure.microsoft.com/en-us/pricing/details/api-management/"
+          },
+          "enum": [
+            "Developer",
+            "Standard",
+            "Premium",
+            "Basic",
+            "Consumption"
+          ],
+          "x-ms-enum": {
+            "name": "SkuType",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "Developer",
+                "description": "Developer SKU of Api Management."
+              },
+              {
+                "value": "Standard",
+                "description": "Standard SKU of Api Management."
+              },
+              {
+                "value": "Premium",
+                "description": "Premium SKU of Api Management."
+              },
+              {
+                "value": "Basic",
+                "description": "Basic SKU of Api Management."
+              },
+              {
+                "value": "Consumption",
+                "description": "Consumption SKU of Api Management."
+              }
+            ]
+          }
+        },
+        "capacity": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Capacity of the SKU (number of deployed units of the SKU). For Consumption SKU capacity must be specified as 0."
+        }
+      },
+      "required": [
+        "name",
+        "capacity"
+      ],
+      "description": "API Management service resource SKU properties."
+    },
+    "ApiManagementServiceResource": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ApiManagementServiceProperties",
+          "description": "Properties of the API Management service."
+        },
+        "sku": {
+          "$ref": "#/definitions/ApiManagementServiceSkuProperties",
+          "description": "SKU properties of the API Management service."
+        },
+        "identity": {
+          "$ref": "#/definitions/ApiManagementServiceIdentity",
+          "description": "Managed service identity of the Api Management service."
+        },
+        "location": {
+          "type": "string",
+          "description": "Resource location.",
+          "x-ms-mutability": [
+            "read",
+            "create"
+          ]
+        },
+        "etag": {
+          "type": "string",
+          "description": "ETag of the resource.",
+          "readOnly": true
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApimResource"
+        }
+      ],
+      "required": [
+        "location",
+        "sku",
+        "properties"
+      ],
+      "description": "A single API Management service resource in List or Get response."
+    },
+    "ApimResource": {
+      "description": "The Resource definition.",
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Resource ID."
+        },
+        "name": {
+          "type": "string",
+          "description": "Resource name.",
+          "readOnly": true
+        },
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Resource type for API Management resource is set to Microsoft.ApiManagement."
+        },
+        "tags": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Resource tags."
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "ApiManagementServiceUpdateParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ApiManagementServiceUpdateProperties",
+          "description": "Properties of the API Management service."
+        },
+        "sku": {
+          "$ref": "#/definitions/ApiManagementServiceSkuProperties",
+          "description": "SKU properties of the API Management service."
+        },
+        "identity": {
+          "$ref": "#/definitions/ApiManagementServiceIdentity",
+          "description": "Managed service identity of the Api Management service."
+        },
+        "etag": {
+          "type": "string",
+          "description": "ETag of the resource.",
+          "readOnly": true
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApimResource"
+        }
+      ],
+      "description": "Parameter supplied to Update Api Management Service."
+    },
+    "ApiManagementServiceListResult": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ApiManagementServiceResource"
+          },
+          "description": "Result of the List API Management services operation."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Link to the next set of results. Not empty if Value contains incomplete list of API Management services."
+        }
+      },
+      "required": [
+        "value"
+      ],
+      "description": "The response of the List API Management services operation."
+    },
+    "ApiManagementServiceGetSsoTokenResult": {
+      "properties": {
+        "redirectUri": {
+          "type": "string",
+          "description": "Redirect URL to the Publisher Portal containing the SSO token."
+        }
+      },
+      "description": "The response of the GetSsoToken operation."
+    },
+    "ApiManagementServiceCheckNameAvailabilityParameters": {
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The name to check for availability."
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "description": "Parameters supplied to the CheckNameAvailability operation."
+    },
+    "ApiManagementServiceNameAvailabilityResult": {
+      "properties": {
+        "nameAvailable": {
+          "type": "boolean",
+          "description": "True if the name is available and can be used to create a new API Management service; otherwise false.",
+          "readOnly": true
+        },
+        "message": {
+          "type": "string",
+          "description": "If reason == invalid, provide the user with the reason why the given name is invalid, and provide the resource naming requirements so that the user can select a valid name. If reason == AlreadyExists, explain that <resourceName> is already in use, and direct them to select a different name.",
+          "readOnly": true
+        },
+        "reason": {
+          "type": "string",
+          "description": "Invalid indicates the name provided does not match the resource provider’s naming requirements (incorrect length, unsupported characters, etc.)  AlreadyExists indicates that the name is already in use and is therefore unavailable.",
+          "enum": [
+            "Valid",
+            "Invalid",
+            "AlreadyExists"
+          ],
+          "x-ms-enum": {
+            "name": "NameAvailabilityReason",
+            "modelAsString": false
+          }
+        }
+      },
+      "description": "Response of the CheckNameAvailability operation."
+    },
+    "ApiManagementServiceApplyNetworkConfigurationParameters": {
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "Location of the Api Management service to update for a multi-region service. For a service deployed in a single region, this parameter is not required."
+        }
+      },
+      "description": "Parameter supplied to the Apply Network configuration operation."
+    },
+    "ApiManagementServiceIdentity": {
+      "description": "Identity properties of the Api Management service resource.",
+      "properties": {
+        "type": {
+          "type": "string",
+          "description": "The type of identity used for the resource. The type 'SystemAssigned, UserAssigned' includes both an implicitly created identity and a set of user assigned identities. The type 'None' will remove any identities from the service.",
+          "enum": [
+            "SystemAssigned",
+            "UserAssigned",
+            "SystemAssigned, UserAssigned",
+            "None"
+          ],
+          "x-ms-enum": {
+            "name": "ApimIdentityType",
+            "modelAsString": true
+          }
+        },
+        "principalId": {
+          "type": "string",
+          "format": "uuid",
+          "readOnly": true,
+          "description": "The principal id of the identity."
+        },
+        "tenantId": {
+          "type": "string",
+          "format": "uuid",
+          "readOnly": true,
+          "description": "The client tenant id of the identity."
+        },
+        "userAssignedIdentities": {
+          "description": "The list of user identities associated with the resource. The user identity \r\ndictionary key references will be ARM resource ids in the form: \r\n'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/\r\n    providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.",
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/UserIdentityProperties"
+          }
+        }
+      },
+      "required": [
+        "type"
+      ]
+    },
+    "UserIdentityProperties": {
+      "type": "object",
+      "properties": {
+        "principalId": {
+          "description": "The principal id of user assigned identity.",
+          "type": "string"
+        },
+        "clientId": {
+          "description": "The client id of user assigned identity.",
+          "type": "string"
+        }
+      }
+    },
+    "Operation": {
+      "description": "REST API operation",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "Operation name: {provider}/{resource}/{operation}",
+          "type": "string"
+        },
+        "display": {
+          "description": "The object that describes the operation.",
+          "properties": {
+            "provider": {
+              "description": "Friendly name of the resource provider",
+              "type": "string"
+            },
+            "operation": {
+              "description": "Operation type: read, write, delete, listKeys/action, etc.",
+              "type": "string"
+            },
+            "resource": {
+              "description": "Resource type on which the operation is performed.",
+              "type": "string"
+            },
+            "description": {
+              "description": "Friendly name of the operation",
+              "type": "string"
+            }
+          }
+        },
+        "origin": {
+          "type": "string",
+          "description": "The operation origin."
+        },
+        "properties": {
+          "type": "object",
+          "x-ms-client-flatten": true,
+          "description": "The operation properties."
+        }
+      }
+    },
+    "OperationListResult": {
+      "description": "Result of the request to list REST API operations. It contains a list of operations and a URL nextLink to get the next set of results.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Operation"
+          },
+          "description": "List of operations supported by the resource provider."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of operation list results if there are any."
+        }
+      }
+    }
+  },
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimdiagnostics.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimdiagnostics.json
new file mode 100644
index 000000000000..6cb67423b422
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimdiagnostics.json
@@ -0,0 +1,367 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on Diagnostic entity associated with your Azure API Management deployment. Diagnostics are used to log requests/responses in the APIM proxy.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics": {
+      "get": {
+        "tags": [
+          "Diagnostic"
+        ],
+        "operationId": "Diagnostic_ListByService",
+        "description": "Lists all diagnostics of the API Management service instance.",
+        "x-ms-examples": {
+          "ApiManagementListDiagnostics": {
+            "$ref": "./examples/ApiManagementListDiagnostics.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Paged Result response of diagnostics.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/DiagnosticCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/DiagnosticContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId}": {
+      "head": {
+        "tags": [
+          "Diagnostic"
+        ],
+        "operationId": "Diagnostic_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the Diagnostic specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadDiagnostic": {
+            "$ref": "./examples/ApiManagementHeadDiagnostic.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/DiagnosticIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Gets the entity tag of the diagnostic",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "Diagnostic"
+        ],
+        "operationId": "Diagnostic_Get",
+        "description": "Gets the details of the Diagnostic specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetDiagnostic": {
+            "$ref": "./examples/ApiManagementGetDiagnostic.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/DiagnosticIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified Diagnostic entity.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/DiagnosticContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Diagnostic"
+        ],
+        "operationId": "Diagnostic_CreateOrUpdate",
+        "description": "Creates a new Diagnostic or updates an existing one.",
+        "x-ms-examples": {
+          "ApiManagementCreateDiagnostic": {
+            "$ref": "./examples/ApiManagementCreateDiagnostic.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/DiagnosticIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/DiagnosticContract"
+            },
+            "description": "Create parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Diagnostic was successfully created.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/DiagnosticContract"
+            }
+          },
+          "200": {
+            "description": "Diagnostic successfully updated",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/DiagnosticContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "Diagnostic"
+        ],
+        "operationId": "Diagnostic_Update",
+        "description": "Updates the details of the Diagnostic specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementUpdateDiagnostic": {
+            "$ref": "./examples/ApiManagementUpdateDiagnostic.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/DiagnosticIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/DiagnosticContract"
+            },
+            "description": "Diagnostic Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The Diagnostic was successfully updated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Diagnostic"
+        ],
+        "operationId": "Diagnostic_Delete",
+        "description": "Deletes the specified Diagnostic.",
+        "x-ms-examples": {
+          "ApiManagementDeleteDiagnostic": {
+            "$ref": "./examples/ApiManagementDeleteDiagnostic.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/DiagnosticIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The Diagnostic was successfully deleted."
+          },
+          "204": {
+            "description": "The Diagnostic was successfully deleted."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimemailtemplates.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimemailtemplates.json
new file mode 100644
index 000000000000..143854511ac8
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimemailtemplates.json
@@ -0,0 +1,354 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on Email Templates associated with your Azure API Management deployment.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/templates": {
+      "get": {
+        "tags": [
+          "EmailTemplate"
+        ],
+        "operationId": "EmailTemplate_ListByService",
+        "description": "Lists a collection of properties defined within a service instance.",
+        "x-ms-examples": {
+          "ApiManagementListEmailTemplates": {
+            "$ref": "./examples/ApiManagementListEmailTemplates.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A Collection of the Email Template for the specified API Management service instance.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/EmailTemplateCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/templates/{templateName}": {
+      "head": {
+        "tags": [
+          "EmailTemplates"
+        ],
+        "operationId": "EmailTemplate_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the email template specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadEmailTemplate": {
+            "$ref": "./examples/ApiManagementHeadEmailTemplate.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TemplateNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified email template entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "EmailTemplates"
+        ],
+        "operationId": "EmailTemplate_Get",
+        "description": "Gets the details of the email template specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetEmailTemplate": {
+            "$ref": "./examples/ApiManagementGetEmailTemplate.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TemplateNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified Email template.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/EmailTemplateContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "EmailTemplates"
+        ],
+        "operationId": "EmailTemplate_CreateOrUpdate",
+        "description": "Updates an Email Template.",
+        "x-ms-examples": {
+          "ApiManagementCreateEmailTemplate": {
+            "$ref": "./examples/ApiManagementCreateEmailTemplate.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TemplateNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/EmailTemplateUpdateParameters"
+            },
+            "description": "Email Template update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Email Template was successfully updated.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/EmailTemplateContract"
+            }
+          },
+          "200": {
+            "description": "Email Template was successfully updated.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/EmailTemplateContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "EmailTemplates"
+        ],
+        "operationId": "EmailTemplate_Update",
+        "description": "Updates the specific Email Template.",
+        "x-ms-examples": {
+          "ApiManagementUpdateEmailTemplate": {
+            "$ref": "./examples/ApiManagementUpdateEmailTemplate.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TemplateNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/EmailTemplateUpdateParameters"
+            },
+            "description": "Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Email Template was successfully updated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "EmailTemplates"
+        ],
+        "operationId": "EmailTemplate_Delete",
+        "description": "Reset the Email Template to default template provided by the API Management service instance.",
+        "x-ms-examples": {
+          "ApiManagementDeleteEmailTemplate": {
+            "$ref": "./examples/ApiManagementDeleteEmailTemplate.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TemplateNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Email Template was successfully reset to default."
+          },
+          "204": {
+            "description": "Email Template was successfully reset to default."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimgateways.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimgateways.json
new file mode 100644
index 000000000000..a89f6dbfecf2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimgateways.json
@@ -0,0 +1,997 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on Gateway entity in Azure API Management deployment.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways": {
+      "get": {
+        "tags": [
+          "Gateway"
+        ],
+        "operationId": "Gateway_ListByService",
+        "description": "Lists a collection of gateways registered with service instance.",
+        "x-ms-examples": {
+          "ApiManagementListGateways": {
+            "$ref": "./examples/ApiManagementListGateways.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of Gateway entities.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GatewayCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/{gatewayId}": {
+      "head": {
+        "tags": [
+          "Gateway"
+        ],
+        "operationId": "Gateway_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the Gateway specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadGateway": {
+            "$ref": "./examples/ApiManagementHeadGateway.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GatewayIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified Gateway entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "Gateway"
+        ],
+        "operationId": "Gateway_Get",
+        "description": "Gets the details of the Gateway specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetGateway": {
+            "$ref": "./examples/ApiManagementGetGateway.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GatewayIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified Gateway entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GatewayContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Gateway"
+        ],
+        "operationId": "Gateway_CreateOrUpdate",
+        "description": "Creates or updates a Gateway to be used in Api Management instance.",
+        "x-ms-examples": {
+          "ApiManagementCreateGateway": {
+            "$ref": "./examples/ApiManagementCreateGateway.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GatewayIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GatewayContract"
+            }
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "The new Gateway was successfully added.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GatewayContract"
+            }
+          },
+          "200": {
+            "description": "The Gateway details were successfully updated.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GatewayContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "Gateway"
+        ],
+        "operationId": "Gateway_Update",
+        "description": "Updates the details of the gateway specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementUpdateGateway": {
+            "$ref": "./examples/ApiManagementUpdateGateway.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GatewayIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GatewayContract"
+            }
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The gateway details were successfully updated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Gateway"
+        ],
+        "operationId": "Gateway_Delete",
+        "description": "Deletes specific Gateway.",
+        "x-ms-examples": {
+          "ApiManagementDeleteGateway": {
+            "$ref": "./examples/ApiManagementDeleteGateway.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GatewayIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The Gateway was successfully deleted."
+          },
+          "204": {
+            "description": "The Gateway was successfully deleted."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/{gatewayId}/listKeys": {
+      "post": {
+        "tags": [
+          "GatewayListKeys"
+        ],
+        "operationId": "Gateway_ListKeys",
+        "description": "Retrieves gateway keys.",
+        "x-ms-examples": {
+          "ApiManagementGatewayKeys": {
+            "$ref": "./examples/ApiManagementGatewayListKeys.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GatewayIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified Gateway keys.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GatewayKeysContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/{gatewayId}/regenerateKey": {
+      "post": {
+        "tags": [
+          "GatewayRegenerateKey"
+        ],
+        "operationId": "Gateway_RegenerateKey",
+        "description": "Regenerates specified gateway key invalidating any tokens created with it.",
+        "x-ms-examples": {
+          "ApiManagementGatewayRegeneratePrimaryKey": {
+            "$ref": "./examples/ApiManagementGatewayRegenerateKey.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GatewayIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GatewayKeyRegenerationRequestContract"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Key successfully regenerated"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/{gatewayId}/generateToken": {
+      "post": {
+        "tags": [
+          "GatewayGenerateToken"
+        ],
+        "operationId": "Gateway_GenerateToken",
+        "description": "Gets the Shared Access Authorization Token for the gateway.",
+        "x-ms-examples": {
+          "ApiManagementGatewayToken": {
+            "$ref": "./examples/ApiManagementGatewayGenerateToken.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GatewayIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GatewayTokenRequestContract"
+            }
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the authorization token for the gateway.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GatewayTokenContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/{gatewayId}/hostnameConfigurations": {
+      "get": {
+        "tags": [
+          "GatewayHostnameConfiguration"
+        ],
+        "operationId": "GatewayHostnameConfiguration_ListByService",
+        "description": "Lists the collection of hostname configurations for the specified gateway.",
+        "x-ms-examples": {
+          "ApiManagementListGatewayHostnameConfigurations": {
+            "$ref": "./examples/ApiManagementListGatewayHostnameConfigurations.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GatewayIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Collection of hostname configuration entities.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GatewayHostnameConfigurationCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/{gatewayId}/hostnameConfigurations/{hcId}": {
+      "head": {
+        "tags": [
+          "GatewayHostnameConfiguration"
+        ],
+        "operationId": "GatewayHostnameConfiguration_GetEntityTag",
+        "description": "Checks that hostname configuration entity specified by identifier exists for specified Gateway entity.",
+        "x-ms-examples": {
+          "ApiManagementHeadGatewayHostnameConfiguration": {
+            "$ref": "./examples/ApiManagementHeadGatewayHostnameConfiguration.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GatewayIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GatewayHostnameConfigurationIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified Gateway entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "GatewayHostnameConfiguration"
+        ],
+        "operationId": "GatewayHostnameConfiguration_Get",
+        "description": "Gets the details of the Gateway hostname configuration specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetGateway": {
+            "$ref": "./examples/ApiManagementGetGatewayHostnameConfiguration.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GatewayIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GatewayHostnameConfigurationIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified Gateway entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GatewayHostnameConfigurationContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "GatewayHostnameConfiguration"
+        ],
+        "operationId": "GatewayHostnameConfiguration_CreateOrUpdate",
+        "description": "Creates of updates hostname configuration for a Gateway.",
+        "x-ms-examples": {
+          "ApiManagementCreateGatewayHostnameConfiguration": {
+            "$ref": "./examples/ApiManagementCreateGatewayHostnameConfiguration.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GatewayIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GatewayHostnameConfigurationIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GatewayHostnameConfigurationContract"
+            }
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "The new Gateway hostname configuration was successfully created.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GatewayHostnameConfigurationContract"
+            }
+          },
+          "200": {
+            "description": "The Gateway hostname configuration details were successfully updated.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GatewayHostnameConfigurationContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "GatewayHostnameConfiguration"
+        ],
+        "operationId": "GatewayHostnameConfiguration_Delete",
+        "description": "Deletes the specified hostname configuration from the specified Gateway.",
+        "x-ms-examples": {
+          "ApiManagementDeleteGatewayHostnameConfiguration": {
+            "$ref": "./examples/ApiManagementDeleteGatewayHostnameConfiguration.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GatewayIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GatewayHostnameConfigurationIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Hostname configuration was successfully removed from Gateway"
+          },
+          "204": {
+            "description": "Hostname configuration successfully removed by previous request or does not exist in Gateway"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/{gatewayId}/apis": {
+      "get": {
+        "tags": [
+          "GatewayApi"
+        ],
+        "operationId": "GatewayApi_ListByService",
+        "description": "Lists a collection of the APIs associated with a gateway.",
+        "x-ms-examples": {
+          "ApiManagementListGatewayApis": {
+            "$ref": "./examples/ApiManagementListGatewayApis.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GatewayIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains a collection of Api entities in the gateway.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/{gatewayId}/apis/{apiId}": {
+      "head": {
+        "tags": [
+          "GatewayApi"
+        ],
+        "operationId": "GatewayApi_GetEntityTag",
+        "description": "Checks that API entity specified by identifier is associated with the Gateway entity.",
+        "x-ms-examples": {
+          "ApiManagementHeadGatewayApi": {
+            "$ref": "./examples/ApiManagementHeadGatewayApi.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GatewayIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified Gateway entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "GatewayApi"
+        ],
+        "operationId": "GatewayApi_CreateOrUpdate",
+        "description": "Adds an API to the specified Gateway.",
+        "x-ms-examples": {
+          "ApiManagementCreateGatewayApi": {
+            "$ref": "./examples/ApiManagementCreateGatewayApi.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GatewayIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": false,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/AssociationContract"
+            }
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "The API was successfully added to the Gateway.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiContract"
+            }
+          },
+          "200": {
+            "description": "The specified API is already added to the Gateway.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "GatewayApi"
+        ],
+        "operationId": "GatewayApi_Delete",
+        "description": "Deletes the specified API from the specified Gateway.",
+        "x-ms-examples": {
+          "ApiManagementDeleteGatewayApi": {
+            "$ref": "./examples/ApiManagementDeleteGatewayApi.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GatewayIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "API was successfully removed from Gateway"
+          },
+          "204": {
+            "description": "API successfully removed by previous request or does not exist in Gateway"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimgroups.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimgroups.json
new file mode 100644
index 000000000000..94be1d63a606
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimgroups.json
@@ -0,0 +1,581 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on Group entity in your Azure API Management deployment. Groups are used to manage the visibility of products to developers. Each API Management service instance comes with the following immutable system groups whose membership is automatically managed by API Management.  - **Administrators** - Azure subscription administrators are members of this group. - **Developers** - Authenticated developer portal users fall into this group. - **Guests** - Unauthenticated developer portal users are placed into this group. In addition to these system groups, administrators can create custom groups or [leverage external groups in associated Azure Active Directory tenants](https://docs.microsoft.com/en-us/azure/api-management/api-management-howto-aad#how-to-add-an-external-azure-active-directory-group). Custom and external groups can be used alongside system groups in giving developers visibility and access to API products. For example, you could create one custom group for developers affiliated with a specific partner organization and allow them access to the APIs from a product containing relevant APIs only. A user can be a member of more than one group.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups": {
+      "get": {
+        "tags": [
+          "Group"
+        ],
+        "operationId": "Group_ListByService",
+        "description": "Lists a collection of groups defined within a service instance.",
+        "externalDocs": {
+          "url": "https://docs.microsoft.com/en-us/azure/api-management/api-management-howto-create-groups"
+        },
+        "x-ms-examples": {
+          "ApiManagementListGroups": {
+            "$ref": "./examples/ApiManagementListGroups.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| description | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| aadObjectId | filter | eq |     | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of Group entities.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GroupCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/GroupContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}": {
+      "head": {
+        "tags": [
+          "Group"
+        ],
+        "operationId": "Group_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the group specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadGroup": {
+            "$ref": "./examples/ApiManagementHeadGroup.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GroupIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified group entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "Group"
+        ],
+        "operationId": "Group_Get",
+        "description": "Gets the details of the group specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetGroup": {
+            "$ref": "./examples/ApiManagementGetGroup.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GroupIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified Group entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GroupContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Group"
+        ],
+        "operationId": "Group_CreateOrUpdate",
+        "description": "Creates or Updates a group.",
+        "x-ms-examples": {
+          "ApiManagementCreateGroup": {
+            "$ref": "./examples/ApiManagementCreateGroup.json"
+          },
+          "ApiManagementCreateGroupExternal": {
+            "$ref": "./examples/ApiManagementCreateGroupExternal.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GroupIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GroupCreateParameters"
+            },
+            "description": "Create parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Group was created successfully.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GroupContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "200": {
+            "description": "Group already exists.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GroupContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "Group"
+        ],
+        "operationId": "Group_Update",
+        "description": "Updates the details of the group specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementUpdateGroup": {
+            "$ref": "./examples/ApiManagementUpdateGroup.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GroupIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GroupUpdateParameters"
+            },
+            "description": "Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The group details were successfully updated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Group"
+        ],
+        "operationId": "Group_Delete",
+        "description": "Deletes specific group of the API Management service instance.",
+        "x-ms-examples": {
+          "ApiManagementDeleteGroup": {
+            "$ref": "./examples/ApiManagementDeleteGroup.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GroupIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The group was successfully deleted."
+          },
+          "204": {
+            "description": "The group was successfully deleted."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}/users": {
+      "get": {
+        "tags": [
+          "GroupUser"
+        ],
+        "operationId": "GroupUser_List",
+        "description": "Lists a collection of user entities associated with the group.",
+        "x-ms-examples": {
+          "ApiManagementListGroupUsers": {
+            "$ref": "./examples/ApiManagementListGroupUsers.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GroupIdParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| firstName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| lastName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| email | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| registrationDate | filter | ge, le, eq, ne, gt, lt |     | </br>| note | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of user entities associated with the group.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/UserCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/UserContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}/users/{userId}": {
+      "head": {
+        "tags": [
+          "GroupUser"
+        ],
+        "operationId": "GroupUser_CheckEntityExists",
+        "description": "Checks that user entity specified by identifier is associated with the group entity.",
+        "x-ms-examples": {
+          "ApiManagementHeadGroupUser": {
+            "$ref": "./examples/ApiManagementHeadGroupUser.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GroupIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/UserIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Entity exists"
+          },
+          "404": {
+            "description": "Entity does not exists."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "GroupUser"
+        ],
+        "operationId": "GroupUser_Create",
+        "description": "Add existing user to existing group",
+        "x-ms-examples": {
+          "ApiManagementCreateGroupUser": {
+            "$ref": "./examples/ApiManagementCreateGroupUser.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GroupIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/UserIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "The user was successfully added to the group.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/UserContract"
+            }
+          },
+          "200": {
+            "description": "The specified user is already a member of the specified group.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/UserContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "GroupUser"
+        ],
+        "operationId": "GroupUser_Delete",
+        "description": "Remove existing user from existing group.",
+        "x-ms-examples": {
+          "ApiManagementDeleteGroupUser": {
+            "$ref": "./examples/ApiManagementDeleteGroupUser.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GroupIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/UserIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The user was successfully removed from the group."
+          },
+          "204": {
+            "description": "The user was successfully removed from the group."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimidentityprovider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimidentityprovider.json
new file mode 100644
index 000000000000..5ab15241ebec
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimidentityprovider.json
@@ -0,0 +1,401 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on Identity Provider entity associated with your Azure API Management deployment. Setting up an external Identity Provider for authentication can help you manage the developer portal logins using the OAuth2 flow.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/identityProviders": {
+      "get": {
+        "tags": [
+          "IdentityProvider"
+        ],
+        "operationId": "IdentityProvider_ListByService",
+        "description": "Lists a collection of Identity Provider configured in the specified service instance.",
+        "externalDocs": {
+          "url": "https://docs.microsoft.com/en-us/azure/api-management/api-management-howto-aad#how-to-authorize-developer-accounts-using-azure-active-directory"
+        },
+        "x-ms-examples": {
+          "ApiManagementListIdentityProviders": {
+            "$ref": "./examples/ApiManagementListIdentityProviders.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of Identity Providers.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IdentityProviderList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/identityProviders/{identityProviderName}": {
+      "head": {
+        "tags": [
+          "IdentityProvider"
+        ],
+        "operationId": "IdentityProvider_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the identityProvider specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadIdentityProvider": {
+            "$ref": "./examples/ApiManagementHeadIdentityProvider.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IdentityProviderNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified identity provider entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "IdentityProvider"
+        ],
+        "operationId": "IdentityProvider_Get",
+        "description": "Gets the configuration details of the identity Provider configured in specified service instance.",
+        "x-ms-examples": {
+          "ApiManagementGetIdentityProvider": {
+            "$ref": "./examples/ApiManagementGetIdentityProvider.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IdentityProviderNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified IdentityProvider entity configuration details.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IdentityProviderContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "IdentityProvider"
+        ],
+        "operationId": "IdentityProvider_CreateOrUpdate",
+        "description": "Creates or Updates the IdentityProvider configuration.",
+        "x-ms-examples": {
+          "ApiManagementCreateIdentityProvider": {
+            "$ref": "./examples/ApiManagementCreateIdentityProvider.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IdentityProviderNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IdentityProviderCreateContract"
+            },
+            "description": "Create parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "IdentityProvider configuration were successfully created.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IdentityProviderContract"
+            }
+          },
+          "200": {
+            "description": "The existing Identity Provider was successfully updated.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IdentityProviderContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "IdentityProvider"
+        ],
+        "operationId": "IdentityProvider_Update",
+        "description": "Updates an existing IdentityProvider configuration.",
+        "x-ms-examples": {
+          "ApiManagementUpdateIdentityProvider": {
+            "$ref": "./examples/ApiManagementUpdateIdentityProvider.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IdentityProviderNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IdentityProviderUpdateParameters"
+            },
+            "description": "Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The existing identity provider configuration was successfully updated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "IdentityProvider"
+        ],
+        "operationId": "IdentityProvider_Delete",
+        "description": "Deletes the specified identity provider configuration.",
+        "x-ms-examples": {
+          "ApiManagementDeleteIdentityProvider": {
+            "$ref": "./examples/ApiManagementDeleteIdentityProvider.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IdentityProviderNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The identity provider configuration was successfully deleted."
+          },
+          "204": {
+            "description": "The identity provider configuration was successfully deleted."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/identityProviders/{identityProviderName}/listSecrets": {
+      "post": {
+        "tags": [
+          "IdentityProvider"
+        ],
+        "operationId": "IdentityProvider_ListSecrets",
+        "description": "Gets the client secret details of the Identity Provider.",
+        "x-ms-examples": {
+          "ApiManagementListSecretsIdentityProvider": {
+            "$ref": "./examples/ApiManagementListSecretsIdentityProvider.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IdentityProviderNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the client secret.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ClientSecretContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimissues.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimissues.json
new file mode 100644
index 000000000000..d85bf5904ee8
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimissues.json
@@ -0,0 +1,150 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use this REST API to get all the issues across an Azure Api Management service.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/issues": {
+      "get": {
+        "tags": [
+          "Issue"
+        ],
+        "operationId": "Issue_ListByService",
+        "description": "Lists a collection of issues in the specified service instance.",
+        "x-ms-examples": {
+          "ApiManagementListIssues": {
+            "$ref": "./examples/ApiManagementListIssues.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| apiId | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| title | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| description | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| authorName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| state | filter | eq |     | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of Issue entities.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IssueCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/IssueContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/issues/{issueId}": {
+      "get": {
+        "tags": [
+          "Issue"
+        ],
+        "operationId": "Issue_Get",
+        "description": "Gets API Management issue details",
+        "x-ms-examples": {
+          "ApiManagementGetIssue": {
+            "$ref": "./examples/ApiManagementGetIssue.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IssueIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Get the details of the issue.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/IssueContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimloggers.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimloggers.json
new file mode 100644
index 000000000000..b79ba7080322
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimloggers.json
@@ -0,0 +1,380 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on logger entity Azure API Management deployment.The Logger entity in API Management represents an event sink that you can use to log API Management events. Currently the Logger entity supports logging API Management events to Azure EventHub.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/loggers": {
+      "get": {
+        "tags": [
+          "Logger"
+        ],
+        "operationId": "Logger_ListByService",
+        "description": "Lists a collection of loggers in the specified service instance.",
+        "externalDocs": {
+          "url": "https://docs.microsoft.com/en-us/azure/api-management/api-management-howto-log-event-hubs"
+        },
+        "x-ms-examples": {
+          "ApiManagementListLoggers": {
+            "$ref": "./examples/ApiManagementListLoggers.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| description | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| loggerType | filter | eq |     | </br>| resourceId | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of Logger entities.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/LoggerCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/LoggerContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/loggers/{loggerId}": {
+      "head": {
+        "tags": [
+          "Logger"
+        ],
+        "operationId": "Logger_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the logger specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadLogger": {
+            "$ref": "./examples/ApiManagementHeadLogger.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/LoggerIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified logger entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "Logger"
+        ],
+        "operationId": "Logger_Get",
+        "description": "Gets the details of the logger specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetLogger": {
+            "$ref": "./examples/ApiManagementGetLogger.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/LoggerIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified Logger entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/LoggerContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Logger"
+        ],
+        "operationId": "Logger_CreateOrUpdate",
+        "description": "Creates or Updates a logger.",
+        "x-ms-examples": {
+          "ApiManagementCreateEHLogger": {
+            "$ref": "./examples/ApiManagementCreateEHLogger.json"
+          },
+          "ApiManagementCreateAILogger": {
+            "$ref": "./examples/ApiManagementCreateAILogger.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/LoggerIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/LoggerContract"
+            },
+            "description": "Create parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Logger was successfully created.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/LoggerContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "200": {
+            "description": "The existing logger was successfully updated.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/LoggerContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "Logger"
+        ],
+        "operationId": "Logger_Update",
+        "description": "Updates an existing logger.",
+        "x-ms-examples": {
+          "ApiManagementUpdateLogger": {
+            "$ref": "./examples/ApiManagementUpdateLogger.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/LoggerIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/LoggerUpdateContract"
+            },
+            "description": "Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The existing logger was successfully updated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Logger"
+        ],
+        "operationId": "Logger_Delete",
+        "description": "Deletes the specified logger.",
+        "x-ms-examples": {
+          "ApiManagementDeleteLogger": {
+            "$ref": "./examples/ApiManagementDeleteLogger.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/LoggerIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "name": "force",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "description": "Force deletion even if diagnostic is attached."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The logger was successfully deleted."
+          },
+          "204": {
+            "description": "The logger was successfully deleted."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimnamedvalues.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimnamedvalues.json
new file mode 100644
index 000000000000..0127d85f3154
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimnamedvalues.json
@@ -0,0 +1,441 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on NamedValue entity associated with your Azure API Management deployment. API Management policies are a powerful capability of the system that allow the publisher to change the behavior of the API through configuration. Policies are a collection of statements that are executed sequentially on the request or response of an API. Policy statements can be constructed using literal text values, policy expressions, and NamedValues. Each API Management service instance has a NamedValues collection of key/value pairs that are global to the service instance. These NamedValues can be used to manage constant string values across all API configuration and policies.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/namedValues": {
+      "get": {
+        "tags": [
+          "NamedValue"
+        ],
+        "operationId": "NamedValue_ListByService",
+        "description": "Lists a collection of NamedValues defined within a service instance.",
+        "externalDocs": {
+          "url": "https://docs.microsoft.com/en-us/azure/api-management/api-management-howto-properties"
+        },
+        "x-ms-examples": {
+          "ApiManagementListNamedValues": {
+            "$ref": "./examples/ApiManagementListNamedValues.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| tags | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith, any, all | </br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A Collection of the NamedValue entities for the specified API Management service instance.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/NamedValueCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/NamedValueContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/namedValues/{namedValueId}": {
+      "head": {
+        "tags": [
+          "NamedValue"
+        ],
+        "operationId": "NamedValue_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the NamedValue specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadNamedValue": {
+            "$ref": "./examples/ApiManagementHeadNamedValue.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/NamedValueIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified NamedValue entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "NamedValue"
+        ],
+        "operationId": "NamedValue_Get",
+        "description": "Gets the details of the NamedValue specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetNamedValue": {
+            "$ref": "./examples/ApiManagementGetNamedValue.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/NamedValueIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified NamedValue entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/NamedValueContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "NamedValue"
+        ],
+        "operationId": "NamedValue_CreateOrUpdate",
+        "description": "Creates or updates a NamedValue.",
+        "x-ms-examples": {
+          "ApiManagementCreateNamedValue": {
+            "$ref": "./examples/ApiManagementCreateNamedValue.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/NamedValueIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/NamedValueCreateContract"
+            },
+            "description": "Create parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Request to create or update NamedValue was accepted. Location header contains the URL where the status of the long running operation can be checked."
+          },
+          "201": {
+            "description": "NamedValue was successfully created.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/NamedValueContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "200": {
+            "description": "NamedValue was successfully updated.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/NamedValueContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "location"
+        }
+      },
+      "patch": {
+        "tags": [
+          "NamedValue"
+        ],
+        "operationId": "NamedValue_Update",
+        "description": "Updates the specific NamedValue.",
+        "x-ms-examples": {
+          "ApiManagementUpdateNamedValue": {
+            "$ref": "./examples/ApiManagementUpdateNamedValue.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/NamedValueIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/NamedValueUpdateParameters"
+            },
+            "description": "Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Request to update NamedValue was accepted. Location header contains the URL where the status of the long running operation can be checked."
+          },
+          "204": {
+            "description": "NamedValue was successfully updated."
+          },
+          "200": {
+            "description": "NamedValue was successfully updated.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/NamedValueContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "location"
+        }
+      },
+      "delete": {
+        "tags": [
+          "NamedValue"
+        ],
+        "operationId": "NamedValue_Delete",
+        "description": "Deletes specific NamedValue from the API Management service instance.",
+        "x-ms-examples": {
+          "ApiManagementDeleteNamedValue": {
+            "$ref": "./examples/ApiManagementDeleteNamedValue.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/NamedValueIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "NamedValue was successfully deleted."
+          },
+          "204": {
+            "description": "NamedValue was successfully deleted."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/namedValues/{namedValueId}/listValue": {
+      "post": {
+        "tags": [
+          "NamedValue"
+        ],
+        "operationId": "NamedValue_ListValue",
+        "description": "Gets the secret value of the NamedValue.",
+        "x-ms-examples": {
+          "ApiManagementListSecretsSubscription": {
+            "$ref": "./examples/ApiManagementListSecretsNamedValue.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/NamedValueIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains secret value.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PropertyValueContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimnetworkstatus.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimnetworkstatus.json
new file mode 100644
index 000000000000..8c6685f66278
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimnetworkstatus.json
@@ -0,0 +1,212 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for getting the network connectivity status of your Azure API Management deployment. When the API Management service is deployed inside a Virtual Network, it needs to have access to other Azure resources it depends on. This also gives details about the DNS Servers visible to Azure API Management deployment.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/networkstatus": {
+      "get": {
+        "tags": [
+          "NetworkStatus"
+        ],
+        "operationId": "NetworkStatus_ListByService",
+        "description": "Gets the Connectivity Status to the external resources on which the Api Management service depends from inside the Cloud Service. This also returns the DNS Servers as visible to the CloudService.",
+        "x-ms-examples": {
+          "ApiManagementServiceGetNetworkStatus": {
+            "$ref": "./examples/ApiManagementServiceGetNetworkStatus.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Gets the list Network status details for all regions in which service is deployed.",
+            "schema": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/NetworkStatusContractByLocation"
+              },
+              "description": "List of Network Status values."
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/locations/{locationName}/networkstatus": {
+      "get": {
+        "tags": [
+          "NetworkStatus"
+        ],
+        "operationId": "NetworkStatus_ListByLocation",
+        "description": "Gets the Connectivity Status to the external resources on which the Api Management service depends from inside the Cloud Service. This also returns the DNS Servers as visible to the CloudService.",
+        "x-ms-examples": {
+          "ApiManagementServiceGetNetworkStatusByLocation": {
+            "$ref": "./examples/ApiManagementServiceGetNetworkStatusByLocation.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/LocationNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Gets the Network status details.",
+            "schema": {
+              "$ref": "#/definitions/NetworkStatusContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "ConnectivityStatusContract": {
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The hostname of the resource which the service depends on. This can be the database, storage or any other azure resource on which the service depends upon.",
+          "minLength": 1
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "initializing",
+            "success",
+            "failure"
+          ],
+          "x-ms-enum": {
+            "name": "ConnectivityStatusType",
+            "modelAsString": true
+          },
+          "description": "Resource Connectivity Status Type identifier."
+        },
+        "error": {
+          "type": "string",
+          "description": "Error details of the connectivity to the resource."
+        },
+        "lastUpdated": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The date when the resource connectivity status was last updated. This status should be updated every 15 minutes. If this status has not been updated, then it means that the service has lost network connectivity to the resource, from inside the Virtual Network.The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard.\n"
+        },
+        "lastStatusChange": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The date when the resource connectivity status last Changed from success to failure or vice-versa. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard.\n"
+        }
+      },
+      "required": [
+        "name",
+        "status",
+        "lastUpdated",
+        "lastStatusChange"
+      ],
+      "description": "Details about connectivity to a resource."
+    },
+    "NetworkStatusContractByLocation": {
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "Location of service",
+          "minLength": 1
+        },
+        "networkStatus": {
+          "$ref": "#/definitions/NetworkStatusContract",
+          "description": "Network status in Location"
+        }
+      },
+      "description": "Network Status in the Location"
+    },
+    "NetworkStatusContract": {
+      "properties": {
+        "dnsServers": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Gets the list of DNS servers IPV4 addresses."
+        },
+        "connectivityStatus": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ConnectivityStatusContract"
+          },
+          "description": "Gets the list of Connectivity Status to the Resources on which the service depends upon."
+        }
+      },
+      "required": [
+        "dnsServers",
+        "connectivityStatus"
+      ],
+      "description": "Network Status details."
+    }
+  },
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimnotifications.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimnotifications.json
new file mode 100644
index 000000000000..591923264656
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimnotifications.json
@@ -0,0 +1,564 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on who is going to receive notifications associated with your Azure API Management deployment.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications": {
+      "get": {
+        "tags": [
+          "Notification"
+        ],
+        "operationId": "Notification_ListByService",
+        "description": "Lists a collection of properties defined within a service instance.",
+        "x-ms-examples": {
+          "ApiManagementListNotifications": {
+            "$ref": "./examples/ApiManagementListNotifications.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A Collection of the Notification for the specified API Management service instance.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/NotificationCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}": {
+      "get": {
+        "tags": [
+          "Notification"
+        ],
+        "operationId": "Notification_Get",
+        "description": "Gets the details of the Notification specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetNotification": {
+            "$ref": "./examples/ApiManagementGetNotification.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/NotificationNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified Notification.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/NotificationContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Notification"
+        ],
+        "operationId": "Notification_CreateOrUpdate",
+        "description": "Create or Update API Management publisher notification.",
+        "x-ms-examples": {
+          "ApiManagementCreateNotification": {
+            "$ref": "./examples/ApiManagementCreateNotification.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/NotificationNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Notification was successfully updated.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/NotificationContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientUsers": {
+      "get": {
+        "tags": [
+          "NotificationRecipientUser"
+        ],
+        "operationId": "NotificationRecipientUser_ListByNotification",
+        "description": "Gets the list of the Notification Recipient User subscribed to the notification.",
+        "x-ms-examples": {
+          "ApiManagementListNotificationRecipientUsers": {
+            "$ref": "./examples/ApiManagementListNotificationRecipientUsers.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/NotificationNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the Recipient User collection for the notification.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/RecipientUserCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientUsers/{userId}": {
+      "head": {
+        "tags": [
+          "NotificationRecipientUser"
+        ],
+        "operationId": "NotificationRecipientUser_CheckEntityExists",
+        "description": "Determine if the Notification Recipient User is subscribed to the notification.",
+        "x-ms-examples": {
+          "ApiManagementHeadNotificationRecipientUser": {
+            "$ref": "./examples/ApiManagementHeadNotificationRecipientUser.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/NotificationNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/UserIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The User is subscribed to receive the notification."
+          },
+          "404": {
+            "description": "Entity does not exists."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "NotificationRecipientUser"
+        ],
+        "operationId": "NotificationRecipientUser_CreateOrUpdate",
+        "description": "Adds the API Management User to the list of Recipients for the Notification.",
+        "x-ms-examples": {
+          "ApiManagementCreateNotificationRecipientUser": {
+            "$ref": "./examples/ApiManagementCreateNotificationRecipientUser.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/NotificationNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/UserIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Recipient User was successfully added to the notification list.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/RecipientUserContract"
+            }
+          },
+          "200": {
+            "description": "Recipient User is already part of the notification list.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/RecipientUserContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "NotificationRecipientUser"
+        ],
+        "operationId": "NotificationRecipientUser_Delete",
+        "description": "Removes the API Management user from the list of Notification.",
+        "x-ms-examples": {
+          "ApiManagementDeleteNotificationRecipientUser": {
+            "$ref": "./examples/ApiManagementDeleteNotificationRecipientUser.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/NotificationNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/UserIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Recipient User was successfully removed from the notification list."
+          },
+          "204": {
+            "description": "Recipient User was successfully removed from the notification list."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientEmails": {
+      "get": {
+        "tags": [
+          "NotificationRecipientEmail"
+        ],
+        "operationId": "NotificationRecipientEmail_ListByNotification",
+        "description": "Gets the list of the Notification Recipient Emails subscribed to a notification.",
+        "x-ms-examples": {
+          "ApiManagementListNotificationRecipientEmails": {
+            "$ref": "./examples/ApiManagementListNotificationRecipientEmails.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/NotificationNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the Recipient Email collection subscribed to the notification.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/RecipientEmailCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientEmails/{email}": {
+      "head": {
+        "tags": [
+          "NotificationRecipientEmail"
+        ],
+        "operationId": "NotificationRecipientEmail_CheckEntityExists",
+        "description": "Determine if Notification Recipient Email subscribed to the notification.",
+        "x-ms-examples": {
+          "ApiManagementHeadNotificationRecipientEmail": {
+            "$ref": "./examples/ApiManagementHeadNotificationRecipientEmail.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/NotificationNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/EmailParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The Users is subscribed to receive the notification."
+          },
+          "404": {
+            "description": "The Users is not subscribed to receive the notification."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "NotificationRecipientEmail"
+        ],
+        "operationId": "NotificationRecipientEmail_CreateOrUpdate",
+        "description": "Adds the Email address to the list of Recipients for the Notification.",
+        "x-ms-examples": {
+          "ApiManagementCreateNotificationRecipientEmail": {
+            "$ref": "./examples/ApiManagementCreateNotificationRecipientEmail.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/NotificationNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/EmailParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Recipient Email was successfully added to the notification list.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/RecipientEmailContract"
+            }
+          },
+          "200": {
+            "description": "Recipient Email is already part of the notification list.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/RecipientEmailContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "NotificationRecipientEmail"
+        ],
+        "operationId": "NotificationRecipientEmail_Delete",
+        "description": "Removes the email from the list of Notification.",
+        "x-ms-examples": {
+          "ApiManagementDeleteNotificationRecipientEmail": {
+            "$ref": "./examples/ApiManagementDeleteNotificationRecipientEmail.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/NotificationNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/EmailParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Recipient Email was successfully removed to the notification list."
+          },
+          "204": {
+            "description": "Recipient Email was successfully removed to the notification list."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimopenidconnectproviders.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimopenidconnectproviders.json
new file mode 100644
index 000000000000..6e8a91da0798
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimopenidconnectproviders.json
@@ -0,0 +1,412 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on OpenId Connect Provider entity associated with your Azure API Management deployment. API Management allows you to access APIs secured with token from [OpenID Connect Provider ](http://openid.net/connect/) to be accessed from the Developer Console.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/openidConnectProviders": {
+      "get": {
+        "tags": [
+          "OpenidConnectProvider"
+        ],
+        "operationId": "OpenIdConnectProvider_ListByService",
+        "description": "Lists of all the OpenId Connect Providers.",
+        "x-ms-examples": {
+          "ApiManagementListOpenIdConnectProviders": {
+            "$ref": "./examples/ApiManagementListOpenIdConnectProviders.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists of all the OpenId Connect Providers.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/OpenIdConnectProviderCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/OpenidConnectProviderContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/openidConnectProviders/{opid}": {
+      "head": {
+        "tags": [
+          "OpenidConnectProvider"
+        ],
+        "operationId": "OpenIdConnectProvider_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the openIdConnectProvider specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadOpenIdConnectProvider": {
+            "$ref": "./examples/ApiManagementHeadOpenIdConnectProvider.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/OpenIdConnectIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified openidConnectProvider entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "OpenidConnectProvider"
+        ],
+        "operationId": "OpenIdConnectProvider_Get",
+        "description": "Gets specific OpenID Connect Provider.",
+        "x-ms-examples": {
+          "ApiManagementGetOpenIdConnectProvider": {
+            "$ref": "./examples/ApiManagementGetOpenIdConnectProvider.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/OpenIdConnectIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified OpenId Connect Provider entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/OpenidConnectProviderContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "OpenidConnectProvider"
+        ],
+        "operationId": "OpenIdConnectProvider_CreateOrUpdate",
+        "description": "Creates or updates the OpenID Connect Provider.",
+        "x-ms-examples": {
+          "ApiManagementCreateOpenIdConnectProvider": {
+            "$ref": "./examples/ApiManagementCreateOpenIdConnectProvider.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/OpenIdConnectIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/OpenidConnectProviderContract"
+            },
+            "description": "Create parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "OpenIdConnect Provider was successfully created.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/OpenidConnectProviderContract"
+            }
+          },
+          "200": {
+            "description": "OpenIdConnect Provider was successfully updated.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/OpenidConnectProviderContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "OpenidConnectProvider"
+        ],
+        "operationId": "OpenIdConnectProvider_Update",
+        "description": "Updates the specific OpenID Connect Provider.",
+        "x-ms-examples": {
+          "ApiManagementUpdateOpenIdConnectProvider": {
+            "$ref": "./examples/ApiManagementUpdateOpenIdConnectProvider.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/OpenIdConnectIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/OpenidConnectProviderUpdateContract"
+            },
+            "description": "Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "OpenId Connect Provider was successfully updated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "OpenidConnectProvider"
+        ],
+        "operationId": "OpenIdConnectProvider_Delete",
+        "description": "Deletes specific OpenID Connect Provider of the API Management service instance.",
+        "x-ms-examples": {
+          "ApiManagementDeleteOpenIdConnectProvider": {
+            "$ref": "./examples/ApiManagementDeleteOpenIdConnectProvider.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/OpenIdConnectIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OpenId Connect Provider was successfully deleted."
+          },
+          "204": {
+            "description": "OpenId Connect Provider was successfully deleted."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/openidConnectProviders/{opid}/listSecrets": {
+      "post": {
+        "tags": [
+          "OpenidConnectProvider"
+        ],
+        "operationId": "OpenIdConnectProvider_ListSecrets",
+        "description": "Gets the client secret details of the OpenID Connect Provider.",
+        "x-ms-examples": {
+          "ApiManagementListSecretsOpenidConnectProvider": {
+            "$ref": "./examples/ApiManagementListSecretsOpenIdConnectProvider.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/OpenIdConnectIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the client secret.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ClientSecretContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimpolicies.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimpolicies.json
new file mode 100644
index 000000000000..36b610f0ccd3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimpolicies.json
@@ -0,0 +1,304 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on Global Policies in Azure API Management deployment.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/policies": {
+      "get": {
+        "tags": [
+          "Policy"
+        ],
+        "operationId": "Policy_ListByService",
+        "description": "Lists all the Global Policy definitions of the Api Management service.",
+        "x-ms-examples": {
+          "ApiManagementListPolicies": {
+            "$ref": "./examples/ApiManagementListPolicies.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Returns an array of Policy Contracts.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PolicyCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/policies/{policyId}": {
+      "head": {
+        "tags": [
+          "Policy"
+        ],
+        "operationId": "Policy_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the Global policy definition in the Api Management service.",
+        "x-ms-examples": {
+          "ApiManagementHeadPolicy": {
+            "$ref": "./examples/ApiManagementHeadPolicy.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/PolicyIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "Policy"
+        ],
+        "operationId": "Policy_Get",
+        "description": "Get the Global policy definition of the Api Management service.",
+        "x-ms-examples": {
+          "ApiManagementGetPolicy": {
+            "$ref": "./examples/ApiManagementGetPolicy.json"
+          },
+          "ApiManagementGetPolicyFormat": {
+            "$ref": "./examples/ApiManagementGetPolicyFormat.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/PolicyIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/PolicyExportFormat"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Get the Global policy definition of the Api Management service.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PolicyContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Policy"
+        ],
+        "operationId": "Policy_CreateOrUpdate",
+        "description": "Creates or updates the global policy configuration of the Api Management service.",
+        "x-ms-examples": {
+          "ApiManagementCreatePolicy": {
+            "$ref": "./examples/ApiManagementCreatePolicy.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/PolicyIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PolicyContract"
+            },
+            "description": "The policy contents to apply."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Global policy configuration was successfully created.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PolicyContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "200": {
+            "description": "Global policy configuration of the Api Management service was successfully updated.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PolicyContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Policy"
+        ],
+        "operationId": "Policy_Delete",
+        "description": "Deletes the global policy configuration of the Api Management Service.",
+        "x-ms-examples": {
+          "ApiManagementDeletePolicy": {
+            "$ref": "./examples/ApiManagementDeletePolicy.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/PolicyIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Policy was successfully removed"
+          },
+          "204": {
+            "description": "Policy successfully removed by previous request or does not exist"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimpolicydescriptions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimpolicydescriptions.json
new file mode 100644
index 000000000000..834258a44cd4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimpolicydescriptions.json
@@ -0,0 +1,100 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing retrieving a collection of policy snippets available in Azure API Management deployment.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/policyDescriptions": {
+      "get": {
+        "tags": [
+          "PolicyDescription"
+        ],
+        "operationId": "PolicyDescription_ListByService",
+        "description": "Lists all policy descriptions.",
+        "x-ms-examples": {
+          "ApiManagementListPolicyDescriptions": {
+            "$ref": "./examples/ApiManagementListPolicyDescriptions.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "scope",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "Policy scope.",
+            "enum": [
+              "Tenant",
+              "Product",
+              "Api",
+              "Operation",
+              "All"
+            ],
+            "x-ms-enum": {
+              "name": "PolicyScopeContract",
+              "modelAsString": false
+            }
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Returns an array of policy descriptions.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PolicyDescriptionCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimportalsettings.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimportalsettings.json
new file mode 100644
index 000000000000..abf6b6644e29
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimportalsettings.json
@@ -0,0 +1,657 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on PortalSettings entity associated with your Azure API Management deployment. Using this entity you can manage settings for a Developer Portal.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/signin": {
+      "head": {
+        "tags": [
+          "SignInSettings"
+        ],
+        "operationId": "SignInSettings_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the SignInSettings.",
+        "x-ms-examples": {
+          "ApiManagementHeadSignInSettings": {
+            "$ref": "./examples/ApiManagementHeadSignInSettings.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Operation completed successfully.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "SignInSettings"
+        ],
+        "operationId": "SignInSettings_Get",
+        "description": "Get Sign In Settings for the Portal",
+        "x-ms-examples": {
+          "ApiManagementPortalSettingsGetSignIn": {
+            "$ref": "./examples/ApiManagementPortalSettingsGetSignIn.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Sign-In settings.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PortalSigninSettings"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "SignInSettings"
+        ],
+        "operationId": "SignInSettings_Update",
+        "description": "Update Sign-In settings.",
+        "x-ms-examples": {
+          "ApiManagementPortalSettingsUpdateSignIn": {
+            "$ref": "./examples/ApiManagementPortalSettingsUpdateSignIn.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PortalSigninSettings"
+            },
+            "description": "Update Sign-In settings."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Sign-In settings was updated successfully."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "SignInSettings"
+        ],
+        "operationId": "SignInSettings_CreateOrUpdate",
+        "description": "Create or Update Sign-In settings.",
+        "x-ms-examples": {
+          "ApiManagementPortalSettingsUpdateSignIn": {
+            "$ref": "./examples/ApiManagementPortalSettingsPutSignIn.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PortalSigninSettings"
+            },
+            "description": "Create or update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Sign-In settings was successfully updated.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PortalSigninSettings"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/signup": {
+      "head": {
+        "tags": [
+          "SignUpSettings"
+        ],
+        "operationId": "SignUpSettings_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the SignUpSettings.",
+        "x-ms-examples": {
+          "ApiManagementHeadSignUpSettings": {
+            "$ref": "./examples/ApiManagementHeadSignUpSettings.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Operation completed successfully.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "SignUpSettings"
+        ],
+        "operationId": "SignUpSettings_Get",
+        "description": "Get Sign Up Settings for the Portal",
+        "x-ms-examples": {
+          "ApiManagementPortalSettingsGetSignUp": {
+            "$ref": "./examples/ApiManagementPortalSettingsGetSignUp.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Sign-Up settings.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PortalSignupSettings"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "SignUpSettings"
+        ],
+        "operationId": "SignUpSettings_Update",
+        "description": "Update Sign-Up settings.",
+        "x-ms-examples": {
+          "ApiManagementPortalSettingsUpdateSignUp": {
+            "$ref": "./examples/ApiManagementPortalSettingsUpdateSignUp.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PortalSignupSettings"
+            },
+            "description": "Update Sign-Up settings."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Sign-Up settings was updated successfully."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "SignUpSettings"
+        ],
+        "operationId": "SignUpSettings_CreateOrUpdate",
+        "description": "Create or Update Sign-Up settings.",
+        "x-ms-examples": {
+          "ApiManagementPortalSettingsUpdateSignUp": {
+            "$ref": "./examples/ApiManagementPortalSettingsPutSignUp.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PortalSignupSettings"
+            },
+            "description": "Create or update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Sign-Up settings was successfully updated.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PortalSignupSettings"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/delegation": {
+      "head": {
+        "tags": [
+          "DelegationSettings"
+        ],
+        "operationId": "DelegationSettings_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the DelegationSettings.",
+        "x-ms-examples": {
+          "ApiManagementHeadDelegationSettings": {
+            "$ref": "./examples/ApiManagementHeadDelegationSettings.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Operation completed successfully.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "DelegationSettings"
+        ],
+        "operationId": "DelegationSettings_Get",
+        "description": "Get Delegation Settings for the Portal.",
+        "x-ms-examples": {
+          "ApiManagementPortalSettingsGetDelegation": {
+            "$ref": "./examples/ApiManagementPortalSettingsGetDelegation.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Delegation settings.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PortalDelegationSettings"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "DelegationSettings"
+        ],
+        "operationId": "DelegationSettings_Update",
+        "description": "Update Delegation settings.",
+        "x-ms-examples": {
+          "ApiManagementPortalSettingsUpdateDelegation": {
+            "$ref": "./examples/ApiManagementPortalSettingsUpdateDelegation.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PortalDelegationSettings"
+            },
+            "description": "Update Delegation settings."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Delegation settings was updated successfully."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "DelegationSettings"
+        ],
+        "operationId": "DelegationSettings_CreateOrUpdate",
+        "description": "Create or Update Delegation settings.",
+        "x-ms-examples": {
+          "ApiManagementPortalSettingsUpdateDelegation": {
+            "$ref": "./examples/ApiManagementPortalSettingsPutDelegation.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PortalDelegationSettings"
+            },
+            "description": "Create or update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Delegation settings was successfully updated.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PortalDelegationSettings"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/delegation/listSecrets": {
+      "post": {
+        "tags": [
+          "DelegationSettings"
+        ],
+        "operationId": "DelegationSettings_ListSecrets",
+        "description": "Gets the secret validation key of the DelegationSettings.",
+        "x-ms-examples": {
+          "ApiManagementListSecretsPortalSettings": {
+            "$ref": "./examples/ApiManagementListSecretsPortalSettingsValidationKey.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the validation key.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PortalSettingValidationKeyContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimproducts.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimproducts.json
new file mode 100644
index 000000000000..2133252b0379
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimproducts.json
@@ -0,0 +1,1399 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on Product entity associated with your Azure API Management deployment. The Product entity represents a product in API Management. Products include one or more APIs and their associated terms of use. Once a product is published, developers can subscribe to the product and begin to use the product’s APIs.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products": {
+      "get": {
+        "tags": [
+          "Product"
+        ],
+        "operationId": "Product_ListByService",
+        "description": "Lists a collection of products in the specified service instance.",
+        "x-ms-examples": {
+          "ApiManagementListProducts": {
+            "$ref": "./examples/ApiManagementListProducts.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| description | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| terms | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| state | filter | eq |     | </br>| groups | expand |     |     | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "name": "expandGroups",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "description": "When set to true, the response contains an array of groups that have visibility to the product. The default is false."
+          },
+          {
+            "name": "tags",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "Products which are part of a specific tag."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A Collection of the Product entities for the specified API Management service instance.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ProductCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/ProductContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}": {
+      "head": {
+        "tags": [
+          "Product"
+        ],
+        "operationId": "Product_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the product specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadProduct": {
+            "$ref": "./examples/ApiManagementHeadProduct.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified Product entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "Product"
+        ],
+        "operationId": "Product_Get",
+        "description": "Gets the details of the product specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetProduct": {
+            "$ref": "./examples/ApiManagementGetProduct.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified Product entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ProductContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Product"
+        ],
+        "operationId": "Product_CreateOrUpdate",
+        "description": "Creates or Updates a product.",
+        "x-ms-examples": {
+          "ApiManagementCreateProduct": {
+            "$ref": "./examples/ApiManagementCreateProduct.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ProductContract"
+            },
+            "description": "Create or update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Product was successfully created.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ProductContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "200": {
+            "description": "Product was successfully updated.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ProductContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "Product"
+        ],
+        "operationId": "Product_Update",
+        "description": "Update existing product details.",
+        "x-ms-examples": {
+          "ApiManagementUpdateProduct": {
+            "$ref": "./examples/ApiManagementUpdateProduct.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ProductUpdateParameters"
+            },
+            "description": "Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Product details was successfully updated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Product"
+        ],
+        "operationId": "Product_Delete",
+        "description": "Delete product.",
+        "x-ms-examples": {
+          "ApiManagementDeleteProduct": {
+            "$ref": "./examples/ApiManagementDeleteProduct.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "name": "deleteSubscriptions",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "description": "Delete existing subscriptions associated with the product or not."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Product was successfully removed."
+          },
+          "204": {
+            "description": "Product was successfully removed by previous request or does not exist."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/apis": {
+      "get": {
+        "tags": [
+          "ProductApi"
+        ],
+        "operationId": "ProductApi_ListByProduct",
+        "description": "Lists a collection of the APIs associated with a product.",
+        "x-ms-examples": {
+          "ApiManagementListProductApis": {
+            "$ref": "./examples/ApiManagementListProductApis.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| description | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| serviceUrl | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| path | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains a collection of Api entities in the product.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/ApiContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/apis/{apiId}": {
+      "head": {
+        "tags": [
+          "ProductApi"
+        ],
+        "operationId": "ProductApi_CheckEntityExists",
+        "description": "Checks that API entity specified by identifier is associated with the Product entity.",
+        "x-ms-examples": {
+          "ApiManagementHeadProductApi": {
+            "$ref": "./examples/ApiManagementHeadProductApi.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Entity exists"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "ProductApi"
+        ],
+        "operationId": "ProductApi_CreateOrUpdate",
+        "description": "Adds an API to the specified product.",
+        "x-ms-examples": {
+          "ApiManagementCreateProductApi": {
+            "$ref": "./examples/ApiManagementCreateProductApi.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "The API was successfully added to the product.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiContract"
+            }
+          },
+          "200": {
+            "description": "The specified API is already added to the product.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ApiContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ProductApi"
+        ],
+        "operationId": "ProductApi_Delete",
+        "description": "Deletes the specified API from the specified product.",
+        "x-ms-examples": {
+          "ApiManagementDeleteProductApi": {
+            "$ref": "./examples/ApiManagementDeleteProductApi.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiIdRevParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "API was successfully removed from product"
+          },
+          "204": {
+            "description": "API successfully removed by previous request or does not exist in product"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/groups": {
+      "get": {
+        "tags": [
+          "ProductGroup"
+        ],
+        "operationId": "ProductGroup_ListByProduct",
+        "description": "Lists the collection of developer groups associated with the specified product.",
+        "x-ms-examples": {
+          "ApiManagementListProductGroups": {
+            "$ref": "./examples/ApiManagementListProductGroups.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt |     | </br>| displayName | filter | eq, ne |     | </br>| description | filter | eq, ne |     | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of Group entities.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GroupCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/GroupContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/groups/{groupId}": {
+      "head": {
+        "tags": [
+          "ProductGroup"
+        ],
+        "operationId": "ProductGroup_CheckEntityExists",
+        "description": "Checks that Group entity specified by identifier is associated with the Product entity.",
+        "x-ms-examples": {
+          "ApiManagementHeadProductGroup": {
+            "$ref": "./examples/ApiManagementHeadProductGroup.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GroupIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The Group is associated with the Product."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "ProductGroup"
+        ],
+        "operationId": "ProductGroup_CreateOrUpdate",
+        "description": "Adds the association between the specified developer group with the specified product.",
+        "x-ms-examples": {
+          "ApiManagementCreateProductGroup": {
+            "$ref": "./examples/ApiManagementCreateProductGroup.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GroupIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "The group was successfully associated with the product.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GroupContract"
+            }
+          },
+          "200": {
+            "description": "The specified group is already associated with the product.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GroupContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ProductGroup"
+        ],
+        "operationId": "ProductGroup_Delete",
+        "description": "Deletes the association between the specified group and product.",
+        "x-ms-examples": {
+          "ApiManagementDeleteProductGroup": {
+            "$ref": "./examples/ApiManagementDeleteProductGroup.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/GroupIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The group was successfully disassociated with the product."
+          },
+          "204": {
+            "description": "The group was successfully disassociated with the product."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/subscriptions": {
+      "get": {
+        "tags": [
+          "ProductSubscription"
+        ],
+        "operationId": "ProductSubscriptions_List",
+        "description": "Lists the collection of subscriptions to the specified product.",
+        "x-ms-examples": {
+          "ApiManagementListProductSubscriptions": {
+            "$ref": "./examples/ApiManagementListProductSubscriptions.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| stateComment | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| ownerId | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| scope | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| userId | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| productId | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| state | filter | eq |     | </br>| user | expand |     |     | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of subscription entities.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/SubscriptionCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/SubscriptionContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/policies": {
+      "get": {
+        "tags": [
+          "ProductPolicy"
+        ],
+        "operationId": "ProductPolicy_ListByProduct",
+        "description": "Get the policy configuration at the Product level.",
+        "x-ms-examples": {
+          "ApiManagementListProductPolicies": {
+            "$ref": "./examples/ApiManagementListProductPolicies.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Product Policy information.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PolicyCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/policies/{policyId}": {
+      "head": {
+        "tags": [
+          "ProductPolicy"
+        ],
+        "operationId": "ProductPolicy_GetEntityTag",
+        "description": "Get the ETag of the policy configuration at the Product level.",
+        "x-ms-examples": {
+          "ApiManagementHeadProductPolicy": {
+            "$ref": "./examples/ApiManagementHeadProductPolicy.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/PolicyIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Product Policy Etag information.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "ProductPolicy"
+        ],
+        "operationId": "ProductPolicy_Get",
+        "description": "Get the policy configuration at the Product level.",
+        "x-ms-examples": {
+          "ApiManagementGetProductPolicy": {
+            "$ref": "./examples/ApiManagementGetProductPolicy.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/PolicyIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/PolicyExportFormat"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Product Policy information.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PolicyContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "ProductPolicy"
+        ],
+        "operationId": "ProductPolicy_CreateOrUpdate",
+        "description": "Creates or updates policy configuration for the Product.",
+        "x-ms-examples": {
+          "ApiManagementCreateProductPolicy": {
+            "$ref": "./examples/ApiManagementCreateProductPolicy.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/PolicyIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PolicyContract"
+            },
+            "description": "The policy contents to apply."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Product policy configuration was successfully created.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PolicyContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "200": {
+            "description": "Product policy configuration of the tenant was successfully updated.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/PolicyContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ProductPolicy"
+        ],
+        "operationId": "ProductPolicy_Delete",
+        "description": "Deletes the policy configuration at the Product.",
+        "x-ms-examples": {
+          "ApiManagementDeleteProductPolicy": {
+            "$ref": "./examples/ApiManagementDeleteProductPolicy.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/PolicyIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successfully deleted the policy configuration at the Product level."
+          },
+          "204": {
+            "description": "Successfully deleted the policy configuration at the Product level."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/tags": {
+      "get": {
+        "tags": [
+          "ProductTag"
+        ],
+        "operationId": "Tag_ListByProduct",
+        "description": "Lists all Tags associated with the Product.",
+        "x-ms-examples": {
+          "ApiManagementListProductTags": {
+            "$ref": "./examples/ApiManagementListProductTags.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation returns a collection of tags associated with the Product entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/TagContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/tags/{tagId}": {
+      "head": {
+        "tags": [
+          "ProductTag"
+        ],
+        "operationId": "Tag_GetEntityStateByProduct",
+        "description": "Gets the entity state version of the tag specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadProductTag": {
+            "$ref": "./examples/ApiManagementHeadProductTag.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TagIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Empty response body, ETag header entity state version.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "ProductTag"
+        ],
+        "operationId": "Tag_GetByProduct",
+        "description": "Get tag associated with the Product.",
+        "x-ms-examples": {
+          "ApiManagementGetProductTag": {
+            "$ref": "./examples/ApiManagementGetProductTag.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TagIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Gets the details of the tag specified by its identifier.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "ProductTag"
+        ],
+        "operationId": "Tag_AssignToProduct",
+        "description": "Assign tag to the Product.",
+        "x-ms-examples": {
+          "ApiManagementCreateProductTag": {
+            "$ref": "./examples/ApiManagementCreateProductTag.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TagIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Tag was assigned to the Product.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagContract"
+            }
+          },
+          "200": {
+            "description": "Tag is already assigned to the Product.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ProductTag"
+        ],
+        "operationId": "Tag_DetachFromProduct",
+        "description": "Detach the tag from the Product.",
+        "x-ms-examples": {
+          "ApiManagementDeleteProductTag": {
+            "$ref": "./examples/ApiManagementDeleteProductTag.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ProductIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TagIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successfully detached the tag from the Product."
+          },
+          "204": {
+            "description": "Successfully detached the tag from the Product."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimproductsByTags.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimproductsByTags.json
new file mode 100644
index 000000000000..981f7aaf5d7c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimproductsByTags.json
@@ -0,0 +1,106 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations to retrieve Products by Tags in Azure API Management deployment.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/productsByTags": {
+      "get": {
+        "tags": [
+          "ProductsByTag"
+        ],
+        "operationId": "Product_ListByTags",
+        "description": "Lists a collection of products associated with tags.",
+        "x-ms-examples": {
+          "ApiManagementListProductsByTags": {
+            "$ref": "./examples/ApiManagementListProductsByTags.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| description | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| terms | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| state | filter | eq | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "name": "includeNotTaggedProducts",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "description": "Include not tagged Products."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of TagResource entities.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagResourceCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/TagResourceContract"
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimquotas.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimquotas.json
new file mode 100644
index 000000000000..2aa6ffd5883d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimquotas.json
@@ -0,0 +1,242 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on Quota entity associated with your Azure API Management deployment. To configure call rate limit and quota policies refer to [how to configure call rate limit and quota](https://docs.microsoft.com/en-us/azure/api-management/api-management-howto-product-with-rules#a-namepolicies-ato-configure-call-rate-limit-and-quota-policies).",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/quotas/{quotaCounterKey}": {
+      "get": {
+        "tags": [
+          "QuotaByCounterKeys"
+        ],
+        "operationId": "QuotaByCounterKeys_ListByService",
+        "description": "Lists a collection of current quota counter periods associated with the counter-key configured in the policy on the specified service instance. The api does not support paging yet.",
+        "externalDocs": {
+          "url": "https://docs.microsoft.com/en-us/azure/api-management/api-management-howto-product-with-rules#a-namepolicies-ato-configure-call-rate-limit-and-quota-policies",
+          "description": "Document describing how to configure the quota policies."
+        },
+        "x-ms-examples": {
+          "ApiManagementGetQuotaCounterKeys": {
+            "$ref": "./examples/ApiManagementGetQuotaCounterKeys.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/QuotaCounterKeyParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of the quota counter values.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/QuotaCounterCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "QuotaByCounterKeys"
+        ],
+        "operationId": "QuotaByCounterKeys_Update",
+        "description": "Updates all the quota counter values specified with the existing quota counter key to a value in the specified service instance. This should be used for reset of the quota counter values.",
+        "x-ms-examples": {
+          "ApiManagementUpdateQuotaCounterKey": {
+            "$ref": "./examples/ApiManagementUpdateQuotaCounterKey.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/QuotaCounterKeyParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/QuotaCounterValueContractProperties"
+            },
+            "description": "The value of the quota counter to be applied to all quota counter periods."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Quota counter period was successfully updated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/quotas/{quotaCounterKey}/periods/{quotaPeriodKey}": {
+      "get": {
+        "tags": [
+          "QuotaByPeriodKeys"
+        ],
+        "operationId": "QuotaByPeriodKeys_Get",
+        "description": "Gets the value of the quota counter associated with the counter-key in the policy for the specific period in service instance.",
+        "externalDocs": {
+          "url": "https://docs.microsoft.com/en-us/azure/api-management/api-management-howto-product-with-rules#a-namepolicies-ato-configure-call-rate-limit-and-quota-policies",
+          "description": "Document describing how to configure the quota policies."
+        },
+        "x-ms-examples": {
+          "ApiManagementGetQuotaCounterKeysByQuotaPeriod": {
+            "$ref": "./examples/ApiManagementGetQuotaCounterKeysByQuotaPeriod.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/QuotaCounterKeyParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/QuotaPeriodKeyParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the Quota counter details for the specified period.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/QuotaCounterContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "QuotaByPeriodKeys"
+        ],
+        "operationId": "QuotaByPeriodKeys_Update",
+        "description": "Updates an existing quota counter value in the specified service instance.",
+        "x-ms-examples": {
+          "ApiManagementUpdateQuotaCounterKeyByQuotaPeriod": {
+            "$ref": "./examples/ApiManagementUpdateQuotaCounterKeyByQuotaPeriod.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/QuotaCounterKeyParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/QuotaPeriodKeyParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/QuotaCounterValueContractProperties"
+            },
+            "description": "The value of the Quota counter to be applied on the specified period."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The quota counter value was successfully updated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimregions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimregions.json
new file mode 100644
index 000000000000..4beef75dbe2a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimregions.json
@@ -0,0 +1,85 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations in Azure API Management deployment.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/regions": {
+      "get": {
+        "tags": [
+          "Region"
+        ],
+        "operationId": "Region_ListByService",
+        "description": "Lists all azure regions in which the service exists.",
+        "x-ms-examples": {
+          "ApiManagementListRegions": {
+            "$ref": "./examples/ApiManagementListRegions.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists of Regions in which the service is deployed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/RegionListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimreports.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimreports.json
new file mode 100644
index 000000000000..461f343ec801
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimreports.json
@@ -0,0 +1,514 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs to get the analytics reports associated with your Azure API Management deployment.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byApi": {
+      "get": {
+        "tags": [
+          "Reports"
+        ],
+        "operationId": "Reports_ListByApi",
+        "description": "Lists report records by API.",
+        "x-ms-examples": {
+          "ApiManagementGetReportsByApi": {
+            "$ref": "./examples/ApiManagementGetReportsByApi.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": true,
+            "type": "string",
+            "description": "The filter to apply on the operation."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "name": "$orderby",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "OData order by query option."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of Report record.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ReportCollection"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/ReportRecordContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byUser": {
+      "get": {
+        "tags": [
+          "Reports"
+        ],
+        "operationId": "Reports_ListByUser",
+        "description": "Lists report records by User.",
+        "x-ms-examples": {
+          "ApiManagementGetReportsByUser": {
+            "$ref": "./examples/ApiManagementGetReportsByUser.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": true,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| timestamp | filter | ge, le |     | </br>| displayName | select, orderBy |     |     | </br>| userId | select, filter | eq |     | </br>| apiRegion | filter | eq |     | </br>| productId | filter | eq |     | </br>| subscriptionId | filter | eq |     | </br>| apiId | filter | eq |     | </br>| operationId | filter | eq |     | </br>| callCountSuccess | select, orderBy |     |     | </br>| callCountBlocked | select, orderBy |     |     | </br>| callCountFailed | select, orderBy |     |     | </br>| callCountOther | select, orderBy |     |     | </br>| callCountTotal | select, orderBy |     |     | </br>| bandwidth | select, orderBy |     |     | </br>| cacheHitsCount | select |     |     | </br>| cacheMissCount | select |     |     | </br>| apiTimeAvg | select, orderBy |     |     | </br>| apiTimeMin | select |     |     | </br>| apiTimeMax | select |     |     | </br>| serviceTimeAvg | select |     |     | </br>| serviceTimeMin | select |     |     | </br>| serviceTimeMax | select |     |     | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "name": "$orderby",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "OData order by query option."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of Report record.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ReportCollection"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/ReportRecordContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byOperation": {
+      "get": {
+        "tags": [
+          "Reports"
+        ],
+        "operationId": "Reports_ListByOperation",
+        "description": "Lists report records by API Operations.",
+        "x-ms-examples": {
+          "ApiManagementGetReportsByOperation": {
+            "$ref": "./examples/ApiManagementGetReportsByOperation.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": true,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| timestamp | filter | ge, le |     | </br>| displayName | select, orderBy |     |     | </br>| apiRegion | filter | eq |     | </br>| userId | filter | eq |     | </br>| productId | filter | eq |     | </br>| subscriptionId | filter | eq |     | </br>| apiId | filter | eq |     | </br>| operationId | select, filter | eq |     | </br>| callCountSuccess | select, orderBy |     |     | </br>| callCountBlocked | select, orderBy |     |     | </br>| callCountFailed | select, orderBy |     |     | </br>| callCountOther | select, orderBy |     |     | </br>| callCountTotal | select, orderBy |     |     | </br>| bandwidth | select, orderBy |     |     | </br>| cacheHitsCount | select |     |     | </br>| cacheMissCount | select |     |     | </br>| apiTimeAvg | select, orderBy |     |     | </br>| apiTimeMin | select |     |     | </br>| apiTimeMax | select |     |     | </br>| serviceTimeAvg | select |     |     | </br>| serviceTimeMin | select |     |     | </br>| serviceTimeMax | select |     |     | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "name": "$orderby",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "OData order by query option."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of Report record.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ReportCollection"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/ReportRecordContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byProduct": {
+      "get": {
+        "tags": [
+          "Reports"
+        ],
+        "operationId": "Reports_ListByProduct",
+        "description": "Lists report records by Product.",
+        "x-ms-examples": {
+          "ApiManagementGetReportsByProduct": {
+            "$ref": "./examples/ApiManagementGetReportsByProduct.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": true,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| timestamp | filter | ge, le |     | </br>| displayName | select, orderBy |     |     | </br>| apiRegion | filter | eq |     | </br>| userId | filter | eq |     | </br>| productId | select, filter | eq |     | </br>| subscriptionId | filter | eq |     | </br>| callCountSuccess | select, orderBy |     |     | </br>| callCountBlocked | select, orderBy |     |     | </br>| callCountFailed | select, orderBy |     |     | </br>| callCountOther | select, orderBy |     |     | </br>| callCountTotal | select, orderBy |     |     | </br>| bandwidth | select, orderBy |     |     | </br>| cacheHitsCount | select |     |     | </br>| cacheMissCount | select |     |     | </br>| apiTimeAvg | select, orderBy |     |     | </br>| apiTimeMin | select |     |     | </br>| apiTimeMax | select |     |     | </br>| serviceTimeAvg | select |     |     | </br>| serviceTimeMin | select |     |     | </br>| serviceTimeMax | select |     |     | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "name": "$orderby",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "OData order by query option."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of Report record.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ReportCollection"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/ReportRecordContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byGeo": {
+      "get": {
+        "tags": [
+          "Reports"
+        ],
+        "operationId": "Reports_ListByGeo",
+        "description": "Lists report records by geography.",
+        "x-ms-examples": {
+          "ApiManagementGetReportsByGeo": {
+            "$ref": "./examples/ApiManagementGetReportsByGeo.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": true,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| timestamp | filter | ge, le |     | </br>| country | select |     |     | </br>| region | select |     |     | </br>| zip | select |     |     | </br>| apiRegion | filter | eq |     | </br>| userId | filter | eq |     | </br>| productId | filter | eq |     | </br>| subscriptionId | filter | eq |     | </br>| apiId | filter | eq |     | </br>| operationId | filter | eq |     | </br>| callCountSuccess | select |     |     | </br>| callCountBlocked | select |     |     | </br>| callCountFailed | select |     |     | </br>| callCountOther | select |     |     | </br>| bandwidth | select, orderBy |     |     | </br>| cacheHitsCount | select |     |     | </br>| cacheMissCount | select |     |     | </br>| apiTimeAvg | select |     |     | </br>| apiTimeMin | select |     |     | </br>| apiTimeMax | select |     |     | </br>| serviceTimeAvg | select |     |     | </br>| serviceTimeMin | select |     |     | </br>| serviceTimeMax | select |     |     | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of Report record.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ReportCollection"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/ReportRecordContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/bySubscription": {
+      "get": {
+        "tags": [
+          "Reports"
+        ],
+        "operationId": "Reports_ListBySubscription",
+        "description": "Lists report records by subscription.",
+        "x-ms-examples": {
+          "ApiManagementGetReportsBySubscription": {
+            "$ref": "./examples/ApiManagementGetReportsBySubscription.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": true,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| timestamp | filter | ge, le |     | </br>| displayName | select, orderBy |     |     | </br>| apiRegion | filter | eq |     | </br>| userId | select, filter | eq |     | </br>| productId | select, filter | eq |     | </br>| subscriptionId | select, filter | eq |     | </br>| callCountSuccess | select, orderBy |     |     | </br>| callCountBlocked | select, orderBy |     |     | </br>| callCountFailed | select, orderBy |     |     | </br>| callCountOther | select, orderBy |     |     | </br>| callCountTotal | select, orderBy |     |     | </br>| bandwidth | select, orderBy |     |     | </br>| cacheHitsCount | select |     |     | </br>| cacheMissCount | select |     |     | </br>| apiTimeAvg | select, orderBy |     |     | </br>| apiTimeMin | select |     |     | </br>| apiTimeMax | select |     |     | </br>| serviceTimeAvg | select |     |     | </br>| serviceTimeMin | select |     |     | </br>| serviceTimeMax | select |     |     | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "name": "$orderby",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "OData order by query option."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of Report record.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ReportCollection"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/ReportRecordContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byTime": {
+      "get": {
+        "tags": [
+          "Reports"
+        ],
+        "operationId": "Reports_ListByTime",
+        "description": "Lists report records by Time.",
+        "x-ms-examples": {
+          "ApiManagementGetReportsByTime": {
+            "$ref": "./examples/ApiManagementGetReportsByTime.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": true,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| timestamp | filter, select | ge, le |     | </br>| interval | select |     |     | </br>| apiRegion | filter | eq |     | </br>| userId | filter | eq |     | </br>| productId | filter | eq |     | </br>| subscriptionId | filter | eq |     | </br>| apiId | filter | eq |     | </br>| operationId | filter | eq |     | </br>| callCountSuccess | select |     |     | </br>| callCountBlocked | select |     |     | </br>| callCountFailed | select |     |     | </br>| callCountOther | select |     |     | </br>| bandwidth | select, orderBy |     |     | </br>| cacheHitsCount | select |     |     | </br>| cacheMissCount | select |     |     | </br>| apiTimeAvg | select |     |     | </br>| apiTimeMin | select |     |     | </br>| apiTimeMax | select |     |     | </br>| serviceTimeAvg | select |     |     | </br>| serviceTimeMin | select |     |     | </br>| serviceTimeMax | select |     |     | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "name": "$orderby",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "OData order by query option."
+          },
+          {
+            "name": "interval",
+            "in": "query",
+            "required": true,
+            "type": "string",
+            "format": "duration",
+            "description": "By time interval. Interval must be multiple of 15 minutes and may not be zero. The value should be in ISO  8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations).This code can be used to convert TimeSpan to a valid interval string: XmlConvert.ToString(new TimeSpan(hours, minutes, seconds))."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of Report record.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ReportCollection"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/ReportRecordContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byRequest": {
+      "get": {
+        "tags": [
+          "Reports"
+        ],
+        "operationId": "Reports_ListByRequest",
+        "description": "Lists report records by Request.",
+        "x-ms-examples": {
+          "ApiManagementGetReportsByRequest": {
+            "$ref": "./examples/ApiManagementGetReportsByRequest.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": true,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| timestamp | filter | ge, le |     | </br>| apiId | filter | eq |     | </br>| operationId | filter | eq |     | </br>| productId | filter | eq |     | </br>| userId | filter | eq |     | </br>| apiRegion | filter | eq |     | </br>| subscriptionId | filter | eq |     | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of Report record.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/RequestReportCollection"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "x-ms-odata": "./definitions.json#/definitions/RequestReportRecordContract"
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimsubscriptions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimsubscriptions.json
new file mode 100644
index 000000000000..3c7cad660af8
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimsubscriptions.json
@@ -0,0 +1,502 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on Subscription entity associated with your Azure API Management deployment. The Subscription entity represents the association between a user and a product in API Management. Products contain one or more APIs, and once a product is published, developers can subscribe to the product and begin to use the product’s APIs.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions": {
+      "get": {
+        "tags": [
+          "Subscription"
+        ],
+        "operationId": "Subscription_List",
+        "description": "Lists all subscriptions of the API Management service instance.",
+        "x-ms-examples": {
+          "ApiManagementListSubscriptions": {
+            "$ref": "./examples/ApiManagementListSubscriptions.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| stateComment | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| ownerId | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| scope | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| userId | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| productId | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| state | filter | eq |     | </br>| user | expand |     |     | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A collection of the Subscription entities for the specified API Management service instance.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/SubscriptionCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/SubscriptionContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions/{sid}": {
+      "head": {
+        "tags": [
+          "Subscription"
+        ],
+        "operationId": "Subscription_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the apimanagement subscription specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadSubscription": {
+            "$ref": "./examples/ApiManagementHeadSubscription.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionEntityIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified apimanagement subscription entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "Subscription"
+        ],
+        "operationId": "Subscription_Get",
+        "description": "Gets the specified Subscription entity.",
+        "x-ms-examples": {
+          "ApiManagementGetSubscription": {
+            "$ref": "./examples/ApiManagementGetSubscription.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionEntityIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified Subscription entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/SubscriptionContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Subscription"
+        ],
+        "operationId": "Subscription_CreateOrUpdate",
+        "description": "Creates or updates the subscription of specified user to the specified product.",
+        "x-ms-examples": {
+          "ApiManagementCreateSubscription": {
+            "$ref": "./examples/ApiManagementCreateSubscription.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionEntityIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/SubscriptionCreateParameters"
+            },
+            "description": "Create parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/NotifySubscriptionStateChangeParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "The user was successfully subscribed to the product.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/SubscriptionContract"
+            }
+          },
+          "200": {
+            "description": "The user already subscribed to the product.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/SubscriptionContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "Subscription"
+        ],
+        "operationId": "Subscription_Update",
+        "description": "Updates the details of a subscription specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementUpdateSubscription": {
+            "$ref": "./examples/ApiManagementUpdateSubscription.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionEntityIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/SubscriptionUpdateParameters"
+            },
+            "description": "Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/NotifySubscriptionStateChangeParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The subscription details were successfully updated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Subscription"
+        ],
+        "operationId": "Subscription_Delete",
+        "description": "Deletes the specified subscription.",
+        "x-ms-examples": {
+          "ApiManagementDeleteSubscription": {
+            "$ref": "./examples/ApiManagementDeleteSubscription.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionEntityIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The subscription details were successfully deleted."
+          },
+          "204": {
+            "description": "The subscription details were successfully deleted."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions/{sid}/regeneratePrimaryKey": {
+      "post": {
+        "tags": [
+          "Subscription"
+        ],
+        "operationId": "Subscription_RegeneratePrimaryKey",
+        "description": "Regenerates primary key of existing subscription of the API Management service instance.",
+        "x-ms-examples": {
+          "ApiManagementSubscriptionRegeneratePrimaryKey": {
+            "$ref": "./examples/ApiManagementSubscriptionRegeneratePrimaryKey.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionEntityIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The primary key was successfully regenerated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions/{sid}/regenerateSecondaryKey": {
+      "post": {
+        "tags": [
+          "Subscription"
+        ],
+        "operationId": "Subscription_RegenerateSecondaryKey",
+        "description": "Regenerates secondary key of existing subscription of the API Management service instance.",
+        "x-ms-examples": {
+          "ApiManagementSubscriptionRegenerateSecondaryKey": {
+            "$ref": "./examples/ApiManagementSubscriptionRegenerateSecondaryKey.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionEntityIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The secondary key was successfully regenerated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions/{sid}/listSecrets": {
+      "post": {
+        "tags": [
+          "Subscription"
+        ],
+        "operationId": "Subscription_ListSecrets",
+        "description": "Gets the subscription keys.",
+        "x-ms-examples": {
+          "ApiManagementListSecretsSubscription": {
+            "$ref": "./examples/ApiManagementListSecretsSubscription.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionEntityIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains subscription keys.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/SubscriptionKeysContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimtagresources.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimtagresources.json
new file mode 100644
index 000000000000..525afd07bd08
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimtagresources.json
@@ -0,0 +1,99 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for querying APIs. Operations and Products by tags in your Azure API Management deployment.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tagResources": {
+      "get": {
+        "tags": [
+          "TagResource"
+        ],
+        "operationId": "TagResource_ListByService",
+        "description": "Lists a collection of resources associated with tags.",
+        "x-ms-examples": {
+          "ApiManagementListTagResources": {
+            "$ref": "./examples/ApiManagementListTagResources.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| aid | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| apiName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| apiRevision | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| path | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| description | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| serviceUrl | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| method | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| urlTemplate | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| terms | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| state | filter | eq |     | </br>| isCurrent | filter | eq |     | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of TagResource entities.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagResourceCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/TagResourceContract"
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimtags.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimtags.json
new file mode 100644
index 000000000000..ea44d76261a8
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimtags.json
@@ -0,0 +1,374 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on Tag entity in your Azure API Management deployment. Tags can be assigned to APIs, Operations and Products.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags": {
+      "get": {
+        "tags": [
+          "Tag"
+        ],
+        "operationId": "Tag_ListByService",
+        "description": "Lists a collection of tags defined within a service instance.",
+        "x-ms-examples": {
+          "ApiManagementListTags": {
+            "$ref": "./examples/ApiManagementListTags.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "name": "scope",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "Scope like 'apis', 'products' or 'apis/{apiId}"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of Tag entities.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/TagContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}": {
+      "head": {
+        "tags": [
+          "Tag"
+        ],
+        "operationId": "Tag_GetEntityState",
+        "description": "Gets the entity state version of the tag specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadTag": {
+            "$ref": "./examples/ApiManagementHeadTag.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TagIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Empty response body, ETag header entity state version.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "Tag"
+        ],
+        "operationId": "Tag_Get",
+        "description": "Gets the details of the tag specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetTag": {
+            "$ref": "./examples/ApiManagementGetTag.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TagIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified Tag entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Tag"
+        ],
+        "operationId": "Tag_CreateOrUpdate",
+        "description": "Creates a tag.",
+        "x-ms-examples": {
+          "ApiManagementCreateTag": {
+            "$ref": "./examples/ApiManagementCreateTag.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TagIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagCreateUpdateParameters"
+            },
+            "description": "Create parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Tag was created successfully.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagContract"
+            }
+          },
+          "200": {
+            "description": "Tag already exists.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "Tag"
+        ],
+        "operationId": "Tag_Update",
+        "description": "Updates the details of the tag specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementUpdateTag": {
+            "$ref": "./examples/ApiManagementUpdateTag.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TagIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TagCreateUpdateParameters"
+            },
+            "description": "Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The tag details were successfully updated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Tag"
+        ],
+        "operationId": "Tag_Delete",
+        "description": "Deletes specific tag of the API Management service instance.",
+        "x-ms-examples": {
+          "ApiManagementDeleteTag": {
+            "$ref": "./examples/ApiManagementDeleteTag.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TagIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Tag successfully removed"
+          },
+          "204": {
+            "description": "Tag successfully removed by previous request or does not exist"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimtenant.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimtenant.json
new file mode 100644
index 000000000000..7a03e8b28249
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimtenant.json
@@ -0,0 +1,740 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on tenant entity associated with your Azure API Management deployment. Using this entity you can manage properties and configuration that apply to the entire API Management service instance.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}": {
+      "head": {
+        "tags": [
+          "TenantAccess"
+        ],
+        "operationId": "TenantAccess_GetEntityTag",
+        "description": "Tenant access metadata",
+        "x-ms-examples": {
+          "ApiManagementHeadTenantAccess": {
+            "$ref": "./examples/ApiManagementHeadTenantAccess.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AccessParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Operation completed successfully.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "TenantAccess"
+        ],
+        "operationId": "TenantAccess_Get",
+        "description": "Get tenant access information details without secrets.",
+        "x-ms-examples": {
+          "ApiManagementGetTenantAccess": {
+            "$ref": "./examples/ApiManagementGetTenantAccess.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AccessParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Tenant Access information.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/AccessInformationContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "TenantAccess"
+        ],
+        "operationId": "TenantAccess_Update",
+        "description": "Update tenant access information details.",
+        "x-ms-examples": {
+          "ApiManagementUpdateTenantAccess": {
+            "$ref": "./examples/ApiManagementUpdateTenantAccess.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/AccessInformationUpdateParameters"
+            },
+            "description": "Parameters supplied to retrieve the Tenant Access Information."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AccessParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Tenant's access information updated successfully."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}/regeneratePrimaryKey": {
+      "post": {
+        "tags": [
+          "TenantAccess"
+        ],
+        "operationId": "TenantAccess_RegeneratePrimaryKey",
+        "description": "Regenerate primary access key",
+        "x-ms-examples": {
+          "ApiManagementTenantAccessRegenerateKey": {
+            "$ref": "./examples/ApiManagementTenantAccessRegenerateKey.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AccessParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The primary key was successfully regenerated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}/regenerateSecondaryKey": {
+      "post": {
+        "tags": [
+          "TenantAccess"
+        ],
+        "operationId": "TenantAccess_RegenerateSecondaryKey",
+        "description": "Regenerate secondary access key",
+        "x-ms-examples": {
+          "ApiManagementTenantAccessRegenerateKey": {
+            "$ref": "./examples/ApiManagementTenantAccessRegenerateKey.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AccessParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The secondary key was successfully regenerated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}/listSecrets": {
+      "post": {
+        "tags": [
+          "TenantAccess"
+        ],
+        "operationId": "TenantAccess_ListSecrets",
+        "description": "Get tenant access information details.",
+        "x-ms-examples": {
+          "ApiManagementListSecretsTenantAccess": {
+            "$ref": "./examples/ApiManagementListSecretsTenantAccess.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AccessParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Tenant Access information.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/AccessInformationContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}/git": {
+      "get": {
+        "tags": [
+          "TenantAccessGit"
+        ],
+        "operationId": "TenantAccessGit_Get",
+        "description": "Gets the Git access configuration for the tenant. Without secrets.",
+        "x-ms-examples": {
+          "ApiManagementGetTenantAccess": {
+            "$ref": "./examples/ApiManagementGetTenantAccess.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AccessParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Git Access Information for the Service.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/AccessInformationContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}/git/regeneratePrimaryKey": {
+      "post": {
+        "tags": [
+          "TenantAccessGit"
+        ],
+        "operationId": "TenantAccessGit_RegeneratePrimaryKey",
+        "description": "Regenerate primary access key for GIT.",
+        "x-ms-examples": {
+          "ApiManagementTenantAccessRegenerateKey": {
+            "$ref": "./examples/ApiManagementTenantAccessRegenerateKey.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AccessParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The primary key was successfully regenerated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}/git/regenerateSecondaryKey": {
+      "post": {
+        "tags": [
+          "TenantAccessGit"
+        ],
+        "operationId": "TenantAccessGit_RegenerateSecondaryKey",
+        "description": "Regenerate secondary access key for GIT.",
+        "x-ms-examples": {
+          "ApiManagementTenantAccessRegenerateKey": {
+            "$ref": "./examples/ApiManagementTenantAccessRegenerateKey.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AccessParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The secondary key was successfully regenerated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}/git/listSecrets": {
+      "post": {
+        "tags": [
+          "TenantAccessGit"
+        ],
+        "operationId": "TenantAccessGit_ListSecrets",
+        "description": "Gets the Git access configuration for the tenant.",
+        "x-ms-examples": {
+          "ApiManagementListSecretsTenantAccess": {
+            "$ref": "./examples/ApiManagementListSecretsTenantAccess.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AccessParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Git Access Information for the Service.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/AccessInformationContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{configurationName}/deploy": {
+      "post": {
+        "tags": [
+          "TenantConfiguration"
+        ],
+        "operationId": "TenantConfiguration_Deploy",
+        "description": "This operation applies changes from the specified Git branch to the configuration database. This is a long running operation and could take several minutes to complete.",
+        "externalDocs": {
+          "description": "To deploy any service configuration changes to the API Management service instance",
+          "url": "https://azure.microsoft.com/en-us/documentation/articles/api-management-configuration-repository-git/#to-deploy-any-service-configuration-changes-to-the-api-management-service-instance"
+        },
+        "x-ms-examples": {
+          "ApiManagementTenantConfigurationDeploy": {
+            "$ref": "./examples/ApiManagementTenantConfigurationDeploy.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/DeployConfigurationParameters"
+            },
+            "description": "Deploy Configuration parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ConfigurationParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Accepted: Location header contains the URL where the status of the long running operation can be checked."
+          },
+          "200": {
+            "description": "Result of applying changes from Git branch to database.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/OperationResultContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "location"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{configurationName}/save": {
+      "post": {
+        "tags": [
+          "TenantConfiguration"
+        ],
+        "operationId": "TenantConfiguration_Save",
+        "description": "This operation creates a commit with the current configuration snapshot to the specified branch in the repository. This is a long running operation and could take several minutes to complete.",
+        "externalDocs": {
+          "description": "To save the service configuration to the Git repository",
+          "url": "https://azure.microsoft.com/en-us/documentation/articles/api-management-configuration-repository-git/#to-save-the-service-configuration-to-the-git-repository"
+        },
+        "x-ms-examples": {
+          "ApiManagementTenantConfigurationSave": {
+            "$ref": "./examples/ApiManagementTenantConfigurationSave.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/SaveConfigurationParameter"
+            },
+            "description": "Save Configuration parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ConfigurationParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Accepted: Location header contains the URL where the status of the long running operation can be checked."
+          },
+          "200": {
+            "description": "Result of creating a commit in the repository.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/OperationResultContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "location"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{configurationName}/validate": {
+      "post": {
+        "tags": [
+          "TenantConfiguration"
+        ],
+        "operationId": "TenantConfiguration_Validate",
+        "description": "This operation validates the changes in the specified Git branch. This is a long running operation and could take several minutes to complete.",
+        "x-ms-examples": {
+          "ApiManagementTenantConfigurationValidate": {
+            "$ref": "./examples/ApiManagementTenantConfigurationValidate.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/DeployConfigurationParameters"
+            },
+            "description": "Validate Configuration parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ConfigurationParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Accepted: Location header contains the URL where the status of the long running operation can be checked."
+          },
+          "200": {
+            "description": "Result of validating the changes in the specified Git branch.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/OperationResultContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "location"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{configurationName}/syncState": {
+      "get": {
+        "tags": [
+          "TenantConfigurationSyncState"
+        ],
+        "operationId": "TenantConfiguration_GetSyncState",
+        "description": "Gets the status of the most recent synchronization between the configuration database and the Git repository.",
+        "x-ms-examples": {
+          "ApiManagementTenantAccessSyncState": {
+            "$ref": "./examples/ApiManagementTenantAccessSyncState.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ConfigurationParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Sync state result.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/TenantConfigurationSyncStateContract"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimusers.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimusers.json
new file mode 100644
index 000000000000..c290fb30f0a0
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/apimusers.json
@@ -0,0 +1,702 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on User entity in Azure API Management deployment. The User entity in API Management represents the developers that call the APIs of the products to which they are subscribed.",
+    "version": "2019-12-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users": {
+      "get": {
+        "tags": [
+          "User"
+        ],
+        "operationId": "User_ListByService",
+        "description": "Lists a collection of registered users in the specified service instance.",
+        "x-ms-examples": {
+          "ApiManagementListUsers": {
+            "$ref": "./examples/ApiManagementListUsers.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| firstName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| lastName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| email | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| state | filter | eq |     | </br>| registrationDate | filter | ge, le, eq, ne, gt, lt |     | </br>| note | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| groups | expand |     |     | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "name": "expandGroups",
+            "in": "query",
+            "type": "boolean",
+            "description": "Detailed Group in response."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of User entities.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/UserCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/UserContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{userId}": {
+      "head": {
+        "tags": [
+          "User"
+        ],
+        "operationId": "User_GetEntityTag",
+        "description": "Gets the entity state (Etag) version of the user specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementHeadUser": {
+            "$ref": "./examples/ApiManagementHeadUser.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/UserIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified user entity exists and current entity state version is present in the ETag header.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "User"
+        ],
+        "operationId": "User_Get",
+        "description": "Gets the details of the user specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetUser": {
+            "$ref": "./examples/ApiManagementGetUser.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/UserIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Gets the specified user entity.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/UserContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "User"
+        ],
+        "operationId": "User_CreateOrUpdate",
+        "description": "Creates or Updates a user.",
+        "x-ms-examples": {
+          "ApiManagementCreateUser": {
+            "$ref": "./examples/ApiManagementCreateUser.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/UserIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/UserCreateParameters"
+            },
+            "description": "Create or update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "User was successfully created.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/UserContract"
+            },
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            }
+          },
+          "200": {
+            "description": "User was successfully updated.",
+            "headers": {
+              "ETag": {
+                "description": "Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "./definitions.json#/definitions/UserContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "User"
+        ],
+        "operationId": "User_Update",
+        "description": "Updates the details of the user specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementUpdateUser": {
+            "$ref": "./examples/ApiManagementUpdateUser.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/UserIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/UserUpdateParameters"
+            },
+            "description": "Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The user details were successfully updated."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "User"
+        ],
+        "operationId": "User_Delete",
+        "description": "Deletes specific user.",
+        "x-ms-examples": {
+          "ApiManagementDeleteUser": {
+            "$ref": "./examples/ApiManagementDeleteUser.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/UserIdParameter"
+          },
+          {
+            "name": "deleteSubscriptions",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "description": "Whether to delete user's subscription or not."
+          },
+          {
+            "name": "notify",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "description": "Send an Account Closed Email notification to the User."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The user details were successfully deleted."
+          },
+          "204": {
+            "description": "The user details were successfully deleted."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{userId}/generateSsoUrl": {
+      "post": {
+        "tags": [
+          "Users"
+        ],
+        "operationId": "User_GenerateSsoUrl",
+        "description": "Retrieves a redirection URL containing an authentication token for signing a given user into the developer portal.",
+        "x-ms-examples": {
+          "ApiManagementUserGenerateSsoUrl": {
+            "$ref": "./examples/ApiManagementUserGenerateSsoUrl.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/UserIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the single sign-on URL.",
+            "schema": {
+              "x-ms-client-flatten": true,
+              "$ref": "./definitions.json#/definitions/GenerateSsoUrlResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{userId}/groups": {
+      "get": {
+        "tags": [
+          "UserGroup"
+        ],
+        "operationId": "UserGroup_List",
+        "description": "Lists all user groups.",
+        "x-ms-examples": {
+          "ApiManagementListUserGroups": {
+            "$ref": "./examples/ApiManagementListUserGroups.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/UserIdParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| description | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of Group entities.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GroupCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/GroupContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{userId}/subscriptions": {
+      "get": {
+        "tags": [
+          "UserSubscription"
+        ],
+        "operationId": "UserSubscription_List",
+        "description": "Lists the collection of subscriptions of the specified user.",
+        "x-ms-examples": {
+          "ApiManagementListUserSubscriptions": {
+            "$ref": "./examples/ApiManagementListUserSubscriptions.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/UserIdParameter"
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "|   Field     |     Usage     |     Supported operators     |     Supported functions     |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| stateComment | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| ownerId | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| scope | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| userId | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>| productId | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | </br>"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of Subscription entities.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/SubscriptionCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/SubscriptionContract"
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{userId}/identities": {
+      "get": {
+        "tags": [
+          "UserIdentity"
+        ],
+        "operationId": "UserIdentities_List",
+        "description": "List of all user identities.",
+        "x-ms-examples": {
+          "ApiManagementListUserIdentities": {
+            "$ref": "./examples/ApiManagementListUserIdentities.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/UserIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists of User Identities.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/UserIdentityCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{userId}/token": {
+      "post": {
+        "tags": [
+          "UserToken"
+        ],
+        "operationId": "User_GetSharedAccessToken",
+        "description": "Gets the Shared Access Authorization Token for the User.",
+        "x-ms-examples": {
+          "ApiManagementUserToken": {
+            "$ref": "./examples/ApiManagementUserToken.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/UserIdParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/UserTokenParameters"
+            },
+            "description": "Create Authorization Token parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the authorization token for the user.",
+            "schema": {
+              "x-ms-client-flatten": true,
+              "$ref": "./definitions.json#/definitions/UserTokenResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{userId}/confirmations/password/send": {
+      "post": {
+        "tags": [
+          "UserConfirmationPasswordSend"
+        ],
+        "operationId": "UserConfirmationPassword_Send",
+        "description": "Sends confirmation",
+        "x-ms-examples": {
+          "ApiManagementUserConfirmationPasswordSend": {
+            "$ref": "./examples/ApiManagementUserConfirmationPasswordSend.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/UserIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Notification successfully sent"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/definitions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/definitions.json
new file mode 100644
index 000000000000..490ae700e22e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/definitions.json
@@ -0,0 +1,5561 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "version": "2019-12-01",
+    "description": "A spec file containing all the definitions",
+    "title": "Definitions file"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {},
+  "definitions": {
+    "AccessInformationContract": {
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Identifier."
+        },
+        "primaryKey": {
+          "type": "string",
+          "description": "Primary access key. This property will not be filled on 'GET' operations! Use '/listSecrets' POST request to get the value."
+        },
+        "secondaryKey": {
+          "type": "string",
+          "description": "Secondary access key. This property will not be filled on 'GET' operations! Use '/listSecrets' POST request to get the value."
+        },
+        "enabled": {
+          "type": "boolean",
+          "description": "Determines whether direct access is enabled."
+        }
+      },
+      "description": "Tenant access information contract of the API Management service."
+    },
+    "AccessInformationUpdateParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/AccessInformationUpdateParameterProperties",
+          "description": "Tenant access information update parameter properties."
+        }
+      },
+      "description": "Tenant access information update parameters."
+    },
+    "AccessInformationUpdateParameterProperties": {
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Determines whether direct access is enabled."
+        }
+      },
+      "description": "Tenant access information update parameters of the API Management service"
+    },
+    "ApiCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ApiContract"
+          },
+          "description": "Page values.",
+          "readOnly": true
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any.",
+          "readOnly": true
+        }
+      },
+      "description": "Paged Api list representation."
+    },
+    "ApiContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ApiContractProperties",
+          "description": "Api entity contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Api details."
+    },
+    "ApiContractProperties": {
+      "properties": {
+        "sourceApiId": {
+          "type": "string",
+          "description": "API identifier of the source API."
+        },
+        "displayName": {
+          "type": "string",
+          "description": "API name. Must be 1 to 300 characters long.",
+          "minLength": 1,
+          "maxLength": 300
+        },
+        "serviceUrl": {
+          "type": "string",
+          "description": "Absolute URL of the backend service implementing this API. Cannot be more than 2000 characters long.",
+          "minLength": 0,
+          "maxLength": 2000
+        },
+        "path": {
+          "type": "string",
+          "description": "Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API.",
+          "minLength": 0,
+          "maxLength": 400
+        },
+        "protocols": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "http",
+              "https"
+            ],
+            "x-ms-enum": {
+              "name": "Protocol",
+              "modelAsString": false
+            }
+          },
+          "description": "Describes on which protocols the operations in this API can be invoked."
+        },
+        "apiVersionSet": {
+          "description": "Version set details",
+          "$ref": "#/definitions/ApiVersionSetContractDetails"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApiEntityBaseContract"
+        }
+      ],
+      "required": [
+        "path"
+      ],
+      "description": "Api Entity Properties"
+    },
+    "ApiCreateOrUpdateParameter": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ApiCreateOrUpdateProperties",
+          "description": "Api entity create of update properties."
+        }
+      },
+      "description": "API Create or Update Parameters."
+    },
+    "ApiCreateOrUpdateProperties": {
+      "properties": {
+        "value": {
+          "type": "string",
+          "description": "Content value when Importing an API."
+        },
+        "format": {
+          "type": "string",
+          "description": "Format of the Content in which the API is getting imported.",
+          "enum": [
+            "wadl-xml",
+            "wadl-link-json",
+            "swagger-json",
+            "swagger-link-json",
+            "wsdl",
+            "wsdl-link",
+            "openapi",
+            "openapi+json",
+            "openapi-link",
+            "openapi+json-link"
+          ],
+          "x-ms-enum": {
+            "name": "ContentFormat",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "wadl-xml",
+                "description": "The contents are inline and Content type is a WADL document."
+              },
+              {
+                "value": "wadl-link-json",
+                "description": "The WADL document is hosted on a publicly accessible internet address."
+              },
+              {
+                "value": "swagger-json",
+                "description": "The contents are inline and Content Type is a OpenApi 2.0 Document."
+              },
+              {
+                "value": "swagger-link-json",
+                "description": "The Open Api 2.0 document is hosted on a publicly accessible internet address."
+              },
+              {
+                "value": "wsdl",
+                "description": "The contents are inline and the document is a WSDL/Soap document."
+              },
+              {
+                "value": "wsdl-link",
+                "description": "The WSDL document is hosted on a publicly accessible internet address."
+              },
+              {
+                "value": "openapi",
+                "description": "The contents are inline and Content Type is a OpenApi 3.0 Document in YAML format."
+              },
+              {
+                "value": "openapi+json",
+                "description": "The contents are inline and Content Type is a OpenApi 3.0 Document in JSON format."
+              },
+              {
+                "value": "openapi-link",
+                "description": "The Open Api 3.0 document is hosted on a publicly accessible internet address."
+              },
+              {
+                "value": "openapi+json-link",
+                "description": "The Open Api 3.0 Json document is hosted on a publicly accessible internet address."
+              }
+            ]
+          }
+        },
+        "wsdlSelector": {
+          "type": "object",
+          "description": "Criteria to limit import of WSDL to a subset of the document.",
+          "properties": {
+            "wsdlServiceName": {
+              "type": "string",
+              "description": "Name of service to import from WSDL"
+            },
+            "wsdlEndpointName": {
+              "type": "string",
+              "description": "Name of endpoint(port) to import from WSDL"
+            }
+          }
+        },
+        "apiType": {
+          "type": "string",
+          "description": "Type of Api to create. \n * `http` creates a SOAP to REST API \n * `soap` creates a SOAP pass-through API .",
+          "enum": [
+            "http",
+            "soap"
+          ],
+          "x-ms-client-name": "SoapApiType",
+          "x-ms-enum": {
+            "name": "SoapApiType",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "http",
+                "description": "Imports a SOAP API having a RESTful front end.",
+                "name": "SoapToRest"
+              },
+              {
+                "value": "soap",
+                "description": "Imports the Soap API having a SOAP front end.",
+                "name": "SoapPassThrough"
+              }
+            ]
+          }
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApiContractProperties"
+        }
+      ],
+      "description": "Api Create or Update Properties."
+    },
+    "ApiEntityBaseContract": {
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "Description of the API. May include HTML formatting tags."
+        },
+        "authenticationSettings": {
+          "$ref": "#/definitions/AuthenticationSettingsContract",
+          "description": "Collection of authentication settings included into this API."
+        },
+        "subscriptionKeyParameterNames": {
+          "$ref": "#/definitions/SubscriptionKeyParameterNamesContract",
+          "description": "Protocols over which API is made available."
+        },
+        "type": {
+          "type": "string",
+          "description": "Type of API.",
+          "enum": [
+            "http",
+            "soap"
+          ],
+          "x-ms-client-name": "ApiType",
+          "x-ms-enum": {
+            "name": "ApiType",
+            "modelAsString": true
+          }
+        },
+        "apiRevision": {
+          "type": "string",
+          "description": "Describes the Revision of the Api. If no value is provided, default revision 1 is created",
+          "minLength": 1,
+          "maxLength": 100
+        },
+        "apiVersion": {
+          "type": "string",
+          "description": "Indicates the Version identifier of the API if the API is versioned",
+          "maxLength": 100
+        },
+        "isCurrent": {
+          "type": "boolean",
+          "description": "Indicates if API revision is current api revision."
+        },
+        "isOnline": {
+          "type": "boolean",
+          "description": "Indicates if API revision is accessible via the gateway.",
+          "readOnly": true
+        },
+        "apiRevisionDescription": {
+          "type": "string",
+          "description": "Description of the Api Revision.",
+          "maxLength": 256
+        },
+        "apiVersionDescription": {
+          "type": "string",
+          "description": "Description of the Api Version.",
+          "maxLength": 256
+        },
+        "apiVersionSetId": {
+          "type": "string",
+          "description": "A resource identifier for the related ApiVersionSet."
+        },
+        "subscriptionRequired": {
+          "type": "boolean",
+          "description": "Specifies whether an API or Product subscription is required for accessing the API."
+        }
+      },
+      "description": "API base contract details."
+    },
+    "ApiExportResult": {
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "ResourceId of the API which was exported."
+        },
+        "format": {
+          "type": "string",
+          "enum": [
+            "swagger-link-json",
+            "wadl-link-json",
+            "wsdl-link+xml",
+            "openapi-link"
+          ],
+          "x-ms-client-name": "ExportResultFormat",
+          "x-ms-enum": {
+            "name": "ExportResultFormat",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "swagger-link-json",
+                "description": "The Api Definition is exported in OpenApi Specification 2.0 format to the Storage Blob.",
+                "name": "Swagger"
+              },
+              {
+                "value": "wsdl-link+xml",
+                "description": "The Api Definition is exported in WSDL Schema to Storage Blob. This is only supported for APIs of Type `soap`",
+                "name": "Wsdl"
+              },
+              {
+                "value": "wadl-link-json",
+                "description": "Export the Api Definition in WADL Schema to Storage Blob.",
+                "name": "Wadl"
+              },
+              {
+                "value": "openapi-link",
+                "description": "Export the Api Definition in OpenApi Specification 3.0 to Storage Blob.",
+                "name": "OpenApi"
+              }
+            ]
+          },
+          "description": "Format in which the Api Details are exported to the Storage Blob with Sas Key valid for 5 minutes."
+        },
+        "value": {
+          "type": "object",
+          "description": "The object defining the schema of the exported Api Detail",
+          "properties": {
+            "link": {
+              "type": "string",
+              "description": "Link to the Storage Blob containing the result of the export operation. The Blob Uri is only valid for 5 minutes."
+            }
+          }
+        }
+      },
+      "description": "API Export result."
+    },
+    "ApiReleaseCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ApiReleaseContract"
+          },
+          "description": "Page values.",
+          "readOnly": true
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any.",
+          "readOnly": true
+        }
+      },
+      "description": "Paged ApiRelease list representation."
+    },
+    "ApiReleaseContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ApiReleaseContractProperties",
+          "description": "ApiRelease entity contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "ApiRelease details."
+    },
+    "ApiReleaseContractProperties": {
+      "properties": {
+        "apiId": {
+          "type": "string",
+          "description": "Identifier of the API the release belongs to."
+        },
+        "createdDateTime": {
+          "type": "string",
+          "readOnly": true,
+          "format": "date-time",
+          "description": "The time the API was released. The date conforms to the following format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard."
+        },
+        "updatedDateTime": {
+          "type": "string",
+          "readOnly": true,
+          "format": "date-time",
+          "description": "The time the API release was updated."
+        },
+        "notes": {
+          "type": "string",
+          "description": "Release Notes"
+        }
+      },
+      "description": "API Release details"
+    },
+    "ApiRevisionCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ApiRevisionContract"
+          },
+          "description": "Page values.",
+          "readOnly": true
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any.",
+          "readOnly": true
+        }
+      },
+      "description": "Paged Api Revision list representation."
+    },
+    "ApiRevisionContract": {
+      "properties": {
+        "apiId": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Identifier of the API Revision."
+        },
+        "apiRevision": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100,
+          "readOnly": true,
+          "description": "Revision number of API."
+        },
+        "createdDateTime": {
+          "type": "string",
+          "readOnly": true,
+          "format": "date-time",
+          "description": "The time the API Revision was created. The date conforms to the following format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard."
+        },
+        "updatedDateTime": {
+          "type": "string",
+          "readOnly": true,
+          "format": "date-time",
+          "description": "The time the API Revision were updated. The date conforms to the following format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard."
+        },
+        "description": {
+          "type": "string",
+          "readOnly": true,
+          "maxLength": 256,
+          "description": "Description of the API Revision."
+        },
+        "privateUrl": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Gateway URL for accessing the non-current API Revision."
+        },
+        "isOnline": {
+          "type": "boolean",
+          "readOnly": true,
+          "description": "Indicates if API revision is the current api revision."
+        },
+        "isCurrent": {
+          "type": "boolean",
+          "readOnly": true,
+          "description": "Indicates if API revision is accessible via the gateway."
+        }
+      },
+      "description": "Summary of revision metadata."
+    },
+    "ApiRevisionInfoContract": {
+      "description": "Object used to create an API Revision or Version based on an existing API Revision",
+      "properties": {
+        "sourceApiId": {
+          "type": "string",
+          "description": "Resource identifier of API to be used to create the revision from."
+        },
+        "apiVersionName": {
+          "type": "string",
+          "maxLength": 100,
+          "description": "Version identifier for the new API Version."
+        },
+        "apiRevisionDescription": {
+          "type": "string",
+          "maxLength": 256,
+          "description": "Description of new API Revision."
+        },
+        "apiVersionSet": {
+          "description": "Version set details",
+          "$ref": "#/definitions/ApiVersionSetContractDetails"
+        }
+      }
+    },
+    "ApiTagResourceContractProperties": {
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "API identifier in the form /apis/{apiId}."
+        },
+        "name": {
+          "type": "string",
+          "description": "API name.",
+          "minLength": 1,
+          "maxLength": 300
+        },
+        "serviceUrl": {
+          "type": "string",
+          "description": "Absolute URL of the backend service implementing this API.",
+          "minLength": 1,
+          "maxLength": 2000
+        },
+        "path": {
+          "type": "string",
+          "description": "Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API.",
+          "minLength": 0,
+          "maxLength": 400
+        },
+        "protocols": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "http",
+              "https"
+            ],
+            "x-ms-enum": {
+              "name": "Protocol",
+              "modelAsString": false
+            }
+          },
+          "description": "Describes on which protocols the operations in this API can be invoked."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./definitions.json#/definitions/ApiEntityBaseContract"
+        }
+      ],
+      "description": "API contract properties for the Tag Resources."
+    },
+    "ApiUpdateContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ApiContractUpdateProperties",
+          "description": "Properties of the API entity that can be updated."
+        }
+      },
+      "description": "API update contract details."
+    },
+    "ApiContractUpdateProperties": {
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "API name.",
+          "minLength": 1,
+          "maxLength": 300
+        },
+        "serviceUrl": {
+          "type": "string",
+          "description": "Absolute URL of the backend service implementing this API.",
+          "minLength": 1,
+          "maxLength": 2000
+        },
+        "path": {
+          "type": "string",
+          "description": "Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API.",
+          "minLength": 0,
+          "maxLength": 400
+        },
+        "protocols": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "http",
+              "https"
+            ],
+            "x-ms-enum": {
+              "name": "Protocol",
+              "modelAsString": false
+            }
+          },
+          "description": "Describes on which protocols the operations in this API can be invoked."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApiEntityBaseContract"
+        }
+      ],
+      "description": "API update contract properties."
+    },
+    "ApiVersionSetCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ApiVersionSetContract"
+          },
+          "description": "Page values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged Api Version Set list representation."
+    },
+    "ApiVersionSetContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ApiVersionSetContractProperties",
+          "description": "Api VersionSet contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Api Version Set Contract details."
+    },
+    "ApiVersionSetContractDetails": {
+      "description": "An API Version Set contains the common configuration for a set of API Versions relating ",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Identifier for existing API Version Set. Omit this value to create a new Version Set."
+        },
+        "name": {
+          "type": "string",
+          "description": "The display Name of the API Version Set."
+        },
+        "description": {
+          "type": "string",
+          "description": "Description of API Version Set."
+        },
+        "versioningScheme": {
+          "type": "string",
+          "description": "An value that determines where the API Version identifer will be located in a HTTP request.",
+          "enum": [
+            "Segment",
+            "Query",
+            "Header"
+          ]
+        },
+        "versionQueryName": {
+          "type": "string",
+          "description": "Name of query parameter that indicates the API Version if versioningScheme is set to `query`."
+        },
+        "versionHeaderName": {
+          "type": "string",
+          "description": "Name of HTTP header parameter that indicates the API Version if versioningScheme is set to `header`."
+        }
+      }
+    },
+    "ApiVersionSetContractProperties": {
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "Name of API Version Set",
+          "minLength": 1,
+          "maxLength": 100
+        },
+        "versioningScheme": {
+          "type": "string",
+          "description": "An value that determines where the API Version identifer will be located in a HTTP request.",
+          "enum": [
+            "Segment",
+            "Query",
+            "Header"
+          ],
+          "x-ms-enum": {
+            "name": "versioningScheme",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "Segment",
+                "description": "The API Version is passed in a path segment."
+              },
+              {
+                "value": "Query",
+                "description": "The API Version is passed in a query parameter."
+              },
+              {
+                "value": "Header",
+                "description": "The API Version is passed in a HTTP header."
+              }
+            ]
+          }
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApiVersionSetEntityBase"
+        }
+      ],
+      "required": [
+        "displayName",
+        "versioningScheme"
+      ],
+      "description": "Properties of an API Version Set."
+    },
+    "ApiVersionSetEntityBase": {
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "Description of API Version Set."
+        },
+        "versionQueryName": {
+          "type": "string",
+          "description": "Name of query parameter that indicates the API Version if versioningScheme is set to `query`.",
+          "minLength": 1,
+          "maxLength": 100
+        },
+        "versionHeaderName": {
+          "type": "string",
+          "description": "Name of HTTP header parameter that indicates the API Version if versioningScheme is set to `header`.",
+          "minLength": 1,
+          "maxLength": 100
+        }
+      },
+      "description": "Api Version set base parameters"
+    },
+    "ApiVersionSetUpdateParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ApiVersionSetUpdateParametersProperties",
+          "description": "Parameters to update or create an Api Version Set Contract."
+        }
+      },
+      "description": "Parameters to update or create an Api Version Set Contract."
+    },
+    "ApiVersionSetUpdateParametersProperties": {
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "Name of API Version Set",
+          "minLength": 1,
+          "maxLength": 100
+        },
+        "versioningScheme": {
+          "type": "string",
+          "description": "An value that determines where the API Version identifer will be located in a HTTP request.",
+          "enum": [
+            "Segment",
+            "Query",
+            "Header"
+          ],
+          "x-ms-enum": {
+            "name": "versioningScheme",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "Segment",
+                "description": "The API Version is passed in a path segment."
+              },
+              {
+                "value": "Query",
+                "description": "The API Version is passed in a query parameter."
+              },
+              {
+                "value": "Header",
+                "description": "The API Version is passed in a HTTP header."
+              }
+            ]
+          }
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApiVersionSetEntityBase"
+        }
+      ],
+      "description": "Properties used to create or update an API Version Set."
+    },
+    "AuthenticationSettingsContract": {
+      "properties": {
+        "oAuth2": {
+          "$ref": "#/definitions/OAuth2AuthenticationSettingsContract",
+          "description": "OAuth2 Authentication settings"
+        },
+        "openid": {
+          "$ref": "#/definitions/OpenIdAuthenticationSettingsContract",
+          "description": "OpenID Connect Authentication Settings"
+        }
+      },
+      "description": "API Authentication Settings."
+    },
+    "AuthorizationServerCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/AuthorizationServerContract"
+          },
+          "description": "Page values."
+        },
+        "count": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total record count number across all pages."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged OAuth2 Authorization Servers list representation."
+    },
+    "AuthorizationServerContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/AuthorizationServerContractProperties",
+          "description": "Properties of the External OAuth authorization server Contract."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "External OAuth authorization server settings."
+    },
+    "AuthorizationServerContractBaseProperties": {
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "Description of the authorization server. Can contain HTML formatting tags."
+        },
+        "authorizationMethods": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "HEAD",
+              "OPTIONS",
+              "TRACE",
+              "GET",
+              "POST",
+              "PUT",
+              "PATCH",
+              "DELETE"
+            ],
+            "x-ms-enum": {
+              "name": "AuthorizationMethod",
+              "modelAsString": false
+            }
+          },
+          "description": "HTTP verbs supported by the authorization endpoint. GET must be always present. POST is optional."
+        },
+        "clientAuthenticationMethod": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "Basic",
+              "Body"
+            ],
+            "x-ms-enum": {
+              "name": "ClientAuthenticationMethod",
+              "modelAsString": true,
+              "values": [
+                {
+                  "value": "Basic",
+                  "description": "Basic Client Authentication method."
+                },
+                {
+                  "value": "Body",
+                  "description": "Body based Authentication method."
+                }
+              ]
+            }
+          },
+          "description": "Method of authentication supported by the token endpoint of this authorization server. Possible values are Basic and/or Body. When Body is specified, client credentials and other parameters are passed within the request body in the application/x-www-form-urlencoded format."
+        },
+        "tokenBodyParameters": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/TokenBodyParameterContract"
+          },
+          "description": "Additional parameters required by the token endpoint of this authorization server represented as an array of JSON objects with name and value string properties, i.e. {\"name\" : \"name value\", \"value\": \"a value\"}."
+        },
+        "tokenEndpoint": {
+          "type": "string",
+          "description": "OAuth token endpoint. Contains absolute URI to entity being referenced.",
+          "externalDocs": {
+            "url": "http://tools.ietf.org/html/rfc6749#section-3.1"
+          }
+        },
+        "supportState": {
+          "type": "boolean",
+          "description": "If true, authorization server will include state parameter from the authorization request to its response. Client may use state parameter to raise protocol security.",
+          "externalDocs": {
+            "url": "http://tools.ietf.org/html/rfc6749#section-3.1"
+          }
+        },
+        "defaultScope": {
+          "type": "string",
+          "description": "Access token scope that is going to be requested by default. Can be overridden at the API level. Should be provided in the form of a string containing space-delimited values.",
+          "externalDocs": {
+            "url": "http://tools.ietf.org/html/rfc6749#section-3.3"
+          }
+        },
+        "bearerTokenSendingMethods": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "authorizationHeader",
+              "query"
+            ],
+            "x-ms-enum": {
+              "name": "BearerTokenSendingMethod",
+              "modelAsString": true
+            }
+          },
+          "description": "Specifies the mechanism by which access token is passed to the API. ",
+          "externalDocs": {
+            "url": "http://tools.ietf.org/html/rfc6749#section-4"
+          }
+        },
+        "resourceOwnerUsername": {
+          "type": "string",
+          "description": "Can be optionally specified when resource owner password grant type is supported by this authorization server. Default resource owner username."
+        },
+        "resourceOwnerPassword": {
+          "type": "string",
+          "description": "Can be optionally specified when resource owner password grant type is supported by this authorization server. Default resource owner password."
+        }
+      },
+      "description": "External OAuth authorization server Update settings contract."
+    },
+    "AuthorizationServerContractProperties": {
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "User-friendly authorization server name.",
+          "minLength": 1,
+          "maxLength": 50
+        },
+        "clientRegistrationEndpoint": {
+          "type": "string",
+          "description": "Optional reference to a page where client or app registration for this authorization server is performed. Contains absolute URL to entity being referenced."
+        },
+        "authorizationEndpoint": {
+          "type": "string",
+          "description": "OAuth authorization endpoint. See http://tools.ietf.org/html/rfc6749#section-3.2."
+        },
+        "grantTypes": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "authorizationCode",
+              "implicit",
+              "resourceOwnerPassword",
+              "clientCredentials"
+            ],
+            "x-ms-enum": {
+              "name": "GrantType",
+              "modelAsString": true,
+              "values": [
+                {
+                  "value": "authorizationCode",
+                  "description": "Authorization Code Grant flow as described https://tools.ietf.org/html/rfc6749#section-4.1."
+                },
+                {
+                  "value": "implicit",
+                  "description": "Implicit Code Grant flow as described https://tools.ietf.org/html/rfc6749#section-4.2."
+                },
+                {
+                  "value": "resourceOwnerPassword",
+                  "description": "Resource Owner Password Grant flow as described https://tools.ietf.org/html/rfc6749#section-4.3."
+                },
+                {
+                  "value": "clientCredentials",
+                  "description": "Client Credentials Grant flow as described https://tools.ietf.org/html/rfc6749#section-4.4."
+                }
+              ]
+            }
+          },
+          "description": "Form of an authorization grant, which the client uses to request the access token.",
+          "externalDocs": {
+            "url": "http://tools.ietf.org/html/rfc6749#section-4"
+          }
+        },
+        "clientId": {
+          "type": "string",
+          "description": "Client or app id registered with this authorization server."
+        },
+        "clientSecret": {
+          "x-ms-secret": true,
+          "type": "string",
+          "description": "Client or app secret registered with this authorization server. This property will not be filled on 'GET' operations! Use '/listSecrets' POST request to get the value."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/AuthorizationServerContractBaseProperties"
+        }
+      ],
+      "required": [
+        "displayName",
+        "clientRegistrationEndpoint",
+        "authorizationEndpoint",
+        "clientId",
+        "grantTypes"
+      ],
+      "description": "External OAuth authorization server settings Properties."
+    },
+    "AuthorizationServerUpdateContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/AuthorizationServerUpdateContractProperties",
+          "description": "Properties of the External OAuth authorization server update Contract."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "External OAuth authorization server settings."
+    },
+    "AuthorizationServerUpdateContractProperties": {
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "User-friendly authorization server name.",
+          "minLength": 1,
+          "maxLength": 50
+        },
+        "clientRegistrationEndpoint": {
+          "type": "string",
+          "description": "Optional reference to a page where client or app registration for this authorization server is performed. Contains absolute URL to entity being referenced."
+        },
+        "authorizationEndpoint": {
+          "type": "string",
+          "description": "OAuth authorization endpoint. See http://tools.ietf.org/html/rfc6749#section-3.2."
+        },
+        "grantTypes": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "authorizationCode",
+              "implicit",
+              "resourceOwnerPassword",
+              "clientCredentials"
+            ],
+            "x-ms-enum": {
+              "name": "GrantType",
+              "modelAsString": true,
+              "values": [
+                {
+                  "value": "authorizationCode",
+                  "description": "Authorization Code Grant flow as described https://tools.ietf.org/html/rfc6749#section-4.1."
+                },
+                {
+                  "value": "implicit",
+                  "description": "Implicit Code Grant flow as described https://tools.ietf.org/html/rfc6749#section-4.2."
+                },
+                {
+                  "value": "resourceOwnerPassword",
+                  "description": "Resource Owner Password Grant flow as described https://tools.ietf.org/html/rfc6749#section-4.3."
+                },
+                {
+                  "value": "clientCredentials",
+                  "description": "Client Credentials Grant flow as described https://tools.ietf.org/html/rfc6749#section-4.4."
+                }
+              ]
+            }
+          },
+          "description": "Form of an authorization grant, which the client uses to request the access token.",
+          "externalDocs": {
+            "url": "http://tools.ietf.org/html/rfc6749#section-4"
+          }
+        },
+        "clientId": {
+          "type": "string",
+          "description": "Client or app id registered with this authorization server."
+        },
+        "clientSecret": {
+          "x-ms-secret": true,
+          "type": "string",
+          "description": "Client or app secret registered with this authorization server. This property will not be filled on 'GET' operations! Use '/listSecrets' POST request to get the value."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/AuthorizationServerContractBaseProperties"
+        }
+      ],
+      "description": "External OAuth authorization server Update settings contract."
+    },
+    "BackendAuthorizationHeaderCredentials": {
+      "properties": {
+        "scheme": {
+          "type": "string",
+          "description": "Authentication Scheme name.",
+          "minLength": 1,
+          "maxLength": 100
+        },
+        "parameter": {
+          "type": "string",
+          "description": "Authentication Parameter value.",
+          "minLength": 1,
+          "maxLength": 300
+        }
+      },
+      "required": [
+        "scheme",
+        "parameter"
+      ],
+      "description": "Authorization header information."
+    },
+    "BackendBaseParameters": {
+      "properties": {
+        "title": {
+          "type": "string",
+          "description": "Backend Title.",
+          "minLength": 1,
+          "maxLength": 300
+        },
+        "description": {
+          "type": "string",
+          "description": "Backend Description.",
+          "minLength": 1,
+          "maxLength": 2000
+        },
+        "resourceId": {
+          "type": "string",
+          "description": "Management Uri of the Resource in External System. This url can be the Arm Resource Id of Logic Apps, Function Apps or Api Apps.",
+          "minLength": 1,
+          "maxLength": 2000
+        },
+        "properties": {
+          "$ref": "#/definitions/BackendProperties",
+          "description": "Backend Properties contract"
+        },
+        "credentials": {
+          "$ref": "#/definitions/BackendCredentialsContract",
+          "description": "Backend Credentials Contract Properties"
+        },
+        "proxy": {
+          "$ref": "#/definitions/BackendProxyContract",
+          "description": "Backend Proxy Contract Properties"
+        },
+        "tls": {
+          "$ref": "#/definitions/BackendTlsProperties",
+          "description": "Backend TLS Properties"
+        }
+      },
+      "description": "Backend entity base Parameter set."
+    },
+    "BackendCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/BackendContract"
+          },
+          "description": "Backend values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged Backend list representation."
+    },
+    "BackendContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/BackendContractProperties",
+          "description": "Backend entity contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Backend details."
+    },
+    "BackendContractProperties": {
+      "properties": {
+        "url": {
+          "type": "string",
+          "description": "Runtime Url of the Backend.",
+          "minLength": 1,
+          "maxLength": 2000
+        },
+        "protocol": {
+          "type": "string",
+          "enum": [
+            "http",
+            "soap"
+          ],
+          "x-ms-enum": {
+            "name": "BackendProtocol",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "http",
+                "description": "The Backend is a RESTful service."
+              },
+              {
+                "value": "soap",
+                "description": "The Backend is a SOAP service."
+              }
+            ]
+          },
+          "description": "Backend communication protocol."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/BackendBaseParameters"
+        }
+      ],
+      "required": [
+        "url",
+        "protocol"
+      ],
+      "description": "Parameters supplied to the Create Backend operation."
+    },
+    "BackendCredentialsContract": {
+      "properties": {
+        "certificate": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "maxItems": 32,
+          "description": "List of Client Certificate Thumbprint."
+        },
+        "query": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "description": "Query Parameter description."
+        },
+        "header": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "description": "Header Parameter description."
+        },
+        "authorization": {
+          "description": "Authorization header authentication",
+          "$ref": "#/definitions/BackendAuthorizationHeaderCredentials"
+        }
+      },
+      "description": "Details of the Credentials used to connect to Backend."
+    },
+    "BackendProperties": {
+      "properties": {
+        "serviceFabricCluster": {
+          "$ref": "#/definitions/BackendServiceFabricClusterProperties",
+          "description": "Backend Service Fabric Cluster Properties"
+        }
+      },
+      "description": "Properties specific to the Backend Type."
+    },
+    "BackendProxyContract": {
+      "externalDocs": {
+        "url": "https://msdn.microsoft.com/en-us/library/system.net.webproxy(v=vs.110).aspx",
+        "description": "Backend entity uses these details to connect to a WebProxy."
+      },
+      "properties": {
+        "url": {
+          "type": "string",
+          "description": "WebProxy Server AbsoluteUri property which includes the entire URI stored in the Uri instance, including all fragments and query strings.",
+          "minLength": 1,
+          "maxLength": 2000
+        },
+        "username": {
+          "type": "string",
+          "description": "Username to connect to the WebProxy server"
+        },
+        "password": {
+          "type": "string",
+          "description": "Password to connect to the WebProxy Server"
+        }
+      },
+      "required": [
+        "url"
+      ],
+      "description": "Details of the Backend WebProxy Server to use in the Request to Backend."
+    },
+    "BackendReconnectContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/BackendReconnectProperties",
+          "description": "Reconnect request properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Reconnect request parameters."
+    },
+    "BackendReconnectProperties": {
+      "properties": {
+        "after": {
+          "type": "string",
+          "format": "duration",
+          "description": "Duration in ISO8601 format after which reconnect will be initiated. Minimum duration of the Reconnect is PT2M."
+        }
+      },
+      "description": "Properties to control reconnect requests."
+    },
+    "BackendServiceFabricClusterProperties": {
+      "properties": {
+        "clientCertificatethumbprint": {
+          "description": "The client certificate thumbprint for the management endpoint.",
+          "type": "string"
+        },
+        "maxPartitionResolutionRetries": {
+          "description": "Maximum number of retries while attempting resolve the partition.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "managementEndpoints": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "The cluster management endpoint."
+        },
+        "serverCertificateThumbprints": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Thumbprints of certificates cluster management service uses for tls communication"
+        },
+        "serverX509Names": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/X509CertificateName"
+          },
+          "description": "Server X509 Certificate Names Collection"
+        }
+      },
+      "required": [
+        "managementEndpoints",
+        "clientCertificatethumbprint"
+      ],
+      "description": "Properties of the Service Fabric Type Backend."
+    },
+    "BackendTlsProperties": {
+      "properties": {
+        "validateCertificateChain": {
+          "description": "Flag indicating whether SSL certificate chain validation should be done when using self-signed certificates for this backend host.",
+          "type": "boolean",
+          "default": true
+        },
+        "validateCertificateName": {
+          "description": "Flag indicating whether SSL certificate name validation should be done when using self-signed certificates for this backend host.",
+          "type": "boolean",
+          "default": true
+        }
+      },
+      "description": "Properties controlling TLS Certificate Validation."
+    },
+    "BackendUpdateParameterProperties": {
+      "properties": {
+        "url": {
+          "type": "string",
+          "description": "Runtime Url of the Backend.",
+          "minLength": 1,
+          "maxLength": 2000
+        },
+        "protocol": {
+          "type": "string",
+          "enum": [
+            "http",
+            "soap"
+          ],
+          "x-ms-enum": {
+            "name": "BackendProtocol",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "http",
+                "description": "The Backend is a RESTful service."
+              },
+              {
+                "value": "soap",
+                "description": "The Backend is a SOAP service."
+              }
+            ]
+          },
+          "description": "Backend communication protocol."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/BackendBaseParameters"
+        }
+      ],
+      "description": "Parameters supplied to the Update Backend operation."
+    },
+    "BackendUpdateParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/BackendUpdateParameterProperties",
+          "description": "Backend entity update contract properties."
+        }
+      },
+      "description": "Backend update parameters."
+    },
+    "BearerTokenSendingMethodsContract": {
+      "type": "string",
+      "description": "Form of an authorization grant, which the client uses to request the access token.",
+      "enum": [
+        "authorizationHeader",
+        "query"
+      ],
+      "x-ms-enum": {
+        "modelAsString": true,
+        "name": "bearerTokenSendingMethods",
+        "values": [
+          {
+            "value": "authorizationHeader",
+            "description": "Access token will be transmitted in the Authorization header using Bearer schema"
+          },
+          {
+            "value": "query",
+            "description": "Access token will be transmitted as query parameters."
+          }
+        ]
+      }
+    },
+    "BodyDiagnosticSettings": {
+      "properties": {
+        "bytes": {
+          "type": "integer",
+          "format": "int32",
+          "maximum": 8192,
+          "description": "Number of request body bytes to log."
+        }
+      },
+      "description": "Body logging settings."
+    },
+    "CacheCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/CacheContract"
+          },
+          "description": "Page values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged Caches list representation."
+    },
+    "CacheContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/CacheContractProperties",
+          "description": "Cache properties details."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Cache details."
+    },
+    "CacheContractProperties": {
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "Cache description",
+          "maxLength": 2000
+        },
+        "connectionString": {
+          "type": "string",
+          "description": "Runtime connection string to cache",
+          "maxLength": 300
+        },
+        "resourceId": {
+          "type": "string",
+          "description": "Original uri of entity in external system cache points to",
+          "maxLength": 2000
+        }
+      },
+      "required": [
+        "connectionString"
+      ],
+      "description": "Properties of the Cache contract."
+    },
+    "CacheUpdateParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/CacheUpdateProperties",
+          "description": "Cache update properties details."
+        }
+      },
+      "description": "Cache update details."
+    },
+    "CacheUpdateProperties": {
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "Cache description",
+          "maxLength": 2000
+        },
+        "connectionString": {
+          "type": "string",
+          "description": "Runtime connection string to cache",
+          "maxLength": 300
+        },
+        "resourceId": {
+          "type": "string",
+          "description": "Original uri of entity in external system cache points to",
+          "maxLength": 2000
+        }
+      },
+      "description": "Parameters supplied to the Update Cache operation."
+    },
+    "CertificateCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/CertificateContract"
+          },
+          "description": "Page values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged Certificates list representation."
+    },
+    "CertificateContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/CertificateContractProperties",
+          "description": "Certificate properties details."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Certificate details."
+    },
+    "CertificateContractProperties": {
+      "properties": {
+        "subject": {
+          "type": "string",
+          "description": "Subject attribute of the certificate."
+        },
+        "thumbprint": {
+          "type": "string",
+          "description": "Thumbprint of the certificate."
+        },
+        "expirationDate": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Expiration date of the certificate. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard.\n"
+        }
+      },
+      "required": [
+        "subject",
+        "thumbprint",
+        "expirationDate"
+      ],
+      "description": "Properties of the Certificate contract."
+    },
+    "CertificateCreateOrUpdateParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/CertificateCreateOrUpdateProperties",
+          "description": "Certificate create or update properties details."
+        }
+      },
+      "description": "Certificate create or update details."
+    },
+    "CertificateCreateOrUpdateProperties": {
+      "properties": {
+        "data": {
+          "type": "string",
+          "description": "Base 64 encoded certificate using the application/x-pkcs12 representation."
+        },
+        "password": {
+          "type": "string",
+          "description": "Password for the Certificate"
+        }
+      },
+      "required": [
+        "data",
+        "password"
+      ],
+      "description": "Parameters supplied to the CreateOrUpdate certificate operation."
+    },
+    "DeployConfigurationParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/DeployConfigurationParameterProperties",
+          "description": "Deploy Configuration Parameter contract properties."
+        }
+      },
+      "description": "Deploy Tenant Configuration Contract."
+    },
+    "DeployConfigurationParameterProperties": {
+      "properties": {
+        "branch": {
+          "type": "string",
+          "description": "The name of the Git branch from which the configuration is to be deployed to the configuration database."
+        },
+        "force": {
+          "type": "boolean",
+          "description": "The value enforcing deleting subscriptions to products that are deleted in this update."
+        }
+      },
+      "required": [
+        "branch"
+      ],
+      "description": "Parameters supplied to the Deploy Configuration operation."
+    },
+    "DiagnosticCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DiagnosticContract"
+          },
+          "description": "Page values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged Diagnostic list representation."
+    },
+    "DiagnosticContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/DiagnosticContractProperties",
+          "description": "Diagnostic entity contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Diagnostic details."
+    },
+    "DiagnosticContractProperties": {
+      "properties": {
+        "alwaysLog": {
+          "type": "string",
+          "enum": [
+            "allErrors"
+          ],
+          "x-ms-enum": {
+            "name": "AlwaysLog",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "allErrors",
+                "description": "Always log all erroneous request regardless of sampling settings."
+              }
+            ]
+          },
+          "description": "Specifies for what type of messages sampling settings should not apply."
+        },
+        "loggerId": {
+          "type": "string",
+          "description": "Resource Id of a target logger."
+        },
+        "sampling": {
+          "$ref": "#/definitions/SamplingSettings",
+          "description": "Sampling settings for Diagnostic."
+        },
+        "frontend": {
+          "$ref": "#/definitions/PipelineDiagnosticSettings",
+          "description": "Diagnostic settings for incoming/outgoing HTTP messages to the Gateway."
+        },
+        "backend": {
+          "$ref": "#/definitions/PipelineDiagnosticSettings",
+          "description": "Diagnostic settings for incoming/outgoing HTTP messages to the Backend"
+        },
+        "logClientIp": {
+          "type": "boolean",
+          "description": "Log the ClientIP. Default is false."
+        },
+        "httpCorrelationProtocol": {
+          "type": "string",
+          "enum": [
+            "None",
+            "Legacy",
+            "W3C"
+          ],
+          "x-ms-enum": {
+            "name": "HttpCorrelationProtocol",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "None",
+                "description": "Do not read and inject correlation headers."
+              },
+              {
+                "value": "Legacy",
+                "description": "Inject Request-Id and Request-Context headers with request correlation data. See https://github.com/dotnet/corefx/blob/master/src/System.Diagnostics.DiagnosticSource/src/HttpCorrelationProtocol.md."
+              },
+              {
+                "value": "W3C",
+                "description": "Inject Trace Context headers. See https://w3c.github.io/trace-context."
+              }
+            ]
+          },
+          "description": "Sets correlation protocol to use for Application Insights diagnostics."
+        },
+        "verbosity": {
+          "type": "string",
+          "enum": [
+            "verbose",
+            "information",
+            "error"
+          ],
+          "x-ms-enum": {
+            "name": "Verbosity",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "verbose",
+                "description": "All the traces emitted by trace policies will be sent to the logger attached to this diagnostic instance."
+              },
+              {
+                "value": "information",
+                "description": "Traces with 'severity' set to 'information' and 'error' will be sent to the logger attached to this diagnostic instance."
+              },
+              {
+                "value": "error",
+                "description": "Only traces with 'severity' set to 'error' will be sent to the logger attached to this diagnostic instance."
+              }
+            ]
+          },
+          "description": "The verbosity level applied to traces emitted by trace policies."
+        }
+      },
+      "required": [
+        "loggerId"
+      ],
+      "description": "Diagnostic Entity Properties"
+    },
+    "EmailTemplateCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/EmailTemplateContract"
+          },
+          "description": "Page values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged email template list representation."
+    },
+    "EmailTemplateContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/EmailTemplateContractProperties",
+          "description": "Email Template entity contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Email Template details."
+    },
+    "EmailTemplateContractProperties": {
+      "properties": {
+        "subject": {
+          "type": "string",
+          "description": "Subject of the Template.",
+          "minLength": 1,
+          "maxLength": 1000
+        },
+        "body": {
+          "type": "string",
+          "description": "Email Template Body. This should be a valid XDocument",
+          "minLength": 1
+        },
+        "title": {
+          "type": "string",
+          "description": "Title of the Template."
+        },
+        "description": {
+          "type": "string",
+          "description": "Description of the Email Template."
+        },
+        "isDefault": {
+          "type": "boolean",
+          "description": "Whether the template is the default template provided by Api Management or has been edited.",
+          "readOnly": true
+        },
+        "parameters": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/EmailTemplateParametersContractProperties"
+          },
+          "description": "Email Template Parameter values."
+        }
+      },
+      "required": [
+        "body",
+        "subject"
+      ],
+      "description": "Email Template Contract properties."
+    },
+    "EmailTemplateParametersContractProperties": {
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Template parameter name.",
+          "minLength": 1,
+          "maxLength": 256,
+          "pattern": "^[A-Za-z0-9-._]+$"
+        },
+        "title": {
+          "type": "string",
+          "description": "Template parameter title.",
+          "minLength": 1,
+          "maxLength": 4096
+        },
+        "description": {
+          "type": "string",
+          "description": "Template parameter description.",
+          "minLength": 1,
+          "maxLength": 256,
+          "pattern": "^[A-Za-z0-9-._]+$"
+        }
+      },
+      "description": "Email Template Parameter contract."
+    },
+    "EmailTemplateUpdateParameterProperties": {
+      "properties": {
+        "subject": {
+          "type": "string",
+          "description": "Subject of the Template.",
+          "minLength": 1,
+          "maxLength": 1000
+        },
+        "title": {
+          "type": "string",
+          "description": "Title of the Template."
+        },
+        "description": {
+          "type": "string",
+          "description": "Description of the Email Template."
+        },
+        "body": {
+          "type": "string",
+          "description": "Email Template Body. This should be a valid XDocument",
+          "minLength": 1
+        },
+        "parameters": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/EmailTemplateParametersContractProperties"
+          },
+          "description": "Email Template Parameter values."
+        }
+      },
+      "description": "Email Template Update Contract properties."
+    },
+    "EmailTemplateUpdateParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/EmailTemplateUpdateParameterProperties",
+          "description": "Email Template Update contract properties."
+        }
+      },
+      "description": "Email Template update Parameters."
+    },
+    "GenerateSsoUrlResult": {
+      "properties": {
+        "value": {
+          "type": "string",
+          "description": "Redirect Url containing the SSO URL value."
+        }
+      },
+      "description": "Generate SSO Url operations response details."
+    },
+    "GroupCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/GroupContract"
+          },
+          "description": "Page values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged Group list representation."
+    },
+    "GroupContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/GroupContractProperties",
+          "description": "Group entity contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Contract details."
+    },
+    "GroupContractProperties": {
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "Group name.",
+          "maxLength": 300,
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "description": "Group description. Can contain HTML formatting tags.",
+          "maxLength": 1000
+        },
+        "builtIn": {
+          "readOnly": true,
+          "type": "boolean",
+          "description": "true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false."
+        },
+        "type": {
+          "type": "string",
+          "description": "Group type.",
+          "enum": [
+            "custom",
+            "system",
+            "external"
+          ],
+          "x-ms-enum": {
+            "name": "GroupType",
+            "modelAsString": false
+          }
+        },
+        "externalId": {
+          "type": "string",
+          "description": "For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory `aad://<tenant>.onmicrosoft.com/groups/<group object id>`; otherwise the value is null."
+        }
+      },
+      "required": [
+        "displayName"
+      ],
+      "description": "Group contract Properties."
+    },
+    "GroupCreateParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/GroupCreateParametersProperties",
+          "description": "Properties supplied to Create Group operation."
+        }
+      },
+      "description": "Parameters supplied to the Create Group operation."
+    },
+    "GroupCreateParametersProperties": {
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "Group name.",
+          "maxLength": 300,
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "description": "Group description."
+        },
+        "type": {
+          "type": "string",
+          "description": "Group type.",
+          "enum": [
+            "custom",
+            "system",
+            "external"
+          ],
+          "x-ms-enum": {
+            "name": "GroupType",
+            "modelAsString": false
+          }
+        },
+        "externalId": {
+          "type": "string",
+          "description": "Identifier of the external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory `aad://<tenant>.onmicrosoft.com/groups/<group object id>`; otherwise the value is null."
+        }
+      },
+      "required": [
+        "displayName"
+      ],
+      "description": "Parameters supplied to the Create Group operation."
+    },
+    "GroupUpdateParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/GroupUpdateParametersProperties",
+          "description": "Group entity update contract properties."
+        }
+      },
+      "description": "Parameters supplied to the Update Group operation."
+    },
+    "GroupUpdateParametersProperties": {
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "Group name.",
+          "maxLength": 300,
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "description": "Group description."
+        },
+        "type": {
+          "type": "string",
+          "description": "Group type.",
+          "enum": [
+            "custom",
+            "system",
+            "external"
+          ],
+          "x-ms-enum": {
+            "name": "GroupType",
+            "modelAsString": false
+          }
+        },
+        "externalId": {
+          "type": "string",
+          "description": "Identifier of the external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory `aad://<tenant>.onmicrosoft.com/groups/<group object id>`; otherwise the value is null."
+        }
+      },
+      "description": "Parameters supplied to the Update Group operation."
+    },
+    "HttpMessageDiagnostic": {
+      "properties": {
+        "headers": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Array of HTTP Headers to log."
+        },
+        "body": {
+          "$ref": "#/definitions/BodyDiagnosticSettings",
+          "description": "Body logging settings."
+        }
+      },
+      "description": "Http message diagnostic settings."
+    },
+    "IdentityProviderBaseParameters": {
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "facebook",
+            "google",
+            "microsoft",
+            "twitter",
+            "aad",
+            "aadB2C"
+          ],
+          "x-ms-enum": {
+            "name": "IdentityProviderType",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "facebook",
+                "description": "Facebook as Identity provider."
+              },
+              {
+                "value": "google",
+                "description": "Google as Identity provider."
+              },
+              {
+                "value": "microsoft",
+                "description": "Microsoft Live as Identity provider."
+              },
+              {
+                "value": "twitter",
+                "description": "Twitter as Identity provider."
+              },
+              {
+                "value": "aad",
+                "description": "Azure Active Directory as Identity provider."
+              },
+              {
+                "value": "aadB2C",
+                "description": "Azure Active Directory B2C as Identity provider."
+              }
+            ]
+          },
+          "description": "Identity Provider Type identifier."
+        },
+        "signinTenant": {
+          "type": "string",
+          "description": "The TenantId to use instead of Common when logging into Active Directory"
+        },
+        "allowedTenants": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "maxItems": 32,
+          "description": "List of Allowed Tenants when configuring Azure Active Directory login."
+        },
+        "authority": {
+          "type": "string",
+          "description": "OpenID Connect discovery endpoint hostname for AAD or AAD B2C."
+        },
+        "signupPolicyName": {
+          "type": "string",
+          "description": "Signup Policy Name. Only applies to AAD B2C Identity Provider.",
+          "minLength": 1
+        },
+        "signinPolicyName": {
+          "type": "string",
+          "description": "Signin Policy Name. Only applies to AAD B2C Identity Provider.",
+          "minLength": 1
+        },
+        "profileEditingPolicyName": {
+          "type": "string",
+          "description": "Profile Editing Policy Name. Only applies to AAD B2C Identity Provider.",
+          "minLength": 1
+        },
+        "passwordResetPolicyName": {
+          "type": "string",
+          "description": "Password Reset Policy Name. Only applies to AAD B2C Identity Provider.",
+          "minLength": 1
+        }
+      },
+      "description": "Identity Provider Base Parameter Properties."
+    },
+    "IdentityProviderCreateContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/IdentityProviderCreateContractProperties",
+          "description": "Identity Provider contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Identity Provider details."
+    },
+    "IdentityProviderCreateContractProperties": {
+      "properties": {
+        "clientId": {
+          "type": "string",
+          "description": "Client Id of the Application in the external Identity Provider. It is App ID for Facebook login, Client ID for Google login, App ID for Microsoft.",
+          "minLength": 1
+        },
+        "clientSecret": {
+          "x-ms-secret": true,
+          "type": "string",
+          "description": "Client secret of the Application in external Identity Provider, used to authenticate login request. For example, it is App Secret for Facebook login, API Key for Google login, Public Key for Microsoft. This property will not be filled on 'GET' operations! Use '/listSecrets' POST request to get the value.",
+          "minLength": 1
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/IdentityProviderBaseParameters"
+        }
+      ],
+      "required": [
+        "clientId",
+        "clientSecret"
+      ],
+      "description": "The external Identity Providers like Facebook, Google, Microsoft, Twitter or Azure Active Directory which can be used to enable access to the API Management service developer portal for all users."
+    },
+    "IdentityProviderContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/IdentityProviderContractProperties",
+          "description": "Identity Provider contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Identity Provider details."
+    },
+    "IdentityProviderContractProperties": {
+      "properties": {
+        "clientId": {
+          "type": "string",
+          "description": "Client Id of the Application in the external Identity Provider. It is App ID for Facebook login, Client ID for Google login, App ID for Microsoft.",
+          "minLength": 1
+        },
+        "clientSecret": {
+          "x-ms-secret": true,
+          "type": "string",
+          "description": "Client secret of the Application in external Identity Provider, used to authenticate login request. For example, it is App Secret for Facebook login, API Key for Google login, Public Key for Microsoft. This property will not be filled on 'GET' operations! Use '/listSecrets' POST request to get the value.",
+          "minLength": 1
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/IdentityProviderBaseParameters"
+        }
+      ],
+      "required": [
+        "clientId"
+      ],
+      "description": "The external Identity Providers like Facebook, Google, Microsoft, Twitter or Azure Active Directory which can be used to enable access to the API Management service developer portal for all users."
+    },
+    "IdentityProviderList": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/IdentityProviderContract"
+          },
+          "description": "Identity Provider configuration values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "List of all the Identity Providers configured on the service instance."
+    },
+    "IdentityProviderUpdateParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/IdentityProviderUpdateProperties",
+          "description": "Identity Provider update properties."
+        }
+      },
+      "description": "Parameters supplied to update Identity Provider"
+    },
+    "IdentityProviderUpdateProperties": {
+      "properties": {
+        "clientId": {
+          "type": "string",
+          "description": "Client Id of the Application in the external Identity Provider. It is App ID for Facebook login, Client ID for Google login, App ID for Microsoft.",
+          "minLength": 1
+        },
+        "clientSecret": {
+          "x-ms-secret": true,
+          "type": "string",
+          "description": "Client secret of the Application in external Identity Provider, used to authenticate login request. For example, it is App Secret for Facebook login, API Key for Google login, Public Key for Microsoft.",
+          "minLength": 1
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/IdentityProviderBaseParameters"
+        }
+      ],
+      "description": "Parameters supplied to the Update Identity Provider operation."
+    },
+    "IssueAttachmentCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/IssueAttachmentContract"
+          },
+          "description": "Issue Attachment values.",
+          "readOnly": true
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any.",
+          "readOnly": true
+        }
+      },
+      "description": "Paged Issue Attachment list representation."
+    },
+    "IssueAttachmentContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/IssueAttachmentContractProperties",
+          "description": "Properties of the Issue Attachment."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Issue Attachment Contract details."
+    },
+    "IssueAttachmentContractProperties": {
+      "properties": {
+        "title": {
+          "type": "string",
+          "description": "Filename by which the binary data will be saved."
+        },
+        "contentFormat": {
+          "type": "string",
+          "description": "Either 'link' if content is provided via an HTTP link or the MIME type of the Base64-encoded binary data provided in the 'content' property."
+        },
+        "content": {
+          "type": "string",
+          "description": "An HTTP link or Base64-encoded binary data."
+        }
+      },
+      "required": [
+        "title",
+        "contentFormat",
+        "content"
+      ],
+      "description": "Issue Attachment contract Properties."
+    },
+    "IssueCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/IssueContract"
+          },
+          "description": "Issue values.",
+          "readOnly": true
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any.",
+          "readOnly": true
+        }
+      },
+      "description": "Paged Issue list representation."
+    },
+    "IssueCommentCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/IssueCommentContract"
+          },
+          "description": "Issue Comment values.",
+          "readOnly": true
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any.",
+          "readOnly": true
+        }
+      },
+      "description": "Paged Issue Comment list representation."
+    },
+    "IssueCommentContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/IssueCommentContractProperties",
+          "description": "Properties of the Issue Comment."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Issue Comment Contract details."
+    },
+    "IssueCommentContractProperties": {
+      "properties": {
+        "text": {
+          "type": "string",
+          "description": "Comment text."
+        },
+        "createdDate": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Date and time when the comment was created."
+        },
+        "userId": {
+          "type": "string",
+          "description": "A resource identifier for the user who left the comment."
+        }
+      },
+      "required": [
+        "text",
+        "userId"
+      ],
+      "description": "Issue Comment contract Properties."
+    },
+    "IssueContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/IssueContractProperties",
+          "description": "Properties of the Issue."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Issue Contract details."
+    },
+    "IssueContractBaseProperties": {
+      "properties": {
+        "createdDate": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Date and time when the issue was created."
+        },
+        "state": {
+          "type": "string",
+          "description": "Status of the issue.",
+          "enum": [
+            "proposed",
+            "open",
+            "removed",
+            "resolved",
+            "closed"
+          ],
+          "x-ms-enum": {
+            "name": "State",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "proposed",
+                "description": "The issue is proposed."
+              },
+              {
+                "value": "open",
+                "description": "The issue is opened."
+              },
+              {
+                "value": "removed",
+                "description": "The issue was removed."
+              },
+              {
+                "value": "resolved",
+                "description": "The issue is now resolved."
+              },
+              {
+                "value": "closed",
+                "description": "The issue was closed."
+              }
+            ]
+          }
+        },
+        "apiId": {
+          "type": "string",
+          "description": "A resource identifier for the API the issue was created for."
+        }
+      },
+      "description": "Issue contract Base Properties."
+    },
+    "IssueContractProperties": {
+      "properties": {
+        "title": {
+          "type": "string",
+          "description": "The issue title."
+        },
+        "description": {
+          "type": "string",
+          "description": "Text describing the issue."
+        },
+        "userId": {
+          "type": "string",
+          "description": "A resource identifier for the user created the issue."
+        }
+      },
+      "required": [
+        "title",
+        "description",
+        "userId"
+      ],
+      "allOf": [
+        {
+          "$ref": "#/definitions/IssueContractBaseProperties"
+        }
+      ],
+      "description": "Issue contract Properties."
+    },
+    "IssueUpdateContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/IssueUpdateContractProperties",
+          "description": "Issue entity Update contract properties."
+        }
+      },
+      "description": "Issue update Parameters."
+    },
+    "IssueUpdateContractProperties": {
+      "properties": {
+        "title": {
+          "type": "string",
+          "description": "The issue title."
+        },
+        "description": {
+          "type": "string",
+          "description": "Text describing the issue."
+        },
+        "userId": {
+          "type": "string",
+          "description": "A resource identifier for the user created the issue."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/IssueContractBaseProperties"
+        }
+      ],
+      "description": "Issue contract Update Properties."
+    },
+    "LoggerCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/LoggerContract"
+          },
+          "description": "Logger values."
+        },
+        "count": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total record count number across all pages."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged Logger list representation."
+    },
+    "LoggerContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/LoggerContractProperties",
+          "description": "Logger entity contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Logger details."
+    },
+    "LoggerContractProperties": {
+      "properties": {
+        "loggerType": {
+          "type": "string",
+          "description": "Logger type.",
+          "enum": [
+            "azureEventHub",
+            "applicationInsights"
+          ],
+          "x-ms-enum": {
+            "name": "LoggerType",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "azureEventHub",
+                "description": "Azure Event Hub as log destination."
+              },
+              {
+                "value": "applicationInsights",
+                "description": "Azure Application Insights as log destination."
+              }
+            ]
+          }
+        },
+        "description": {
+          "type": "string",
+          "description": "Logger description.",
+          "maxLength": 256
+        },
+        "credentials": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "The name and SendRule connection string of the event hub for azureEventHub logger.\nInstrumentation key for applicationInsights logger.",
+          "example": {
+            "name": "apim",
+            "connectionString": "Endpoint=sb://contoso-ns.servicebus.windows.net/;SharedAccessKeyName=Sender;SharedAccessKey=..."
+          }
+        },
+        "isBuffered": {
+          "type": "boolean",
+          "description": "Whether records are buffered in the logger before publishing. Default is assumed to be true."
+        },
+        "resourceId": {
+          "type": "string",
+          "description": "Azure Resource Id of a log target (either Azure Event Hub resource or Azure Application Insights resource)."
+        }
+      },
+      "required": [
+        "loggerType",
+        "credentials"
+      ],
+      "description": "The Logger entity in API Management represents an event sink that you can use to log API Management events. Currently the Logger entity supports logging API Management events to Azure Event Hubs."
+    },
+    "LoggerUpdateContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/LoggerUpdateParameters",
+          "description": "Logger entity update contract properties."
+        }
+      },
+      "description": "Logger update contract."
+    },
+    "LoggerUpdateParameters": {
+      "properties": {
+        "loggerType": {
+          "type": "string",
+          "description": "Logger type.",
+          "enum": [
+            "azureEventHub",
+            "applicationInsights"
+          ],
+          "x-ms-enum": {
+            "name": "LoggerType",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "azureEventHub",
+                "description": "Azure Event Hub as log destination."
+              },
+              {
+                "value": "applicationInsights",
+                "description": "Azure Application Insights as log destination."
+              }
+            ]
+          }
+        },
+        "description": {
+          "type": "string",
+          "description": "Logger description."
+        },
+        "credentials": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Logger credentials."
+        },
+        "isBuffered": {
+          "type": "boolean",
+          "description": "Whether records are buffered in the logger before publishing. Default is assumed to be true."
+        }
+      },
+      "description": "Parameters supplied to the Update Logger operation."
+    },
+    "NotificationCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/NotificationContract"
+          },
+          "description": "Page values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged Notification list representation."
+    },
+    "NotificationContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/NotificationContractProperties",
+          "description": "Notification entity contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Notification details."
+    },
+    "NotificationContractProperties": {
+      "properties": {
+        "title": {
+          "type": "string",
+          "description": "Title of the Notification.",
+          "minLength": 1,
+          "maxLength": 1000
+        },
+        "description": {
+          "type": "string",
+          "description": "Description of the Notification."
+        },
+        "recipients": {
+          "$ref": "#/definitions/RecipientsContractProperties",
+          "description": "Recipient Parameter values."
+        }
+      },
+      "required": [
+        "title"
+      ],
+      "description": "Notification Contract properties."
+    },
+    "OAuth2AuthenticationSettingsContract": {
+      "properties": {
+        "authorizationServerId": {
+          "type": "string",
+          "description": "OAuth authorization server identifier."
+        },
+        "scope": {
+          "type": "string",
+          "description": "operations scope."
+        }
+      },
+      "description": "API OAuth2 Authentication settings details."
+    },
+    "OpenIdAuthenticationSettingsContract": {
+      "properties": {
+        "openidProviderId": {
+          "type": "string",
+          "description": "OAuth authorization server identifier."
+        },
+        "bearerTokenSendingMethods": {
+          "description": "How to send token to the server.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/BearerTokenSendingMethodsContract"
+          }
+        }
+      },
+      "description": "API OAuth2 Authentication settings details."
+    },
+    "OpenIdConnectProviderCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/OpenidConnectProviderContract"
+          },
+          "description": "Page values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged OpenIdProviders list representation."
+    },
+    "OpenidConnectProviderContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/OpenidConnectProviderContractProperties",
+          "description": "OpenId Connect Provider contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "OpenId Connect Provider details."
+    },
+    "OpenidConnectProviderContractProperties": {
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "User-friendly OpenID Connect Provider name.",
+          "maxLength": 50
+        },
+        "description": {
+          "type": "string",
+          "description": "User-friendly description of OpenID Connect Provider."
+        },
+        "metadataEndpoint": {
+          "type": "string",
+          "description": "Metadata endpoint URI."
+        },
+        "clientId": {
+          "type": "string",
+          "description": "Client ID of developer console which is the client application."
+        },
+        "clientSecret": {
+          "x-ms-secret": true,
+          "type": "string",
+          "description": "Client Secret of developer console which is the client application."
+        }
+      },
+      "required": [
+        "displayName",
+        "metadataEndpoint",
+        "clientId"
+      ],
+      "description": "OpenID Connect Providers Contract."
+    },
+    "OpenidConnectProviderUpdateContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/OpenidConnectProviderUpdateContractProperties",
+          "description": "OpenId Connect Provider Update contract properties."
+        }
+      },
+      "description": "Parameters supplied to the Update OpenID Connect Provider operation."
+    },
+    "OpenidConnectProviderUpdateContractProperties": {
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "User-friendly OpenID Connect Provider name.",
+          "maxLength": 50
+        },
+        "description": {
+          "type": "string",
+          "description": "User-friendly description of OpenID Connect Provider."
+        },
+        "metadataEndpoint": {
+          "type": "string",
+          "description": "Metadata endpoint URI."
+        },
+        "clientId": {
+          "type": "string",
+          "description": "Client ID of developer console which is the client application."
+        },
+        "clientSecret": {
+          "x-ms-secret": true,
+          "type": "string",
+          "description": "Client Secret of developer console which is the client application."
+        }
+      },
+      "description": "Parameters supplied to the Update OpenID Connect Provider operation."
+    },
+    "OperationCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/OperationContract"
+          },
+          "description": "Page values.",
+          "readOnly": true
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any.",
+          "readOnly": true
+        }
+      },
+      "description": "Paged Operation list representation."
+    },
+    "OperationContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/OperationContractProperties",
+          "description": "Properties of the Operation Contract."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Api Operation details."
+    },
+    "OperationContractProperties": {
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "Operation Name.",
+          "minLength": 1,
+          "maxLength": 300
+        },
+        "method": {
+          "type": "string",
+          "description": "A Valid HTTP Operation Method. Typical Http Methods like GET, PUT, POST but not limited by only them.",
+          "externalDocs": {
+            "description": "As defined by RFC.",
+            "url": "http://www.rfc-editor.org/rfc/rfc7230.txt"
+          }
+        },
+        "urlTemplate": {
+          "type": "string",
+          "description": "Relative URL template identifying the target resource for this operation. May include parameters. Example: /customers/{cid}/orders/{oid}/?date={date}",
+          "minLength": 1,
+          "maxLength": 1000
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/OperationEntityBaseContract"
+        }
+      ],
+      "required": [
+        "displayName",
+        "method",
+        "urlTemplate"
+      ],
+      "description": "Operation Contract Properties"
+    },
+    "OperationEntityBaseContract": {
+      "properties": {
+        "templateParameters": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ParameterContract"
+          },
+          "description": "Collection of URL template parameters."
+        },
+        "description": {
+          "type": "string",
+          "description": "Description of the operation. May include HTML formatting tags.",
+          "maxLength": 1000
+        },
+        "request": {
+          "$ref": "#/definitions/RequestContract",
+          "description": "An entity containing request details."
+        },
+        "responses": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ResponseContract"
+          },
+          "description": "Array of Operation responses."
+        },
+        "policies": {
+          "type": "string",
+          "description": "Operation Policies"
+        }
+      },
+      "description": "Api Operation Entity Base Contract details."
+    },
+    "OperationResultContract": {
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Operation result identifier."
+        },
+        "status": {
+          "type": "string",
+          "description": "Status of an async operation.",
+          "enum": [
+            "Started",
+            "InProgress",
+            "Succeeded",
+            "Failed"
+          ],
+          "x-ms-enum": {
+            "name": "AsyncOperationStatus",
+            "modelAsString": false
+          }
+        },
+        "started": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Start time of an async operation. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard.\n"
+        },
+        "updated": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Last update time of an async operation. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard.\n"
+        },
+        "resultInfo": {
+          "type": "string",
+          "description": "Optional result info."
+        },
+        "error": {
+          "$ref": "./apimanagement.json#/definitions/ErrorResponseBody",
+          "description": "Error Body Contract"
+        },
+        "actionLog": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/OperationResultLogItemContract"
+          },
+          "readOnly": true,
+          "description": "This property if only provided as part of the TenantConfiguration_Validate operation. It contains the log the entities which will be updated/created/deleted as part of the TenantConfiguration_Deploy operation."
+        }
+      },
+      "description": "Operation Result."
+    },
+    "OperationResultLogItemContract": {
+      "properties": {
+        "objectType": {
+          "type": "string",
+          "description": "The type of entity contract."
+        },
+        "action": {
+          "type": "string",
+          "description": "Action like create/update/delete."
+        },
+        "objectKey": {
+          "type": "string",
+          "description": "Identifier of the entity being created/updated/deleted."
+        }
+      },
+      "description": "Log of the entity being created, updated or deleted."
+    },
+    "OperationTagResourceContractProperties": {
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Identifier of the operation in form /operations/{operationId}."
+        },
+        "name": {
+          "type": "string",
+          "description": "Operation name.",
+          "readOnly": true
+        },
+        "apiName": {
+          "type": "string",
+          "description": "Api Name.",
+          "readOnly": true
+        },
+        "apiRevision": {
+          "type": "string",
+          "description": "Api Revision.",
+          "readOnly": true
+        },
+        "apiVersion": {
+          "type": "string",
+          "description": "Api Version.",
+          "readOnly": true
+        },
+        "description": {
+          "type": "string",
+          "description": "Operation Description.",
+          "readOnly": true
+        },
+        "method": {
+          "type": "string",
+          "description": "A Valid HTTP Operation Method. Typical Http Methods like GET, PUT, POST but not limited by only them.",
+          "externalDocs": {
+            "description": "As defined by RFC.",
+            "url": "http://www.rfc-editor.org/rfc/rfc7230.txt"
+          },
+          "readOnly": true
+        },
+        "urlTemplate": {
+          "type": "string",
+          "description": "Relative URL template identifying the target resource for this operation. May include parameters. Example: /customers/{cid}/orders/{oid}/?date={date}",
+          "readOnly": true
+        }
+      },
+      "description": "Operation Entity contract Properties."
+    },
+    "OperationUpdateContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/OperationUpdateContractProperties",
+          "description": "Properties of the API Operation entity that can be updated."
+        }
+      },
+      "description": "Api Operation Update Contract details."
+    },
+    "OperationUpdateContractProperties": {
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "Operation Name.",
+          "minLength": 1,
+          "maxLength": 300
+        },
+        "method": {
+          "type": "string",
+          "description": "A Valid HTTP Operation Method. Typical Http Methods like GET, PUT, POST but not limited by only them.",
+          "externalDocs": {
+            "description": "As defined by RFC.",
+            "url": "http://www.rfc-editor.org/rfc/rfc7230.txt"
+          }
+        },
+        "urlTemplate": {
+          "type": "string",
+          "description": "Relative URL template identifying the target resource for this operation. May include parameters. Example: /customers/{cid}/orders/{oid}/?date={date}",
+          "minLength": 1,
+          "maxLength": 1000
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/OperationEntityBaseContract"
+        }
+      ],
+      "description": "Operation Update Contract Properties."
+    },
+    "ParameterContract": {
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Parameter name."
+        },
+        "description": {
+          "type": "string",
+          "description": "Parameter description."
+        },
+        "type": {
+          "type": "string",
+          "description": "Parameter type."
+        },
+        "defaultValue": {
+          "type": "string",
+          "description": "Default parameter value."
+        },
+        "required": {
+          "type": "boolean",
+          "description": "Specifies whether parameter is required or not."
+        },
+        "values": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Parameter values."
+        }
+      },
+      "required": [
+        "name",
+        "type"
+      ],
+      "description": "Operation parameters details."
+    },
+    "PipelineDiagnosticSettings": {
+      "properties": {
+        "request": {
+          "$ref": "#/definitions/HttpMessageDiagnostic",
+          "description": "Diagnostic settings for request."
+        },
+        "response": {
+          "$ref": "#/definitions/HttpMessageDiagnostic",
+          "description": "Diagnostic settings for response."
+        }
+      },
+      "description": "Diagnostic settings for incoming/outgoing HTTP messages to the Gateway."
+    },
+    "PolicyCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/PolicyContract"
+          },
+          "description": "Policy Contract value."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "The response of the list policy operation."
+    },
+    "PolicyContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/PolicyContractProperties",
+          "description": "Properties of the Policy."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Policy Contract details."
+    },
+    "PolicyContractProperties": {
+      "properties": {
+        "value": {
+          "type": "string",
+          "description": "Contents of the Policy as defined by the format."
+        },
+        "format": {
+          "type": "string",
+          "description": "Format of the policyContent.",
+          "enum": [
+            "xml",
+            "xml-link",
+            "rawxml",
+            "rawxml-link"
+          ],
+          "x-ms-enum": {
+            "name": "PolicyContentFormat",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "xml",
+                "description": "The contents are inline and Content type is an XML document."
+              },
+              {
+                "value": "xml-link",
+                "description": "The policy 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."
+              },
+              {
+                "value": "rawxml-link",
+                "description": "The policy document is not Xml encoded and is hosted on a http endpoint accessible from the API Management service."
+              }
+            ]
+          },
+          "default": "xml"
+        }
+      },
+      "required": [
+        "value"
+      ],
+      "description": "Policy contract Properties."
+    },
+    "PolicyDescriptionContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/PolicyDescriptionContractProperties",
+          "description": "Policy description contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Policy description details."
+    },
+    "PolicyDescriptionContractProperties": {
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "Policy description.",
+          "readOnly": true
+        },
+        "scope": {
+          "type": "integer",
+          "description": "Binary OR value of the Snippet scope.",
+          "readOnly": true
+        }
+      },
+      "description": "Policy description properties."
+    },
+    "PolicyDescriptionCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/PolicyDescriptionContract"
+          },
+          "description": "Descriptions of APIM policies."
+        },
+        "count": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total record count number."
+        }
+      },
+      "description": "Descriptions of APIM policies."
+    },
+    "PortalDelegationSettings": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/PortalDelegationSettingsProperties",
+          "description": "Delegation settings contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Delegation settings for a developer portal."
+    },
+    "PortalDelegationSettingsProperties": {
+      "properties": {
+        "url": {
+          "type": "string",
+          "description": "A delegation Url."
+        },
+        "validationKey": {
+          "x-ms-secret": true,
+          "type": "string",
+          "description": "A base64-encoded validation key to validate, that a request is coming from Azure API Management."
+        },
+        "subscriptions": {
+          "$ref": "#/definitions/SubscriptionsDelegationSettingsProperties",
+          "description": "Subscriptions delegation settings."
+        },
+        "userRegistration": {
+          "$ref": "#/definitions/RegistrationDelegationSettingsProperties",
+          "description": "User registration delegation settings."
+        }
+      },
+      "description": "Delegation settings contract properties."
+    },
+    "PortalSigninSettingProperties": {
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Redirect Anonymous users to the Sign-In page."
+        }
+      },
+      "description": "Sign-in settings contract properties."
+    },
+    "PortalSigninSettings": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/PortalSigninSettingProperties",
+          "description": "Sign-in settings contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Sign-In settings for the Developer Portal."
+    },
+    "PortalSignupSettings": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/PortalSignupSettingsProperties",
+          "description": "Sign-up settings contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Sign-Up settings for a developer portal."
+    },
+    "PortalSignupSettingsProperties": {
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Allow users to sign up on a developer portal."
+        },
+        "termsOfService": {
+          "type": "object",
+          "$ref": "#/definitions/TermsOfServiceProperties",
+          "description": "Terms of service contract properties."
+        }
+      },
+      "description": "Sign-up settings contract properties."
+    },
+    "ProductCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ProductContract"
+          },
+          "description": "Page values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged Products list representation."
+    },
+    "ProductContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ProductContractProperties",
+          "description": "Product entity contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Product details."
+    },
+    "ProductContractProperties": {
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "Product name.",
+          "minLength": 1,
+          "maxLength": 300
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ProductEntityBaseParameters"
+        }
+      ],
+      "required": [
+        "displayName"
+      ],
+      "description": "Product profile."
+    },
+    "ProductEntityBaseParameters": {
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "Product description. May include HTML formatting tags.",
+          "minLength": 1,
+          "maxLength": 1000
+        },
+        "terms": {
+          "type": "string",
+          "description": "Product terms of use. Developers trying to subscribe to the product will be presented and required to accept these terms before they can complete the subscription process."
+        },
+        "subscriptionRequired": {
+          "description": "Whether a product subscription is required for accessing APIs included in this product. If true, the product is referred to as \"protected\" and a valid subscription key is required for a request to an API included in the product to succeed. If false, the product is referred to as \"open\" and requests to an API included in the product can be made without a subscription key. If property is omitted when creating a new product it's value is assumed to be true.",
+          "type": "boolean"
+        },
+        "approvalRequired": {
+          "description": "whether subscription approval is required. If false, new subscriptions will be approved automatically enabling developers to call the product’s APIs immediately after subscribing. If true, administrators must manually approve the subscription before the developer can any of the product’s APIs. Can be present only if subscriptionRequired property is present and has a value of false.",
+          "type": "boolean"
+        },
+        "subscriptionsLimit": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Whether the number of subscriptions a user can have to this product at the same time. Set to null or omit to allow unlimited per user subscriptions. Can be present only if subscriptionRequired property is present and has a value of false."
+        },
+        "state": {
+          "type": "string",
+          "description": "whether product is published or not. Published products are discoverable by users of developer portal. Non published products are visible only to administrators. Default state of Product is notPublished.",
+          "enum": [
+            "notPublished",
+            "published"
+          ],
+          "x-ms-enum": {
+            "name": "ProductState",
+            "modelAsString": false
+          }
+        }
+      },
+      "description": "Product Entity Base Parameters"
+    },
+    "ProductTagResourceContractProperties": {
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Identifier of the product in the form of /products/{productId}"
+        },
+        "name": {
+          "type": "string",
+          "description": "Product name.",
+          "minLength": 1,
+          "maxLength": 300
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./definitions.json#/definitions/ProductEntityBaseParameters"
+        }
+      ],
+      "required": [
+        "name"
+      ],
+      "description": "Product profile."
+    },
+    "ProductUpdateParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ProductUpdateProperties",
+          "description": "Product entity Update contract properties."
+        }
+      },
+      "description": "Product Update parameters."
+    },
+    "ProductUpdateProperties": {
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "Product name.",
+          "maxLength": 300,
+          "minLength": 1
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ProductEntityBaseParameters"
+        }
+      ],
+      "description": "Parameters supplied to the Update Product operation."
+    },
+    "NamedValueCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/NamedValueContract"
+          },
+          "description": "Page values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged NamedValue list representation."
+    },
+    "NamedValueCreateContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/NamedValueCreateContractProperties",
+          "description": "NamedValue entity contract properties for PUT operation."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "NamedValue details."
+    },
+    "NamedValueCreateContractProperties": {
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "Unique name of NamedValue. It may contain only letters, digits, period, dash, and underscore characters.",
+          "minLength": 1,
+          "maxLength": 256,
+          "pattern": "^[A-Za-z0-9-._]+$"
+        },
+        "value": {
+          "type": "string",
+          "description": "Value of the NamedValue. Can contain policy expressions. It may not be empty or consist only of whitespace. This property will not be filled on 'GET' operations! Use '/listSecrets' POST request to get the value.",
+          "minLength": 1,
+          "maxLength": 4096
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/NamedValueEntityBaseParameters"
+        }
+      ],
+      "required": [
+        "displayName",
+        "value"
+      ],
+      "description": "NamedValue Contract properties."
+    },
+    "NamedValueContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/NamedValueContractProperties",
+          "description": "NamedValue entity contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "NamedValue details."
+    },
+    "NamedValueContractProperties": {
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "Unique name of NamedValue. It may contain only letters, digits, period, dash, and underscore characters.",
+          "minLength": 1,
+          "maxLength": 256,
+          "pattern": "^[A-Za-z0-9-._]+$"
+        },
+        "value": {
+          "type": "string",
+          "description": "Value of the NamedValue. Can contain policy expressions. It may not be empty or consist only of whitespace. This property will not be filled on 'GET' operations! Use '/listSecrets' POST request to get the value.",
+          "minLength": 1,
+          "maxLength": 4096
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/NamedValueEntityBaseParameters"
+        }
+      ],
+      "required": [
+        "displayName"
+      ],
+      "description": "NamedValue Contract properties."
+    },
+    "NamedValueEntityBaseParameters": {
+      "properties": {
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "maxItems": 32,
+          "description": "Optional tags that when provided can be used to filter the NamedValue list."
+        },
+        "secret": {
+          "description": "Determines whether the value is a secret and should be encrypted or not. Default value is false.",
+          "type": "boolean"
+        }
+      },
+      "description": "NamedValue Entity Base Parameters set."
+    },
+    "NamedValueUpdateParameterProperties": {
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "Unique name of NamedValue. It may contain only letters, digits, period, dash, and underscore characters.",
+          "minLength": 1,
+          "maxLength": 256,
+          "pattern": "^[A-Za-z0-9-._]+$"
+        },
+        "value": {
+          "type": "string",
+          "description": "Value of the NamedValue. Can contain policy expressions. It may not be empty or consist only of whitespace.",
+          "minLength": 1,
+          "maxLength": 4096
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/NamedValueEntityBaseParameters"
+        }
+      ],
+      "description": "NamedValue Contract properties."
+    },
+    "NamedValueUpdateParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/NamedValueUpdateParameterProperties",
+          "description": "NamedValue entity Update contract properties."
+        }
+      },
+      "description": "NamedValue update Parameters."
+    },
+    "QuotaCounterCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/QuotaCounterContract"
+          },
+          "description": "Quota counter values."
+        },
+        "count": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total record count number across all pages."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged Quota Counter list representation."
+    },
+    "QuotaCounterContract": {
+      "properties": {
+        "counterKey": {
+          "type": "string",
+          "description": "The Key value of the Counter. Must not be empty.",
+          "minLength": 1
+        },
+        "periodKey": {
+          "type": "string",
+          "description": "Identifier of the Period for which the counter was collected. Must not be empty.",
+          "minLength": 1
+        },
+        "periodStartTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The date of the start of Counter Period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard.\n"
+        },
+        "periodEndTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The date of the end of Counter Period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard.\n"
+        },
+        "value": {
+          "$ref": "#/definitions/QuotaCounterValueContractProperties",
+          "description": "Quota Value Properties"
+        }
+      },
+      "required": [
+        "counterKey",
+        "periodKey",
+        "periodStartTime",
+        "periodEndTime"
+      ],
+      "description": "Quota counter details."
+    },
+    "QuotaCounterValueContract": {
+      "properties": {
+        "value": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/QuotaCounterValueContractProperties",
+          "description": "Quota counter Value Properties."
+        }
+      },
+      "description": "Quota counter value details."
+    },
+    "QuotaCounterValueContractProperties": {
+      "properties": {
+        "callsCount": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Number of times Counter was called."
+        },
+        "kbTransferred": {
+          "type": "number",
+          "format": "double",
+          "description": "Data Transferred in KiloBytes."
+        }
+      },
+      "description": "Quota counter value details."
+    },
+    "RecipientEmailCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/RecipientEmailContract"
+          },
+          "description": "Page values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged Recipient User list representation."
+    },
+    "RecipientEmailContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/RecipientEmailContractProperties",
+          "description": "Recipient Email contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Recipient Email details."
+    },
+    "RecipientEmailContractProperties": {
+      "properties": {
+        "email": {
+          "type": "string",
+          "description": "User Email subscribed to notification."
+        }
+      },
+      "description": "Recipient Email Contract Properties."
+    },
+    "RecipientsContractProperties": {
+      "properties": {
+        "emails": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "List of Emails subscribed for the notification."
+        },
+        "users": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "List of Users subscribed for the notification."
+        }
+      },
+      "description": "Notification Parameter contract."
+    },
+    "RecipientUserCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/RecipientUserContract"
+          },
+          "description": "Page values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged Recipient User list representation."
+    },
+    "RecipientUserContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/RecipientUsersContractProperties",
+          "description": "Recipient User entity contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Recipient User details."
+    },
+    "RecipientUsersContractProperties": {
+      "properties": {
+        "userId": {
+          "type": "string",
+          "description": "API Management UserId subscribed to notification."
+        }
+      },
+      "description": "Recipient User Contract Properties."
+    },
+    "RegistrationDelegationSettingsProperties": {
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Enable or disable delegation for user registration."
+        }
+      },
+      "description": "User registration delegation settings properties."
+    },
+    "ReportCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ReportRecordContract"
+          },
+          "description": "Page values."
+        },
+        "count": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total record count number across all pages."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged Report records list representation."
+    },
+    "ReportRecordContract": {
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Name depending on report endpoint specifies product, API, operation or developer name."
+        },
+        "timestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Start of aggregation period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard.\n"
+        },
+        "interval": {
+          "type": "string",
+          "description": "Length of aggregation period.  Interval must be multiple of 15 minutes and may not be zero. The value should be in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations)."
+        },
+        "country": {
+          "type": "string",
+          "description": "Country to which this record data is related."
+        },
+        "region": {
+          "type": "string",
+          "description": "Country region to which this record data is related."
+        },
+        "zip": {
+          "type": "string",
+          "description": "Zip code to which this record data is related."
+        },
+        "userId": {
+          "readOnly": true,
+          "type": "string",
+          "description": "User identifier path. /users/{userId}"
+        },
+        "productId": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Product identifier path. /products/{productId}"
+        },
+        "apiId": {
+          "type": "string",
+          "description": "API identifier path. /apis/{apiId}"
+        },
+        "operationId": {
+          "type": "string",
+          "description": "Operation identifier path. /apis/{apiId}/operations/{operationId}"
+        },
+        "apiRegion": {
+          "type": "string",
+          "description": "API region identifier."
+        },
+        "subscriptionId": {
+          "type": "string",
+          "description": "Subscription identifier path. /subscriptions/{subscriptionId}"
+        },
+        "callCountSuccess": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Number of successful calls. This includes calls returning HttpStatusCode <= 301 and HttpStatusCode.NotModified and HttpStatusCode.TemporaryRedirect"
+        },
+        "callCountBlocked": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Number of calls blocked due to invalid credentials. This includes calls returning HttpStatusCode.Unauthorized and HttpStatusCode.Forbidden and HttpStatusCode.TooManyRequests"
+        },
+        "callCountFailed": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Number of calls failed due to proxy or backend errors. This includes calls returning HttpStatusCode.BadRequest(400) and any Code between HttpStatusCode.InternalServerError (500) and 600"
+        },
+        "callCountOther": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Number of other calls."
+        },
+        "callCountTotal": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Total number of calls."
+        },
+        "bandwidth": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Bandwidth consumed."
+        },
+        "cacheHitCount": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Number of times when content was served from cache policy."
+        },
+        "cacheMissCount": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Number of times content was fetched from backend."
+        },
+        "apiTimeAvg": {
+          "type": "number",
+          "format": "double",
+          "description": "Average time it took to process request."
+        },
+        "apiTimeMin": {
+          "type": "number",
+          "format": "double",
+          "description": "Minimum time it took to process request."
+        },
+        "apiTimeMax": {
+          "type": "number",
+          "format": "double",
+          "description": "Maximum time it took to process request."
+        },
+        "serviceTimeAvg": {
+          "type": "number",
+          "format": "double",
+          "description": "Average time it took to process request on backend."
+        },
+        "serviceTimeMin": {
+          "type": "number",
+          "format": "double",
+          "description": "Minimum time it took to process request on backend."
+        },
+        "serviceTimeMax": {
+          "type": "number",
+          "format": "double",
+          "description": "Maximum time it took to process request on backend."
+        }
+      },
+      "description": "Report data."
+    },
+    "RepresentationContract": {
+      "properties": {
+        "contentType": {
+          "type": "string",
+          "description": "Specifies a registered or custom content type for this representation, e.g. application/xml."
+        },
+        "sample": {
+          "type": "string",
+          "description": "An example of the representation."
+        },
+        "schemaId": {
+          "type": "string",
+          "description": "Schema identifier. Applicable only if 'contentType' value is neither 'application/x-www-form-urlencoded' nor 'multipart/form-data'."
+        },
+        "typeName": {
+          "type": "string",
+          "description": "Type name defined by the schema. Applicable only if 'contentType' value is neither 'application/x-www-form-urlencoded' nor 'multipart/form-data'."
+        },
+        "formParameters": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ParameterContract"
+          },
+          "description": "Collection of form parameters. Required if 'contentType' value is either 'application/x-www-form-urlencoded' or 'multipart/form-data'.."
+        }
+      },
+      "required": [
+        "contentType"
+      ],
+      "description": "Operation request/response representation details."
+    },
+    "RequestContract": {
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "Operation request description."
+        },
+        "queryParameters": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ParameterContract"
+          },
+          "description": "Collection of operation request query parameters."
+        },
+        "headers": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ParameterContract"
+          },
+          "description": "Collection of operation request headers."
+        },
+        "representations": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/RepresentationContract"
+          },
+          "description": "Collection of operation request representations."
+        }
+      },
+      "description": "Operation request details."
+    },
+    "RequestReportCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/RequestReportRecordContract"
+          },
+          "description": "Page values."
+        },
+        "count": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total record count number across all pages."
+        }
+      },
+      "description": "Paged Report records list representation."
+    },
+    "RequestReportRecordContract": {
+      "properties": {
+        "apiId": {
+          "type": "string",
+          "description": "API identifier path. /apis/{apiId}"
+        },
+        "operationId": {
+          "type": "string",
+          "description": "Operation identifier path. /apis/{apiId}/operations/{operationId}"
+        },
+        "productId": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Product identifier path. /products/{productId}"
+        },
+        "userId": {
+          "readOnly": true,
+          "type": "string",
+          "description": "User identifier path. /users/{userId}"
+        },
+        "method": {
+          "type": "string",
+          "description": "The HTTP method associated with this request.."
+        },
+        "url": {
+          "type": "string",
+          "description": "The full URL associated with this request."
+        },
+        "ipAddress": {
+          "type": "string",
+          "description": "The client IP address associated with this request."
+        },
+        "backendResponseCode": {
+          "type": "string",
+          "description": "The HTTP status code received by the gateway as a result of forwarding this request to the backend."
+        },
+        "responseCode": {
+          "type": "integer",
+          "format": "int32",
+          "description": "The HTTP status code returned by the gateway."
+        },
+        "responseSize": {
+          "type": "integer",
+          "format": "int32",
+          "description": "The size of the response returned by the gateway."
+        },
+        "timestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The date and time when this request was received by the gateway in ISO 8601 format."
+        },
+        "cache": {
+          "type": "string",
+          "description": "Specifies if response cache was involved in generating the response. If the value is none, the cache was not used. If the value is hit, cached response was returned. If the value is miss, the cache was used but lookup resulted in a miss and request was fulfilled by the backend."
+        },
+        "apiTime": {
+          "type": "number",
+          "format": "double",
+          "description": "The total time it took to process this request."
+        },
+        "serviceTime": {
+          "type": "number",
+          "format": "double",
+          "description": "he time it took to forward this request to the backend and get the response back."
+        },
+        "apiRegion": {
+          "type": "string",
+          "description": "Azure region where the gateway that processed this request is located."
+        },
+        "subscriptionId": {
+          "type": "string",
+          "description": "Subscription identifier path. /subscriptions/{subscriptionId}"
+        },
+        "requestId": {
+          "type": "string",
+          "description": "Request Identifier."
+        },
+        "requestSize": {
+          "type": "integer",
+          "format": "int32",
+          "description": "The size of this request.."
+        }
+      },
+      "description": "Request Report data."
+    },
+    "ResponseContract": {
+      "properties": {
+        "statusCode": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Operation response HTTP status code."
+        },
+        "description": {
+          "type": "string",
+          "description": "Operation response description."
+        },
+        "representations": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/RepresentationContract"
+          },
+          "description": "Collection of operation response representations."
+        },
+        "headers": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ParameterContract"
+          },
+          "description": "Collection of operation response headers."
+        }
+      },
+      "required": [
+        "statusCode"
+      ],
+      "description": "Operation response details."
+    },
+    "SamplingSettings": {
+      "properties": {
+        "samplingType": {
+          "type": "string",
+          "description": "Sampling type.",
+          "enum": [
+            "fixed"
+          ],
+          "x-ms-enum": {
+            "name": "SamplingType",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "fixed",
+                "description": "Fixed-rate sampling."
+              }
+            ]
+          }
+        },
+        "percentage": {
+          "type": "number",
+          "format": "double",
+          "minimum": 0,
+          "maximum": 100,
+          "description": "Rate of sampling for fixed-rate sampling."
+        }
+      },
+      "description": "Sampling settings for Diagnostic."
+    },
+    "SaveConfigurationParameter": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/SaveConfigurationParameterProperties",
+          "description": "Properties of the Save Configuration Parameters."
+        }
+      },
+      "description": "Save Tenant Configuration Contract details."
+    },
+    "SaveConfigurationParameterProperties": {
+      "properties": {
+        "branch": {
+          "type": "string",
+          "description": "The name of the Git branch in which to commit the current configuration snapshot."
+        },
+        "force": {
+          "type": "boolean",
+          "description": "The value if true, the current configuration database is committed to the Git repository, even if the Git repository has newer changes that would be overwritten."
+        }
+      },
+      "required": [
+        "branch"
+      ],
+      "description": "Parameters supplied to the Save Tenant Configuration operation."
+    },
+    "SchemaCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SchemaContract"
+          },
+          "description": "Api Schema Contract value.",
+          "readOnly": true
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any.",
+          "readOnly": true
+        }
+      },
+      "description": "The response of the list schema operation."
+    },
+    "SchemaContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/SchemaContractProperties",
+          "description": "Properties of the Schema."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Schema Contract details."
+    },
+    "SchemaContractProperties": {
+      "properties": {
+        "contentType": {
+          "type": "string",
+          "description": "Must be a valid a media type used in a Content-Type header as defined in the RFC 2616. Media type of the schema document (e.g. application/json, application/xml). </br> - `Swagger` Schema use `application/vnd.ms-azure-apim.swagger.definitions+json` </br> - `WSDL` Schema use `application/vnd.ms-azure-apim.xsd+xml` </br> - `OpenApi` Schema use `application/vnd.oai.openapi.components+json` </br> - `WADL Schema` use `application/vnd.ms-azure-apim.wadl.grammars+xml`."
+        },
+        "document": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/SchemaDocumentProperties",
+          "description": "Create or update Properties of the Schema Document."
+        }
+      },
+      "required": [
+        "contentType"
+      ],
+      "description": "API Schema create or update contract Properties."
+    },
+    "SchemaDocumentProperties": {
+      "properties": {
+        "value": {
+          "type": "string",
+          "description": "Json escaped string defining the document representing the Schema. Used for schemas other than Swagger/OpenAPI."
+        },
+        "definitions": {
+          "type": "object",
+          "description": "Types definitions. Used for Swagger/OpenAPI schemas only, null otherwise."
+        }
+      },
+      "description": "Schema Document Properties."
+    },
+    "SubscriptionCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SubscriptionContract"
+          },
+          "description": "Page values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged Subscriptions list representation."
+    },
+    "SubscriptionContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/SubscriptionContractProperties",
+          "description": "Subscription contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Subscription details."
+    },
+    "SubscriptionContractProperties": {
+      "properties": {
+        "ownerId": {
+          "type": "string",
+          "description": "The user resource identifier of the subscription owner. The value is a valid relative URL in the format of /users/{userId} where {userId} is a user identifier."
+        },
+        "scope": {
+          "type": "string",
+          "description": "Scope like /products/{productId} or /apis or /apis/{apiId}."
+        },
+        "displayName": {
+          "type": "string",
+          "description": "The name of the subscription, or null if the subscription has no name.",
+          "minLength": 0,
+          "maxLength": 100
+        },
+        "state": {
+          "type": "string",
+          "description": "Subscription state. Possible states are * active – the subscription is active, * suspended – the subscription is blocked, and the subscriber cannot call any APIs of the product, * submitted – the subscription request has been made by the developer, but has not yet been approved or rejected, * rejected – the subscription request has been denied by an administrator, * cancelled – the subscription has been cancelled by the developer or administrator, * expired – the subscription reached its expiration date and was deactivated.",
+          "enum": [
+            "suspended",
+            "active",
+            "expired",
+            "submitted",
+            "rejected",
+            "cancelled"
+          ],
+          "x-ms-enum": {
+            "name": "SubscriptionState",
+            "modelAsString": false
+          }
+        },
+        "createdDate": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Subscription creation date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard.\n",
+          "readOnly": true
+        },
+        "startDate": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Subscription activation date. The setting is for audit purposes only and the subscription is not automatically activated. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard.\n"
+        },
+        "expirationDate": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Subscription expiration date. The setting is for audit purposes only and the subscription is not automatically expired. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard.\n"
+        },
+        "endDate": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Date when subscription was cancelled or expired. The setting is for audit purposes only and the subscription is not automatically cancelled. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard.\n"
+        },
+        "notificationDate": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Upcoming subscription expiration notification date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard.\n"
+        },
+        "primaryKey": {
+          "x-ms-secret": true,
+          "type": "string",
+          "description": "Subscription primary key. This property will not be filled on 'GET' operations! Use '/listSecrets' POST request to get the value.",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "secondaryKey": {
+          "x-ms-secret": true,
+          "type": "string",
+          "description": "Subscription secondary key. This property will not be filled on 'GET' operations! Use '/listSecrets' POST request to get the value.",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "stateComment": {
+          "type": "string",
+          "description": "Optional subscription comment added by an administrator."
+        },
+        "allowTracing": {
+          "type": "boolean",
+          "description": "Determines whether tracing is enabled",
+          "x-apim-code-nillable": true
+        }
+      },
+      "required": [
+        "scope",
+        "state"
+      ],
+      "description": "Subscription details."
+    },
+    "SubscriptionCreateParameterProperties": {
+      "properties": {
+        "ownerId": {
+          "type": "string",
+          "description": "User (user id path) for whom subscription is being created in form /users/{userId}"
+        },
+        "scope": {
+          "type": "string",
+          "description": "Scope like /products/{productId} or /apis or /apis/{apiId}."
+        },
+        "displayName": {
+          "type": "string",
+          "description": "Subscription name.",
+          "minLength": 1,
+          "maxLength": 100
+        },
+        "primaryKey": {
+          "type": "string",
+          "description": "Primary subscription key. If not specified during request key will be generated automatically.",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "secondaryKey": {
+          "type": "string",
+          "description": "Secondary subscription key. If not specified during request key will be generated automatically.",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "state": {
+          "type": "string",
+          "description": "Initial subscription state. If no value is specified, subscription is created with Submitted state. Possible states are * active – the subscription is active, * suspended – the subscription is blocked, and the subscriber cannot call any APIs of the product, * submitted – the subscription request has been made by the developer, but has not yet been approved or rejected, * rejected – the subscription request has been denied by an administrator, * cancelled – the subscription has been cancelled by the developer or administrator, * expired – the subscription reached its expiration date and was deactivated.",
+          "enum": [
+            "suspended",
+            "active",
+            "expired",
+            "submitted",
+            "rejected",
+            "cancelled"
+          ],
+          "x-ms-enum": {
+            "name": "SubscriptionState",
+            "modelAsString": false
+          }
+        },
+        "allowTracing": {
+          "type": "boolean",
+          "description": "Determines whether tracing can be enabled"
+        }
+      },
+      "required": [
+        "scope",
+        "displayName"
+      ],
+      "description": "Parameters supplied to the Create subscription operation."
+    },
+    "SubscriptionCreateParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/SubscriptionCreateParameterProperties",
+          "description": "Subscription contract properties."
+        }
+      },
+      "description": "Subscription create details."
+    },
+    "SubscriptionKeyParameterNamesContract": {
+      "properties": {
+        "header": {
+          "type": "string",
+          "description": "Subscription key header name."
+        },
+        "query": {
+          "type": "string",
+          "description": "Subscription key query string parameter name."
+        }
+      },
+      "description": "Subscription key parameter names details.",
+      "example": {
+        "subscriptionKeyParameterNames": {
+          "query": "customQueryParameterName",
+          "header": "customHeaderParameterName"
+        }
+      }
+    },
+    "SubscriptionsDelegationSettingsProperties": {
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Enable or disable delegation for subscriptions."
+        }
+      },
+      "description": "Subscriptions delegation settings properties."
+    },
+    "SubscriptionUpdateParameterProperties": {
+      "properties": {
+        "ownerId": {
+          "type": "string",
+          "description": "User identifier path: /users/{userId}"
+        },
+        "scope": {
+          "type": "string",
+          "description": "Scope like /products/{productId} or /apis or /apis/{apiId}"
+        },
+        "expirationDate": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Subscription expiration date. The setting is for audit purposes only and the subscription is not automatically expired. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard."
+        },
+        "displayName": {
+          "type": "string",
+          "description": "Subscription name."
+        },
+        "primaryKey": {
+          "type": "string",
+          "description": "Primary subscription key.",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "secondaryKey": {
+          "type": "string",
+          "description": "Secondary subscription key.",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "state": {
+          "type": "string",
+          "description": "Subscription state. Possible states are * active – the subscription is active, * suspended – the subscription is blocked, and the subscriber cannot call any APIs of the product, * submitted – the subscription request has been made by the developer, but has not yet been approved or rejected, * rejected – the subscription request has been denied by an administrator, * cancelled – the subscription has been cancelled by the developer or administrator, * expired – the subscription reached its expiration date and was deactivated.",
+          "enum": [
+            "suspended",
+            "active",
+            "expired",
+            "submitted",
+            "rejected",
+            "cancelled"
+          ],
+          "x-ms-enum": {
+            "name": "SubscriptionState",
+            "modelAsString": false
+          }
+        },
+        "stateComment": {
+          "type": "string",
+          "description": "Comments describing subscription state change by the administrator."
+        },
+        "allowTracing": {
+          "type": "boolean",
+          "description": "Determines whether tracing can be enabled"
+        }
+      },
+      "description": "Parameters supplied to the Update subscription operation."
+    },
+    "SubscriptionUpdateParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/SubscriptionUpdateParameterProperties",
+          "description": "Subscription Update contract properties."
+        }
+      },
+      "description": "Subscription update details."
+    },
+    "TagCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/TagContract"
+          },
+          "description": "Page values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged Tag list representation."
+    },
+    "TagContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/TagContractProperties",
+          "description": "Tag entity contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Tag Contract details."
+    },
+    "TagContractProperties": {
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "Tag name.",
+          "maxLength": 160,
+          "minLength": 1
+        }
+      },
+      "required": [
+        "displayName"
+      ],
+      "description": "Tag contract Properties."
+    },
+    "TagCreateUpdateParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/TagContractProperties",
+          "description": "Properties supplied to Create Tag operation."
+        }
+      },
+      "description": "Parameters supplied to Create/Update Tag operations."
+    },
+    "TagDescriptionBaseProperties": {
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "Description of the Tag."
+        },
+        "externalDocsUrl": {
+          "type": "string",
+          "description": "Absolute URL of external resources describing the tag.",
+          "maxLength": 2000
+        },
+        "externalDocsDescription": {
+          "type": "string",
+          "description": "Description of the external resources describing the tag."
+        }
+      },
+      "description": "Parameters supplied to the Create TagDescription operation."
+    },
+    "TagDescriptionCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/TagDescriptionContract"
+          },
+          "description": "Page values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged TagDescription list representation."
+    },
+    "TagDescriptionContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/TagDescriptionContractProperties",
+          "description": "TagDescription entity contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Contract details."
+    },
+    "TagDescriptionContractProperties": {
+      "properties": {
+        "tagId": {
+          "type": "string",
+          "description": "Identifier of the tag in the form of /tags/{tagId}"
+        },
+        "displayName": {
+          "type": "string",
+          "description": "Tag name.",
+          "maxLength": 160,
+          "minLength": 1
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/TagDescriptionBaseProperties"
+        }
+      ],
+      "description": "TagDescription contract Properties."
+    },
+    "TagDescriptionCreateParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/TagDescriptionBaseProperties",
+          "description": "Properties supplied to Create TagDescription operation."
+        }
+      },
+      "description": "Parameters supplied to the Create TagDescription operation."
+    },
+    "TagResourceCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/TagResourceContract"
+          },
+          "description": "Page values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged Tag list representation."
+    },
+    "TagResourceContract": {
+      "properties": {
+        "tag": {
+          "$ref": "#/definitions/TagTagResourceContractProperties",
+          "description": "Tag associated with the resource."
+        },
+        "api": {
+          "$ref": "#/definitions/ApiTagResourceContractProperties",
+          "description": "Api associated with the tag."
+        },
+        "operation": {
+          "$ref": "#/definitions/OperationTagResourceContractProperties",
+          "description": "Operation associated with the tag."
+        },
+        "product": {
+          "$ref": "#/definitions/ProductTagResourceContractProperties",
+          "description": "Product associated with the tag."
+        }
+      },
+      "required": [
+        "tag"
+      ],
+      "description": "TagResource contract properties."
+    },
+    "TagTagResourceContractProperties": {
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Tag identifier"
+        },
+        "name": {
+          "type": "string",
+          "description": "Tag Name",
+          "minLength": 1,
+          "maxLength": 160
+        }
+      },
+      "description": "Contract defining the Tag property in the Tag Resource Contract"
+    },
+    "TenantConfigurationSyncStateContract": {
+      "properties": {
+        "branch": {
+          "type": "string",
+          "description": "The name of Git branch."
+        },
+        "commitId": {
+          "type": "string",
+          "description": "The latest commit Id."
+        },
+        "isExport": {
+          "type": "boolean",
+          "description": "value indicating if last sync was save (true) or deploy (false) operation."
+        },
+        "isSynced": {
+          "type": "boolean",
+          "description": "value indicating if last synchronization was later than the configuration change."
+        },
+        "isGitEnabled": {
+          "type": "boolean",
+          "description": "value indicating whether Git configuration access is enabled."
+        },
+        "syncDate": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The date of the latest synchronization. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard.\n"
+        },
+        "configurationChangeDate": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The date of the latest configuration change. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard.\n"
+        }
+      },
+      "description": "Tenant Configuration Synchronization State."
+    },
+    "TermsOfServiceProperties": {
+      "properties": {
+        "text": {
+          "type": "string",
+          "description": "A terms of service text."
+        },
+        "enabled": {
+          "type": "boolean",
+          "description": "Display terms of service during a sign-up process."
+        },
+        "consentRequired": {
+          "type": "boolean",
+          "description": "Ask user for consent to the terms of service."
+        }
+      },
+      "description": "Terms of service contract properties."
+    },
+    "TokenBodyParameterContract": {
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "body parameter name."
+        },
+        "value": {
+          "type": "string",
+          "description": "body parameter value."
+        }
+      },
+      "required": [
+        "name",
+        "value"
+      ],
+      "description": "OAuth acquire token request body parameter (www-url-form-encoded)."
+    },
+    "UserCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/UserContract"
+          },
+          "description": "Page values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged Users list representation."
+    },
+    "UserContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/UserContractProperties",
+          "description": "User entity contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "User details."
+    },
+    "UserContractProperties": {
+      "properties": {
+        "firstName": {
+          "type": "string",
+          "description": "First name."
+        },
+        "lastName": {
+          "type": "string",
+          "description": "Last name."
+        },
+        "email": {
+          "type": "string",
+          "description": "Email address."
+        },
+        "registrationDate": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Date of user registration. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard.\n"
+        },
+        "groups": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "./definitions.json#/definitions/GroupContractProperties"
+          },
+          "description": "Collection of groups user is part of."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/UserEntityBaseParameters"
+        }
+      ],
+      "description": "User profile."
+    },
+    "UserCreateParameterProperties": {
+      "properties": {
+        "email": {
+          "type": "string",
+          "description": "Email address. Must not be empty and must be unique within the service instance.",
+          "minLength": 1,
+          "maxLength": 254
+        },
+        "firstName": {
+          "type": "string",
+          "description": "First name.",
+          "minLength": 1,
+          "maxLength": 100
+        },
+        "lastName": {
+          "type": "string",
+          "description": "Last name.",
+          "minLength": 1,
+          "maxLength": 100
+        },
+        "password": {
+          "type": "string",
+          "description": "User Password. If no value is provided, a default password is generated."
+        },
+        "appType": {
+          "type": "string",
+          "description": "Determines the type of application which send the create user request. Default is old publisher portal.",
+          "enum": [
+            "developerPortal"
+          ],
+          "x-ms-enum": {
+            "name": "AppType",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "developerPortal",
+                "description": "User create request was sent by new developer portal."
+              }
+            ]
+          }
+        },
+        "confirmation": {
+          "type": "string",
+          "description": "Determines the type of confirmation e-mail that will be sent to the newly created user.",
+          "enum": [
+            "signup",
+            "invite"
+          ],
+          "x-ms-enum": {
+            "name": "Confirmation",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "signup",
+                "description": "Send an e-mail to the user confirming they have successfully signed up."
+              },
+              {
+                "value": "invite",
+                "description": "Send an e-mail inviting the user to sign-up and complete registration."
+              }
+            ]
+          }
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/UserEntityBaseParameters"
+        }
+      ],
+      "required": [
+        "email",
+        "firstName",
+        "lastName"
+      ],
+      "description": "Parameters supplied to the Create User operation."
+    },
+    "UserCreateParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/UserCreateParameterProperties",
+          "description": "User entity create contract properties."
+        }
+      },
+      "description": "User create details."
+    },
+    "UserEntityBaseParameters": {
+      "properties": {
+        "state": {
+          "type": "string",
+          "description": "Account state. Specifies whether the user is active or not. Blocked users are unable to sign into the developer portal or call any APIs of subscribed products. Default state is Active.",
+          "enum": [
+            "active",
+            "blocked",
+            "pending",
+            "deleted"
+          ],
+          "default": "active",
+          "x-ms-enum": {
+            "name": "UserState",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "active",
+                "description": "User state is active."
+              },
+              {
+                "value": "blocked",
+                "description": "User is blocked. Blocked users cannot authenticate at developer portal or call API."
+              },
+              {
+                "value": "pending",
+                "description": "User account is pending. Requires identity confirmation before it can be made active."
+              },
+              {
+                "value": "deleted",
+                "description": "User account is closed. All identities and related entities are removed."
+              }
+            ]
+          }
+        },
+        "note": {
+          "type": "string",
+          "description": "Optional note about a user set by the administrator."
+        },
+        "identities": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/UserIdentityContract"
+          },
+          "description": "Collection of user identities."
+        }
+      },
+      "description": "User Entity Base Parameters set."
+    },
+    "UserIdentityCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/UserIdentityContract"
+          },
+          "description": "User Identity values."
+        },
+        "count": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total record count number across all pages."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "List of Users Identity list representation."
+    },
+    "UserIdentityContract": {
+      "properties": {
+        "provider": {
+          "type": "string",
+          "description": "Identity provider name."
+        },
+        "id": {
+          "type": "string",
+          "description": "Identifier value within provider."
+        }
+      },
+      "description": "User identity details."
+    },
+    "UserTokenParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/UserTokenParameterProperties",
+          "description": "User Token Parameter contract properties."
+        }
+      },
+      "description": "Get User Token parameters."
+    },
+    "UserTokenParameterProperties": {
+      "properties": {
+        "keyType": {
+          "type": "string",
+          "description": "The Key to be used to generate token for user.",
+          "enum": [
+            "primary",
+            "secondary"
+          ],
+          "default": "primary",
+          "x-ms-enum": {
+            "name": "KeyType",
+            "modelAsString": false
+          }
+        },
+        "expiry": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The Expiry time of the Token. Maximum token expiry time is set to 30 days. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard.\n"
+        }
+      },
+      "required": [
+        "keyType",
+        "expiry"
+      ],
+      "description": "Parameters supplied to the Get User Token operation."
+    },
+    "UserTokenResult": {
+      "properties": {
+        "value": {
+          "type": "string",
+          "description": "Shared Access Authorization token for the User."
+        }
+      },
+      "description": "Get User Token response details."
+    },
+    "UserUpdateParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/UserUpdateParametersProperties",
+          "description": "User entity update contract properties."
+        }
+      },
+      "description": "User update parameters."
+    },
+    "UserUpdateParametersProperties": {
+      "properties": {
+        "email": {
+          "type": "string",
+          "description": "Email address. Must not be empty and must be unique within the service instance.",
+          "minLength": 1,
+          "maxLength": 254
+        },
+        "password": {
+          "type": "string",
+          "description": "User Password."
+        },
+        "firstName": {
+          "type": "string",
+          "description": "First name.",
+          "minLength": 1,
+          "maxLength": 100
+        },
+        "lastName": {
+          "type": "string",
+          "description": "Last name.",
+          "minLength": 1,
+          "maxLength": 100
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/UserEntityBaseParameters"
+        }
+      ],
+      "description": "Parameters supplied to the Update User operation."
+    },
+    "X509CertificateName": {
+      "properties": {
+        "name": {
+          "description": "Common Name of the Certificate.",
+          "type": "string"
+        },
+        "issuerCertificateThumbprint": {
+          "description": "Thumbprint for the Issuer of the Certificate.",
+          "type": "string"
+        }
+      },
+      "externalDocs": {
+        "url": "https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-windows-cluster-x509-security"
+      },
+      "description": "Properties of server X509Names."
+    },
+    "ClientSecretContract": {
+      "properties": {
+        "clientSecret": {
+          "type": "string",
+          "description": "Client or app secret used in IdentityProviders, Aad, OpenID or OAuth."
+        }
+      },
+      "description": "Client or app secret used in IdentityProviders, Aad, OpenID or OAuth."
+    },
+    "PropertyValueContract": {
+      "properties": {
+        "value": {
+          "type": "string",
+          "description": "This is secret value of the NamedValue entity."
+        }
+      },
+      "description": "Client or app secret used in IdentityProviders, Aad, OpenID or OAuth."
+    },
+    "PortalSettingValidationKeyContract": {
+      "properties": {
+        "validationKey": {
+          "type": "string",
+          "description": "This is secret value of the validation key in portal settings."
+        }
+      },
+      "description": "Client or app secret used in IdentityProviders, Aad, OpenID or OAuth."
+    },
+    "SubscriptionKeysContract": {
+      "properties": {
+        "primaryKey": {
+          "type": "string",
+          "description": "Subscription primary key.",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "secondaryKey": {
+          "type": "string",
+          "description": "Subscription secondary key.",
+          "minLength": 1,
+          "maxLength": 256
+        }
+      },
+      "description": "Subscription keys."
+    },
+    "GatewayCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/GatewayContract"
+          },
+          "description": "Page values.",
+          "readOnly": true
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any.",
+          "readOnly": true
+        }
+      },
+      "description": "Paged Gateway list representation."
+    },
+    "GatewayContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/GatewayContractProperties",
+          "description": "Gateway details."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Gateway details."
+    },
+    "GatewayContractProperties": {
+      "properties": {
+        "locationData": {
+          "$ref": "#/definitions/ResourceLocationDataContract",
+          "description": "Gateway location."
+        },
+        "description": {
+          "type": "string",
+          "description": "Gateway description",
+          "maxLength": 1000
+        }
+      },
+      "description": "Properties of the Gateway contract."
+    },
+    "ResourceLocationDataContract": {
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "A canonical name for the geographic or physical location.",
+          "maxLength": 256
+        },
+        "city": {
+          "type": "string",
+          "description": "The city or locality where the resource is located.",
+          "maxLength": 256
+        },
+        "district": {
+          "type": "string",
+          "description": "The district, state, or province where the resource is located.",
+          "maxLength": 256
+        },
+        "countryOrRegion": {
+          "type": "string",
+          "description": "The country or region where the resource is located.",
+          "maxLength": 256
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "description": "Resource location data properties."
+    },
+    "GatewayKeysContract": {
+      "properties": {
+        "primary": {
+          "type": "string",
+          "description": "Primary gateway key."
+        },
+        "secondary": {
+          "type": "string",
+          "description": "Secondary gateway key."
+        }
+      },
+      "description": "Gateway authentication keys."
+    },
+    "GatewayTokenRequestContract": {
+      "properties": {
+        "keyType": {
+          "type": "string",
+          "description": "The Key to be used to generate gateway token.",
+          "enum": [
+            "primary",
+            "secondary"
+          ],
+          "default": "primary",
+          "x-ms-enum": {
+            "name": "KeyType",
+            "modelAsString": false
+          }
+        },
+        "expiry": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The Expiry time of the Token. Maximum token expiry time is set to 30 days. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard.\n"
+        }
+      },
+      "required": [
+        "keyType",
+        "expiry"
+      ],
+      "description": "Gateway token request contract properties."
+    },
+    "GatewayTokenContract": {
+      "properties": {
+        "value": {
+          "type": "string",
+          "description": "Shared Access Authentication token value for the Gateway."
+        }
+      },
+      "description": "Gateway access token."
+    },
+    "GatewayKeyRegenerationRequestContract": {
+      "properties": {
+        "keyType": {
+          "type": "string",
+          "description": "The Key being regenerated.",
+          "enum": [
+            "primary",
+            "secondary"
+          ],
+          "x-ms-enum": {
+            "name": "KeyType",
+            "modelAsString": false
+          }
+        }
+      },
+      "required": [
+        "keyType"
+      ],
+      "description": "Gateway key regeneration request contract properties."
+    },
+    "GatewayHostnameConfigurationCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/GatewayHostnameConfigurationContract"
+          },
+          "description": "Page values.",
+          "readOnly": true
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any.",
+          "readOnly": true
+        }
+      },
+      "description": "Paged Gateway hostname configuration list representation."
+    },
+    "GatewayHostnameConfigurationContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/GatewayHostnameConfigurationContractProperties",
+          "description": "Gateway hostname configuration details."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Gateway hostname configuration details."
+    },
+    "GatewayHostnameConfigurationContractProperties": {
+      "properties": {
+        "hostname": {
+          "type": "string",
+          "description": "Hostname value. Supports valid domain name, partial or full wildcard"
+        },
+        "certificateId": {
+          "type": "string",
+          "description": "Identifier of Certificate entity that will be used for TLS connection establishment"
+        },
+        "negotiateClientCertificate": {
+          "type": "boolean",
+          "description": "Determines whether gateway requests client certificate"
+        }
+      },
+      "description": "Gateway hostname configuration details."
+    },
+    "AssociationContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "properties": {
+            "provisioningState": {
+              "type": "string",
+              "description": "Provisioning state.",
+              "enum": [
+                "created"
+              ],
+              "x-ms-enum": {
+                "name": "ProvisioningState",
+                "modelAsString": false
+              }
+            }
+          },
+          "description": "Association entity contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Association entity details."
+    }
+  },
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementApplyNetworkConfigurationUpdates.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementApplyNetworkConfigurationUpdates.json
new file mode 100644
index 000000000000..1d9eb86172ab
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementApplyNetworkConfigurationUpdates.json
@@ -0,0 +1,53 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "parameters": {
+      "location": "west us"
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/dGVjaGVkX01hbmFnZVJvbGVfNWRiNGI3Ng==?api-version=2019-12-01"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+        "name": "apimService1",
+        "type": "Microsoft.ApiManagement/service",
+        "tags": {
+          "UID": "52ed5986-717b-45b4-b17c-3df8db372cff"
+        },
+        "location": "East Asia",
+        "etag": "AAAAAAAXX6Y=",
+        "properties": {
+          "publisherEmail": "admin@live.com",
+          "publisherName": "Contoso",
+          "provisioningState": "Succeeded",
+          "targetProvisioningState": "",
+          "createdAtUtc": "2015-09-22T01:50:34.7921566Z",
+          "gatewayUrl": "https://apimService1.azure-api.net",
+          "portalUrl": "https://apimService1.portal.azure-api.net",
+          "managementApiUrl": "https://apimService1.management.azure-api.net",
+          "scmUrl": "https://apimService1.scm.azure-api.net",
+          "hostnameConfigurations": [],
+          "publicIPAddresses": [
+            "207.46.155.24"
+          ],
+          "virtualNetworkConfiguration": {
+            "subnetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/eastUsVirtualNetwork/subnets/apimSubnet"
+          },
+          "virtualNetworkType": "External"
+        },
+        "sku": {
+          "name": "Premium",
+          "capacity": 1
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementBackendReconnect.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementBackendReconnect.json
new file mode 100644
index 000000000000..ef84823bcd09
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementBackendReconnect.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "backendId": "proxybackend",
+    "parameters": {
+      "properties": {
+        "after": "PT3S"
+      }
+    }
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateAILogger.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateAILogger.json
new file mode 100644
index 000000000000..ad1d38c31abe
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateAILogger.json
@@ -0,0 +1,51 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "loggerId": "loggerId",
+    "parameters": {
+      "properties": {
+        "loggerType": "applicationInsights",
+        "description": "adding a new logger",
+        "credentials": {
+          "instrumentationKey": "11................a1"
+        }
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/loggers/loggerId",
+        "type": "Microsoft.ApiManagement/service/loggers",
+        "name": "loggerId",
+        "properties": {
+          "loggerType": "applicationInsights",
+          "description": null,
+          "credentials": {
+            "instrumentationKey": "{{5a.......2a}}"
+          },
+          "isBuffered": false,
+          "resourceId": "/subscriptions/subid/resourceGroups/rg1/providers/microsoft.insights/components/airesource"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/loggers/loggerId",
+        "type": "Microsoft.ApiManagement/service/loggers",
+        "name": "loggerId",
+        "properties": {
+          "loggerType": "applicationInsights",
+          "description": null,
+          "credentials": {
+            "instrumentationKey": "{{5a.......2a}}"
+          },
+          "isBuffered": false
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApi.json
new file mode 100644
index 000000000000..c1ad48276acf
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApi.json
@@ -0,0 +1,98 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "tempgroup",
+    "parameters": {
+      "properties": {
+        "description": "apidescription5200",
+        "authenticationSettings": {
+          "oAuth2": {
+            "authorizationServerId": "authorizationServerId2283",
+            "scope": "oauth2scope2580"
+          }
+        },
+        "subscriptionKeyParameterNames": {
+          "header": "header4520",
+          "query": "query3037"
+        },
+        "displayName": "apiname1463",
+        "serviceUrl": "http://newechoapi.cloudapp.net/api",
+        "path": "newapiPath",
+        "protocols": [
+          "https",
+          "http"
+        ]
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/apiid9419",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "apiid9419",
+        "properties": {
+          "displayName": "apiname1463",
+          "apiRevision": "1",
+          "description": "apidescription5200",
+          "serviceUrl": "http://newechoapi.cloudapp.net/api",
+          "path": "newapiPath",
+          "protocols": [
+            "http",
+            "https"
+          ],
+          "authenticationSettings": {
+            "oAuth2": {
+              "authorizationServerId": "authorizationServerId2283",
+              "scope": "oauth2scope2580"
+            }
+          },
+          "subscriptionKeyParameterNames": {
+            "header": "header4520",
+            "query": "query3037"
+          },
+          "isCurrent": true,
+          "isOnline": true
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/tempgroup?api-version=2019-12-01&asyncId=5c730e343244df1b9cb56e85&asyncCode=201"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/apiid9419",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "apiid9419",
+        "properties": {
+          "displayName": "apiname1463",
+          "apiRevision": "1",
+          "description": "apidescription5200",
+          "serviceUrl": "http://newechoapi.cloudapp.net/api",
+          "path": "newapiPath",
+          "protocols": [
+            "http",
+            "https"
+          ],
+          "authenticationSettings": {
+            "oAuth2": {
+              "authorizationServerId": "authorizationServerId2283",
+              "scope": "oauth2scope2580"
+            }
+          },
+          "subscriptionKeyParameterNames": {
+            "header": "header4520",
+            "query": "query3037"
+          },
+          "isCurrent": true,
+          "isOnline": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiClone.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiClone.json
new file mode 100644
index 000000000000..9f97b4d34826
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiClone.json
@@ -0,0 +1,79 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "echo-api2",
+    "parameters": {
+      "properties": {
+        "displayName": "Echo API2",
+        "description": "Copy of Existing Echo Api including Operations.",
+        "subscriptionRequired": true,
+        "serviceUrl": "http://echoapi.cloudapp.net/api",
+        "path": "echo2",
+        "protocols": [
+          "http",
+          "https"
+        ],
+        "isCurrent": true,
+        "sourceApiId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/58a4aeac497000007d040001"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/echoapi2",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "echoapi2",
+        "properties": {
+          "displayName": "Echo API2",
+          "apiRevision": "1",
+          "description": "Copy of Existing Echo Api including Operations.",
+          "subscriptionRequired": true,
+          "serviceUrl": "http://echoapi.cloudapp.net/api",
+          "path": "echo2",
+          "protocols": [
+            "http",
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "isCurrent": true
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/tempgroup?api-version=2019-12-01&asyncId=5c730e343244df1b9cb56e85&asyncCode=201"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/echoapi2",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "echoapi2",
+        "properties": {
+          "displayName": "Echo API2",
+          "apiRevision": "1",
+          "description": "Copy of Existing Echo Api including Operations.",
+          "subscriptionRequired": true,
+          "serviceUrl": "http://echoapi.cloudapp.net/api",
+          "path": "echo2",
+          "protocols": [
+            "http",
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "isCurrent": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiDiagnostic.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiDiagnostic.json
new file mode 100644
index 000000000000..f5e479f8ed67
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiDiagnostic.json
@@ -0,0 +1,160 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "diagnosticId": "applicationinsights",
+    "apiId": "57d1f7558aa04f15146d9d8a",
+    "parameters": {
+      "properties": {
+        "alwaysLog": "allErrors",
+        "loggerId": "/loggers/applicationinsights",
+        "sampling": {
+          "samplingType": "fixed",
+          "percentage": 50
+        },
+        "frontend": {
+          "request": {
+            "headers": [
+              "Content-type"
+            ],
+            "body": {
+              "bytes": 512
+            }
+          },
+          "response": {
+            "headers": [
+              "Content-type"
+            ],
+            "body": {
+              "bytes": 512
+            }
+          }
+        },
+        "backend": {
+          "request": {
+            "headers": [
+              "Content-type"
+            ],
+            "body": {
+              "bytes": 512
+            }
+          },
+          "response": {
+            "headers": [
+              "Content-type"
+            ],
+            "body": {
+              "bytes": 512
+            }
+          }
+        }
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a/diagnostics/applicationinsights",
+        "type": "Microsoft.ApiManagement/service/apis/diagnostics",
+        "name": "applicationinsights",
+        "properties": {
+          "alwaysLog": "allErrors",
+          "loggerId": "/loggers/applicationinsights",
+          "sampling": {
+            "samplingType": "fixed",
+            "percentage": 50
+          },
+          "frontend": {
+            "request": {
+              "headers": [
+                "Content-type"
+              ],
+              "body": {
+                "bytes": 512
+              }
+            },
+            "response": {
+              "headers": [
+                "Content-type"
+              ],
+              "body": {
+                "bytes": 512
+              }
+            }
+          },
+          "backend": {
+            "request": {
+              "headers": [
+                "Content-type"
+              ],
+              "body": {
+                "bytes": 512
+              }
+            },
+            "response": {
+              "headers": [
+                "Content-type"
+              ],
+              "body": {
+                "bytes": 512
+              }
+            }
+          }
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a/diagnostics/applicationinsights",
+        "type": "Microsoft.ApiManagement/service/apis/diagnostics",
+        "name": "applicationinsights",
+        "properties": {
+          "alwaysLog": "allErrors",
+          "loggerId": "/loggers/applicationinsights",
+          "sampling": {
+            "samplingType": "fixed",
+            "percentage": 50
+          },
+          "frontend": {
+            "request": {
+              "headers": [
+                "Content-type"
+              ],
+              "body": {
+                "bytes": 512
+              }
+            },
+            "response": {
+              "headers": [
+                "Content-type"
+              ],
+              "body": {
+                "bytes": 512
+              }
+            }
+          },
+          "backend": {
+            "request": {
+              "headers": [
+                "Content-type"
+              ],
+              "body": {
+                "bytes": 512
+              }
+            },
+            "response": {
+              "headers": [
+                "Content-type"
+              ],
+              "body": {
+                "bytes": 512
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiIssue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiIssue.json
new file mode 100644
index 000000000000..6a37a846cef9
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiIssue.json
@@ -0,0 +1,49 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "issueId": "57d2ef278aa04f0ad01d6cdc",
+    "apiId": "57d1f7558aa04f15146d9d8a",
+    "parameters": {
+      "properties": {
+        "title": "New API issue",
+        "description": "New API issue description",
+        "createdDate": "2018-02-01T22:21:20.467Z",
+        "state": "open",
+        "userId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/1"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a/issues/57d2ef278aa04f0ad01d6cdc",
+        "type": "Microsoft.ApiManagement/service/apis/issues",
+        "name": "57d2ef278aa04f0ad01d6cdc",
+        "properties": {
+          "title": "New API issue",
+          "description": "New API issue description",
+          "createdDate": "2018-02-01T22:21:20.467Z",
+          "state": "open",
+          "userId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/1"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a/issues/57d2ef278aa04f0ad01d6cdc",
+        "type": "Microsoft.ApiManagement/service/apis/issues",
+        "name": "57d2ef278aa04f0ad01d6cdc",
+        "properties": {
+          "title": "New API issue",
+          "description": "New API issue description",
+          "createdDate": "2018-02-01T22:21:20.467Z",
+          "state": "open",
+          "userId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/1"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiIssueAttachment.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiIssueAttachment.json
new file mode 100644
index 000000000000..47e402ef52e9
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiIssueAttachment.json
@@ -0,0 +1,44 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "issueId": "57d2ef278aa04f0ad01d6cdc",
+    "apiId": "57d1f7558aa04f15146d9d8a",
+    "attachmentId": "57d2ef278aa04f0888cba3f3",
+    "parameters": {
+      "properties": {
+        "title": "Issue attachment.",
+        "contentFormat": "image/jpeg",
+        "content": "IEJhc2U2NA=="
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a/issues/57d2ef278aa04f0ad01d6cdc/attachments/57d2ef278aa04f0888cba3f3",
+        "type": "Microsoft.ApiManagement/service/apis/issues/attachments",
+        "name": "57d2ef278aa04f0888cba3f3",
+        "properties": {
+          "title": "Issue attachment.",
+          "contentFormat": "link",
+          "content": "https://.../image.jpg"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a/issues/57d2ef278aa04f0ad01d6cdc/attachments/57d2ef278aa04f0888cba3f3",
+        "type": "Microsoft.ApiManagement/service/apis/issues/attachments",
+        "name": "57d2ef278aa04f0888cba3f3",
+        "properties": {
+          "title": "Issue attachment.",
+          "contentFormat": "link",
+          "content": "https://.../image.jpg"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiIssueComment.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiIssueComment.json
new file mode 100644
index 000000000000..13ad9e3a84f4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiIssueComment.json
@@ -0,0 +1,44 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "issueId": "57d2ef278aa04f0ad01d6cdc",
+    "apiId": "57d1f7558aa04f15146d9d8a",
+    "commentId": "599e29ab193c3c0bd0b3e2fb",
+    "parameters": {
+      "properties": {
+        "text": "Issue comment.",
+        "createdDate": "2018-02-01T22:21:20.467Z",
+        "userId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/1"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a/issues/57d2ef278aa04f0ad01d6cdc/comments/599e29ab193c3c0bd0b3e2fb",
+        "type": "Microsoft.ApiManagement/service/apis/issues/comments",
+        "name": "599e29ab193c3c0bd0b3e2fb",
+        "properties": {
+          "text": "Issue comment.",
+          "createdDate": "2018-02-01T22:21:20.467Z",
+          "userId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/1"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a/issues/57d2ef278aa04f0ad01d6cdc/comments/599e29ab193c3c0bd0b3e2fb",
+        "type": "Microsoft.ApiManagement/service/apis/issues/comments",
+        "name": "599e29ab193c3c0bd0b3e2fb",
+        "properties": {
+          "text": "Issue comment.",
+          "createdDate": "2018-02-01T22:21:20.467Z",
+          "userId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/1"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiNewVersionUsingExistingApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiNewVersionUsingExistingApi.json
new file mode 100644
index 000000000000..28d0480ecb4b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiNewVersionUsingExistingApi.json
@@ -0,0 +1,95 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "echoapiv3",
+    "parameters": {
+      "properties": {
+        "displayName": "Echo API2",
+        "description": "Create Echo API into a new Version using Existing Version Set and Copy all Operations.",
+        "subscriptionRequired": true,
+        "serviceUrl": "http://echoapi.cloudapp.net/api",
+        "path": "echo2",
+        "protocols": [
+          "http",
+          "https"
+        ],
+        "isCurrent": true,
+        "apiVersion": "v4",
+        "sourceApiId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/echoPath",
+        "apiVersionSetId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apiVersionSets/aa9c59e6-c0cd-4258-9356-9ca7d2f0b458"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/echoapiv3",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "echoapiv3",
+        "properties": {
+          "displayName": "Echo API2",
+          "apiRevision": "1",
+          "description": "Create Echo API into a new Version using Existing Version Set and Copy all Operations.",
+          "subscriptionRequired": true,
+          "serviceUrl": "http://echoapi.cloudapp.net/api",
+          "path": "echo2",
+          "protocols": [
+            "http",
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "isCurrent": true,
+          "apiVersion": "v4",
+          "apiVersionSetId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apiVersionSets/aa9c59e6-c0cd-4258-9356-9ca7d2f0b458",
+          "apiVersionSet": {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apiVersionSets/aa9c59e6-c0cd-4258-9356-9ca7d2f0b458",
+            "name": "Echo API2",
+            "versioningScheme": "Segment"
+          }
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/tempgroup?api-version=2019-12-01&asyncId=5c730e343244df1b9cb56e85&asyncCode=201"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/echoapiv3",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "echoapiv3",
+        "properties": {
+          "displayName": "Echo API2",
+          "apiRevision": "1",
+          "description": "Create Echo API into a new Version using Existing Version Set and Copy all Operations.",
+          "subscriptionRequired": true,
+          "serviceUrl": "http://echoapi.cloudapp.net/api",
+          "path": "echo2",
+          "protocols": [
+            "http",
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "isCurrent": true,
+          "apiVersion": "v4",
+          "apiVersionSetId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apiVersionSets/aa9c59e6-c0cd-4258-9356-9ca7d2f0b458",
+          "apiVersionSet": {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apiVersionSets/aa9c59e6-c0cd-4258-9356-9ca7d2f0b458",
+            "name": "Echo API2",
+            "versioningScheme": "Segment"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiOperation.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiOperation.json
new file mode 100644
index 000000000000..aa583d1e4a53
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiOperation.json
@@ -0,0 +1,130 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "PetStoreTemplate2",
+    "operationId": "newoperations",
+    "parameters": {
+      "properties": {
+        "displayName": "createUser2",
+        "method": "POST",
+        "urlTemplate": "/user1",
+        "templateParameters": [],
+        "description": "This can only be done by the logged in user.",
+        "request": {
+          "description": "Created user object",
+          "queryParameters": [],
+          "headers": [],
+          "representations": [
+            {
+              "contentType": "application/json",
+              "schemaId": "592f6c1d0af5840ca8897f0c",
+              "typeName": "User"
+            }
+          ]
+        },
+        "responses": [
+          {
+            "statusCode": 200,
+            "description": "successful operation",
+            "representations": [
+              {
+                "contentType": "application/xml"
+              },
+              {
+                "contentType": "application/json"
+              }
+            ],
+            "headers": []
+          }
+        ]
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/PetStoreTemplate2/operations/newoperations",
+        "type": "Microsoft.ApiManagement/service/apis/operations",
+        "name": "newoperations",
+        "properties": {
+          "displayName": "createUser2",
+          "method": "POST",
+          "urlTemplate": "/user1",
+          "templateParameters": [],
+          "description": "This can only be done by the logged in user.",
+          "request": {
+            "description": "Created user object",
+            "queryParameters": [],
+            "headers": [],
+            "representations": [
+              {
+                "contentType": "application/json",
+                "schemaId": "592f6c1d0af5840ca8897f0c",
+                "typeName": "User"
+              }
+            ]
+          },
+          "responses": [
+            {
+              "statusCode": 200,
+              "description": "successful operation",
+              "representations": [
+                {
+                  "contentType": "application/xml"
+                },
+                {
+                  "contentType": "application/json"
+                }
+              ],
+              "headers": []
+            }
+          ]
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/PetStoreTemplate2/operations/newoperations",
+        "type": "Microsoft.ApiManagement/service/apis/operations",
+        "name": "newoperations",
+        "properties": {
+          "displayName": "createUser2",
+          "method": "POST",
+          "urlTemplate": "/user1",
+          "templateParameters": [],
+          "description": "This can only be done by the logged in user.",
+          "request": {
+            "description": "Created user object",
+            "queryParameters": [],
+            "headers": [],
+            "representations": [
+              {
+                "contentType": "application/json",
+                "schemaId": "592f6c1d0af5840ca8897f0c",
+                "typeName": "User"
+              }
+            ]
+          },
+          "responses": [
+            {
+              "statusCode": 200,
+              "description": "successful operation",
+              "representations": [
+                {
+                  "contentType": "application/xml"
+                },
+                {
+                  "contentType": "application/json"
+                }
+              ],
+              "headers": []
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiOperationPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiOperationPolicy.json
new file mode 100644
index 000000000000..c3f682a88c54
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiOperationPolicy.json
@@ -0,0 +1,40 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "5600b57e7e8880006a040001",
+    "operationId": "5600b57e7e8880006a080001",
+    "policyId": "policy",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "format": "xml",
+        "value": "<policies> <inbound /> <backend>    <forward-request />  </backend>  <outbound /></policies>"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/5600b57e7e8880006a040001/operations/5600b57e7e8880006a080001/policies/policy",
+        "type": "Microsoft.ApiManagement/service/apis/operations/policies",
+        "name": "policy",
+        "properties": {
+          "value": "<policies>\r\n  <inbound />\r\n  <backend>\r\n    <forward-request />\r\n  </backend>\r\n  <outbound />\r\n</policies>"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/5600b57e7e8880006a040001/operations/5600b57e7e8880006a080001/policies/policy",
+        "type": "Microsoft.ApiManagement/service/apis/operations/policies",
+        "name": "policy",
+        "properties": {
+          "value": "<policies>\r\n  <inbound />\r\n  <backend>\r\n    <forward-request />\r\n  </backend>\r\n  <outbound />\r\n</policies>"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiOperationTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiOperationTag.json
new file mode 100644
index 000000000000..540e98b5904a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiOperationTag.json
@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "5931a75ae4bbd512a88c680b",
+    "operationId": "5931a75ae4bbd512a88c680a",
+    "tagId": "tagId1"
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/tagId1",
+        "type": "Microsoft.ApiManagement/service/tags",
+        "name": "tagId1",
+        "properties": {
+          "displayName": "tag1"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/tagId1",
+        "type": "Microsoft.ApiManagement/service/tags",
+        "name": "tagId1",
+        "properties": {
+          "displayName": "tag1"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiPolicy.json
new file mode 100644
index 000000000000..ee6f7a0b6f06
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiPolicy.json
@@ -0,0 +1,39 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "5600b57e7e8880006a040001",
+    "policyId": "policy",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "format": "xml",
+        "value": "<policies> <inbound /> <backend>    <forward-request />  </backend>  <outbound /></policies>"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/5600b57e7e8880006a040001/policies/policy",
+        "type": "Microsoft.ApiManagement/service/apis/policies",
+        "name": "policy",
+        "properties": {
+          "value": "<policies>\r\n  <inbound />\r\n  <backend>\r\n    <forward-request />\r\n  </backend>\r\n  <outbound />\r\n</policies>"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/5600b57e7e8880006a040001/policies/policy",
+        "type": "Microsoft.ApiManagement/service/apis/policies",
+        "name": "policy",
+        "properties": {
+          "value": "<policies>\r\n  <inbound />\r\n  <backend>\r\n    <forward-request />\r\n  </backend>\r\n  <outbound />\r\n</policies>"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiPolicyNonXmlEncoded.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiPolicyNonXmlEncoded.json
new file mode 100644
index 000000000000..d3ead917d1b0
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiPolicyNonXmlEncoded.json
@@ -0,0 +1,39 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "5600b57e7e8880006a040001",
+    "policyId": "policy",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "value": "<policies>\r\n     <inbound>\r\n     <base />\r\n  <set-header name=\"newvalue\" exists-action=\"override\">\r\n   <value>\"@(context.Request.Headers.FirstOrDefault(h => h.Ke==\"Via\"))\" </value>\r\n    </set-header>\r\n  </inbound>\r\n      </policies>",
+        "format": "rawxml"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/4c1a3bc6-89f9-46fe-a175-5d8984b25095/resourcegroups/Api-DF-West-US/providers/Microsoft.ApiManagement/service/samirmsiservice2/apis/echo-api/operations/create-resource/policies/policy",
+        "type": "Microsoft.ApiManagement/service/apis/operations/policies",
+        "name": "policy",
+        "properties": {
+          "value": "<policies>\r\n  <inbound>\r\n    <base />\r\n    <set-header name=\"newvalue\" exists-action=\"override\">\r\n      <value>\"@(context.Request.Headers.FirstOrDefault(h =&gt; h.Ke==\"Via\"))\" </value>\r\n    </set-header>\r\n  </inbound>\r\n</policies>"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/4c1a3bc6-89f9-46fe-a175-5d8984b25095/resourcegroups/Api-DF-West-US/providers/Microsoft.ApiManagement/service/samirmsiservice2/apis/echo-api/operations/create-resource/policies/policy",
+        "type": "Microsoft.ApiManagement/service/apis/operations/policies",
+        "name": "policy",
+        "properties": {
+          "value": "<policies>\r\n  <inbound>\r\n    <base />\r\n    <set-header name=\"newvalue\" exists-action=\"override\">\r\n      <value>\"@(context.Request.Headers.FirstOrDefault(h =&gt; h.Ke==\"Via\"))\" </value>\r\n    </set-header>\r\n  </inbound>\r\n</policies>"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiRelease.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiRelease.json
new file mode 100644
index 000000000000..43078347afb2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiRelease.json
@@ -0,0 +1,44 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "a1",
+    "releaseId": "testrev",
+    "parameters": {
+      "properties": {
+        "apiId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/a1",
+        "notes": "yahooagain"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/a1/releases/testrev",
+        "type": "Microsoft.ApiManagement/service/apis/releases",
+        "name": "testrev",
+        "properties": {
+          "apiId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/a1",
+          "createdDateTime": "2018-02-08T20:52:00.65Z",
+          "updatedDateTime": "2018-02-08T20:52:00.65Z",
+          "notes": "yahooagain"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/a1/releases/testrev",
+        "type": "Microsoft.ApiManagement/service/apis/releases",
+        "name": "testrev",
+        "properties": {
+          "apiId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/a1",
+          "createdDateTime": "2018-02-08T20:52:00.65Z",
+          "updatedDateTime": "2018-02-08T20:52:00.65Z",
+          "notes": "yahooagain"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiRevisionFromExistingApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiRevisionFromExistingApi.json
new file mode 100644
index 000000000000..8f6b4fd05da2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiRevisionFromExistingApi.json
@@ -0,0 +1,68 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "echo-api;rev=3",
+    "parameters": {
+      "properties": {
+        "path": "echo",
+        "serviceUrl": "http://echoapi.cloudapp.net/apiv3",
+        "sourceApiId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/echo-api",
+        "apiRevisionDescription": "Creating a Revision of an existing API"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/echo-api;rev=3",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "echo-api;rev=3",
+        "properties": {
+          "displayName": "Echo API",
+          "apiRevision": "3",
+          "subscriptionRequired": true,
+          "serviceUrl": "http://echoapi.cloudapp.net/apiv3",
+          "path": "echo",
+          "protocols": [
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "apiRevisionDescription": "Creating a Revision of an existing API"
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/tempgroup?api-version=2019-12-01&asyncId=5c730e343244df1b9cb56e85&asyncCode=201"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/echo-api;rev=3",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "echo-api;rev=3",
+        "properties": {
+          "displayName": "Echo API",
+          "apiRevision": "3",
+          "subscriptionRequired": true,
+          "serviceUrl": "http://echoapi.cloudapp.net/apiv3",
+          "path": "echo",
+          "protocols": [
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "apiRevisionDescription": "Creating a Revision of an existing API"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiSchema.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiSchema.json
new file mode 100644
index 000000000000..d8e372bb5405
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiSchema.json
@@ -0,0 +1,51 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "59d6bb8f1f7fab13dc67ec9b",
+    "schemaId": "ec12520d-9d48-4e7b-8f39-698ca2ac63f1",
+    "parameters": {
+      "properties": {
+        "contentType": "application/vnd.ms-azure-apim.xsd+xml",
+        "document": {
+          "value": "<s:schema elementFormDefault=\"qualified\" targetNamespace=\"http://ws.cdyne.com/WeatherWS/\" xmlns:tns=\"http://ws.cdyne.com/WeatherWS/\" xmlns:s=\"http://www.w3.org/2001/XMLSchema\" xmlns:soap12=\"http://schemas.xmlsoap.org/wsdl/soap12/\" xmlns:mime=\"http://schemas.xmlsoap.org/wsdl/mime/\" xmlns:soap=\"http://schemas.xmlsoap.org/wsdl/soap/\" xmlns:tm=\"http://microsoft.com/wsdl/mime/textMatching/\" xmlns:http=\"http://schemas.xmlsoap.org/wsdl/http/\" xmlns:soapenc=\"http://schemas.xmlsoap.org/soap/encoding/\" xmlns:wsdl=\"http://schemas.xmlsoap.org/wsdl/\" xmlns:apim-wsdltns=\"http://ws.cdyne.com/WeatherWS/\">\r\n  <s:element name=\"GetWeatherInformation\">\r\n    <s:complexType />\r\n  </s:element>\r\n  <s:element name=\"GetWeatherInformationResponse\">\r\n    <s:complexType>\r\n      <s:sequence>\r\n        <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"GetWeatherInformationResult\" type=\"tns:ArrayOfWeatherDescription\" />\r\n      </s:sequence>\r\n    </s:complexType>\r\n  </s:element>\r\n  <s:complexType name=\"ArrayOfWeatherDescription\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"0\" maxOccurs=\"unbounded\" name=\"WeatherDescription\" type=\"tns:WeatherDescription\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:complexType name=\"WeatherDescription\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"WeatherID\" type=\"s:short\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Description\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"PictureURL\" type=\"s:string\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:element name=\"GetCityForecastByZIP\">\r\n    <s:complexType>\r\n      <s:sequence>\r\n        <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"ZIP\" type=\"s:string\" />\r\n      </s:sequence>\r\n    </s:complexType>\r\n  </s:element>\r\n  <s:element name=\"GetCityForecastByZIPResponse\">\r\n    <s:complexType>\r\n      <s:sequence>\r\n        <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"GetCityForecastByZIPResult\" type=\"tns:ForecastReturn\" />\r\n      </s:sequence>\r\n    </s:complexType>\r\n  </s:element>\r\n  <s:complexType name=\"ForecastReturn\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"Success\" type=\"s:boolean\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"ResponseText\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"State\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"City\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"WeatherStationCity\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"ForecastResult\" type=\"tns:ArrayOfForecast\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:complexType name=\"ArrayOfForecast\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"0\" maxOccurs=\"unbounded\" name=\"Forecast\" nillable=\"true\" type=\"tns:Forecast\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:complexType name=\"Forecast\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"Date\" type=\"s:dateTime\" />\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"WeatherID\" type=\"s:short\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Desciption\" type=\"s:string\" />\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"Temperatures\" type=\"tns:temp\" />\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"ProbabilityOfPrecipiation\" type=\"tns:POP\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:complexType name=\"temp\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"MorningLow\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"DaytimeHigh\" type=\"s:string\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:complexType name=\"POP\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Nighttime\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Daytime\" type=\"s:string\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:element name=\"GetCityWeatherByZIP\">\r\n    <s:complexType>\r\n      <s:sequence>\r\n        <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"ZIP\" type=\"s:string\" />\r\n      </s:sequence>\r\n    </s:complexType>\r\n  </s:element>\r\n  <s:element name=\"GetCityWeatherByZIPResponse\">\r\n    <s:complexType>\r\n      <s:sequence>\r\n        <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"GetCityWeatherByZIPResult\" type=\"tns:WeatherReturn\" />\r\n      </s:sequence>\r\n    </s:complexType>\r\n  </s:element>\r\n  <s:complexType name=\"WeatherReturn\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"Success\" type=\"s:boolean\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"ResponseText\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"State\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"City\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"WeatherStationCity\" type=\"s:string\" />\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"WeatherID\" type=\"s:short\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Description\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Temperature\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"RelativeHumidity\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Wind\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Pressure\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Visibility\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"WindChill\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Remarks\" type=\"s:string\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:element name=\"ArrayOfWeatherDescription\" nillable=\"true\" type=\"tns:ArrayOfWeatherDescription\" />\r\n  <s:element name=\"ForecastReturn\" nillable=\"true\" type=\"tns:ForecastReturn\" />\r\n  <s:element name=\"WeatherReturn\" type=\"tns:WeatherReturn\" />\r\n</s:schema>"
+        }
+      }
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/59d6bb8f1f7fab13dc67ec9b/schemas/ec12520d-9d48-4e7b-8f39-698ca2ac63f1?api-version=2019-12-01&asyncId=5c730e343244df1b9cb56e85&asyncCode=201"
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/59d6bb8f1f7fab13dc67ec9b/schemas/ec12520d-9d48-4e7b-8f39-698ca2ac63f1",
+        "type": "Microsoft.ApiManagement/service/apis/schemas",
+        "name": "ec12520d-9d48-4e7b-8f39-698ca2ac63f1",
+        "properties": {
+          "contentType": "application/vnd.ms-azure-apim.xsd+xml",
+          "document": {
+            "value": "<s:schema elementFormDefault=\"qualified\" targetNamespace=\"http://ws.cdyne.com/WeatherWS/\" xmlns:tns=\"http://ws.cdyne.com/WeatherWS/\" xmlns:s=\"http://www.w3.org/2001/XMLSchema\" xmlns:soap12=\"http://schemas.xmlsoap.org/wsdl/soap12/\" xmlns:mime=\"http://schemas.xmlsoap.org/wsdl/mime/\" xmlns:soap=\"http://schemas.xmlsoap.org/wsdl/soap/\" xmlns:tm=\"http://microsoft.com/wsdl/mime/textMatching/\" xmlns:http=\"http://schemas.xmlsoap.org/wsdl/http/\" xmlns:soapenc=\"http://schemas.xmlsoap.org/soap/encoding/\" xmlns:wsdl=\"http://schemas.xmlsoap.org/wsdl/\" xmlns:apim-wsdltns=\"http://ws.cdyne.com/WeatherWS/\">\r\n  <s:element name=\"GetWeatherInformation\">\r\n    <s:complexType />\r\n  </s:element>\r\n  <s:element name=\"GetWeatherInformationResponse\">\r\n    <s:complexType>\r\n      <s:sequence>\r\n        <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"GetWeatherInformationResult\" type=\"tns:ArrayOfWeatherDescription\" />\r\n      </s:sequence>\r\n    </s:complexType>\r\n  </s:element>\r\n  <s:complexType name=\"ArrayOfWeatherDescription\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"0\" maxOccurs=\"unbounded\" name=\"WeatherDescription\" type=\"tns:WeatherDescription\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:complexType name=\"WeatherDescription\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"WeatherID\" type=\"s:short\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Description\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"PictureURL\" type=\"s:string\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:element name=\"GetCityForecastByZIP\">\r\n    <s:complexType>\r\n      <s:sequence>\r\n        <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"ZIP\" type=\"s:string\" />\r\n      </s:sequence>\r\n    </s:complexType>\r\n  </s:element>\r\n  <s:element name=\"GetCityForecastByZIPResponse\">\r\n    <s:complexType>\r\n      <s:sequence>\r\n        <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"GetCityForecastByZIPResult\" type=\"tns:ForecastReturn\" />\r\n      </s:sequence>\r\n    </s:complexType>\r\n  </s:element>\r\n  <s:complexType name=\"ForecastReturn\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"Success\" type=\"s:boolean\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"ResponseText\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"State\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"City\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"WeatherStationCity\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"ForecastResult\" type=\"tns:ArrayOfForecast\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:complexType name=\"ArrayOfForecast\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"0\" maxOccurs=\"unbounded\" name=\"Forecast\" nillable=\"true\" type=\"tns:Forecast\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:complexType name=\"Forecast\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"Date\" type=\"s:dateTime\" />\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"WeatherID\" type=\"s:short\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Desciption\" type=\"s:string\" />\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"Temperatures\" type=\"tns:temp\" />\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"ProbabilityOfPrecipiation\" type=\"tns:POP\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:complexType name=\"temp\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"MorningLow\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"DaytimeHigh\" type=\"s:string\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:complexType name=\"POP\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Nighttime\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Daytime\" type=\"s:string\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:element name=\"GetCityWeatherByZIP\">\r\n    <s:complexType>\r\n      <s:sequence>\r\n        <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"ZIP\" type=\"s:string\" />\r\n      </s:sequence>\r\n    </s:complexType>\r\n  </s:element>\r\n  <s:element name=\"GetCityWeatherByZIPResponse\">\r\n    <s:complexType>\r\n      <s:sequence>\r\n        <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"GetCityWeatherByZIPResult\" type=\"tns:WeatherReturn\" />\r\n      </s:sequence>\r\n    </s:complexType>\r\n  </s:element>\r\n  <s:complexType name=\"WeatherReturn\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"Success\" type=\"s:boolean\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"ResponseText\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"State\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"City\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"WeatherStationCity\" type=\"s:string\" />\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"WeatherID\" type=\"s:short\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Description\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Temperature\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"RelativeHumidity\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Wind\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Pressure\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Visibility\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"WindChill\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Remarks\" type=\"s:string\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:element name=\"ArrayOfWeatherDescription\" nillable=\"true\" type=\"tns:ArrayOfWeatherDescription\" />\r\n  <s:element name=\"ForecastReturn\" nillable=\"true\" type=\"tns:ForecastReturn\" />\r\n  <s:element name=\"WeatherReturn\" type=\"tns:WeatherReturn\" />\r\n</s:schema>"
+          }
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/59d6bb8f1f7fab13dc67ec9b/schemas/ec12520d-9d48-4e7b-8f39-698ca2ac63f1",
+        "type": "Microsoft.ApiManagement/service/apis/schemas",
+        "name": "ec12520d-9d48-4e7b-8f39-698ca2ac63f1",
+        "properties": {
+          "contentType": "application/vnd.ms-azure-apim.xsd+xml",
+          "document": {
+            "value": "<s:schema elementFormDefault=\"qualified\" targetNamespace=\"http://ws.cdyne.com/WeatherWS/\" xmlns:tns=\"http://ws.cdyne.com/WeatherWS/\" xmlns:s=\"http://www.w3.org/2001/XMLSchema\" xmlns:soap12=\"http://schemas.xmlsoap.org/wsdl/soap12/\" xmlns:mime=\"http://schemas.xmlsoap.org/wsdl/mime/\" xmlns:soap=\"http://schemas.xmlsoap.org/wsdl/soap/\" xmlns:tm=\"http://microsoft.com/wsdl/mime/textMatching/\" xmlns:http=\"http://schemas.xmlsoap.org/wsdl/http/\" xmlns:soapenc=\"http://schemas.xmlsoap.org/soap/encoding/\" xmlns:wsdl=\"http://schemas.xmlsoap.org/wsdl/\" xmlns:apim-wsdltns=\"http://ws.cdyne.com/WeatherWS/\">\r\n  <s:element name=\"GetWeatherInformation\">\r\n    <s:complexType />\r\n  </s:element>\r\n  <s:element name=\"GetWeatherInformationResponse\">\r\n    <s:complexType>\r\n      <s:sequence>\r\n        <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"GetWeatherInformationResult\" type=\"tns:ArrayOfWeatherDescription\" />\r\n      </s:sequence>\r\n    </s:complexType>\r\n  </s:element>\r\n  <s:complexType name=\"ArrayOfWeatherDescription\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"0\" maxOccurs=\"unbounded\" name=\"WeatherDescription\" type=\"tns:WeatherDescription\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:complexType name=\"WeatherDescription\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"WeatherID\" type=\"s:short\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Description\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"PictureURL\" type=\"s:string\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:element name=\"GetCityForecastByZIP\">\r\n    <s:complexType>\r\n      <s:sequence>\r\n        <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"ZIP\" type=\"s:string\" />\r\n      </s:sequence>\r\n    </s:complexType>\r\n  </s:element>\r\n  <s:element name=\"GetCityForecastByZIPResponse\">\r\n    <s:complexType>\r\n      <s:sequence>\r\n        <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"GetCityForecastByZIPResult\" type=\"tns:ForecastReturn\" />\r\n      </s:sequence>\r\n    </s:complexType>\r\n  </s:element>\r\n  <s:complexType name=\"ForecastReturn\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"Success\" type=\"s:boolean\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"ResponseText\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"State\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"City\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"WeatherStationCity\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"ForecastResult\" type=\"tns:ArrayOfForecast\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:complexType name=\"ArrayOfForecast\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"0\" maxOccurs=\"unbounded\" name=\"Forecast\" nillable=\"true\" type=\"tns:Forecast\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:complexType name=\"Forecast\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"Date\" type=\"s:dateTime\" />\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"WeatherID\" type=\"s:short\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Desciption\" type=\"s:string\" />\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"Temperatures\" type=\"tns:temp\" />\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"ProbabilityOfPrecipiation\" type=\"tns:POP\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:complexType name=\"temp\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"MorningLow\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"DaytimeHigh\" type=\"s:string\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:complexType name=\"POP\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Nighttime\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Daytime\" type=\"s:string\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:element name=\"GetCityWeatherByZIP\">\r\n    <s:complexType>\r\n      <s:sequence>\r\n        <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"ZIP\" type=\"s:string\" />\r\n      </s:sequence>\r\n    </s:complexType>\r\n  </s:element>\r\n  <s:element name=\"GetCityWeatherByZIPResponse\">\r\n    <s:complexType>\r\n      <s:sequence>\r\n        <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"GetCityWeatherByZIPResult\" type=\"tns:WeatherReturn\" />\r\n      </s:sequence>\r\n    </s:complexType>\r\n  </s:element>\r\n  <s:complexType name=\"WeatherReturn\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"Success\" type=\"s:boolean\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"ResponseText\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"State\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"City\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"WeatherStationCity\" type=\"s:string\" />\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"WeatherID\" type=\"s:short\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Description\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Temperature\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"RelativeHumidity\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Wind\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Pressure\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Visibility\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"WindChill\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Remarks\" type=\"s:string\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:element name=\"ArrayOfWeatherDescription\" nillable=\"true\" type=\"tns:ArrayOfWeatherDescription\" />\r\n  <s:element name=\"ForecastReturn\" nillable=\"true\" type=\"tns:ForecastReturn\" />\r\n  <s:element name=\"WeatherReturn\" type=\"tns:WeatherReturn\" />\r\n</s:schema>"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiTag.json
new file mode 100644
index 000000000000..83c7ca9ac303
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiTag.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "5931a75ae4bbd512a88c680b",
+    "tagId": "tagId1"
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/tagId1",
+        "type": "Microsoft.ApiManagement/service/tags",
+        "name": "tagId1",
+        "properties": {
+          "displayName": "tag1"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/tagId1",
+        "type": "Microsoft.ApiManagement/service/tags",
+        "name": "tagId1",
+        "properties": {
+          "displayName": "tag1"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiTagDescription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiTagDescription.json
new file mode 100644
index 000000000000..abce73e357a7
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiTagDescription.json
@@ -0,0 +1,47 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "5931a75ae4bbd512a88c680b",
+    "tagDescriptionId": "tagId1",
+    "parameters": {
+      "properties": {
+        "description": "Some description that will be displayed for operation's tag if the tag is assigned to operation of the API",
+        "externalDocsUrl": "http://some.url/additionaldoc",
+        "externalDocsDescription": "Description of the external docs resource"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/5931a75ae4bbd512a88c680b/tagDescriptions/tagId1",
+        "type": "Microsoft.ApiManagement/service/apis/tagDescriptions",
+        "name": "tagId1",
+        "properties": {
+          "tagId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/tagId1",
+          "displayName": "tag1",
+          "description": "Some description that will be displayed for operation's tag if the tag is assigned to operation of the API",
+          "externalDocsDescription": "some additional info",
+          "externalDocsUrl": "http://some_url.com"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/5931a75ae4bbd512a88c680b/tagDescriptions/tagId1",
+        "type": "Microsoft.ApiManagement/service/apis/tagDescriptions",
+        "name": "tagId1",
+        "properties": {
+          "tagId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/tagId1",
+          "displayName": "tag1",
+          "description": "Some description that will be displayed for operation's tag if the tag is assigned to operation of the API",
+          "externalDocsDescription": "some additional info",
+          "externalDocsUrl": "http://some_url.com"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiUsingImportOverrideServiceUrl.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiUsingImportOverrideServiceUrl.json
new file mode 100644
index 000000000000..495f08091b3e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiUsingImportOverrideServiceUrl.json
@@ -0,0 +1,68 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "apidocs",
+    "parameters": {
+      "properties": {
+        "format": "swagger-link",
+        "value": "http://apimpimportviaurl.azurewebsites.net/api/apidocs/",
+        "path": "petstoreapi123",
+        "serviceUrl": "http://petstore.swagger.wordnik.com/api"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/apidocs",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "apidocs",
+        "properties": {
+          "displayName": "Swagger Sample App",
+          "apiRevision": "1",
+          "description": "This is a sample server Petstore server.  You can find out more about Swagger \n    at <a href=\"http://swagger.wordnik.com\">http://swagger.wordnik.com</a> or on irc.freenode.net, #swagger.  For this sample,\n    you can use the api key \"special-key\" to test the authorization filters",
+          "serviceUrl": "http://petstore.swagger.wordnik.com/api",
+          "path": "petstoreapi123",
+          "protocols": [
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "isCurrent": true
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/apidocs?api-version=2019-12-01&asyncId=5c730e343244df1b9cb56e85&asyncCode=201"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/apidocs",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "apidocs",
+        "properties": {
+          "displayName": "Swagger Sample App",
+          "apiRevision": "1",
+          "description": "This is a sample server Petstore server.  You can find out more about Swagger \n    at <a href=\"http://swagger.wordnik.com\">http://swagger.wordnik.com</a> or on irc.freenode.net, #swagger.  For this sample,\n    you can use the api key \"special-key\" to test the authorization filters",
+          "serviceUrl": "http://petstore.swagger.wordnik.com/api",
+          "path": "petstoreapi123",
+          "protocols": [
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "isCurrent": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiUsingOai3Import.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiUsingOai3Import.json
new file mode 100644
index 000000000000..160488451be1
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiUsingOai3Import.json
@@ -0,0 +1,65 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "petstore",
+    "parameters": {
+      "properties": {
+        "format": "openapi-link",
+        "value": "https://raw.githubusercontent.com/OAI/OpenAPI-Specification/master/examples/v3.0/petstore.yaml",
+        "path": "petstore"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/petstoreapi",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "petstoreapi",
+        "properties": {
+          "displayName": "Swagger Petstore",
+          "apiRevision": "1",
+          "serviceUrl": "http://petstore.swagger.io/v1",
+          "path": "petstore",
+          "protocols": [
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "isCurrent": true
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/tempgroup?api-version=2019-12-01&asyncId=5c730e343244df1b9cb56e85&asyncCode=201"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/petstoreapi",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "petstoreapi",
+        "properties": {
+          "displayName": "Swagger Petstore",
+          "apiRevision": "1",
+          "serviceUrl": "http://petstore.swagger.io/v1",
+          "path": "petstore",
+          "protocols": [
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "isCurrent": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiUsingSwaggerImport.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiUsingSwaggerImport.json
new file mode 100644
index 000000000000..31d94e580b3a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiUsingSwaggerImport.json
@@ -0,0 +1,67 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "petstore",
+    "parameters": {
+      "properties": {
+        "format": "swagger-link-json",
+        "value": "http://petstore.swagger.io/v2/swagger.json",
+        "path": "petstore"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/petstoreapi",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "petstoreapi",
+        "properties": {
+          "displayName": "Swagger Petstore",
+          "apiRevision": "1",
+          "description": "This is a sample server Petstore server.  You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/).  For this sample, you can use the api key `special-key` to test the authorization filters.",
+          "serviceUrl": "http://petstore.swagger.io/v2",
+          "path": "petstore",
+          "protocols": [
+            "http"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "isCurrent": true
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/tempgroup?api-version=2019-12-01&asyncId=5c730e343244df1b9cb56e85&asyncCode=201"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/petstoreapi",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "petstoreapi",
+        "properties": {
+          "displayName": "Swagger Petstore",
+          "apiRevision": "1",
+          "description": "This is a sample server Petstore server.  You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/).  For this sample, you can use the api key `special-key` to test the authorization filters.",
+          "serviceUrl": "http://petstore.swagger.io/v2",
+          "path": "petstore",
+          "protocols": [
+            "http"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "isCurrent": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiUsingWadlImport.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiUsingWadlImport.json
new file mode 100644
index 000000000000..59d3323074ae
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiUsingWadlImport.json
@@ -0,0 +1,67 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "petstore",
+    "parameters": {
+      "properties": {
+        "format": "wadl-link-json",
+        "value": "https://developer.cisco.com/media/wae-release-6-2-api-reference/wae-collector-rest-api/application.wadl",
+        "path": "collector"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/collectorwadl",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "collectorwadl",
+        "properties": {
+          "displayName": "http://localhost:8080/collector-northbound",
+          "apiRevision": "1",
+          "description": "",
+          "serviceUrl": "http://localhost:8080/collector-northbound",
+          "path": "collector",
+          "protocols": [
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "isCurrent": true
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/tempgroup?api-version=2019-12-01&asyncId=5c730e343244df1b9cb56e85&asyncCode=201"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/collectorwadl",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "collectorwadl",
+        "properties": {
+          "displayName": "http://localhost:8080/collector-northbound",
+          "apiRevision": "1",
+          "description": "",
+          "serviceUrl": "http://localhost:8080/collector-northbound",
+          "path": "collector",
+          "protocols": [
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "isCurrent": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiVersionSet.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiVersionSet.json
new file mode 100644
index 000000000000..bcad907ca8d9
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiVersionSet.json
@@ -0,0 +1,42 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "versionSetId": "api1",
+    "parameters": {
+      "properties": {
+        "displayName": "api set 1",
+        "versioningScheme": "Segment",
+        "description": "Version configuration"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apiVersionSets/api1",
+        "type": "Microsoft.ApiManagement/service/api-version-sets",
+        "name": "api1",
+        "properties": {
+          "displayName": "api set 1",
+          "versioningScheme": "Segment",
+          "description": "Version configuration"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apiVersionSets/api1",
+        "type": "Microsoft.ApiManagement/service/api-version-sets",
+        "name": "api1",
+        "properties": {
+          "displayName": "api set 1",
+          "versioningScheme": "Segment",
+          "description": "Version configuration"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiWithOpenIdConnect.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiWithOpenIdConnect.json
new file mode 100644
index 000000000000..706e971aaf2d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateApiWithOpenIdConnect.json
@@ -0,0 +1,99 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "tempgroup",
+    "parameters": {
+      "properties": {
+        "displayName": "Swagger Petstore",
+        "description": "This is a sample server Petstore server.  You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/).  For this sample, you can use the api key `special-key` to test the authorization filters.",
+        "serviceUrl": "http://petstore.swagger.io/v2",
+        "path": "petstore",
+        "protocols": [
+          "https"
+        ],
+        "authenticationSettings": {
+          "openid": {
+            "openidProviderId": "testopenid",
+            "bearerTokenSendingMethods": [
+              "authorizationHeader"
+            ]
+          }
+        },
+        "subscriptionKeyParameterNames": {
+          "header": "Ocp-Apim-Subscription-Key",
+          "query": "subscription-key"
+        }
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/58da4c4ccdae970a08121230",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "58da4c4ccdae970a08121230",
+        "properties": {
+          "displayName": "Swagger Petstore",
+          "apiRevision": "1",
+          "description": "This is a sample server Petstore server.  You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/).  For this sample, you can use the api key `special-key` to test the authorization filters.",
+          "serviceUrl": "http://petstore.swagger.io/v2",
+          "path": "petstore",
+          "protocols": [
+            "https"
+          ],
+          "authenticationSettings": {
+            "openid": {
+              "openidProviderId": "testopenid",
+              "bearerTokenSendingMethods": [
+                "authorizationHeader"
+              ]
+            }
+          },
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "isCurrent": true
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/tempgroup?api-version=2019-12-01&asyncId=5c730e343244df1b9cb56e85&asyncCode=201"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/58da4c4ccdae970a08121230",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "58da4c4ccdae970a08121230",
+        "properties": {
+          "displayName": "Swagger Petstore",
+          "apiRevision": "1",
+          "description": "This is a sample server Petstore server.  You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/).  For this sample, you can use the api key `special-key` to test the authorization filters.",
+          "serviceUrl": "http://petstore.swagger.io/v2",
+          "path": "petstore",
+          "protocols": [
+            "https"
+          ],
+          "authenticationSettings": {
+            "openid": {
+              "openidProviderId": "testopenid",
+              "bearerTokenSendingMethods": [
+                "authorizationHeader"
+              ]
+            }
+          },
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "isCurrent": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateAuthorizationServer.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateAuthorizationServer.json
new file mode 100644
index 000000000000..df26fe584663
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateAuthorizationServer.json
@@ -0,0 +1,94 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "authsid": "newauthServer",
+    "parameters": {
+      "properties": {
+        "displayName": "test2",
+        "description": "test server",
+        "clientRegistrationEndpoint": "https://www.contoso.com/apps",
+        "authorizationEndpoint": "https://www.contoso.com/oauth2/auth",
+        "authorizationMethods": [
+          "GET"
+        ],
+        "tokenEndpoint": "https://www.contoso.com/oauth2/token",
+        "supportState": true,
+        "defaultScope": "read write",
+        "grantTypes": [
+          "authorizationCode",
+          "implicit"
+        ],
+        "bearerTokenSendingMethods": [
+          "authorizationHeader"
+        ],
+        "clientId": "1",
+        "clientSecret": "2",
+        "resourceOwnerUsername": "un",
+        "resourceOwnerPassword": "pwd"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/authorizationServers/newauthServer",
+        "type": "Microsoft.ApiManagement/service/authorizationServers",
+        "name": "newauthServer",
+        "properties": {
+          "displayName": "test2",
+          "description": "test server",
+          "clientRegistrationEndpoint": "https://www.contoso.com/apps",
+          "authorizationEndpoint": "https://www.contoso.com/oauth2/auth",
+          "authorizationMethods": [
+            "GET"
+          ],
+          "tokenEndpoint": "https://www.contoso.com/oauth2/token",
+          "supportState": true,
+          "defaultScope": "read write",
+          "grantTypes": [
+            "authorizationCode",
+            "implicit"
+          ],
+          "bearerTokenSendingMethods": [
+            "authorizationHeader"
+          ],
+          "clientId": "1",
+          "resourceOwnerUsername": "un",
+          "resourceOwnerPassword": "pwd"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/authorizationServers/newauthServer",
+        "type": "Microsoft.ApiManagement/service/authorizationServers",
+        "name": "newauthServer",
+        "properties": {
+          "displayName": "test2",
+          "description": "test server",
+          "clientRegistrationEndpoint": "https://www.contoso.com/apps",
+          "authorizationEndpoint": "https://www.contoso.com/oauth2/auth",
+          "authorizationMethods": [
+            "GET"
+          ],
+          "tokenEndpoint": "https://www.contoso.com/oauth2/token",
+          "supportState": true,
+          "defaultScope": "read write",
+          "grantTypes": [
+            "authorizationCode",
+            "implicit"
+          ],
+          "bearerTokenSendingMethods": [
+            "authorizationHeader"
+          ],
+          "clientId": "1",
+          "resourceOwnerUsername": "un",
+          "resourceOwnerPassword": "pwd"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateBackendProxyBackend.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateBackendProxyBackend.json
new file mode 100644
index 000000000000..101062eb227b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateBackendProxyBackend.json
@@ -0,0 +1,126 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "backendId": "proxybackend",
+    "parameters": {
+      "properties": {
+        "description": "description5308",
+        "url": "https://backendname2644/",
+        "protocol": "http",
+        "tls": {
+          "validateCertificateChain": true,
+          "validateCertificateName": true
+        },
+        "proxy": {
+          "url": "http://192.168.1.1:8080",
+          "username": "Contoso\\admin",
+          "password": "opensesame"
+        },
+        "credentials": {
+          "query": {
+            "sv": [
+              "xx",
+              "bb",
+              "cc"
+            ]
+          },
+          "header": {
+            "x-my-1": [
+              "val1",
+              "val2"
+            ]
+          },
+          "authorization": {
+            "scheme": "Basic",
+            "parameter": "opensesma"
+          }
+        }
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/backends/proxybackend",
+        "type": "Microsoft.ApiManagement/service/backends",
+        "name": "proxybackend",
+        "properties": {
+          "description": "description5308",
+          "url": "https://backendname2644/",
+          "protocol": "http",
+          "credentials": {
+            "query": {
+              "sv": [
+                "xx",
+                "bb",
+                "cc"
+              ]
+            },
+            "header": {
+              "x-my-1": [
+                "val1",
+                "val2"
+              ]
+            },
+            "authorization": {
+              "scheme": "Basic",
+              "parameter": "opensesma"
+            }
+          },
+          "proxy": {
+            "url": "http://192.168.1.1:8080",
+            "username": "Contoso\\admin",
+            "password": "opensesame"
+          },
+          "tls": {
+            "validateCertificateChain": false,
+            "validateCertificateName": false
+          }
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/backends/proxybackend",
+        "type": "Microsoft.ApiManagement/service/backends",
+        "name": "proxybackend",
+        "properties": {
+          "description": "description5308",
+          "url": "https://backendname2644/",
+          "protocol": "http",
+          "credentials": {
+            "query": {
+              "sv": [
+                "xx",
+                "bb",
+                "cc"
+              ]
+            },
+            "header": {
+              "x-my-1": [
+                "val1",
+                "val2"
+              ]
+            },
+            "authorization": {
+              "scheme": "Basic",
+              "parameter": "opensesma"
+            }
+          },
+          "proxy": {
+            "url": "http://192.168.1.1:8080",
+            "username": "Contoso\\admin",
+            "password": "opensesame"
+          },
+          "tls": {
+            "validateCertificateChain": false,
+            "validateCertificateName": false
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateBackendServiceFabric.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateBackendServiceFabric.json
new file mode 100644
index 000000000000..b3a993542af8
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateBackendServiceFabric.json
@@ -0,0 +1,87 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "backendId": "sfbackend",
+    "parameters": {
+      "properties": {
+        "description": "Service Fabric Test App 1",
+        "protocol": "http",
+        "url": "fabric:/mytestapp/mytestservice",
+        "properties": {
+          "serviceFabricCluster": {
+            "managementEndpoints": [
+              "https://somecluster.com"
+            ],
+            "clientCertificatethumbprint": "EBA029198AA3E76EF0D70482626E5BCF148594A6",
+            "serverX509Names": [
+              {
+                "name": "ServerCommonName1",
+                "issuerCertificateThumbprint": "IssuerCertificateThumbprint1"
+              }
+            ],
+            "maxPartitionResolutionRetries": 5
+          }
+        }
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/backends/sfbackend",
+        "type": "Microsoft.ApiManagement/service/backends",
+        "name": "sfbackend",
+        "properties": {
+          "description": "Service Fabric Test App 1",
+          "url": "fabric:/mytestapp/mytestservice",
+          "protocol": "http",
+          "properties": {
+            "serviceFabricCluster": {
+              "managementEndpoints": [
+                "https://somecluster.com"
+              ],
+              "clientCertificatethumbprint": "EBA029198AA3E76EF0D70482626E5BCF148594A6",
+              "serverX509Names": [
+                {
+                  "name": "ServerCommonName1",
+                  "issuerCertificateThumbprint": "IssuerCertificateThumbprint1"
+                }
+              ],
+              "maxPartitionResolutionRetries": 5
+            }
+          }
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/backends/sfbackend",
+        "type": "Microsoft.ApiManagement/service/backends",
+        "name": "sfbackend",
+        "properties": {
+          "description": "Service Fabric Test App 1",
+          "url": "fabric:/mytestapp/mytestservice",
+          "protocol": "http",
+          "properties": {
+            "serviceFabricCluster": {
+              "managementEndpoints": [
+                "https://somecluster.com"
+              ],
+              "clientCertificatethumbprint": "EBA029198AA3E76EF0D70482626E5BCF148594A6",
+              "serverX509Names": [
+                {
+                  "name": "ServerCommonName1",
+                  "issuerCertificateThumbprint": "IssuerCertificateThumbprint1"
+                }
+              ],
+              "maxPartitionResolutionRetries": 5
+            }
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateBackup.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateBackup.json
new file mode 100644
index 000000000000..55936485b01b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateBackup.json
@@ -0,0 +1,126 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "parameters": {
+      "storageAccount": "teststorageaccount",
+      "accessKey": "**************************************************",
+      "containerName": "backupContainer",
+      "backupName": "apimService1backup_2017_03_19"
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/dGVjaGVkX01hbmFnZVJvbGVfNWRiNGI3Ng==?api-version=2019-12-01"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+        "name": "apimService1",
+        "type": "Microsoft.ApiManagement/service",
+        "tags": {
+          "tag1": "value1",
+          "tag2": "value2",
+          "tag3": "value3"
+        },
+        "location": "West US",
+        "etag": "AAAAAAACXok=",
+        "properties": {
+          "publisherEmail": "apim@autorestsdk.com",
+          "publisherName": "autorestsdk",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Succeeded",
+          "targetProvisioningState": "",
+          "createdAtUtc": "2019-12-18T06:26:20.3348609Z",
+          "gatewayUrl": "https://apimService1.azure-api.net",
+          "gatewayRegionalUrl": "https://apimService1-westus-01.regional.azure-api.net",
+          "portalUrl": "https://apimService1.portal.azure-api.net",
+          "developerPortalUrl": "https://apimService1.developer.azure-api.net",
+          "managementApiUrl": "https://apimService1.management.azure-api.net",
+          "scmUrl": "https://apimService1.scm.azure-api.net",
+          "hostnameConfigurations": [
+            {
+              "type": "Proxy",
+              "hostName": "apimService1.azure-api.net",
+              "negotiateClientCertificate": false,
+              "defaultSslBinding": false
+            },
+            {
+              "type": "Proxy",
+              "hostName": "gateway1.msitesting.net",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2036-01-01T07:00:00+00:00",
+                "thumbprint": "8E989XXXXXXXXXXXXXXXXB9C2C91F1D174FDB3A2",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": true
+            },
+            {
+              "type": "Management",
+              "hostName": "mgmt.msitesting.net",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2036-01-01T07:00:00+00:00",
+                "thumbprint": "8E989XXXXXXXXXXXXXXXXB9C2C91F1D174FDB3A2",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": false
+            },
+            {
+              "type": "Portal",
+              "hostName": "portal1.msitesting.net",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2036-01-01T07:00:00+00:00",
+                "thumbprint": "8E989XXXXXXXXXXXXXXXXB9C2C91F1D174FDB3A2",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": false
+            }
+          ],
+          "publicIPAddresses": [
+            "13.91.32.113"
+          ],
+          "additionalLocations": [
+            {
+              "location": "East US",
+              "sku": {
+                "name": "Premium",
+                "capacity": 1
+              },
+              "publicIPAddresses": [
+                "23.101.138.153"
+              ],
+              "gatewayRegionalUrl": "https://apimService1-eastus-01.regional.azure-api.net",
+              "disableGateway": true
+            }
+          ],
+          "customProperties": {
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Ssl30": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "False"
+          },
+          "virtualNetworkType": "None",
+          "disableGateway": false,
+          "apiVersionConstraint": {
+            "minApiVersion": "2019-01-01"
+          }
+        },
+        "sku": {
+          "name": "Premium",
+          "capacity": 1
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateCache.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateCache.json
new file mode 100644
index 000000000000..90407481dc0f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateCache.json
@@ -0,0 +1,42 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "cacheId": "westindia",
+    "parameters": {
+      "properties": {
+        "connectionString": "contoso5.redis.cache.windows.net,ssl=true,password=...",
+        "description": "Redis cache instances in West India",
+        "resourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cache/Redis/contoso5"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/caches/westindia",
+        "type": "Microsoft.ApiManagement/service/caches",
+        "name": "westindia",
+        "properties": {
+          "connectionString": "{{5c68d535a40f7e61103cd285}}}",
+          "description": "Redis cache instances in West India",
+          "resourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cache/Redis/contoso5"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/caches/westindia",
+        "type": "Microsoft.ApiManagement/service/caches",
+        "name": "westindia",
+        "properties": {
+          "connectionString": "{{5c68d535a40f7e61103cd285}}}",
+          "description": "Redis cache instances in West India",
+          "resourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cache/Redis/contoso5"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateCertificate.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateCertificate.json
new file mode 100644
index 000000000000..7d4c3549e2af
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateCertificate.json
@@ -0,0 +1,41 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "certificateId": "tempcert",
+    "parameters": {
+      "properties": {
+        "data": "****************Base 64 Encoded Certificate *******************************",
+        "password": "****Certificate Password******"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/tempcert",
+        "type": "Microsoft.ApiManagement/service/certificates",
+        "name": "tempcert",
+        "properties": {
+          "subject": "CN=contoso.com",
+          "thumbprint": "*******************3",
+          "expirationDate": "2018-03-17T21:55:07+00:00"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/tempcert",
+        "type": "Microsoft.ApiManagement/service/certificates",
+        "name": "tempcert",
+        "properties": {
+          "subject": "CN=contoso.com",
+          "thumbprint": "*******************3",
+          "expirationDate": "2018-03-17T21:55:07+00:00"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateDiagnostic.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateDiagnostic.json
new file mode 100644
index 000000000000..2605ca652178
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateDiagnostic.json
@@ -0,0 +1,159 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "diagnosticId": "applicationinsights",
+    "parameters": {
+      "properties": {
+        "alwaysLog": "allErrors",
+        "loggerId": "/loggers/azuremonitor",
+        "sampling": {
+          "samplingType": "fixed",
+          "percentage": 50
+        },
+        "frontend": {
+          "request": {
+            "headers": [
+              "Content-type"
+            ],
+            "body": {
+              "bytes": 512
+            }
+          },
+          "response": {
+            "headers": [
+              "Content-type"
+            ],
+            "body": {
+              "bytes": 512
+            }
+          }
+        },
+        "backend": {
+          "request": {
+            "headers": [
+              "Content-type"
+            ],
+            "body": {
+              "bytes": 512
+            }
+          },
+          "response": {
+            "headers": [
+              "Content-type"
+            ],
+            "body": {
+              "bytes": 512
+            }
+          }
+        }
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/diagnostics/applicationinsights",
+        "type": "Microsoft.ApiManagement/service/diagnostics",
+        "name": "applicationinsights",
+        "properties": {
+          "alwaysLog": "allErrors",
+          "loggerId": "/loggers/azuremonitor",
+          "sampling": {
+            "samplingType": "fixed",
+            "percentage": 50
+          },
+          "frontend": {
+            "request": {
+              "headers": [
+                "Content-type"
+              ],
+              "body": {
+                "bytes": 512
+              }
+            },
+            "response": {
+              "headers": [
+                "Content-type"
+              ],
+              "body": {
+                "bytes": 512
+              }
+            }
+          },
+          "backend": {
+            "request": {
+              "headers": [
+                "Content-type"
+              ],
+              "body": {
+                "bytes": 512
+              }
+            },
+            "response": {
+              "headers": [
+                "Content-type"
+              ],
+              "body": {
+                "bytes": 512
+              }
+            }
+          }
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/diagnostics/applicationinsights",
+        "type": "Microsoft.ApiManagement/service/diagnostics",
+        "name": "applicationinsights",
+        "properties": {
+          "alwaysLog": "allErrors",
+          "loggerId": "/loggers/applicationinsights",
+          "sampling": {
+            "samplingType": "fixed",
+            "percentage": 50
+          },
+          "frontend": {
+            "request": {
+              "headers": [
+                "Content-type"
+              ],
+              "body": {
+                "bytes": 512
+              }
+            },
+            "response": {
+              "headers": [
+                "Content-type"
+              ],
+              "body": {
+                "bytes": 512
+              }
+            }
+          },
+          "backend": {
+            "request": {
+              "headers": [
+                "Content-type"
+              ],
+              "body": {
+                "bytes": 512
+              }
+            },
+            "response": {
+              "headers": [
+                "Content-type"
+              ],
+              "body": {
+                "bytes": 512
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateEHLogger.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateEHLogger.json
new file mode 100644
index 000000000000..8ddd5cd06dbb
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateEHLogger.json
@@ -0,0 +1,55 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "loggerId": "loggerId",
+    "parameters": {
+      "properties": {
+        "loggerType": "azureEventHub",
+        "description": "adding a new logger",
+        "credentials": {
+          "name": "hydraeventhub",
+          "connectionString": "Endpoint=sb://hydraeventhub-ns.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=********="
+        }
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/loggers/loggerId",
+        "type": "Microsoft.ApiManagement/service/loggers",
+        "name": "loggerId",
+        "properties": {
+          "loggerType": "azureEventHub",
+          "description": "adding a new logger",
+          "credentials": {
+            "name": "hydraeventhub",
+            "connectionString": "{{59544ef2e4bbd50d9468c617}}"
+          },
+          "isBuffered": true,
+          "resourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.EventHub/namespaces/hydraeventhub-ns"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/loggers/loggerId",
+        "type": "Microsoft.ApiManagement/service/loggers",
+        "name": "loggerId",
+        "properties": {
+          "loggerType": "azureEventHub",
+          "description": "adding a new logger",
+          "credentials": {
+            "name": "hydraeventhub",
+            "connectionString": "{{59544ef2e4bbd50d9468c617}}"
+          },
+          "isBuffered": true,
+          "resourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.EventHub/namespaces/hydraeventhub-ns"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateEmailTemplate.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateEmailTemplate.json
new file mode 100644
index 000000000000..1ea54ce7637f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateEmailTemplate.json
@@ -0,0 +1,96 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "templateName": "newIssueNotificationMessage",
+    "parameters": {
+      "properties": {
+        "subject": "Your request for $IssueName was successfully received."
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/templates/NewIssueNotificationMessage",
+        "type": "Microsoft.ApiManagement/service/templates",
+        "name": "NewIssueNotificationMessage",
+        "properties": {
+          "subject": "Your request for $IssueName was successfully received.",
+          "body": "<!DOCTYPE html >\r\n<html>\r\n  <head />\r\n  <body>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">Dear $DevFirstName $DevLastName,</p>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">Thank you for contacting us. Our API team will review your issue and get back to you soon.</p>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">\r\n          Click this <a href=\"http://$DevPortalUrl/issues/$IssueId\">link</a> to view or edit your request.\r\n        </p>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">Best,</p>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">The $OrganizationName API Team</p>\r\n  </body>\r\n</html>",
+          "title": "New issue received",
+          "description": "This email is sent to developers after they create a new topic on the Issues page of the developer portal.",
+          "isDefault": false,
+          "parameters": [
+            {
+              "name": "DevFirstName",
+              "title": "Developer first name"
+            },
+            {
+              "name": "DevLastName",
+              "title": "Developer last name"
+            },
+            {
+              "name": "IssueId",
+              "title": "Issue id"
+            },
+            {
+              "name": "IssueName",
+              "title": "Issue name"
+            },
+            {
+              "name": "OrganizationName",
+              "title": "Organization name"
+            },
+            {
+              "name": "DevPortalUrl",
+              "title": "Developer portal URL"
+            }
+          ]
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/templates/NewIssueNotificationMessage",
+        "type": "Microsoft.ApiManagement/service/templates",
+        "name": "NewIssueNotificationMessage",
+        "properties": {
+          "subject": "Your request for $IssueName was successfully received.",
+          "body": "<!DOCTYPE html >\r\n<html>\r\n  <head />\r\n  <body>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">Dear $DevFirstName $DevLastName,</p>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">Thank you for contacting us. Our API team will review your issue and get back to you soon.</p>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">\r\n          Click this <a href=\"http://$DevPortalUrl/issues/$IssueId\">link</a> to view or edit your request.\r\n        </p>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">Best,</p>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">The $OrganizationName API Team</p>\r\n  </body>\r\n</html>",
+          "title": "New issue received",
+          "description": "This email is sent to developers after they create a new topic on the Issues page of the developer portal.",
+          "isDefault": false,
+          "parameters": [
+            {
+              "name": "DevFirstName",
+              "title": "Developer first name"
+            },
+            {
+              "name": "DevLastName",
+              "title": "Developer last name"
+            },
+            {
+              "name": "IssueId",
+              "title": "Issue id"
+            },
+            {
+              "name": "IssueName",
+              "title": "Issue name"
+            },
+            {
+              "name": "OrganizationName",
+              "title": "Organization name"
+            },
+            {
+              "name": "DevPortalUrl",
+              "title": "Developer portal URL"
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateGateway.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateGateway.json
new file mode 100644
index 000000000000..cc83e2b4e3c2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateGateway.json
@@ -0,0 +1,45 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1",
+    "parameters": {
+      "properties": {
+        "description": "my gateway 1",
+        "locationData": {
+          "name": "my location"
+        }
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gw1",
+        "type": "Microsoft.ApiManagement/service/gateways",
+        "name": "a1",
+        "properties": {
+          "description": "my gateway 1",
+          "locationData": {
+            "name": "my location"
+          }
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gw1",
+        "type": "Microsoft.ApiManagement/service/gateways",
+        "name": "a1",
+        "properties": {
+          "description": "my gateway 1",
+          "locationData": {
+            "name": "my location"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateGatewayApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateGatewayApi.json
new file mode 100644
index 000000000000..29b9573e9333
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateGatewayApi.json
@@ -0,0 +1,61 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1",
+    "apiId": "echo-api",
+    "parameters": {
+      "properties": {
+        "provisioningState": "created"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gw1/apis/echo-api",
+        "type": "Microsoft.ApiManagement/service/gateways/apis",
+        "name": "echo-api",
+        "properties": {
+          "displayName": "EchoApi",
+          "apiRevision": "1",
+          "serviceUrl": "https://contoso.com/apis/echo",
+          "path": "",
+          "protocols": [
+            "http",
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "isCurrent": true
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gw1/apis/echo-api",
+        "type": "Microsoft.ApiManagement/service/gateways/apis",
+        "name": "echo-api",
+        "properties": {
+          "displayName": "EchoApi",
+          "apiRevision": "1",
+          "serviceUrl": "https://contoso.com/apis/echo",
+          "path": "",
+          "protocols": [
+            "http",
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "isCurrent": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateGatewayHostnameConfiguration.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateGatewayHostnameConfiguration.json
new file mode 100644
index 000000000000..e06f423962b1
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateGatewayHostnameConfiguration.json
@@ -0,0 +1,43 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1",
+    "hcId": "default",
+    "parameters": {
+      "properties": {
+        "hostname": "*",
+        "certificateId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/cert1",
+        "negotiateClientCertificate": false
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gw1/hostnameConfigurations/default",
+        "type": "Microsoft.ApiManagement/service/gateways/hostnameConfigurations",
+        "name": "default",
+        "properties": {
+          "hostname": "*",
+          "certificateId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/cert1",
+          "negotiateClientCertificate": false
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gw1/hostnameConfigurations/default",
+        "type": "Microsoft.ApiManagement/service/gateways/hostnameConfigurations",
+        "name": "default",
+        "properties": {
+          "hostname": "*",
+          "certificateId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/cert1",
+          "negotiateClientCertificate": false
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateGroup.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateGroup.json
new file mode 100644
index 000000000000..1a724d31cfe7
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateGroup.json
@@ -0,0 +1,38 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "groupId": "tempgroup",
+    "parameters": {
+      "properties": {
+        "displayName": "temp group"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/groups/tempgroup",
+        "type": "Microsoft.ApiManagement/service/groups",
+        "name": "tempgroup",
+        "properties": {
+          "displayName": "temp group",
+          "type": "custom"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/groups/tempgroup",
+        "type": "Microsoft.ApiManagement/service/groups",
+        "name": "tempgroup",
+        "properties": {
+          "displayName": "temp group",
+          "type": "custom"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateGroupExternal.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateGroupExternal.json
new file mode 100644
index 000000000000..99ac6e2d6b7c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateGroupExternal.json
@@ -0,0 +1,45 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "groupId": "aadGroup",
+    "parameters": {
+      "properties": {
+        "displayName": "NewGroup (samiraad.onmicrosoft.com)",
+        "description": "new group to test",
+        "type": "external",
+        "externalId": "aad://samiraad.onmicrosoft.com/groups/83cf2753-5831-4675-bc0e-2f8dc067c58d"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/groups/aadGroup",
+        "type": "Microsoft.ApiManagement/service/groups",
+        "name": "aadGroup",
+        "properties": {
+          "displayName": "NewGroup (samiraad.onmicrosoft.com)",
+          "description": "new group to test",
+          "type": "external",
+          "externalId": "aad://samiraad.onmicrosoft.com/groups/83cf2753-5831-4675-bc0e-2f8dc067c58d"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/groups/aadGroup",
+        "type": "Microsoft.ApiManagement/service/groups",
+        "name": "aadGroup",
+        "properties": {
+          "displayName": "NewGroup (samiraad.onmicrosoft.com)",
+          "description": "new group to test",
+          "type": "external",
+          "externalId": "aad://samiraad.onmicrosoft.com/groups/83cf2753-5831-4675-bc0e-2f8dc067c58d"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateGroupUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateGroupUser.json
new file mode 100644
index 000000000000..3aed4e9e63e3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateGroupUser.json
@@ -0,0 +1,44 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "groupId": "tempgroup",
+    "userId": "59307d350af58404d8a26300"
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/59307d350af58404d8a26300",
+        "type": "Microsoft.ApiManagement/service/groups/users",
+        "name": "59307d350af58404d8a26300",
+        "properties": {
+          "firstName": "test",
+          "lastName": "user",
+          "email": "testuser1@live.com",
+          "state": "active",
+          "registrationDate": "2017-06-01T20:46:45.437Z",
+          "groups": [],
+          "identities": []
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/59307d350af58404d8a26300",
+        "type": "Microsoft.ApiManagement/service/groups/users",
+        "name": "59307d350af58404d8a26300",
+        "properties": {
+          "firstName": "test",
+          "lastName": "user",
+          "email": "testuser1@live.com",
+          "state": "active",
+          "registrationDate": "2017-06-01T20:46:45.437Z",
+          "groups": [],
+          "identities": []
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateIdentityProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateIdentityProvider.json
new file mode 100644
index 000000000000..5db8adf402fd
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateIdentityProvider.json
@@ -0,0 +1,39 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "identityProviderName": "facebook",
+    "parameters": {
+      "properties": {
+        "clientId": "facebookid",
+        "clientSecret": "facebookapplicationsecret"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/identityProviders/Facebook",
+        "type": "Microsoft.ApiManagement/service/identityProviders",
+        "name": "Facebook",
+        "properties": {
+          "clientId": "facebookid",
+          "type": "facebook"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/identityProviders/Facebook",
+        "type": "Microsoft.ApiManagement/service/identityProviders",
+        "name": "Facebook",
+        "properties": {
+          "clientId": "facebookid",
+          "type": "facebook"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateMultiRegionServiceWithCustomHostname.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateMultiRegionServiceWithCustomHostname.json
new file mode 100644
index 000000000000..61456995b4b1
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateMultiRegionServiceWithCustomHostname.json
@@ -0,0 +1,256 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "parameters": {
+      "properties": {
+        "hostnameConfigurations": [
+          {
+            "type": "Proxy",
+            "hostName": "gateway1.msitesting.net",
+            "encodedCertificate": "****** Base 64 Encoded Certificate ************",
+            "certificatePassword": "Password",
+            "defaultSslBinding": true
+          },
+          {
+            "type": "Management",
+            "hostName": "mgmt.msitesting.net",
+            "encodedCertificate": "****** Base 64 Encoded Certificate ************",
+            "certificatePassword": "Password"
+          },
+          {
+            "type": "Portal",
+            "hostName": "portal1.msitesting.net",
+            "encodedCertificate": "****** Base 64 Encoded Certificate ************",
+            "certificatePassword": "Password"
+          }
+        ],
+        "publisherEmail": "apim@autorestsdk.com",
+        "publisherName": "autorestsdk",
+        "additionalLocations": [
+          {
+            "location": "East US",
+            "sku": {
+              "name": "Premium",
+              "capacity": 1
+            },
+            "disableGateway": true
+          }
+        ],
+        "virtualNetworkType": "None",
+        "apiVersionConstraint": {
+          "minApiVersion": "2019-01-01"
+        }
+      },
+      "sku": {
+        "name": "Premium",
+        "capacity": 1
+      },
+      "location": "West US",
+      "tags": {
+        "tag1": "value1",
+        "tag2": "value2",
+        "tag3": "value3"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/bXVsdGlob3N0bmFtZW11bHRpcmVnaW9uc2VydmljZV9BY3RfZjFiOTZhMjc=?api-version=2019-12-01"
+      },
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+        "name": "apimService1",
+        "type": "Microsoft.ApiManagement/service",
+        "tags": {
+          "tag1": "value1",
+          "tag2": "value2",
+          "tag3": "value3"
+        },
+        "location": "West US",
+        "etag": "AAAAAAACXoo=",
+        "properties": {
+          "publisherEmail": "apim@autorestsdk.com",
+          "publisherName": "autorestsdk",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Created",
+          "targetProvisioningState": "Activating",
+          "createdAtUtc": "2019-12-18T08:04:26.9492661Z",
+          "hostnameConfigurations": [
+            {
+              "type": "Proxy",
+              "hostName": "apimService1.azure-api.net",
+              "negotiateClientCertificate": false,
+              "defaultSslBinding": false
+            },
+            {
+              "type": "Proxy",
+              "hostName": "gateway1.msitesting.net",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2036-01-01T07:00:00+00:00",
+                "thumbprint": "8E989XXXXXXXXXXXXXXXXF1D174FDB3A2",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": true
+            },
+            {
+              "type": "Management",
+              "hostName": "mgmt.msitesting.net",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2036-01-01T07:00:00+00:00",
+                "thumbprint": "8E989XXXXXXXXXXXXXXXXF1D174FDB3A2",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": false
+            },
+            {
+              "type": "Portal",
+              "hostName": "portal1.msitesting.net",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2036-01-01T07:00:00+00:00",
+                "thumbprint": "8E989XXXXXXXXXXXXXXXXF1D174FDB3A2",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": false
+            }
+          ],
+          "additionalLocations": [
+            {
+              "location": "East US",
+              "sku": {
+                "name": "Premium",
+                "capacity": 1
+              },
+              "disableGateway": true
+            }
+          ],
+          "virtualNetworkType": "None",
+          "disableGateway": false,
+          "apiVersionConstraint": {
+            "minApiVersion": "2019-01-01"
+          }
+        },
+        "sku": {
+          "name": "Premium",
+          "capacity": 1
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+        "name": "apimService1",
+        "type": "Microsoft.ApiManagement/service",
+        "tags": {
+          "tag1": "value1",
+          "tag2": "value2",
+          "tag3": "value3"
+        },
+        "location": "West US",
+        "etag": "AAAAAAACXok=",
+        "properties": {
+          "publisherEmail": "apim@autorestsdk.com",
+          "publisherName": "autorestsdk",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Succeeded",
+          "targetProvisioningState": "",
+          "createdAtUtc": "2019-12-18T06:26:20.3348609Z",
+          "gatewayUrl": "https://apimService1.azure-api.net",
+          "gatewayRegionalUrl": "https://apimService1-westus-01.regional.azure-api.net",
+          "portalUrl": "https://apimService1.portal.azure-api.net",
+          "developerPortalUrl": "https://apimService1.developer.azure-api.net",
+          "managementApiUrl": "https://apimService1.management.azure-api.net",
+          "scmUrl": "https://apimService1.scm.azure-api.net",
+          "hostnameConfigurations": [
+            {
+              "type": "Proxy",
+              "hostName": "apimService1.azure-api.net",
+              "negotiateClientCertificate": false,
+              "defaultSslBinding": false
+            },
+            {
+              "type": "Proxy",
+              "hostName": "gateway1.msitesting.net",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2036-01-01T07:00:00+00:00",
+                "thumbprint": "8E989XXXXXXXXXXXXXXXXF1D174FDB3A2",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": true
+            },
+            {
+              "type": "Management",
+              "hostName": "mgmt.msitesting.net",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2036-01-01T07:00:00+00:00",
+                "thumbprint": "8E989XXXXXXXXXXXXXXXXF1D174FDB3A2",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": false
+            },
+            {
+              "type": "Portal",
+              "hostName": "portal1.msitesting.net",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2036-01-01T07:00:00+00:00",
+                "thumbprint": "8E989XXXXXXXXXXXXXXXXF1D174FDB3A2",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": false
+            }
+          ],
+          "publicIPAddresses": [
+            "13.91.32.113"
+          ],
+          "additionalLocations": [
+            {
+              "location": "East US",
+              "sku": {
+                "name": "Premium",
+                "capacity": 1
+              },
+              "publicIPAddresses": [
+                "23.101.138.153"
+              ],
+              "gatewayRegionalUrl": "https://apimService1-eastus-01.regional.azure-api.net",
+              "disableGateway": true
+            }
+          ],
+          "customProperties": {
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Ssl30": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "False"
+          },
+          "virtualNetworkType": "None",
+          "disableGateway": false,
+          "apiVersionConstraint": {
+            "minApiVersion": "2019-01-01"
+          }
+        },
+        "sku": {
+          "name": "Premium",
+          "capacity": 1
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/bXVsdGlob3N0bmFtZW11bHRpcmVnaW9uc2VydmljZV9BY3RfZjFiOTZhMjc=?api-version=2019-12-01"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateNamedValue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateNamedValue.json
new file mode 100644
index 000000000000..19be0feebcc8
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateNamedValue.json
@@ -0,0 +1,59 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "namedValueId": "testprop2",
+    "parameters": {
+      "properties": {
+        "displayName": "prop3name",
+        "value": "propValue",
+        "tags": [
+          "foo",
+          "bar"
+        ],
+        "secret": false
+      }
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/namedValues/testprop2?api-version=2019-12-01&asyncId=5c730e343244df1b9cb56e85&asyncCode=201"
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/namedValues/testprop2",
+        "type": "Microsoft.ApiManagement/service/namedValues",
+        "name": "testprop2",
+        "properties": {
+          "displayName": "prop3name",
+          "value": "propValue",
+          "tags": [
+            "foo",
+            "bar"
+          ],
+          "secret": false
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/namedValues/testprop2",
+        "type": "Microsoft.ApiManagement/service/namedValues",
+        "name": "testprop2",
+        "properties": {
+          "displayName": "prop3name",
+          "value": "propValue",
+          "tags": [
+            "foo",
+            "bar"
+          ],
+          "secret": false
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateNotification.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateNotification.json
new file mode 100644
index 000000000000..4a367d3b4e1d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateNotification.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "notificationName": "RequestPublisherNotificationMessage"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage",
+        "type": "Microsoft.ApiManagement/service/notifications",
+        "name": "RequestPublisherNotificationMessage",
+        "properties": {
+          "title": "Subscription requests (requiring approval)",
+          "description": "The following email recipients and users will receive email notifications about subscription requests for API products requiring approval.",
+          "recipients": {
+            "emails": [
+              "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/recipientEmails/contoso@live.com",
+              "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/recipientEmails/foobar!live",
+              "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/recipientEmails/foobar@live.com"
+            ],
+            "users": [
+              "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/576823d0a40f7e74ec07d642"
+            ]
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateNotificationRecipientEmail.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateNotificationRecipientEmail.json
new file mode 100644
index 000000000000..4faab613a7bb
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateNotificationRecipientEmail.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "notificationName": "RequestPublisherNotificationMessage",
+    "email": "foobar@live.com"
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage/recipientEmails/foobar@live.com",
+        "type": "Microsoft.ApiManagement/service/notifications/recipientEmails",
+        "name": "foobar@live.com",
+        "properties": {
+          "email": "foobar@live.com"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage/recipientEmails/foobar@live.com",
+        "type": "Microsoft.ApiManagement/service/notifications/recipientEmails",
+        "name": "foobar@live.com",
+        "properties": {
+          "email": "foobar@live.com"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateNotificationRecipientUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateNotificationRecipientUser.json
new file mode 100644
index 000000000000..e22905720839
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateNotificationRecipientUser.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "notificationName": "RequestPublisherNotificationMessage",
+    "userId": "576823d0a40f7e74ec07d642"
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage/recipientUsers/576823d0a40f7e74ec07d642",
+        "type": "Microsoft.ApiManagement/service/notifications/recipientUsers",
+        "name": "576823d0a40f7e74ec07d642",
+        "properties": {
+          "userId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/576823d0a40f7e74ec07d642"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage/recipientUsers/576823d0a40f7e74ec07d642",
+        "type": "Microsoft.ApiManagement/service/notifications/recipientUsers",
+        "name": "576823d0a40f7e74ec07d642",
+        "properties": {
+          "userId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/576823d0a40f7e74ec07d642"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateOpenIdConnectProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateOpenIdConnectProvider.json
new file mode 100644
index 000000000000..98050d34ffd4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateOpenIdConnectProvider.json
@@ -0,0 +1,43 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "opid": "templateOpenIdConnect3",
+    "parameters": {
+      "properties": {
+        "displayName": "templateoidprovider3",
+        "metadataEndpoint": "https://oidprovider-template3.net",
+        "clientId": "oidprovidertemplate3",
+        "clientSecret": "x"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/openidConnectProviders/templateOpenIdConnect3",
+        "type": "Microsoft.ApiManagement/service/openidconnectproviders",
+        "name": "templateOpenIdConnect3",
+        "properties": {
+          "displayName": "templateoidprovider3",
+          "metadataEndpoint": "https://oidprovider-template3.net",
+          "clientId": "oidprovidertemplate3"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/openidConnectProviders/templateOpenIdConnect3",
+        "type": "Microsoft.ApiManagement/service/openidconnectproviders",
+        "name": "templateOpenIdConnect3",
+        "properties": {
+          "displayName": "templateoidprovider3",
+          "metadataEndpoint": "https://oidprovider-template3.net",
+          "clientId": "oidprovidertemplate3"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreatePolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreatePolicy.json
new file mode 100644
index 000000000000..76086d34b6f3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreatePolicy.json
@@ -0,0 +1,37 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "policyId": "policy",
+    "parameters": {
+      "properties": {
+        "format": "xml",
+        "value": "<policies>\r\n  <inbound />\r\n  <backend>\r\n    <forward-request />\r\n  </backend>\r\n  <outbound />\r\n</policies>"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/policies/policy",
+        "type": "Microsoft.ApiManagement/service/policies",
+        "name": "policy",
+        "properties": {
+          "value": "<policies>\r\n  <inbound />\r\n  <backend>\r\n    <forward-request />\r\n  </backend>\r\n  <outbound />\r\n</policies>"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/policies/policy",
+        "type": "Microsoft.ApiManagement/service/policies",
+        "name": "policy",
+        "properties": {
+          "value": "<policies>\r\n  <inbound />\r\n  <backend>\r\n    <forward-request />\r\n  </backend>\r\n  <outbound />\r\n</policies>"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateProduct.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateProduct.json
new file mode 100644
index 000000000000..925d35d19c91
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateProduct.json
@@ -0,0 +1,42 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "testproduct",
+    "parameters": {
+      "properties": {
+        "displayName": "Test Template ProductName 4"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/testproduct",
+        "type": "Microsoft.ApiManagement/service/products",
+        "name": "testproduct",
+        "properties": {
+          "displayName": "Test Template ProductName 4",
+          "subscriptionRequired": true,
+          "approvalRequired": false,
+          "state": "notPublished"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/testproduct",
+        "type": "Microsoft.ApiManagement/service/products",
+        "name": "testproduct",
+        "properties": {
+          "displayName": "Test Template ProductName 4",
+          "subscriptionRequired": true,
+          "approvalRequired": false,
+          "state": "notPublished"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateProductApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateProductApi.json
new file mode 100644
index 000000000000..30b77c382eff
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateProductApi.json
@@ -0,0 +1,56 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "testproduct",
+    "apiId": "echo-api"
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/5931a75ae4bbd512a88c680b",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "5931a75ae4bbd512a88c680b",
+        "properties": {
+          "displayName": "EchoApi",
+          "apiRevision": "1",
+          "serviceUrl": "https://contoso.com/apis/echo",
+          "path": "",
+          "protocols": [
+            "http",
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "isCurrent": true
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/5931a75ae4bbd512a88c680b",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "5931a75ae4bbd512a88c680b",
+        "properties": {
+          "displayName": "EchoApi",
+          "apiRevision": "1",
+          "serviceUrl": "https://contoso.com/apis/echo",
+          "path": "",
+          "protocols": [
+            "http",
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "isCurrent": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateProductGroup.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateProductGroup.json
new file mode 100644
index 000000000000..a2b80c8400ee
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateProductGroup.json
@@ -0,0 +1,38 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "testproduct",
+    "groupId": "templateGroup"
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/groups/templateGroup",
+        "type": "Microsoft.ApiManagement/service/products/groups",
+        "name": "templateGroup",
+        "properties": {
+          "displayName": "Template Group",
+          "description": "group created via Template",
+          "builtIn": false,
+          "type": "custom"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/groups/templateGroup",
+        "type": "Microsoft.ApiManagement/service/products/groups",
+        "name": "templateGroup",
+        "properties": {
+          "displayName": "Template Group",
+          "description": "group created via Template",
+          "builtIn": false,
+          "type": "custom"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateProductPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateProductPolicy.json
new file mode 100644
index 000000000000..4b94a9f824c7
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateProductPolicy.json
@@ -0,0 +1,38 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "5702e97e5157a50f48dce801",
+    "policyId": "policy",
+    "parameters": {
+      "properties": {
+        "format": "xml",
+        "value": "<policies>\r\n  <inbound>\r\n    <rate-limit calls=\"{{call-count}}\" renewal-period=\"15\"></rate-limit>\r\n    <log-to-eventhub logger-id=\"16\">\r\n                      @( string.Join(\",\", DateTime.UtcNow, context.Deployment.ServiceName, context.RequestId, context.Request.IpAddress, context.Operation.Name) ) \r\n                  </log-to-eventhub>\r\n    <quota-by-key calls=\"40\" counter-key=\"cc\" renewal-period=\"3600\" increment-count=\"@(context.Request.Method == &quot;POST&quot; ? 1:2)\" />\r\n    <base />\r\n  </inbound>\r\n  <backend>\r\n    <base />\r\n  </backend>\r\n  <outbound>\r\n    <base />\r\n  </outbound>\r\n</policies>"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5702e97e5157a50f48dce801/policies/policy",
+        "type": "Microsoft.ApiManagement/service/products/policies",
+        "name": "policy",
+        "properties": {
+          "value": "<policies>\r\n  <inbound>\r\n    <rate-limit calls=\"{{58c884fed8d14f127cec38f0}}\" renewal-period=\"15\" version=\"2\"></rate-limit>\r\n    <log-to-eventhub logger-id=\"16\">\r\n                      @( string.Join(\",\", DateTime.UtcNow, context.Deployment.ServiceName, context.RequestId, context.Request.IpAddress, context.Operation.Name) ) \r\n                  </log-to-eventhub>\r\n    <quota-by-key calls=\"40\" counter-key=\"cc\" renewal-period=\"3600\" increment-count=\"@(context.Request.Method == &quot;POST&quot; ? 1:2)\" />\r\n    <base />\r\n  </inbound>\r\n  <backend>\r\n    <base />\r\n  </backend>\r\n  <outbound>\r\n    <base />\r\n  </outbound>\r\n</policies>"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5702e97e5157a50f48dce801/policies/policy",
+        "type": "Microsoft.ApiManagement/service/products/policies",
+        "name": "policy",
+        "properties": {
+          "value": "<policies>\r\n  <inbound>\r\n    <rate-limit calls=\"{{58c884fed8d14f127cec38f0}}\" renewal-period=\"15\" version=\"2\"></rate-limit>\r\n    <log-to-eventhub logger-id=\"16\">\r\n                      @( string.Join(\",\", DateTime.UtcNow, context.Deployment.ServiceName, context.RequestId, context.Request.IpAddress, context.Operation.Name) ) \r\n                  </log-to-eventhub>\r\n    <quota-by-key calls=\"40\" counter-key=\"cc\" renewal-period=\"3600\" increment-count=\"@(context.Request.Method == &quot;POST&quot; ? 1:2)\" />\r\n    <base />\r\n  </inbound>\r\n  <backend>\r\n    <base />\r\n  </backend>\r\n  <outbound>\r\n    <base />\r\n  </outbound>\r\n</policies>"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateProductTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateProductTag.json
new file mode 100644
index 000000000000..276d5f1dba96
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateProductTag.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "5931a75ae4bbd512a88c680b",
+    "tagId": "tagId1"
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/tagId1",
+        "type": "Microsoft.ApiManagement/service/tags",
+        "name": "tagId1",
+        "properties": {
+          "displayName": "tag1"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/tagId1",
+        "type": "Microsoft.ApiManagement/service/tags",
+        "name": "tagId1",
+        "properties": {
+          "displayName": "tag1"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateService.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateService.json
new file mode 100644
index 000000000000..4b3802e9e064
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateService.json
@@ -0,0 +1,124 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "parameters": {
+      "properties": {
+        "publisherEmail": "foo@contoso.com",
+        "publisherName": "foo"
+      },
+      "sku": {
+        "name": "Developer",
+        "capacity": 1
+      },
+      "location": "South Central US",
+      "tags": {
+        "Name": "Contoso",
+        "Test": "User"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/dGVjaGVkX01hbmFnZVJvbGVfNWRiNGI3Ng==?api-version=2019-12-01"
+      },
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+        "name": "apimService1",
+        "type": "Microsoft.ApiManagement/service",
+        "tags": {
+          "Name": "Contoso",
+          "Test": "User"
+        },
+        "location": "South Central US",
+        "etag": "AAAAAAAp3P0=",
+        "properties": {
+          "publisherEmail": "foo@contoso.com",
+          "publisherName": "foo",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Created",
+          "targetProvisioningState": "Activating",
+          "createdAtUtc": "2019-12-18T06:10:56.0327105Z",
+          "hostnameConfigurations": [
+            {
+              "type": "Proxy",
+              "hostName": "apimService1.azure-api.net",
+              "negotiateClientCertificate": false,
+              "defaultSslBinding": true
+            }
+          ],
+          "virtualNetworkType": "None",
+          "disableGateway": false,
+          "apiVersionConstraint": {}
+        },
+        "sku": {
+          "name": "Developer",
+          "capacity": 1
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+        "name": "apimService1",
+        "type": "Microsoft.ApiManagement/service",
+        "tags": {
+          "Name": "Contoso",
+          "Test": "User"
+        },
+        "location": "South Central US",
+        "etag": "AAAAAAAp3T4=",
+        "properties": {
+          "publisherEmail": "foo@contoso.com",
+          "publisherName": "foo",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Succeeded",
+          "targetProvisioningState": "",
+          "createdAtUtc": "2019-12-18T06:10:56.0327105Z",
+          "gatewayUrl": "https://apimService1.azure-api.net",
+          "gatewayRegionalUrl": "https://apimService1-southcentralus-01.regional.azure-api.net",
+          "portalUrl": "https://apimService1.portal.azure-api.net",
+          "developerPortalUrl": "https://apimService1.developer.azure-api.net",
+          "managementApiUrl": "https://apimService1.management.azure-api.net",
+          "scmUrl": "https://apimService1.scm.azure-api.net",
+          "hostnameConfigurations": [
+            {
+              "type": "Proxy",
+              "hostName": "apimService1.azure-api.net",
+              "negotiateClientCertificate": false,
+              "defaultSslBinding": true
+            }
+          ],
+          "publicIPAddresses": [
+            "23.102.171.124"
+          ],
+          "customProperties": {
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Ssl30": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "False"
+          },
+          "virtualNetworkType": "None",
+          "disableGateway": false,
+          "apiVersionConstraint": {}
+        },
+        "sku": {
+          "name": "Developer",
+          "capacity": 1
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/c2RrdGVzdGFwaW0xNTkxX0FjdF9jZTkyMmNmOQ==?api-version=2019-12-01"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateServiceHavingMsi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateServiceHavingMsi.json
new file mode 100644
index 000000000000..fe5899f40fe5
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateServiceHavingMsi.json
@@ -0,0 +1,119 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "parameters": {
+      "properties": {
+        "publisherEmail": "apim@autorestsdk.com",
+        "publisherName": "autorestsdk"
+      },
+      "sku": {
+        "name": "Consumption",
+        "capacity": 0
+      },
+      "identity": {
+        "type": "SystemAssigned"
+      },
+      "location": "West US",
+      "tags": {
+        "tag1": "value1",
+        "tag2": "value2",
+        "tag3": "value3"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/dGVjaGVkX01hbmFnZVJvbGVfNWRiNGI3Ng==?api-version=2019-12-01"
+      },
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+        "name": "apimService1",
+        "type": "Microsoft.ApiManagement/service",
+        "tags": {
+          "tag1": "value1",
+          "tag2": "value2",
+          "tag3": "value3"
+        },
+        "location": "West US",
+        "etag": "AAAAAAAAWiE=",
+        "properties": {
+          "publisherEmail": "apim@autorestsdk.com",
+          "publisherName": "autorestsdk",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Created",
+          "targetProvisioningState": "Activating",
+          "createdAtUtc": "2019-04-11T16:29:29.9711098Z",
+          "hostnameConfigurations": [
+            {
+              "type": "Proxy",
+              "hostName": "apimService1.azure-api.net",
+              "negotiateClientCertificate": false,
+              "defaultSslBinding": true
+            }
+          ],
+          "virtualNetworkType": "None"
+        },
+        "sku": {
+          "name": "Consumption",
+          "capacity": 0
+        },
+        "identity": {
+          "type": "SystemAssigned",
+          "principalId": "dfb9a757-df69-4966-a8d0-711a9cd8ffb4",
+          "tenantId": "XXXXXX-86f1-41af-91ab-2d7cd011db47"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+        "name": "apimService1",
+        "type": "Microsoft.ApiManagement/service",
+        "tags": {
+          "tag1": "value1",
+          "tag2": "value2",
+          "tag3": "value3"
+        },
+        "location": "West US",
+        "etag": "AAAAAAAAWiU=",
+        "properties": {
+          "publisherEmail": "apim@autorestsdk.com",
+          "publisherName": "autorestsdk",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Succeeded",
+          "targetProvisioningState": "",
+          "createdAtUtc": "2019-04-11T16:29:29.9711098Z",
+          "gatewayUrl": "https://apimService1.azure-api.net",
+          "hostnameConfigurations": [
+            {
+              "type": "Proxy",
+              "hostName": "apimService1.azure-api.net",
+              "negotiateClientCertificate": false,
+              "defaultSslBinding": true
+            }
+          ],
+          "virtualNetworkType": "None",
+          "enableClientCertificate": false
+        },
+        "sku": {
+          "name": "Consumption",
+          "capacity": 0
+        },
+        "identity": {
+          "type": "SystemAssigned",
+          "principalId": "dfb9a757-df69-4966-a8d0-711a9cd8ffb4",
+          "tenantId": "XXXXXX-86f1-41af-91ab-2d7cd011db47"
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/dGVjaGVkX01hbmFnZVJvbGVfNWRiNGI3Ng==?api-version=2019-12-01"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateServiceWithSystemCertificates.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateServiceWithSystemCertificates.json
new file mode 100644
index 000000000000..f3bdc427f2fb
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateServiceWithSystemCertificates.json
@@ -0,0 +1,154 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "parameters": {
+      "properties": {
+        "certificates": [
+          {
+            "encodedCertificate": "*******Base64 encoded Certificate******************",
+            "certificatePassword": "Password",
+            "storeName": "CertificateAuthority"
+          }
+        ],
+        "publisherEmail": "apim@autorestsdk.com",
+        "publisherName": "autorestsdk"
+      },
+      "sku": {
+        "name": "Basic",
+        "capacity": 1
+      },
+      "location": "Central US",
+      "tags": {
+        "tag1": "value1",
+        "tag2": "value2",
+        "tag3": "value3"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/bXVsdGlob3N0bmFtZW11bHRpcmVnaW9uc2VydmljZV9BY3RfZjFiOTZhMjc=?api-version=2019-12-01"
+      },
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+        "name": "apimService1",
+        "type": "Microsoft.ApiManagement/service",
+        "tags": {
+          "tag1": "value1",
+          "tag2": "value2",
+          "tag3": "value3"
+        },
+        "location": "Central US",
+        "etag": "AAAAAAAp3TM=",
+        "properties": {
+          "publisherEmail": "apim@autorestsdk.com",
+          "publisherName": "autorestsdk",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Created",
+          "targetProvisioningState": "Activating",
+          "createdAtUtc": "2019-12-18T06:33:28.0906918Z",
+          "hostnameConfigurations": [
+            {
+              "type": "Proxy",
+              "hostName": "apimService1.azure-api.net",
+              "negotiateClientCertificate": false,
+              "defaultSslBinding": true
+            }
+          ],
+          "virtualNetworkType": "None",
+          "certificates": [
+            {
+              "storeName": "CertificateAuthority",
+              "certificate": {
+                "expiry": "2036-01-01T07:00:00+00:00",
+                "thumbprint": "8E989652CABCF585ACBFCB9C2C91F1D174FDB3A2",
+                "subject": "CN=*.msitesting.net"
+              }
+            }
+          ],
+          "disableGateway": false,
+          "apiVersionConstraint": {}
+        },
+        "sku": {
+          "name": "Basic",
+          "capacity": 1
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+        "name": "apimService1",
+        "type": "Microsoft.ApiManagement/service",
+        "tags": {
+          "tag1": "value1",
+          "tag2": "value2",
+          "tag3": "value3"
+        },
+        "location": "Central US",
+        "etag": "AAAAAAAp3UM=",
+        "properties": {
+          "publisherEmail": "apim@autorestsdk.com",
+          "publisherName": "autorestsdk",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Succeeded",
+          "targetProvisioningState": "",
+          "createdAtUtc": "2019-12-18T06:33:28.0906918Z",
+          "gatewayUrl": "https://apimService1.azure-api.net",
+          "gatewayRegionalUrl": "https://apimService1-centralus-01.regional.azure-api.net",
+          "portalUrl": "https://apimService1.portal.azure-api.net",
+          "developerPortalUrl": "https://apimService1.developer.azure-api.net",
+          "managementApiUrl": "https://apimService1.management.azure-api.net",
+          "scmUrl": "https://apimService1.scm.azure-api.net",
+          "hostnameConfigurations": [
+            {
+              "type": "Proxy",
+              "hostName": "apimService1.azure-api.net",
+              "negotiateClientCertificate": false,
+              "defaultSslBinding": true
+            }
+          ],
+          "publicIPAddresses": [
+            "40.113.223.117"
+          ],
+          "customProperties": {
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Ssl30": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "False"
+          },
+          "virtualNetworkType": "None",
+          "certificates": [
+            {
+              "storeName": "CertificateAuthority",
+              "certificate": {
+                "expiry": "2036-01-01T07:00:00+00:00",
+                "thumbprint": "8E989652CABCF585ACBFCB9C2C91F1D174FDB3A2",
+                "subject": "CN=*.msitesting.net"
+              }
+            }
+          ],
+          "disableGateway": false,
+          "apiVersionConstraint": {}
+        },
+        "sku": {
+          "name": "Basic",
+          "capacity": 1
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/bXVsdGlob3N0bmFtZW11bHRpcmVnaW9uc2VydmljZV9BY3RfZjFiOTZhMjc=?api-version=2019-12-01"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateServiceWithUserAssignedIdentity.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateServiceWithUserAssignedIdentity.json
new file mode 100644
index 000000000000..74ac51a762a4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateServiceWithUserAssignedIdentity.json
@@ -0,0 +1,136 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "parameters": {
+      "properties": {
+        "publisherEmail": "apim@autorestsdk.com",
+        "publisherName": "autorestsdk"
+      },
+      "sku": {
+        "name": "Consumption",
+        "capacity": 0
+      },
+      "identity": {
+        "type": "UserAssigned",
+        "userAssignedIdentities": {
+          "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/apimService1": {}
+        }
+      },
+      "location": "West US",
+      "tags": {
+        "tag1": "value1",
+        "tag2": "value2",
+        "tag3": "value3"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/dGVjaGVkX01hbmFnZVJvbGVfNWRiNGI3Ng==?api-version=2019-12-01"
+      },
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+        "name": "apimService1",
+        "type": "Microsoft.ApiManagement/service",
+        "tags": {
+          "tag1": "value1",
+          "tag2": "value2",
+          "tag3": "value3"
+        },
+        "location": "West US",
+        "etag": "AAAAAAAFzyQ=",
+        "properties": {
+          "publisherEmail": "apim@autorestsdk.com",
+          "publisherName": "autorestsdk",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Created",
+          "targetProvisioningState": "Activating",
+          "createdAtUtc": "2020-03-12T01:05:33.4573398Z",
+          "hostnameConfigurations": [
+            {
+              "type": "Proxy",
+              "hostName": "apimService1.azure-api.net",
+              "negotiateClientCertificate": false,
+              "defaultSslBinding": true
+            }
+          ],
+          "virtualNetworkType": "None"
+        },
+        "sku": {
+          "name": "Consumption",
+          "capacity": 0
+        },
+        "identity": {
+          "type": "UserAssigned",
+          "userAssignedIdentities": {
+            "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/apimService1": {}
+          }
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+        "name": "apimService1",
+        "type": "Microsoft.ApiManagement/service",
+        "tags": {
+          "tag1": "value1",
+          "tag2": "value2",
+          "tag3": "value3"
+        },
+        "location": "West US",
+        "etag": "AAAAAAAFzyk=",
+        "properties": {
+          "publisherEmail": "apim@autorestsdk.com",
+          "publisherName": "autorestsdk",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Succeeded",
+          "targetProvisioningState": "",
+          "createdAtUtc": "2020-03-12T01:05:33.4573398Z",
+          "gatewayUrl": "https://apimService1.azure-api.net",
+          "hostnameConfigurations": [
+            {
+              "type": "Proxy",
+              "hostName": "apimService1.azure-api.net",
+              "negotiateClientCertificate": false,
+              "defaultSslBinding": true
+            }
+          ],
+          "customProperties": {
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "False"
+          },
+          "virtualNetworkType": "None",
+          "disableGateway": false
+        },
+        "sku": {
+          "name": "Consumption",
+          "capacity": 0
+        },
+        "identity": {
+          "type": "UserAssigned",
+          "tenantId": "XXXXX-86f1-41af-XXXX-2d7cd011db47",
+          "userAssignedIdentities": {
+            "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/apimService1": {
+              "principalId": "XXXXX-6e62-4649-9f54-a119fc1ba85e",
+              "clientId": "5a2c6b8e-0905-XXXX-a772-993c9418137f"
+            }
+          }
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/dGVjaGVkX01hbmFnZVJvbGVfNWRiNGI3Ng==?api-version=2019-12-01"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateSoapPassThroughApiUsingWsdlImport.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateSoapPassThroughApiUsingWsdlImport.json
new file mode 100644
index 000000000000..e8c292d513e2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateSoapPassThroughApiUsingWsdlImport.json
@@ -0,0 +1,72 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "soapApi",
+    "parameters": {
+      "properties": {
+        "format": "wsdl-link",
+        "value": "http://www.webservicex.net/CurrencyConvertor.asmx?WSDL",
+        "path": "currency",
+        "apiType": "soap",
+        "wsdlSelector": {
+          "wsdlServiceName": "CurrencyConvertor",
+          "wsdlEndpointName": "CurrencyConvertorSoap"
+        }
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/soapApi",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "soapApi",
+        "properties": {
+          "displayName": "CurrencyConvertor",
+          "apiRevision": "1",
+          "serviceUrl": "http://www.webservicex.net",
+          "path": "currency",
+          "protocols": [
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "type": "soap",
+          "isCurrent": true
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/tempgroup?api-version=2019-12-01&asyncId=5c730e343244df1b9cb56e85&asyncCode=201"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/soapApi",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "soapApi",
+        "properties": {
+          "displayName": "CurrencyConvertor",
+          "apiRevision": "1",
+          "serviceUrl": "http://www.webservicex.net",
+          "path": "currency",
+          "protocols": [
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "type": "soap",
+          "isCurrent": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateSoapToRestApiUsingWsdlImport.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateSoapToRestApiUsingWsdlImport.json
new file mode 100644
index 000000000000..abb37fd5b35a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateSoapToRestApiUsingWsdlImport.json
@@ -0,0 +1,69 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "soapApi",
+    "parameters": {
+      "properties": {
+        "format": "wsdl-link",
+        "value": "http://www.webservicex.net/CurrencyConvertor.asmx?WSDL",
+        "path": "currency",
+        "wsdlSelector": {
+          "wsdlServiceName": "CurrencyConvertor",
+          "wsdlEndpointName": "CurrencyConvertorSoap"
+        }
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/soapApi",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "soapApi",
+        "properties": {
+          "displayName": "CurrencyConvertor",
+          "apiRevision": "1",
+          "serviceUrl": "http://www.webservicex.net",
+          "path": "currency",
+          "protocols": [
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "isCurrent": true
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/tempgroup?api-version=2019-12-01&asyncId=5c730e343244df1b9cb56e85&asyncCode=201"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/soapApi",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "soapApi",
+        "properties": {
+          "displayName": "CurrencyConvertor",
+          "apiRevision": "1",
+          "serviceUrl": "http://www.webservicex.net",
+          "path": "currency",
+          "protocols": [
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "isCurrent": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateSubscription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateSubscription.json
new file mode 100644
index 000000000000..1dad61c8a705
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateSubscription.json
@@ -0,0 +1,46 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "sid": "testsub",
+    "parameters": {
+      "properties": {
+        "ownerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/57127d485157a511ace86ae7",
+        "scope": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5600b59475ff190048060002",
+        "displayName": "testsub"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/subscriptions/testsub",
+        "type": "Microsoft.ApiManagement/service/subscriptions",
+        "name": "testsub",
+        "properties": {
+          "ownerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/57127d485157a511ace86ae7",
+          "scope": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5600b59475ff190048060002",
+          "displayName": "testsub",
+          "state": "submitted",
+          "createdDate": "2017-06-02T23:34:03.1055076Z"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/subscriptions/testsub",
+        "type": "Microsoft.ApiManagement/service/subscriptions",
+        "name": "testsub",
+        "properties": {
+          "ownerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/57127d485157a511ace86ae7",
+          "scope": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5600b59475ff190048060002",
+          "displayName": "testsub",
+          "state": "submitted",
+          "createdDate": "2017-06-02T23:34:03.1055076Z"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateTag.json
new file mode 100644
index 000000000000..2057e10f1bc1
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateTag.json
@@ -0,0 +1,36 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "tagId": "tagId1",
+    "parameters": {
+      "properties": {
+        "displayName": "tag1"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/tagId1",
+        "type": "Microsoft.ApiManagement/service/tags",
+        "name": "tagId1",
+        "properties": {
+          "displayName": "tag1"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/tagId1",
+        "type": "Microsoft.ApiManagement/service/tags",
+        "name": "tagId1",
+        "properties": {
+          "displayName": "tag1"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateUser.json
new file mode 100644
index 000000000000..e8189d5d05ad
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateUser.json
@@ -0,0 +1,61 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "userId": "5931a75ae4bbd512288c680b",
+    "parameters": {
+      "properties": {
+        "firstName": "foo",
+        "lastName": "bar",
+        "email": "foobar@outlook.com",
+        "confirmation": "signup"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/5931a75ae4bbd512288c680b",
+        "type": "Microsoft.ApiManagement/service/users",
+        "name": "5931a75ae4bbd512288c680b",
+        "properties": {
+          "firstName": "foo",
+          "lastName": "bar",
+          "email": "foobar@outlook.com",
+          "state": "active",
+          "registrationDate": "2018-01-07T21:21:29.16Z",
+          "groups": [],
+          "identities": [
+            {
+              "provider": "Basic",
+              "id": "foobar@outlook.com"
+            }
+          ]
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/5931a75ae4bbd512288c680b",
+        "type": "Microsoft.ApiManagement/service/users",
+        "name": "5931a75ae4bbd512288c680b",
+        "properties": {
+          "firstName": "foo",
+          "lastName": "bar",
+          "email": "foobar@outlook.com",
+          "state": "active",
+          "registrationDate": "2018-01-07T21:21:29.16Z",
+          "groups": [],
+          "identities": [
+            {
+              "provider": "Basic",
+              "id": "foobar@outlook.com"
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApi.json
new file mode 100644
index 000000000000..d8aa29f9281b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApi.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "echo-api",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiDiagnostic.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiDiagnostic.json
new file mode 100644
index 000000000000..c9ed67d16225
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiDiagnostic.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "diagnosticId": "applicationinsights",
+    "apiId": "57d1f7558aa04f15146d9d8a",
+    "If-Match": "*"
+  },
+  "responses": {
+    "204": {},
+    "200": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiIssue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiIssue.json
new file mode 100644
index 000000000000..d983b39d2964
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiIssue.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "issueId": "57d2ef278aa04f0ad01d6cdc",
+    "apiId": "57d1f7558aa04f15146d9d8a",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiIssueAttachment.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiIssueAttachment.json
new file mode 100644
index 000000000000..7a9625dd0d42
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiIssueAttachment.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "issueId": "57d2ef278aa04f0ad01d6cdc",
+    "apiId": "57d1f7558aa04f15146d9d8a",
+    "attachmentId": "57d2ef278aa04f0888cba3f3",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiIssueComment.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiIssueComment.json
new file mode 100644
index 000000000000..a2915479edce
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiIssueComment.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "issueId": "57d2ef278aa04f0ad01d6cdc",
+    "apiId": "57d1f7558aa04f15146d9d8a",
+    "commentId": "599e29ab193c3c0bd0b3e2fb",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiOperation.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiOperation.json
new file mode 100644
index 000000000000..0cceb035d673
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiOperation.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d2ef278aa04f0888cba3f3",
+    "operationId": "57d2ef278aa04f0ad01d6cdc",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiOperationPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiOperationPolicy.json
new file mode 100644
index 000000000000..1431094a3124
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiOperationPolicy.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "testapi",
+    "operationId": "testoperation",
+    "policyId": "policy",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiOperationTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiOperationTag.json
new file mode 100644
index 000000000000..95c360a2da08
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiOperationTag.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "59d5b28d1f7fab116c282650",
+    "operationId": "59d5b28d1f7fab116c282651",
+    "tagId": "59d5b28e1f7fab116402044e",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiPolicy.json
new file mode 100644
index 000000000000..bdf429bf117e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiPolicy.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "loggerId",
+    "policyId": "policy",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiRelease.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiRelease.json
new file mode 100644
index 000000000000..4dd8653da7d3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiRelease.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "5a5fcc09124a7fa9b89f2f1d",
+    "releaseId": "testrev",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiSchema.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiSchema.json
new file mode 100644
index 000000000000..2593d688885d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiSchema.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "59d5b28d1f7fab116c282650",
+    "schemaId": "59d5b28e1f7fab116402044e",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiTag.json
new file mode 100644
index 000000000000..6ae6d5b1f9f9
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiTag.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "59d5b28d1f7fab116c282650",
+    "tagId": "59d5b28e1f7fab116402044e",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiTagDescription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiTagDescription.json
new file mode 100644
index 000000000000..d26baf354d61
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiTagDescription.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "59d5b28d1f7fab116c282650",
+    "tagDescriptionId": "59d5b28e1f7fab116402044e",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiVersionSet.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiVersionSet.json
new file mode 100644
index 000000000000..7af79f6fd4b6
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteApiVersionSet.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "versionSetId": "a1",
+    "If-Match": "*"
+  },
+  "responses": {
+    "204": {},
+    "200": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteAuthorizationServer.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteAuthorizationServer.json
new file mode 100644
index 000000000000..469403ea5930
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteAuthorizationServer.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "authsid": "newauthServer2",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteBackend.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteBackend.json
new file mode 100644
index 000000000000..f5cb1b955148
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteBackend.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "backendId": "sfbackend",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteCache.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteCache.json
new file mode 100644
index 000000000000..81d6a3b12d74
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteCache.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "cacheId": "southindia",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteCertificate.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteCertificate.json
new file mode 100644
index 000000000000..779f900f5e3d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteCertificate.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "certificateId": "tempcert",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteDiagnostic.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteDiagnostic.json
new file mode 100644
index 000000000000..f33a517ffaff
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteDiagnostic.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "diagnosticId": "applicationinsights",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteEmailTemplate.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteEmailTemplate.json
new file mode 100644
index 000000000000..e050b47d9e29
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteEmailTemplate.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "templateName": "newIssueNotificationMessage",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteGateway.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteGateway.json
new file mode 100644
index 000000000000..6a8e8eda4f42
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteGateway.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteGatewayApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteGatewayApi.json
new file mode 100644
index 000000000000..fe4d70f46bcf
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteGatewayApi.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1",
+    "apiId": "echo-api",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteGatewayHostnameConfiguration.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteGatewayHostnameConfiguration.json
new file mode 100644
index 000000000000..da2bbe50e057
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteGatewayHostnameConfiguration.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1",
+    "hcId": "default",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteGroup.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteGroup.json
new file mode 100644
index 000000000000..16263544b2a3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteGroup.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "groupId": "aadGroup",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteGroupUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteGroupUser.json
new file mode 100644
index 000000000000..aa3cbc810647
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteGroupUser.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "groupId": "templategroup",
+    "userId": "59307d350af58404d8a26300",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteIdentityProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteIdentityProvider.json
new file mode 100644
index 000000000000..6360982d5097
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteIdentityProvider.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "identityProviderName": "aad",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteLogger.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteLogger.json
new file mode 100644
index 000000000000..d262f1ed9572
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteLogger.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "loggerId": "loggerId",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteNamedValue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteNamedValue.json
new file mode 100644
index 000000000000..5b9993502098
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteNamedValue.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "namedValueId": "testprop2",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteNotificationRecipientEmail.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteNotificationRecipientEmail.json
new file mode 100644
index 000000000000..2e83472d5cdc
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteNotificationRecipientEmail.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "notificationName": "RequestPublisherNotificationMessage",
+    "email": "contoso@live.com"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteNotificationRecipientUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteNotificationRecipientUser.json
new file mode 100644
index 000000000000..ea223206cbf9
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteNotificationRecipientUser.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "notificationName": "RequestPublisherNotificationMessage",
+    "userId": "576823d0a40f7e74ec07d642"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteOpenIdConnectProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteOpenIdConnectProvider.json
new file mode 100644
index 000000000000..88b279edd160
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteOpenIdConnectProvider.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "opid": "templateOpenIdConnect3",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeletePolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeletePolicy.json
new file mode 100644
index 000000000000..e76c2b9e981c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeletePolicy.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "policyId": "policy",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteProduct.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteProduct.json
new file mode 100644
index 000000000000..41ecc63ac8a4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteProduct.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "testproduct",
+    "deleteSubscriptions": true,
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteProductApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteProductApi.json
new file mode 100644
index 000000000000..4ec6d81eaef5
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteProductApi.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "testproduct",
+    "apiId": "echo-api",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteProductGroup.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteProductGroup.json
new file mode 100644
index 000000000000..bea27ba3f6c2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteProductGroup.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "testproduct",
+    "groupId": "templateGroup",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteProductPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteProductPolicy.json
new file mode 100644
index 000000000000..73a7961c69b9
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteProductPolicy.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "testproduct",
+    "policyId": "policy",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteProductTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteProductTag.json
new file mode 100644
index 000000000000..c732ced9fd0c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteProductTag.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "59d5b28d1f7fab116c282650",
+    "tagId": "59d5b28e1f7fab116402044e",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteSubscription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteSubscription.json
new file mode 100644
index 000000000000..4fbc3b8f47b7
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteSubscription.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "sid": "testsub",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteTag.json
new file mode 100644
index 000000000000..0a1157f28786
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteTag.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "tagId": "tagId1",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteUser.json
new file mode 100644
index 000000000000..09ca673e7bc7
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementDeleteUser.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "userId": "5931a75ae4bbd512288c680b",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGatewayGenerateToken.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGatewayGenerateToken.json
new file mode 100644
index 000000000000..656c58069347
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGatewayGenerateToken.json
@@ -0,0 +1,20 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1",
+    "parameters": {
+      "keyType": "primary",
+      "expiry": "2020-04-21T00:44:24.2845269Z"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": "gw1&201904210044&9A1GR1f5WIhFvFmzQG+xxxxxxxxxxx/kBeu87DWad3tkasUXuvPL+MgzlwUHyg=="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGatewayListKeys.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGatewayListKeys.json
new file mode 100644
index 000000000000..1aec559093c2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGatewayListKeys.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "primary": "primary_key_value",
+        "secondary": "secondary_key_value"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGatewayRegenerateKey.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGatewayRegenerateKey.json
new file mode 100644
index 000000000000..31accff0af2f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGatewayRegenerateKey.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "gatewayId": "gwId",
+    "parameters": {
+      "keyType": "primary"
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiContract.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiContract.json
new file mode 100644
index 000000000000..8bf50b120ad7
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiContract.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d1f7558aa04f15146d9d8a"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "57d1f7558aa04f15146d9d8a",
+        "properties": {
+          "displayName": "Service",
+          "apiRevision": "1",
+          "serviceUrl": "https://api.plexonline.com/DataSource/Service.asmx",
+          "path": "schulte",
+          "protocols": [
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "type": "soap",
+          "isCurrent": true,
+          "isOnline": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiDiagnostic.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiDiagnostic.json
new file mode 100644
index 000000000000..ffb2b5124f10
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiDiagnostic.json
@@ -0,0 +1,57 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "diagnosticId": "applicationinsights",
+    "apiId": "57d1f7558aa04f15146d9d8a"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/echo-api/diagnostics/applicationinsights",
+        "type": "Microsoft.ApiManagement/service/apis/diagnostics",
+        "name": "applicationinsights",
+        "properties": {
+          "alwaysLog": "allErrors",
+          "httpCorrelationProtocol": "Legacy",
+          "logClientIp": true,
+          "loggerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/loggers/aisamplingtest",
+          "sampling": {
+            "samplingType": "fixed",
+            "percentage": 100
+          },
+          "frontend": {
+            "request": {
+              "headers": [],
+              "body": {
+                "bytes": 100
+              }
+            },
+            "response": {
+              "headers": [],
+              "body": {
+                "bytes": 100
+              }
+            }
+          },
+          "backend": {
+            "request": {
+              "headers": [],
+              "body": {
+                "bytes": 100
+              }
+            },
+            "response": {
+              "headers": [],
+              "body": {
+                "bytes": 100
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiExportInOpenApi2dot0.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiExportInOpenApi2dot0.json
new file mode 100644
index 000000000000..e88432cf14c8
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiExportInOpenApi2dot0.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "echo-api",
+    "format": "swagger-link",
+    "export": "true"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/echo-api",
+        "format": "swagger-link-json",
+        "value": {
+          "link": "https://apimgmtstkjpszxxxxxxx.blob.core.windows.net/api-export/Swagger Petstore Extensive.json?sv=2015-07-08&sr=b&sig=mxhLsFuOonu8EXIjyFPV%2FnDra0qTIoip7N7MuU%2BTFsA%3D&se=2019-04-10T22:41:31Z&sp=r"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiExportInOpenApi3dot0.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiExportInOpenApi3dot0.json
new file mode 100644
index 000000000000..e6b7652738a8
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiExportInOpenApi3dot0.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "aid9676",
+    "format": "openapi-link",
+    "export": "true"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/aid9676",
+        "format": "openapi-link",
+        "value": {
+          "link": "https: //apimgmtstkjpszxxxxxxx.blob.core.windows.net/api-export/Swagger Petstore.yaml?sv=2015-07-08&sr=b&sig=qqtR1y5iTbz5P7USBduqB5vriIU4gmiGqe0lKVV8j9k%3D&se=2019-04-10T22:40:57Z&sp=r"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiIssue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiIssue.json
new file mode 100644
index 000000000000..46e55421000c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiIssue.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d2ef278aa04f0888cba3f3",
+    "issueId": "57d2ef278aa04f0ad01d6cdc"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a/issues/57d2ef278aa04f0ad01d6cdc",
+        "type": "Microsoft.ApiManagement/service/apis/issues",
+        "name": "57d2ef278aa04f0ad01d6cdc",
+        "properties": {
+          "title": "New API issue",
+          "description": "New API issue description",
+          "createdDate": "2018-02-01T22:21:20.467Z",
+          "state": "open",
+          "userId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/1",
+          "apiId": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiIssueAttachment.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiIssueAttachment.json
new file mode 100644
index 000000000000..658bf7f60014
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiIssueAttachment.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d2ef278aa04f0888cba3f3",
+    "issueId": "57d2ef278aa04f0ad01d6cdc",
+    "attachmentId": "57d2ef278aa04f0888cba3f3"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a/issues/57d2ef278aa04f0ad01d6cdc/attachments/57d2ef278aa04f0888cba3f3",
+        "type": "Microsoft.ApiManagement/service/apis/issues/attachments",
+        "name": "57d2ef278aa04f0888cba3f3",
+        "properties": {
+          "title": "Issue attachment.",
+          "contentFormat": "link",
+          "content": "https://.../image.jpg"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiIssueComment.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiIssueComment.json
new file mode 100644
index 000000000000..fb788a6c3ac6
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiIssueComment.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d2ef278aa04f0888cba3f3",
+    "issueId": "57d2ef278aa04f0ad01d6cdc",
+    "commentId": "599e29ab193c3c0bd0b3e2fb"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a/issues/57d2ef278aa04f0ad01d6cdc/comments/599e29ab193c3c0bd0b3e2fb",
+        "type": "Microsoft.ApiManagement/service/apis/issues/comments",
+        "name": "599e29ab193c3c0bd0b3e2fb",
+        "properties": {
+          "text": "Issue comment.",
+          "createdDate": "2018-02-01T22:21:20.467Z",
+          "userId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/1"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiOperation.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiOperation.json
new file mode 100644
index 000000000000..5c0464b76ab0
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiOperation.json
@@ -0,0 +1,53 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d2ef278aa04f0888cba3f3",
+    "operationId": "57d2ef278aa04f0ad01d6cdc"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d2ef278aa04f0888cba3f3/operations/57d2ef278aa04f0ad01d6cdc",
+        "type": "Microsoft.ApiManagement/service/apis/operations",
+        "name": "57d2ef278aa04f0ad01d6cdc",
+        "properties": {
+          "displayName": "CancelOrder",
+          "method": "POST",
+          "urlTemplate": "/?soapAction=http://tempuri.org/IFazioService/CancelOrder",
+          "templateParameters": [],
+          "request": {
+            "description": "IFazioService_CancelOrder_InputMessage",
+            "queryParameters": [],
+            "headers": [],
+            "representations": [
+              {
+                "contentType": "text/xml",
+                "sample": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n<Envelope xmlns=\"http://schemas.xmlsoap.org/soap/envelope/\">\r\n  <Body>\r\n    <CancelOrder xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns=\"http://tempuri.org/\">\r\n      <orderId>1</orderId>\r\n    </CancelOrder>\r\n  </Body>\r\n</Envelope>",
+                "schemaId": "6980a395-f08b-4a59-8295-1440cbd909b8",
+                "typeName": "CancelOrder"
+              }
+            ]
+          },
+          "responses": [
+            {
+              "statusCode": 200,
+              "description": "IFazioService_CancelOrder_OutputMessage",
+              "representations": [
+                {
+                  "contentType": "text/xml",
+                  "sample": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n<Envelope xmlns=\"http://schemas.xmlsoap.org/soap/envelope/\">\r\n  <Body>\r\n    <CancelOrderResponse xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns=\"http://tempuri.org/\">\r\n      <CancelOrderResult>1</CancelOrderResult>\r\n    </CancelOrderResponse>\r\n  </Body>\r\n</Envelope>",
+                  "schemaId": "6980a395-f08b-4a59-8295-1440cbd909b8",
+                  "typeName": "CancelOrderResponse"
+                }
+              ],
+              "headers": []
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiOperationPetStore.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiOperationPetStore.json
new file mode 100644
index 000000000000..36c0d5d08e06
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiOperationPetStore.json
@@ -0,0 +1,91 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "swagger-petstore",
+    "operationId": "loginUser"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/swagger-petstore/operations/loginUser",
+        "type": "Microsoft.ApiManagement/service/apis/operations",
+        "name": "loginUser",
+        "properties": {
+          "displayName": "Logs user into the system",
+          "method": "GET",
+          "urlTemplate": "/user/login?username={username}&password={password}",
+          "templateParameters": [
+            {
+              "name": "username",
+              "description": "The user name for login",
+              "type": "string",
+              "required": true,
+              "values": []
+            },
+            {
+              "name": "password",
+              "description": "The password for login in clear text",
+              "type": "string",
+              "required": true,
+              "values": []
+            }
+          ],
+          "description": "",
+          "request": {
+            "queryParameters": [],
+            "headers": [],
+            "representations": []
+          },
+          "responses": [
+            {
+              "statusCode": 200,
+              "description": "successful operation",
+              "representations": [
+                {
+                  "contentType": "application/xml",
+                  "schemaId": "5ba91a35f373b513a0bf31c6",
+                  "typeName": "UserLoginGet200ApplicationXmlResponse"
+                },
+                {
+                  "contentType": "application/json",
+                  "schemaId": "5ba91a35f373b513a0bf31c6",
+                  "typeName": "UserLoginGet200ApplicationJsonResponse"
+                }
+              ],
+              "headers": [
+                {
+                  "name": "X-Rate-Limit",
+                  "description": "calls per hour allowed by the user",
+                  "type": "integer",
+                  "values": []
+                },
+                {
+                  "name": "X-Expires-After",
+                  "description": "date in UTC when token expires",
+                  "type": "string",
+                  "values": []
+                }
+              ]
+            },
+            {
+              "statusCode": 400,
+              "description": "Invalid username/password supplied",
+              "representations": [
+                {
+                  "contentType": "application/xml"
+                },
+                {
+                  "contentType": "application/json"
+                }
+              ],
+              "headers": []
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiOperationPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiOperationPolicy.json
new file mode 100644
index 000000000000..26ca96ba015e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiOperationPolicy.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "5600b539c53f5b0062040001",
+    "operationId": "5600b53ac53f5b0062080006",
+    "policyId": "policy"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/5600b539c53f5b0062040001/operations/5600b53ac53f5b0062080006/policies/policy",
+        "type": "Microsoft.ApiManagement/service/apis/operations/policies",
+        "name": "policy",
+        "properties": {
+          "value": "<policies>\r\n  <inbound>\r\n    <base />\r\n  </inbound>\r\n  <backend>\r\n    <base />\r\n  </backend>\r\n  <outbound>\r\n    <base />\r\n    <set-header name=\"X-My-Sample\" exists-action=\"override\">\r\n      <value>This is a sample</value>\r\n      <!-- for multiple headers with the same name add additional value elements -->\r\n    </set-header>\r\n    <jsonp callback-parameter-name=\"ProcessResponse\" />\r\n  </outbound>\r\n</policies>"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiOperationTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiOperationTag.json
new file mode 100644
index 000000000000..055fd572cb51
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiOperationTag.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "59d6bb8f1f7fab13dc67ec9b",
+    "operationId": "59d6bb8f1f7fab13dc67ec9a",
+    "tagId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/59306a29e4bbd510dc24e5f9",
+        "type": "Microsoft.ApiManagement/service/tags",
+        "name": "59306a29e4bbd510dc24e5f9",
+        "properties": {
+          "displayName": "tag1"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiPolicy.json
new file mode 100644
index 000000000000..995a504b5642
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiPolicy.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "5600b59475ff190048040001",
+    "policyId": "policy"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/5600b59475ff190048040001/policies/policy",
+        "type": "Microsoft.ApiManagement/service/apis/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    - Position the <base> element within a section element to inherit all policies from the corresponding section element in the enclosing scope.\r\n    - Remove the <base> element to prevent inheriting policies from the corresponding section element in the enclosing scope.\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    <quota-by-key calls=\"5\" bandwidth=\"2\" renewal-period=\"&#x9;P3Y6M4DT12H30M5S\" counter-key=\"ba\" />\r\n    <base />\r\n  </inbound>\r\n  <backend>\r\n    <base />\r\n  </backend>\r\n  <outbound>\r\n    <log-to-eventhub logger-id=\"apimService1\" partition-key=\"@(context.Subscription.Id)\">\r\n@{\r\n\tRandom Random = new Random();\r\n\t\t\t\tconst string Chars = \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz \";                \r\n                return string.Join(\",\", DateTime.UtcNow, new string(\r\n                    Enumerable.Repeat(Chars, Random.Next(2150400))\r\n                              .Select(s =&gt; s[Random.Next(s.Length)])\r\n                              .ToArray()));\r\n          }                           \r\n                        </log-to-eventhub>\r\n    <base />\r\n  </outbound>\r\n</policies>"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiRelease.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiRelease.json
new file mode 100644
index 000000000000..798233bf70fd
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiRelease.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "a1",
+    "releaseId": "5a7cb545298324c53224a799"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/a1/releases/5a7cb545298324c53224a799",
+        "type": "Microsoft.ApiManagement/service/apis/releases",
+        "name": "5a7cb545298324c53224a799",
+        "properties": {
+          "apiId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/a1",
+          "createdDateTime": "2018-02-08T20:38:29.173Z",
+          "updatedDateTime": "2018-02-08T20:38:29.173Z",
+          "notes": "yahoo"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiRevision.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiRevision.json
new file mode 100644
index 000000000000..38b114917cdc
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiRevision.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "echo-api;rev=3"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/echo-api;rev=3",
+        "type": "Microsoft.ApiManagement/service/apis",
+        "name": "echo-api;rev=3",
+        "properties": {
+          "displayName": "Service",
+          "apiRevision": "3",
+          "serviceUrl": "https://api.plexonline.com/DataSource/Service.asmx",
+          "path": "schulte",
+          "protocols": [
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "apiRevisionDescription": "fixed bug in contract"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiSchema.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiSchema.json
new file mode 100644
index 000000000000..802a8f21adb3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiSchema.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "59d6bb8f1f7fab13dc67ec9b",
+    "schemaId": "ec12520d-9d48-4e7b-8f39-698ca2ac63f1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/59d6bb8f1f7fab13dc67ec9b/schemas/ec12520d-9d48-4e7b-8f39-698ca2ac63f1",
+        "type": "Microsoft.ApiManagement/service/apis/schemas",
+        "name": "ec12520d-9d48-4e7b-8f39-698ca2ac63f1",
+        "properties": {
+          "contentType": "application/vnd.ms-azure-apim.xsd+xml",
+          "document": {
+            "value": "<s:schema elementFormDefault=\"qualified\" targetNamespace=\"http://ws.cdyne.com/WeatherWS/\" xmlns:tns=\"http://ws.cdyne.com/WeatherWS/\" xmlns:s=\"http://www.w3.org/2001/XMLSchema\" xmlns:soap12=\"http://schemas.xmlsoap.org/wsdl/soap12/\" xmlns:mime=\"http://schemas.xmlsoap.org/wsdl/mime/\" xmlns:soap=\"http://schemas.xmlsoap.org/wsdl/soap/\" xmlns:tm=\"http://microsoft.com/wsdl/mime/textMatching/\" xmlns:http=\"http://schemas.xmlsoap.org/wsdl/http/\" xmlns:soapenc=\"http://schemas.xmlsoap.org/soap/encoding/\" xmlns:wsdl=\"http://schemas.xmlsoap.org/wsdl/\" xmlns:apim-wsdltns=\"http://ws.cdyne.com/WeatherWS/\">\r\n  <s:element name=\"GetWeatherInformation\">\r\n    <s:complexType />\r\n  </s:element>\r\n  <s:element name=\"GetWeatherInformationResponse\">\r\n    <s:complexType>\r\n      <s:sequence>\r\n        <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"GetWeatherInformationResult\" type=\"tns:ArrayOfWeatherDescription\" />\r\n      </s:sequence>\r\n    </s:complexType>\r\n  </s:element>\r\n  <s:complexType name=\"ArrayOfWeatherDescription\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"0\" maxOccurs=\"unbounded\" name=\"WeatherDescription\" type=\"tns:WeatherDescription\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:complexType name=\"WeatherDescription\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"WeatherID\" type=\"s:short\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Description\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"PictureURL\" type=\"s:string\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:element name=\"GetCityForecastByZIP\">\r\n    <s:complexType>\r\n      <s:sequence>\r\n        <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"ZIP\" type=\"s:string\" />\r\n      </s:sequence>\r\n    </s:complexType>\r\n  </s:element>\r\n  <s:element name=\"GetCityForecastByZIPResponse\">\r\n    <s:complexType>\r\n      <s:sequence>\r\n        <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"GetCityForecastByZIPResult\" type=\"tns:ForecastReturn\" />\r\n      </s:sequence>\r\n    </s:complexType>\r\n  </s:element>\r\n  <s:complexType name=\"ForecastReturn\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"Success\" type=\"s:boolean\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"ResponseText\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"State\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"City\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"WeatherStationCity\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"ForecastResult\" type=\"tns:ArrayOfForecast\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:complexType name=\"ArrayOfForecast\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"0\" maxOccurs=\"unbounded\" name=\"Forecast\" nillable=\"true\" type=\"tns:Forecast\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:complexType name=\"Forecast\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"Date\" type=\"s:dateTime\" />\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"WeatherID\" type=\"s:short\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Desciption\" type=\"s:string\" />\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"Temperatures\" type=\"tns:temp\" />\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"ProbabilityOfPrecipiation\" type=\"tns:POP\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:complexType name=\"temp\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"MorningLow\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"DaytimeHigh\" type=\"s:string\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:complexType name=\"POP\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Nighttime\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Daytime\" type=\"s:string\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:element name=\"GetCityWeatherByZIP\">\r\n    <s:complexType>\r\n      <s:sequence>\r\n        <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"ZIP\" type=\"s:string\" />\r\n      </s:sequence>\r\n    </s:complexType>\r\n  </s:element>\r\n  <s:element name=\"GetCityWeatherByZIPResponse\">\r\n    <s:complexType>\r\n      <s:sequence>\r\n        <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"GetCityWeatherByZIPResult\" type=\"tns:WeatherReturn\" />\r\n      </s:sequence>\r\n    </s:complexType>\r\n  </s:element>\r\n  <s:complexType name=\"WeatherReturn\">\r\n    <s:sequence>\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"Success\" type=\"s:boolean\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"ResponseText\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"State\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"City\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"WeatherStationCity\" type=\"s:string\" />\r\n      <s:element minOccurs=\"1\" maxOccurs=\"1\" name=\"WeatherID\" type=\"s:short\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Description\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Temperature\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"RelativeHumidity\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Wind\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Pressure\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Visibility\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"WindChill\" type=\"s:string\" />\r\n      <s:element minOccurs=\"0\" maxOccurs=\"1\" name=\"Remarks\" type=\"s:string\" />\r\n    </s:sequence>\r\n  </s:complexType>\r\n  <s:element name=\"ArrayOfWeatherDescription\" nillable=\"true\" type=\"tns:ArrayOfWeatherDescription\" />\r\n  <s:element name=\"ForecastReturn\" nillable=\"true\" type=\"tns:ForecastReturn\" />\r\n  <s:element name=\"WeatherReturn\" type=\"tns:WeatherReturn\" />\r\n</s:schema>"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiTag.json
new file mode 100644
index 000000000000..024bafe1811b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiTag.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "59d6bb8f1f7fab13dc67ec9b",
+    "tagId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/59306a29e4bbd510dc24e5f9",
+        "type": "Microsoft.ApiManagement/service/tags",
+        "name": "59306a29e4bbd510dc24e5f9",
+        "properties": {
+          "displayName": "tag1"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiTagDescription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiTagDescription.json
new file mode 100644
index 000000000000..ff6ccf9f4da6
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiTagDescription.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "59d6bb8f1f7fab13dc67ec9b",
+    "tagDescriptionId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/59d6bb8f1f7fab13dc67ec9b/tagDescriptions/59306a29e4bbd510dc24e5f9",
+        "type": "Microsoft.ApiManagement/service/apis/tagDescriptions",
+        "name": "59306a29e4bbd510dc24e5f9",
+        "properties": {
+          "tagId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/59306a29e4bbd510dc24e5f9",
+          "displayName": "tag1",
+          "description": null,
+          "externalDocsDescription": "some additional info",
+          "externalDocsUrl": "http://some_url.com"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiVersionSet.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiVersionSet.json
new file mode 100644
index 000000000000..e8a8553e1e5d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetApiVersionSet.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "versionSetId": "vs1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apiVersionSets/vs1",
+        "type": "Microsoft.ApiManagement/service/api-version-sets",
+        "name": "vs1",
+        "properties": {
+          "displayName": "Version Set 1",
+          "versioningScheme": "Segment",
+          "description": "Version configuration"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetAuthorizationServer.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetAuthorizationServer.json
new file mode 100644
index 000000000000..42ab274b2e7b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetAuthorizationServer.json
@@ -0,0 +1,43 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "authsid": "newauthServer2"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/authorizationServers/newauthServer2",
+        "type": "Microsoft.ApiManagement/service/authorizationServers",
+        "name": "newauthServer2",
+        "properties": {
+          "displayName": "test3",
+          "description": "test server",
+          "clientRegistrationEndpoint": "https://www.contoso.com/apps",
+          "authorizationEndpoint": "https://www.contoso.com/oauth2/auth",
+          "authorizationMethods": [
+            "GET"
+          ],
+          "clientAuthenticationMethod": [
+            "Basic"
+          ],
+          "tokenEndpoint": "https://www.contoso.com/oauth2/token",
+          "supportState": true,
+          "defaultScope": "read write",
+          "grantTypes": [
+            "authorizationCode",
+            "implicit"
+          ],
+          "bearerTokenSendingMethods": [
+            "authorizationHeader"
+          ],
+          "clientId": "1",
+          "resourceOwnerUsername": "un",
+          "resourceOwnerPassword": "pwd"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetBackend.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetBackend.json
new file mode 100644
index 000000000000..55925d6ed8df
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetBackend.json
@@ -0,0 +1,38 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "backendId": "sfbackend"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/backends/sfbackend",
+        "type": "Microsoft.ApiManagement/service/backends",
+        "name": "sfbackend",
+        "properties": {
+          "description": "Service Fabric Test App 1",
+          "url": "fabric:/mytestapp/mytestservice",
+          "protocol": "http",
+          "properties": {
+            "serviceFabricCluster": {
+              "managementEndpoints": [
+                "https://somecluster.com"
+              ],
+              "clientCertificatethumbprint": "EBA029198AA3E76EF0D70482626E5BCF148594A6",
+              "serverX509Names": [
+                {
+                  "name": "ServerCommonName1",
+                  "issuerCertificateThumbprint": "IssuerCertificateThumbprint1"
+                }
+              ],
+              "maxPartitionResolutionRetries": 5
+            }
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetCache.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetCache.json
new file mode 100644
index 000000000000..1cf3b2ac7be9
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetCache.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "cacheId": "westindia"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/caches/westindia",
+        "type": "Microsoft.ApiManagement/service/caches",
+        "name": "westindia",
+        "properties": {
+          "connectionString": "{{5c68d535a40f7e61103cd285}}}",
+          "description": "Redis cache instances in West India",
+          "resourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cache/Redis/contoso5"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetCertificate.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetCertificate.json
new file mode 100644
index 000000000000..fcbbbb35e154
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetCertificate.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "certificateId": "templateCert1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/templateCert1",
+        "type": "Microsoft.ApiManagement/service/certificates",
+        "name": "templateCert1",
+        "properties": {
+          "subject": "CN=mutual-authcert",
+          "thumbprint": "EBA**********************8594A6",
+          "expirationDate": "2017-04-23T17:03:41Z"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetDiagnostic.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetDiagnostic.json
new file mode 100644
index 000000000000..6d3f0580b7ff
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetDiagnostic.json
@@ -0,0 +1,56 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "diagnosticId": "applicationinsights"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/diagnostics/applicationinsights",
+        "type": "Microsoft.ApiManagement/service/diagnostics",
+        "name": "applicationinsights",
+        "properties": {
+          "alwaysLog": "allErrors",
+          "httpCorrelationProtocol": "Legacy",
+          "logClientIp": true,
+          "loggerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/loggers/aisamplingtest",
+          "sampling": {
+            "samplingType": "fixed",
+            "percentage": 100
+          },
+          "frontend": {
+            "request": {
+              "headers": [],
+              "body": {
+                "bytes": 100
+              }
+            },
+            "response": {
+              "headers": [],
+              "body": {
+                "bytes": 100
+              }
+            }
+          },
+          "backend": {
+            "request": {
+              "headers": [],
+              "body": {
+                "bytes": 100
+              }
+            },
+            "response": {
+              "headers": [],
+              "body": {
+                "bytes": 100
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetEmailTemplate.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetEmailTemplate.json
new file mode 100644
index 000000000000..164f5c26af6a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetEmailTemplate.json
@@ -0,0 +1,51 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "templateName": "newIssueNotificationMessage"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/templates/NewIssueNotificationMessage",
+        "type": "Microsoft.ApiManagement/service/templates",
+        "name": "NewIssueNotificationMessage",
+        "properties": {
+          "subject": "Your request $IssueName was received",
+          "body": "<!DOCTYPE html >\r\n<html>\r\n  <head />\r\n  <body>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">Dear $DevFirstName $DevLastName,</p>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">Thank you for contacting us. Our API team will review your issue and get back to you soon.</p>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">\r\n          Click this <a href=\"http://$DevPortalUrl/issues/$IssueId\">link</a> to view or edit your request.\r\n        </p>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">Best,</p>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">The $OrganizationName API Team</p>\r\n  </body>\r\n</html>",
+          "title": "New issue received",
+          "description": "This email is sent to developers after they create a new topic on the Issues page of the developer portal.",
+          "isDefault": true,
+          "parameters": [
+            {
+              "name": "DevFirstName",
+              "title": "Developer first name"
+            },
+            {
+              "name": "DevLastName",
+              "title": "Developer last name"
+            },
+            {
+              "name": "IssueId",
+              "title": "Issue id"
+            },
+            {
+              "name": "IssueName",
+              "title": "Issue name"
+            },
+            {
+              "name": "OrganizationName",
+              "title": "Organization name"
+            },
+            {
+              "name": "DevPortalUrl",
+              "title": "Developer portal URL"
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetGateway.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetGateway.json
new file mode 100644
index 000000000000..c760ce7fa429
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetGateway.json
@@ -0,0 +1,24 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gw1",
+        "type": "Microsoft.ApiManagement/service/gateways",
+        "name": "a1",
+        "properties": {
+          "description": "my gateway 1",
+          "locationData": {
+            "name": "my location"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetGatewayHostnameConfiguration.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetGatewayHostnameConfiguration.json
new file mode 100644
index 000000000000..43ed55ae0ecd
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetGatewayHostnameConfiguration.json
@@ -0,0 +1,24 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1",
+    "hcId": "default"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gw1/hostnameConfigurations/default",
+        "type": "Microsoft.ApiManagement/service/gateways/hostnameConfigurations",
+        "name": "default",
+        "properties": {
+          "hostname": "*",
+          "certificateId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/cert1",
+          "negotiateClientCertificate": false
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetGroup.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetGroup.json
new file mode 100644
index 000000000000..73ce437e2515
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetGroup.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "groupId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/groups/59306a29e4bbd510dc24e5f9",
+        "type": "Microsoft.ApiManagement/service/groups",
+        "name": "59306a29e4bbd510dc24e5f9",
+        "properties": {
+          "displayName": "AwesomeGroup (samiraad.onmicrosoft.com)",
+          "description": "awesome group of people",
+          "builtIn": false,
+          "type": "external",
+          "externalId": "aad://samiraad.onmicrosoft.com/groups/3773adf4-032e-4d25-9988-eaff9ca72eca"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetIdentityProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetIdentityProvider.json
new file mode 100644
index 000000000000..450389f5bd86
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetIdentityProvider.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "identityProviderName": "aadB2C"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/identityProviders/AadB2C",
+        "type": "Microsoft.ApiManagement/service/identityProviders",
+        "name": "AadB2C",
+        "properties": {
+          "clientId": "f02dafe2-b8b8-48ec-a38e-27e5c16c51e5",
+          "type": "aadB2C",
+          "authority": "login.microsoftonline.com",
+          "signinTenant": "contosoaadb2c.onmicrosoft.com",
+          "allowedTenants": [
+            "contosoaadb2c.onmicrosoft.com",
+            "contoso2aadb2c.onmicrosoft.com"
+          ],
+          "signupPolicyName": "B2C_1_policy-signup",
+          "signinPolicyName": "B2C_1_policy-signin"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetIssue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetIssue.json
new file mode 100644
index 000000000000..55d3821d55c1
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetIssue.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "issueId": "57d2ef278aa04f0ad01d6cdc"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/issues/57d2ef278aa04f0ad01d6cdc",
+        "type": "Microsoft.ApiManagement/service/issues",
+        "name": "57d2ef278aa04f0ad01d6cdc",
+        "properties": {
+          "title": "New API issue",
+          "description": "New API issue description",
+          "createdDate": "2018-02-01T22:21:20.467Z",
+          "state": "open",
+          "userId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/1",
+          "apiId": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetLogger.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetLogger.json
new file mode 100644
index 000000000000..4ce92563e2bc
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetLogger.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "loggerId": "templateLogger"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/loggers/kloudapilogger1",
+        "type": "Microsoft.ApiManagement/service/loggers",
+        "name": "kloudapilogger1",
+        "properties": {
+          "loggerType": "azureEventHub",
+          "description": "testeventhub3again",
+          "credentials": {
+            "name": "testeventhub4",
+            "connectionString": "Endpoint=sb://eventhubapim.servicebus.windows.net/;SharedAccessKeyName=Sender;SharedAccessKey=************"
+          },
+          "isBuffered": true,
+          "resourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.EventHub/namespaces/eventhubapim"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetNamedValue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetNamedValue.json
new file mode 100644
index 000000000000..df382d2de96d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetNamedValue.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "namedValueId": "testarmTemplateproperties2"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/namedValues/testarmTemplateproperties2",
+        "type": "Microsoft.ApiManagement/service/namedValues",
+        "name": "testarmTemplateproperties2",
+        "properties": {
+          "displayName": "propName",
+          "value": "propValue",
+          "tags": [
+            "foo",
+            "bar"
+          ],
+          "secret": false
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetNotification.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetNotification.json
new file mode 100644
index 000000000000..4a367d3b4e1d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetNotification.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "notificationName": "RequestPublisherNotificationMessage"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage",
+        "type": "Microsoft.ApiManagement/service/notifications",
+        "name": "RequestPublisherNotificationMessage",
+        "properties": {
+          "title": "Subscription requests (requiring approval)",
+          "description": "The following email recipients and users will receive email notifications about subscription requests for API products requiring approval.",
+          "recipients": {
+            "emails": [
+              "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/recipientEmails/contoso@live.com",
+              "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/recipientEmails/foobar!live",
+              "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/recipientEmails/foobar@live.com"
+            ],
+            "users": [
+              "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/576823d0a40f7e74ec07d642"
+            ]
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetOpenIdConnectProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetOpenIdConnectProvider.json
new file mode 100644
index 000000000000..45245354590e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetOpenIdConnectProvider.json
@@ -0,0 +1,24 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "opid": "templateOpenIdConnect2"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/openidConnectProviders/templateOpenIdConnect2",
+        "type": "Microsoft.ApiManagement/service/openidconnectproviders",
+        "name": "templateOpenIdConnect2",
+        "properties": {
+          "displayName": "templateoidprovider2",
+          "description": "open id provider template2",
+          "metadataEndpoint": "https://oidprovider-template2.net",
+          "clientId": "oidprovidertemplate2"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetPolicy.json
new file mode 100644
index 000000000000..822bfbdb3e20
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetPolicy.json
@@ -0,0 +1,21 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "policyId": "policy"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "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>"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetPolicyFormat.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetPolicyFormat.json
new file mode 100644
index 000000000000..517d609d8886
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetPolicyFormat.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "policyId": "policy",
+    "format": "rawxml"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/policies/policy",
+        "type": "Microsoft.ApiManagement/service/policies",
+        "name": "policy",
+        "properties": {
+          "format": "rawxml",
+          "value": "<!--\n    IMPORTANT:\n    - Policy elements can appear only within the <inbound>, <outbound>, <backend> section elements.\n    - Only the <forward-request> policy element can appear within the <backend> section element.\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.\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.\n    - To add a policy position the cursor at the desired insertion point and click on the round button associated with the policy.\n    - To remove a policy, delete the corresponding policy statement from the policy document.\n    - Policies are applied in the order of their appearance, from the top down.\n-->\r\n<policies>\r\n\t<inbound>\r\n\t\t<set-header name=\"correlationid\" exists-action=\"skip\">\r\n\t\t\t<value>@{\n                var guidBinary = new byte[16];\n                Array.Copy(Guid.NewGuid().ToByteArray(), 0, guidBinary, 0, 10);\n                long time = DateTime.Now.Ticks;\n                byte[] bytes = new byte[6];\n                unchecked\n                {\n                       bytes[5] = (byte)(time >> 40);\n                       bytes[4] = (byte)(time >> 32);\n                       bytes[3] = (byte)(time >> 24);\n                       bytes[2] = (byte)(time >> 16);\n                       bytes[1] = (byte)(time >> 8);\n                       bytes[0] = (byte)(time);\n                }\n                Array.Copy(bytes, 0, guidBinary, 10, 6);\n                return new Guid(guidBinary).ToString();\n            }\n            </value>\r\n\t\t</set-header>\r\n\t</inbound>\r\n\t<backend>\r\n\t\t<forward-request />\r\n\t</backend>\r\n\t<outbound />\r\n\t<on-error />\r\n</policies>"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetProduct.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetProduct.json
new file mode 100644
index 000000000000..ccff9156c0ed
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetProduct.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "unlimited"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/unlimited",
+        "type": "Microsoft.ApiManagement/service/products",
+        "name": "unlimited",
+        "properties": {
+          "displayName": "Unlimited",
+          "description": "Subscribers have completely unlimited access to the API. Administrator approval is required.",
+          "subscriptionRequired": true,
+          "approvalRequired": true,
+          "subscriptionsLimit": 1,
+          "state": "published"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetProductPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetProductPolicy.json
new file mode 100644
index 000000000000..c42f28d0033c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetProductPolicy.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "kjoshiarmTemplateProduct4",
+    "policyId": "policy"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/kjoshiarmTemplateProduct4/policies/policy",
+        "type": "Microsoft.ApiManagement/service/products/policies",
+        "name": "policy",
+        "properties": {
+          "value": "<policies>\r\n  <inbound>\r\n    <base />\r\n  </inbound>\r\n  <backend>\r\n    <base />\r\n  </backend>\r\n  <outbound>\r\n    <base />\r\n  </outbound>\r\n  <on-error>\r\n    <base />\r\n  </on-error>\r\n</policies>"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetProductTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetProductTag.json
new file mode 100644
index 000000000000..16148b03e91c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetProductTag.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "59d6bb8f1f7fab13dc67ec9b",
+    "tagId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/59306a29e4bbd510dc24e5f9",
+        "type": "Microsoft.ApiManagement/service/tags",
+        "name": "59306a29e4bbd510dc24e5f9",
+        "properties": {
+          "displayName": "tag1"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetQuotaCounterKeys.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetQuotaCounterKeys.json
new file mode 100644
index 000000000000..0653b0403b26
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetQuotaCounterKeys.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "quotaCounterKey": "ba"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "counterKey": "ba",
+            "periodKey": "0_P3Y6M4DT12H30M5S",
+            "periodStartTime": "2014-08-04T04:24:35Z",
+            "periodEndTime": "2018-02-08T16:54:40Z",
+            "value": {
+              "callsCount": 5,
+              "kbTransferred": 2.5830078125
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetQuotaCounterKeysByQuotaPeriod.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetQuotaCounterKeysByQuotaPeriod.json
new file mode 100644
index 000000000000..f2ef112d1381
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetQuotaCounterKeysByQuotaPeriod.json
@@ -0,0 +1,24 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "quotaCounterKey": "ba",
+    "quotaPeriodKey": "0_P3Y6M4DT12H30M5S"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "counterKey": "ba",
+        "periodKey": "0_P3Y6M4DT12H30M5S",
+        "periodStartTime": "2014-08-04T04:24:35Z",
+        "periodEndTime": "2018-02-08T16:54:40Z",
+        "value": {
+          "callsCount": 0,
+          "kbTransferred": 2.5625
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsByApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsByApi.json
new file mode 100644
index 000000000000..e95c28e735d0
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsByApi.json
@@ -0,0 +1,55 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "$filter": "timestamp ge datetime'2017-06-01T00:00:00' and timestamp le datetime'2017-06-04T00:00:00'"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "Echo API",
+            "apiId": "/apis/5600b59475ff190048040001",
+            "callCountSuccess": 0,
+            "callCountBlocked": 0,
+            "callCountFailed": 0,
+            "callCountOther": 0,
+            "callCountTotal": 0,
+            "bandwidth": 0,
+            "cacheHitCount": 0,
+            "cacheMissCount": 0,
+            "apiTimeAvg": 0,
+            "apiTimeMin": 0,
+            "apiTimeMax": 0,
+            "serviceTimeAvg": 0,
+            "serviceTimeMin": 0,
+            "serviceTimeMax": 0
+          },
+          {
+            "name": "httpbin",
+            "apiId": "/apis/57a03a13e4bbd5119c8b19e9",
+            "callCountSuccess": 13,
+            "callCountBlocked": 1,
+            "callCountFailed": 0,
+            "callCountOther": 0,
+            "callCountTotal": 14,
+            "bandwidth": 11019,
+            "cacheHitCount": 0,
+            "cacheMissCount": 0,
+            "apiTimeAvg": 1015.7607923076923,
+            "apiTimeMin": 330.3206,
+            "apiTimeMax": 1819.2173,
+            "serviceTimeAvg": 957.094776923077,
+            "serviceTimeMin": 215.24,
+            "serviceTimeMax": 1697.3612
+          }
+        ],
+        "count": 2,
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsByGeo.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsByGeo.json
new file mode 100644
index 000000000000..49e7e07a3913
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsByGeo.json
@@ -0,0 +1,37 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "$filter": "timestamp ge datetime'2017-06-01T00:00:00' and timestamp le datetime'2017-06-04T00:00:00'"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "country": "US",
+            "region": "WA",
+            "zip": "98052",
+            "callCountSuccess": 13,
+            "callCountBlocked": 1,
+            "callCountFailed": 0,
+            "callCountOther": 0,
+            "callCountTotal": 14,
+            "bandwidth": 11019,
+            "cacheHitCount": 0,
+            "cacheMissCount": 0,
+            "apiTimeAvg": 1015.7607923076923,
+            "apiTimeMin": 330.3206,
+            "apiTimeMax": 1819.2173,
+            "serviceTimeAvg": 957.094776923077,
+            "serviceTimeMin": 215.24,
+            "serviceTimeMax": 1697.3612
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsByOperation.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsByOperation.json
new file mode 100644
index 000000000000..2a9d7064d1f3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsByOperation.json
@@ -0,0 +1,76 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "$filter": "timestamp ge datetime'2017-06-01T00:00:00' and timestamp le datetime'2017-06-04T00:00:00'"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "get",
+            "apiId": "/apis/57a03a13e4bbd5119c8b19e9",
+            "operationId": "/apis/57a03a13e4bbd5119c8b19e9/operations/57a03a1dd8d14f0a780d7d14",
+            "callCountSuccess": 13,
+            "callCountBlocked": 1,
+            "callCountFailed": 0,
+            "callCountOther": 0,
+            "callCountTotal": 14,
+            "bandwidth": 11019,
+            "cacheHitCount": 0,
+            "cacheMissCount": 0,
+            "apiTimeAvg": 1015.7607923076923,
+            "apiTimeMin": 330.3206,
+            "apiTimeMax": 1819.2173,
+            "serviceTimeAvg": 957.094776923077,
+            "serviceTimeMin": 215.24,
+            "serviceTimeMax": 1697.3612
+          },
+          {
+            "name": "GetWeatherInformation",
+            "apiId": "/apis/57c999d1e4bbd50c988cb2c3",
+            "operationId": "/apis/57c999d1e4bbd50c988cb2c3/operations/57c999d1e4bbd50df889c93e",
+            "callCountSuccess": 0,
+            "callCountBlocked": 0,
+            "callCountFailed": 0,
+            "callCountOther": 0,
+            "callCountTotal": 0,
+            "bandwidth": 0,
+            "cacheHitCount": 0,
+            "cacheMissCount": 0,
+            "apiTimeAvg": 0,
+            "apiTimeMin": 0,
+            "apiTimeMax": 0,
+            "serviceTimeAvg": 0,
+            "serviceTimeMin": 0,
+            "serviceTimeMax": 0
+          },
+          {
+            "name": "GetCityForecastByZIP",
+            "apiId": "/apis/57c999d1e4bbd50c988cb2c3",
+            "operationId": "/apis/57c999d1e4bbd50c988cb2c3/operations/57c999d1e4bbd50df889c93f",
+            "callCountSuccess": 0,
+            "callCountBlocked": 0,
+            "callCountFailed": 0,
+            "callCountOther": 0,
+            "callCountTotal": 0,
+            "bandwidth": 0,
+            "cacheHitCount": 0,
+            "cacheMissCount": 0,
+            "apiTimeAvg": 0,
+            "apiTimeMin": 0,
+            "apiTimeMax": 0,
+            "serviceTimeAvg": 0,
+            "serviceTimeMin": 0,
+            "serviceTimeMax": 0
+          }
+        ],
+        "count": 3,
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsByProduct.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsByProduct.json
new file mode 100644
index 000000000000..630133ed867a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsByProduct.json
@@ -0,0 +1,55 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "$filter": "timestamp ge datetime'2017-06-01T00:00:00' and timestamp le datetime'2017-06-04T00:00:00'"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "Starter",
+            "productId": "/products/5600b59475ff190048060001",
+            "callCountSuccess": 0,
+            "callCountBlocked": 0,
+            "callCountFailed": 0,
+            "callCountOther": 0,
+            "callCountTotal": 0,
+            "bandwidth": 0,
+            "cacheHitCount": 0,
+            "cacheMissCount": 0,
+            "apiTimeAvg": 0,
+            "apiTimeMin": 0,
+            "apiTimeMax": 0,
+            "serviceTimeAvg": 0,
+            "serviceTimeMin": 0,
+            "serviceTimeMax": 0
+          },
+          {
+            "name": "Unlimited",
+            "productId": "/products/5600b59475ff190048060002",
+            "callCountSuccess": 13,
+            "callCountBlocked": 1,
+            "callCountFailed": 0,
+            "callCountOther": 0,
+            "callCountTotal": 14,
+            "bandwidth": 11019,
+            "cacheHitCount": 0,
+            "cacheMissCount": 0,
+            "apiTimeAvg": 1015.7607923076923,
+            "apiTimeMin": 330.3206,
+            "apiTimeMax": 1819.2173,
+            "serviceTimeAvg": 957.094776923077,
+            "serviceTimeMin": 215.24,
+            "serviceTimeMax": 1697.3612
+          }
+        ],
+        "count": 2,
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsByRequest.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsByRequest.json
new file mode 100644
index 000000000000..b670d169f40b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsByRequest.json
@@ -0,0 +1,56 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "$filter": "timestamp ge datetime'2017-06-01T00:00:00' and timestamp le datetime'2017-06-04T00:00:00'"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "apiId": "/apis/5931a75ae4bbd512a88c680b",
+            "operationId": "/apis/5931a75ae4bbd512a88c680b/operations/-",
+            "productId": "/products/-",
+            "userId": "/users/1",
+            "method": "GET",
+            "url": "https://apimService1.azure-api.net/echo/resource?param1=sample",
+            "ipAddress": "207.xx.155.xx",
+            "responseCode": 404,
+            "responseSize": 405,
+            "timestamp": "2017-06-03T00:17:00.1649134Z",
+            "cache": "none",
+            "apiTime": 221.1544,
+            "serviceTime": 0.0,
+            "apiRegion": "East Asia",
+            "subscriptionId": "/subscriptions/5600b59475ff190048070002",
+            "requestId": "63e7119c-26aa-433c-96d7-f6f3267ff52f",
+            "requestSize": 0
+          },
+          {
+            "apiId": "/apis/5931a75ae4bbd512a88c680b",
+            "operationId": "/apis/5931a75ae4bbd512a88c680b/operations/-",
+            "productId": "/products/-",
+            "userId": "/users/1",
+            "method": "POST",
+            "url": "https://apimService1.azure-api.net/echo/resource",
+            "ipAddress": "207.xx.155.xx",
+            "responseCode": 404,
+            "responseSize": 403,
+            "timestamp": "2017-06-03T00:17:20.5255131Z",
+            "cache": "none",
+            "apiTime": 6.6754000000000007,
+            "serviceTime": 0.0,
+            "apiRegion": "East Asia",
+            "subscriptionId": "/subscriptions/5600b59475ff190048070002",
+            "requestId": "e581b7f7-c9ec-4fc6-8ab9-3855d9b00b04",
+            "requestSize": 0
+          }
+        ],
+        "count": 2
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsBySubscription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsBySubscription.json
new file mode 100644
index 000000000000..f75c8f550110
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsBySubscription.json
@@ -0,0 +1,79 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "$filter": "timestamp ge datetime'2017-06-01T00:00:00' and timestamp le datetime'2017-06-04T00:00:00'"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "",
+            "userId": "/users/1",
+            "productId": "/products/5600b59475ff190048060001",
+            "subscriptionId": "/subscriptions/5600b59475ff190048070001",
+            "callCountSuccess": 0,
+            "callCountBlocked": 0,
+            "callCountFailed": 0,
+            "callCountOther": 0,
+            "callCountTotal": 0,
+            "bandwidth": 0,
+            "cacheHitCount": 0,
+            "cacheMissCount": 0,
+            "apiTimeAvg": 0,
+            "apiTimeMin": 0,
+            "apiTimeMax": 0,
+            "serviceTimeAvg": 0,
+            "serviceTimeMin": 0,
+            "serviceTimeMax": 0
+          },
+          {
+            "name": "",
+            "userId": "/users/1",
+            "productId": "/products/5600b59475ff190048060002",
+            "subscriptionId": "/subscriptions/5600b59475ff190048070002",
+            "callCountSuccess": 13,
+            "callCountBlocked": 1,
+            "callCountFailed": 0,
+            "callCountOther": 0,
+            "callCountTotal": 14,
+            "bandwidth": 11019,
+            "cacheHitCount": 0,
+            "cacheMissCount": 0,
+            "apiTimeAvg": 1015.7607923076923,
+            "apiTimeMin": 330.3206,
+            "apiTimeMax": 1819.2173,
+            "serviceTimeAvg": 957.094776923077,
+            "serviceTimeMin": 215.24,
+            "serviceTimeMax": 1697.3612
+          },
+          {
+            "name": "",
+            "userId": "/users/1",
+            "productId": "/products/5702e97e5157a50f48dce801",
+            "subscriptionId": "/subscriptions/5702e97e5157a50a9c733303",
+            "callCountSuccess": 0,
+            "callCountBlocked": 0,
+            "callCountFailed": 0,
+            "callCountOther": 0,
+            "callCountTotal": 0,
+            "bandwidth": 0,
+            "cacheHitCount": 0,
+            "cacheMissCount": 0,
+            "apiTimeAvg": 0,
+            "apiTimeMin": 0,
+            "apiTimeMax": 0,
+            "serviceTimeAvg": 0,
+            "serviceTimeMin": 0,
+            "serviceTimeMax": 0
+          }
+        ],
+        "count": 3,
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsByTime.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsByTime.json
new file mode 100644
index 000000000000..a9dc75e37c26
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsByTime.json
@@ -0,0 +1,56 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "$filter": "timestamp ge datetime'2017-06-01T00:00:00' and timestamp le datetime'2017-06-04T00:00:00'",
+    "interval": "PT15M"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "timestamp": "2017-06-03T00:15:00Z",
+            "interval": "PT15M",
+            "callCountSuccess": 4,
+            "callCountBlocked": 0,
+            "callCountFailed": 0,
+            "callCountOther": 0,
+            "callCountTotal": 4,
+            "bandwidth": 3243,
+            "cacheHitCount": 0,
+            "cacheMissCount": 0,
+            "apiTimeAvg": 1337.46335,
+            "apiTimeMin": 885.0839000000001,
+            "apiTimeMax": 1819.2173,
+            "serviceTimeAvg": 1255.917425,
+            "serviceTimeMin": 882.8264,
+            "serviceTimeMax": 1697.3612
+          },
+          {
+            "timestamp": "2017-06-03T00:30:00Z",
+            "interval": "PT15M",
+            "callCountSuccess": 9,
+            "callCountBlocked": 1,
+            "callCountFailed": 0,
+            "callCountOther": 0,
+            "callCountTotal": 10,
+            "bandwidth": 7776,
+            "cacheHitCount": 0,
+            "cacheMissCount": 0,
+            "apiTimeAvg": 872.7818777777778,
+            "apiTimeMin": 330.3206,
+            "apiTimeMax": 1093.8407,
+            "serviceTimeAvg": 824.2847111111112,
+            "serviceTimeMin": 215.24,
+            "serviceTimeMax": 973.2262000000001
+          }
+        ],
+        "count": 2,
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsByUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsByUser.json
new file mode 100644
index 000000000000..deade91b9d06
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetReportsByUser.json
@@ -0,0 +1,73 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "$filter": "timestamp ge datetime'2017-06-01T00:00:00' and timestamp le datetime'2017-06-04T00:00:00'"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "Administrator",
+            "userId": "/users/1",
+            "callCountSuccess": 13,
+            "callCountBlocked": 1,
+            "callCountFailed": 0,
+            "callCountOther": 0,
+            "callCountTotal": 14,
+            "bandwidth": 11019,
+            "cacheHitCount": 0,
+            "cacheMissCount": 0,
+            "apiTimeAvg": 1015.7607923076923,
+            "apiTimeMin": 330.3206,
+            "apiTimeMax": 1819.2173,
+            "serviceTimeAvg": 957.094776923077,
+            "serviceTimeMin": 215.24,
+            "serviceTimeMax": 1697.3612
+          },
+          {
+            "name": "Samir Solanki",
+            "userId": "/users/56eaec62baf08b06e46d27fd",
+            "callCountSuccess": 0,
+            "callCountBlocked": 0,
+            "callCountFailed": 0,
+            "callCountOther": 0,
+            "callCountTotal": 0,
+            "bandwidth": 0,
+            "cacheHitCount": 0,
+            "cacheMissCount": 0,
+            "apiTimeAvg": 0,
+            "apiTimeMin": 0,
+            "apiTimeMax": 0,
+            "serviceTimeAvg": 0,
+            "serviceTimeMin": 0,
+            "serviceTimeMax": 0
+          },
+          {
+            "name": "Anonymous",
+            "userId": "/users/54c800b332965a0035030000",
+            "callCountSuccess": 0,
+            "callCountBlocked": 0,
+            "callCountFailed": 0,
+            "callCountOther": 0,
+            "callCountTotal": 0,
+            "bandwidth": 0,
+            "cacheHitCount": 0,
+            "cacheMissCount": 0,
+            "apiTimeAvg": 0,
+            "apiTimeMin": 0,
+            "apiTimeMax": 0,
+            "serviceTimeAvg": 0,
+            "serviceTimeMin": 0,
+            "serviceTimeMax": 0
+          }
+        ],
+        "count": 3,
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetSubscription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetSubscription.json
new file mode 100644
index 000000000000..84d2974d6d83
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetSubscription.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "sid": "5931a769d8d14f0ad8ce13b8"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/subscriptions/5931a769d8d14f0ad8ce13b8",
+        "type": "Microsoft.ApiManagement/service/subscriptions",
+        "name": "5931a769d8d14f0ad8ce13b8",
+        "properties": {
+          "ownerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/5931a75ae4bbd512a88c680b",
+          "scope": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5600b59475ff190048060002",
+          "displayName": "Unlimited",
+          "state": "submitted",
+          "createdDate": "2017-06-02T17:59:06.223Z"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetTag.json
new file mode 100644
index 000000000000..e4072fabff76
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetTag.json
@@ -0,0 +1,21 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "tagId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/59306a29e4bbd510dc24e5f9",
+        "type": "Microsoft.ApiManagement/service/tags",
+        "name": "59306a29e4bbd510dc24e5f9",
+        "properties": {
+          "displayName": "tag1"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetTenantAccess.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetTenantAccess.json
new file mode 100644
index 000000000000..8350fc3b43cd
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetTenantAccess.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "accessName": "access"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "5600b59375ff190048030003",
+        "enabled": true
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetUser.json
new file mode 100644
index 000000000000..24ef2e280dd4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementGetUser.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "userId": "5931a75ae4bbd512a88c680b"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/5931a75ae4bbd512a88c680b",
+        "type": "Microsoft.ApiManagement/service/users",
+        "name": "5931a75ae4bbd512a88c680b",
+        "properties": {
+          "firstName": "foo",
+          "lastName": "bar",
+          "email": "foobar@outlook.com",
+          "state": "active",
+          "registrationDate": "2017-06-02T17:58:50.357Z",
+          "identities": [
+            {
+              "provider": "Microsoft",
+              "id": "*************"
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApi.json
new file mode 100644
index 000000000000..85bccbd8d42b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApi.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d1f7558aa04f15146d9d8a"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiDiagnostic.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiDiagnostic.json
new file mode 100644
index 000000000000..00f32f58942f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiDiagnostic.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "diagnosticId": "applicationinsights",
+    "apiId": "57d1f7558aa04f15146d9d8a"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiIssue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiIssue.json
new file mode 100644
index 000000000000..7e44ad77d5c7
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiIssue.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d2ef278aa04f0888cba3f3",
+    "issueId": "57d2ef278aa04f0ad01d6cdc"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiIssueAttachment.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiIssueAttachment.json
new file mode 100644
index 000000000000..a1e9ce4e31c9
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiIssueAttachment.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d2ef278aa04f0888cba3f3",
+    "issueId": "57d2ef278aa04f0ad01d6cdc",
+    "attachmentId": "57d2ef278aa04f0888cba3f3"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiIssueComment.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiIssueComment.json
new file mode 100644
index 000000000000..b9fe83eabc80
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiIssueComment.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d2ef278aa04f0888cba3f3",
+    "issueId": "57d2ef278aa04f0ad01d6cdc",
+    "commentId": "599e29ab193c3c0bd0b3e2fb"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiOperation.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiOperation.json
new file mode 100644
index 000000000000..fdda0be096f3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiOperation.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d2ef278aa04f0888cba3f3",
+    "operationId": "57d2ef278aa04f0ad01d6cdc"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiOperationPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiOperationPolicy.json
new file mode 100644
index 000000000000..da51270cfaa3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiOperationPolicy.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "5600b539c53f5b0062040001",
+    "operationId": "5600b53ac53f5b0062080006",
+    "policyId": "policy"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiOperationTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiOperationTag.json
new file mode 100644
index 000000000000..8a6d8cef277a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiOperationTag.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "59d6bb8f1f7fab13dc67ec9b",
+    "operationId": "59d6bb8f1f7fab13dc67ec9a",
+    "tagId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Etag": "AAAAAAAACCI="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiPolicy.json
new file mode 100644
index 000000000000..4bb689e7da45
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiPolicy.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d1f7558aa04f15146d9d8a",
+    "policyId": "policy"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiRelease.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiRelease.json
new file mode 100644
index 000000000000..e31510a42aa4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiRelease.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "a1",
+    "releaseId": "5a7cb545298324c53224a799"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiSchema.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiSchema.json
new file mode 100644
index 000000000000..4dab8a4ce1ea
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiSchema.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d1f7558aa04f15146d9d8a",
+    "schemaId": "ec12520d-9d48-4e7b-8f39-698ca2ac63f1"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiTag.json
new file mode 100644
index 000000000000..7ded5d9c5359
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiTag.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "59d6bb8f1f7fab13dc67ec9b",
+    "tagId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Etag": "AAAAAAAACCI="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiTagDescription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiTagDescription.json
new file mode 100644
index 000000000000..bb2529d1e87b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiTagDescription.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "59d6bb8f1f7fab13dc67ec9b",
+    "tagDescriptionId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Etag": "AAAAAAAACCI="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiVersionSet.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiVersionSet.json
new file mode 100644
index 000000000000..387a30f214ee
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadApiVersionSet.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "versionSetId": "vs1"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadAuthorizationServer.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadAuthorizationServer.json
new file mode 100644
index 000000000000..1126b19c9525
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadAuthorizationServer.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "authsid": "newauthServer2"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadBackend.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadBackend.json
new file mode 100644
index 000000000000..8d44e882d591
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadBackend.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "backendId": "sfbackend"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadCache.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadCache.json
new file mode 100644
index 000000000000..b76b7e9a21a3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadCache.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "cacheId": "default"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadCertificate.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadCertificate.json
new file mode 100644
index 000000000000..15d35ca4af2d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadCertificate.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "certificateId": "templateCert1"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadDelegationSettings.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadDelegationSettings.json
new file mode 100644
index 000000000000..36930e9eecc3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadDelegationSettings.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadDiagnostic.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadDiagnostic.json
new file mode 100644
index 000000000000..709448b49070
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadDiagnostic.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "diagnosticId": "applicationinsights"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadEmailTemplate.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadEmailTemplate.json
new file mode 100644
index 000000000000..e2fa0844a970
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadEmailTemplate.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "templateName": "newIssueNotificationMessage"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadGateway.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadGateway.json
new file mode 100644
index 000000000000..430a5dfb0db0
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadGateway.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "gatewayId": "mygateway"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadGatewayApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadGatewayApi.json
new file mode 100644
index 000000000000..9591eba34b53
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadGatewayApi.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1",
+    "apiId": "api1"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Etag": "AAAAAAAACCI="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadGatewayHostnameConfiguration.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadGatewayHostnameConfiguration.json
new file mode 100644
index 000000000000..e61e9633bb49
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadGatewayHostnameConfiguration.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1",
+    "hcId": "default"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadGroup.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadGroup.json
new file mode 100644
index 000000000000..b0cc989b7e1d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadGroup.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "groupId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadGroupUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadGroupUser.json
new file mode 100644
index 000000000000..4a1acb756409
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadGroupUser.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "groupId": "59306a29e4bbd510dc24e5f9",
+    "userId": "5931a75ae4bbd512a88c680b"
+  },
+  "responses": {
+    "204": {},
+    "404": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadIdentityProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadIdentityProvider.json
new file mode 100644
index 000000000000..436349ed4f48
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadIdentityProvider.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "identityProviderName": "aadB2C"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadLogger.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadLogger.json
new file mode 100644
index 000000000000..86a44a82ffcc
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadLogger.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "loggerId": "templateLogger"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadNamedValue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadNamedValue.json
new file mode 100644
index 000000000000..3f6295792b85
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadNamedValue.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "namedValueId": "testarmTemplateproperties2"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadNotificationRecipientEmail.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadNotificationRecipientEmail.json
new file mode 100644
index 000000000000..28d3d872456c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadNotificationRecipientEmail.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "notificationName": "RequestPublisherNotificationMessage",
+    "email": "contoso@live.com"
+  },
+  "responses": {
+    "204": {},
+    "404": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadNotificationRecipientUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadNotificationRecipientUser.json
new file mode 100644
index 000000000000..cfc970b46b4c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadNotificationRecipientUser.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "notificationName": "RequestPublisherNotificationMessage",
+    "userId": "576823d0a40f7e74ec07d642"
+  },
+  "responses": {
+    "204": {},
+    "404": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadOpenIdConnectProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadOpenIdConnectProvider.json
new file mode 100644
index 000000000000..09faa8db96c6
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadOpenIdConnectProvider.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "opid": "templateOpenIdConnect2"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadPolicy.json
new file mode 100644
index 000000000000..60000cc050ed
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadPolicy.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "policyId": "policy"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadProduct.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadProduct.json
new file mode 100644
index 000000000000..9270e85d7a25
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadProduct.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "unlimited"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadProductApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadProductApi.json
new file mode 100644
index 000000000000..1b7c8837cd2d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadProductApi.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "5931a75ae4bbd512a88c680b",
+    "apiId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadProductGroup.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadProductGroup.json
new file mode 100644
index 000000000000..f8a9fe5ce67f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadProductGroup.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "5931a75ae4bbd512a88c680b",
+    "groupId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadProductPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadProductPolicy.json
new file mode 100644
index 000000000000..b81de558e60b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadProductPolicy.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "unlimited",
+    "policyId": "policy"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadProductTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadProductTag.json
new file mode 100644
index 000000000000..d1feedd77266
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadProductTag.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "59306a29e4bbd510dc24e5f8",
+    "tagId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Etag": "AAAAAAAACCI="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadSignInSettings.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadSignInSettings.json
new file mode 100644
index 000000000000..36930e9eecc3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadSignInSettings.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadSignUpSettings.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadSignUpSettings.json
new file mode 100644
index 000000000000..36930e9eecc3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadSignUpSettings.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadSubscription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadSubscription.json
new file mode 100644
index 000000000000..04b01db486cd
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadSubscription.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "sid": "5931a769d8d14f0ad8ce13b8"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadTag.json
new file mode 100644
index 000000000000..77299ad98953
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadTag.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "tagId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Etag": "AAAAAAAACCI="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadTenantAccess.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadTenantAccess.json
new file mode 100644
index 000000000000..f90a86381063
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadTenantAccess.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "accessName": "access"
+  },
+  "responses": {
+    "200": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadUser.json
new file mode 100644
index 000000000000..b5f5a865b5cb
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementHeadUser.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "userId": "5931a75ae4bbd512a88c680b"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiDiagnostics.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiDiagnostics.json
new file mode 100644
index 000000000000..563cac91f5b0
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiDiagnostics.json
@@ -0,0 +1,60 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "echo-api"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/echo-api/diagnostics/applicationinsights",
+            "type": "Microsoft.ApiManagement/service/apis/diagnostics",
+            "name": "applicationinsights",
+            "properties": {
+              "alwaysLog": "allErrors",
+              "httpCorrelationProtocol": "Legacy",
+              "logClientIp": true,
+              "loggerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/loggers/aisamplingtest",
+              "sampling": {
+                "samplingType": "fixed",
+                "percentage": 100
+              },
+              "frontend": {
+                "request": {
+                  "headers": [],
+                  "body": {
+                    "bytes": 100
+                  }
+                },
+                "response": {
+                  "headers": [],
+                  "body": {
+                    "bytes": 100
+                  }
+                }
+              },
+              "backend": {
+                "request": {
+                  "headers": [],
+                  "body": {
+                    "bytes": 100
+                  }
+                },
+                "response": {
+                  "headers": [],
+                  "body": {
+                    "bytes": 100
+                  }
+                }
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiIssueAttachments.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiIssueAttachments.json
new file mode 100644
index 000000000000..02da761d7375
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiIssueAttachments.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d1f7558aa04f15146d9d8a",
+    "issueId": "57d2ef278aa04f0ad01d6cdc"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a/issues/57d2ef278aa04f0ad01d6cdc/attachments/57d2ef278aa04f0888cba3f3",
+            "type": "Microsoft.ApiManagement/service/apis/issues/attachments",
+            "name": "57d2ef278aa04f0888cba3f3",
+            "properties": {
+              "title": "Issue attachment.",
+              "contentFormat": "link",
+              "content": "https://.../image.jpg"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiIssueComments.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiIssueComments.json
new file mode 100644
index 000000000000..23b11effb7ae
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiIssueComments.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d1f7558aa04f15146d9d8a",
+    "issueId": "57d2ef278aa04f0ad01d6cdc"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a/issues/57d2ef278aa04f0ad01d6cdc/comments/599e29ab193c3c0bd0b3e2fb",
+            "type": "Microsoft.ApiManagement/service/apis/issues/comments",
+            "name": "599e29ab193c3c0bd0b3e2fb",
+            "properties": {
+              "text": "Issue comment.",
+              "createdDate": "2018-02-01T22:21:20.467Z",
+              "userId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/1"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiIssues.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiIssues.json
new file mode 100644
index 000000000000..5d4360156978
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiIssues.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d1f7558aa04f15146d9d8a"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a/issues/57d2ef278aa04f0ad01d6cdc",
+            "type": "Microsoft.ApiManagement/service/apis/issues",
+            "name": "57d2ef278aa04f0ad01d6cdc",
+            "properties": {
+              "title": "New API issue",
+              "description": "New API issue description",
+              "createdDate": "2018-02-01T22:21:20.467Z",
+              "state": "open",
+              "userId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/1",
+              "apiId": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiOperationPolicies.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiOperationPolicies.json
new file mode 100644
index 000000000000..febe80801b74
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiOperationPolicies.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "599e2953193c3c0bd0b3e2fa",
+    "operationId": "599e29ab193c3c0bd0b3e2fb"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/599e2953193c3c0bd0b3e2fa/operations/599e29ab193c3c0bd0b3e2fb/policies/policy",
+            "type": "Microsoft.ApiManagement/service/apis/operations/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    - Position the <base> element within a section element to inherit all policies from the corresponding section element in the enclosing scope.\r\n    - Remove the <base> element to prevent inheriting policies from the corresponding section element in the enclosing scope.\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    <validate-jwt header-name=\"dd\">\r\n      <required-claims>\r\n        <claim name=\"bla\" separator=\"\">\r\n          <value>xxx</value>\r\n        </claim>\r\n      </required-claims>\r\n    </validate-jwt>\r\n    <base />\r\n  </inbound>\r\n  <backend>\r\n    <base />\r\n  </backend>\r\n  <outbound>\r\n    <base />\r\n  </outbound>\r\n</policies>"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiOperationTags.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiOperationTags.json
new file mode 100644
index 000000000000..d31cfd84379b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiOperationTags.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d2ef278aa04f0888cba3f3",
+    "operationId": "57d2ef278aa04f0888cba3f6"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/5600b539c53f5b0062060002",
+            "type": "Microsoft.ApiManagement/service/tags",
+            "name": "5600b539c53f5b0062060002",
+            "properties": {
+              "displayName": "tag1"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiOperations.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiOperations.json
new file mode 100644
index 000000000000..ad214d6a082d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiOperations.json
@@ -0,0 +1,69 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d2ef278aa04f0888cba3f3",
+    "operationId": "57d2ef278aa04f0ad01d6cdc"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d2ef278aa04f0888cba3f3/operations/57d2ef278aa04f0ad01d6cdc",
+            "type": "Microsoft.ApiManagement/service/apis/operations",
+            "name": "57d2ef278aa04f0ad01d6cdc",
+            "properties": {
+              "displayName": "CancelOrder",
+              "method": "POST",
+              "urlTemplate": "/?soapAction=http://tempuri.org/IFazioService/CancelOrder"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d2ef278aa04f0888cba3f3/operations/57d2ef278aa04f0ad01d6cda",
+            "type": "Microsoft.ApiManagement/service/apis/operations",
+            "name": "57d2ef278aa04f0ad01d6cda",
+            "properties": {
+              "displayName": "GetMostRecentOrder",
+              "method": "POST",
+              "urlTemplate": "/?soapAction=http://tempuri.org/IFazioService/GetMostRecentOrder"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d2ef278aa04f0888cba3f3/operations/57d2ef278aa04f0ad01d6cd9",
+            "type": "Microsoft.ApiManagement/service/apis/operations",
+            "name": "57d2ef278aa04f0ad01d6cd9",
+            "properties": {
+              "displayName": "GetOpenOrders",
+              "method": "POST",
+              "urlTemplate": "/?soapAction=http://tempuri.org/IFazioService/GetOpenOrders"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d2ef278aa04f0888cba3f3/operations/57d2ef278aa04f0ad01d6cdb",
+            "type": "Microsoft.ApiManagement/service/apis/operations",
+            "name": "57d2ef278aa04f0ad01d6cdb",
+            "properties": {
+              "displayName": "GetOrder",
+              "method": "POST",
+              "urlTemplate": "/?soapAction=http://tempuri.org/IFazioService/GetOrder"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d2ef278aa04f0888cba3f3/operations/57d2ef278aa04f0ad01d6cd8",
+            "type": "Microsoft.ApiManagement/service/apis/operations",
+            "name": "57d2ef278aa04f0ad01d6cd8",
+            "properties": {
+              "displayName": "submitOrder",
+              "method": "POST",
+              "urlTemplate": "/?soapAction=http://tempuri.org/IFazioService/submitOrder"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiOperationsByTags.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiOperationsByTags.json
new file mode 100644
index 000000000000..91f2bdb4e634
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiOperationsByTags.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "a1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "tag": {
+              "id": "/tags/apitag123",
+              "name": "awesomeTag"
+            },
+            "operation": {
+              "id": "/apis/echo-api/operations/create-resource",
+              "apiName": "Echo API",
+              "apiRevision": "1",
+              "name": "Create resource",
+              "method": "POST",
+              "urlTemplate": "/resource",
+              "description": "A demonstration of a POST call based on the echo backend above. The request body is expected to contain JSON-formatted data (see example below). A policy is used to automatically transform any request sent in JSON directly to XML. In a real-world scenario this could be used to enable modern clients to speak to a legacy backend."
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiPolicies.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiPolicies.json
new file mode 100644
index 000000000000..3ecee3bd6354
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiPolicies.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "5600b59475ff190048040001"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/5600b59475ff190048040001/policies/policy",
+            "type": "Microsoft.ApiManagement/service/apis/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    - Position the <base> element within a section element to inherit all policies from the corresponding section element in the enclosing scope.\r\n    - Remove the <base> element to prevent inheriting policies from the corresponding section element in the enclosing scope.\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    <quota-by-key calls=\"5\" bandwidth=\"2\" renewal-period=\"&#x9;P3Y6M4DT12H30M5S\" counter-key=\"ba\" />\r\n    <base />\r\n  </inbound>\r\n  <backend>\r\n    <base />\r\n  </backend>\r\n  <outbound>\r\n    <log-to-eventhub logger-id=\"apimService1\" partition-key=\"@(context.Subscription.Id)\">\r\n@{\r\n\tRandom Random = new Random();\r\n\t\t\t\tconst string Chars = \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz \";                \r\n                return string.Join(\",\", DateTime.UtcNow, new string(\r\n                    Enumerable.Repeat(Chars, Random.Next(2150400))\r\n                              .Select(s =&gt; s[Random.Next(s.Length)])\r\n                              .ToArray()));\r\n          }                           \r\n                        </log-to-eventhub>\r\n    <base />\r\n  </outbound>\r\n</policies>"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiProducts.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiProducts.json
new file mode 100644
index 000000000000..4adab5c251d0
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiProducts.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d2ef278aa04f0888cba3f3"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5600b539c53f5b0062060002",
+            "type": "Microsoft.ApiManagement/service/apis/products",
+            "name": "5600b539c53f5b0062060002",
+            "properties": {
+              "displayName": "Unlimited",
+              "description": "Subscribers have completely unlimited access to the API. Administrator approval is required.",
+              "subscriptionRequired": true,
+              "approvalRequired": true,
+              "subscriptionsLimit": 1,
+              "state": "published"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiReleases.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiReleases.json
new file mode 100644
index 000000000000..f52383b2b410
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiReleases.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "a1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/a1/releases/5a7cb545298324c53224a799",
+            "type": "Microsoft.ApiManagement/service/apis/releases",
+            "name": "5a7cb545298324c53224a799",
+            "properties": {
+              "createdDateTime": "2018-02-08T20:38:29.173Z",
+              "updatedDateTime": "2018-02-08T20:38:29.173Z",
+              "notes": "yahoo"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiRevisions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiRevisions.json
new file mode 100644
index 000000000000..6ef1385dd6cd
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiRevisions.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d2ef278aa04f0888cba3f3"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "apiId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/a1;rev=1",
+            "apiRevision": "1",
+            "createdDateTime": "2018-02-01T22:21:20.467Z",
+            "updatedDateTime": "2018-02-01T22:21:20.467Z",
+            "isOnline": true,
+            "isCurrent": true
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiSchemas.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiSchemas.json
new file mode 100644
index 000000000000..476b00f20293
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiSchemas.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "59d5b28d1f7fab116c282650"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/59d5b28d1f7fab116c282650/schemas/59d5b28e1f7fab116402044e",
+            "type": "Microsoft.ApiManagement/service/apis/schemas",
+            "name": "59d5b28e1f7fab116402044e",
+            "properties": {
+              "contentType": "application/vnd.ms-azure-apim.swagger.definitions+json"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiTagDescriptions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiTagDescriptions.json
new file mode 100644
index 000000000000..845a12dc8b9e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiTagDescriptions.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d2ef278aa04f0888cba3f3"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tagDescriptions/5600b539c53f5b0062060002",
+            "type": "Microsoft.ApiManagement/service/tags",
+            "name": "5600b539c53f5b0062060002",
+            "properties": {
+              "tagId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/5600b539c53f5b0062060002",
+              "displayName": "tag1",
+              "externalDocsDescription": "some additional info",
+              "externalDocsUrl": "http://some_url.com"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiTags.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiTags.json
new file mode 100644
index 000000000000..efd5943eccba
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiTags.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "57d2ef278aa04f0888cba3f3"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/5600b539c53f5b0062060002",
+            "type": "Microsoft.ApiManagement/service/tags",
+            "name": "5600b539c53f5b0062060002",
+            "properties": {
+              "displayName": "tag1"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiVersionSets.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiVersionSets.json
new file mode 100644
index 000000000000..1dbf8e99a755
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApiVersionSets.json
@@ -0,0 +1,37 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apiVersionSets/vs1",
+            "type": "Microsoft.ApiManagement/service/api-version-sets",
+            "name": "vs1",
+            "properties": {
+              "displayName": "api set 1",
+              "versioningScheme": "Segment",
+              "description": "Version configuration"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apiVersionSets/vs2",
+            "type": "Microsoft.ApiManagement/service/api-version-sets",
+            "name": "vs2",
+            "properties": {
+              "displayName": "api set 2",
+              "versioningScheme": "Query",
+              "description": "Version configuration 2"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApis.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApis.json
new file mode 100644
index 000000000000..ac4646c73025
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApis.json
@@ -0,0 +1,81 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/a1",
+            "type": "Microsoft.ApiManagement/service/apis",
+            "name": "a1",
+            "properties": {
+              "displayName": "api1",
+              "apiRevision": "1",
+              "serviceUrl": "http://echoapi.cloudapp.net/api",
+              "path": "api1",
+              "protocols": [
+                "https"
+              ],
+              "isCurrent": true,
+              "apiVersionSetId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apiVersionSets/c48f96c9-1385-4e2d-b410-5ab591ce0fc4"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/5a73933b8f27f7cc82a2d533",
+            "type": "Microsoft.ApiManagement/service/apis",
+            "name": "5a73933b8f27f7cc82a2d533",
+            "properties": {
+              "displayName": "api1",
+              "apiRevision": "1",
+              "serviceUrl": "http://echoapi.cloudapp.net/api",
+              "path": "api1",
+              "protocols": [
+                "https"
+              ],
+              "isCurrent": true,
+              "apiVersion": "v1",
+              "apiVersionSetId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apiVersionSets/c48f96c9-1385-4e2d-b410-5ab591ce0fc4"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/echo-api",
+            "type": "Microsoft.ApiManagement/service/apis",
+            "name": "echo-api",
+            "properties": {
+              "displayName": "Echo API",
+              "apiRevision": "1",
+              "serviceUrl": "http://echoapi.cloudapp.net/api",
+              "path": "echo",
+              "protocols": [
+                "https"
+              ],
+              "isCurrent": true
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/5a7390baa5816a110435aee0",
+            "type": "Microsoft.ApiManagement/service/apis",
+            "name": "5a7390baa5816a110435aee0",
+            "properties": {
+              "displayName": "Swagger Petstore Extensive",
+              "apiRevision": "1",
+              "description": "A sample API that uses a petstore as an example to demonstrate features in the swagger-2.0 specification",
+              "serviceUrl": "http://petstore.swagger.wordnik.com/api",
+              "path": "vvv",
+              "protocols": [
+                "https"
+              ],
+              "isCurrent": true
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApisByTags.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApisByTags.json
new file mode 100644
index 000000000000..320df65cab33
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListApisByTags.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "tag": {
+              "id": "/tags/apitag123",
+              "name": "awesomeTag"
+            },
+            "api": {
+              "id": "/apis/echo-api",
+              "name": "Echo API",
+              "apiRevision": "1",
+              "serviceUrl": "http://echoapi.cloudapp.net/api",
+              "path": "echo",
+              "isCurrent": true
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListAuthorizationServers.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListAuthorizationServers.json
new file mode 100644
index 000000000000..00f73d60ca6a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListAuthorizationServers.json
@@ -0,0 +1,74 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/authorizationServers/newauthServer",
+            "type": "Microsoft.ApiManagement/service/authorizationServers",
+            "name": "newauthServer",
+            "properties": {
+              "displayName": "test2",
+              "description": "test server",
+              "clientRegistrationEndpoint": "https://www.contoso.com/apps",
+              "authorizationEndpoint": "https://www.contoso.com/oauth2/auth",
+              "authorizationMethods": [
+                "GET"
+              ],
+              "tokenEndpoint": "https://www.contoso.com/oauth2/token",
+              "supportState": true,
+              "defaultScope": "read write",
+              "grantTypes": [
+                "authorizationCode",
+                "implicit"
+              ],
+              "bearerTokenSendingMethods": [
+                "authorizationHeader"
+              ],
+              "clientId": "1",
+              "resourceOwnerUsername": "un",
+              "resourceOwnerPassword": "pwd"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/authorizationServers/newauthServer2",
+            "type": "Microsoft.ApiManagement/service/authorizationServers",
+            "name": "newauthServer2",
+            "properties": {
+              "displayName": "test3",
+              "description": "test server",
+              "clientRegistrationEndpoint": "https://www.contoso.com/apps",
+              "authorizationEndpoint": "https://www.contoso.com/oauth2/auth",
+              "authorizationMethods": [
+                "GET"
+              ],
+              "clientAuthenticationMethod": [
+                "Basic"
+              ],
+              "tokenEndpoint": "https://www.contoso.com/oauth2/token",
+              "supportState": true,
+              "defaultScope": "read write",
+              "grantTypes": [
+                "authorizationCode",
+                "implicit"
+              ],
+              "bearerTokenSendingMethods": [
+                "authorizationHeader"
+              ],
+              "clientId": "1",
+              "resourceOwnerUsername": "un",
+              "resourceOwnerPassword": "pwd"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListBackends.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListBackends.json
new file mode 100644
index 000000000000..2ff24b60f824
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListBackends.json
@@ -0,0 +1,80 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/backends/proxybackend",
+            "type": "Microsoft.ApiManagement/service/backends",
+            "name": "proxybackend",
+            "properties": {
+              "description": "description5308",
+              "url": "https://backendname2644/",
+              "protocol": "http",
+              "credentials": {
+                "query": {
+                  "sv": [
+                    "xx",
+                    "bb",
+                    "cc"
+                  ]
+                },
+                "header": {
+                  "x-my-1": [
+                    "val1",
+                    "val2"
+                  ]
+                },
+                "authorization": {
+                  "scheme": "Basic",
+                  "parameter": "opensesma"
+                }
+              },
+              "proxy": {
+                "url": "http://192.168.1.1:8080",
+                "username": "Contoso\\admin",
+                "password": "opensesame"
+              },
+              "tls": {
+                "validateCertificateChain": false,
+                "validateCertificateName": false
+              }
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/backends/sfbackend",
+            "type": "Microsoft.ApiManagement/service/backends",
+            "name": "sfbackend",
+            "properties": {
+              "description": "Service Fabric Test App 1",
+              "url": "fabric:/mytestapp/mytestservice",
+              "protocol": "http",
+              "properties": {
+                "serviceFabricCluster": {
+                  "managementEndpoints": [
+                    "https://somecluster.com"
+                  ],
+                  "clientCertificatethumbprint": "EBA029198AA3E76EF0D70482626E5BCF148594A6",
+                  "serverX509Names": [
+                    {
+                      "name": "ServerCommonName1",
+                      "issuerCertificateThumbprint": "IssuerCertificateThumbprint1"
+                    }
+                  ],
+                  "maxPartitionResolutionRetries": 5
+                }
+              }
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListCaches.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListCaches.json
new file mode 100644
index 000000000000..df971f34e974
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListCaches.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "resourceGroupName": "rg1",
+    "serviceName": "apimService1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/caches/westindia",
+            "type": "Microsoft.ApiManagement/service/caches",
+            "name": "westindia",
+            "properties": {
+              "connectionString": "{{5c68d535a40f7e61103cd285}}}",
+              "description": "Redis cache instances in West India",
+              "resourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cache/Redis/contoso5"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListCertificates.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListCertificates.json
new file mode 100644
index 000000000000..f5b805259669
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListCertificates.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "resourceGroupName": "rg1",
+    "serviceName": "apimService1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/kjoshiarmtemplateCert1",
+            "type": "Microsoft.ApiManagement/service/certificates",
+            "name": "templateCert1",
+            "properties": {
+              "subject": "CN=mutual-authcert",
+              "thumbprint": "EBA************************48594A6",
+              "expirationDate": "2017-04-23T17:03:41Z"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListDiagnostics.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListDiagnostics.json
new file mode 100644
index 000000000000..046cd506e79c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListDiagnostics.json
@@ -0,0 +1,73 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/diagnostics/applicationinsights",
+            "type": "Microsoft.ApiManagement/service/diagnostics",
+            "name": "applicationinsights",
+            "properties": {
+              "alwaysLog": "allErrors",
+              "httpCorrelationProtocol": "Legacy",
+              "verbosity": "information",
+              "logClientIp": true,
+              "loggerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/loggers/aisamplingtest",
+              "sampling": {
+                "samplingType": "fixed",
+                "percentage": 100
+              },
+              "frontend": {
+                "request": {
+                  "headers": [],
+                  "body": {
+                    "bytes": 0
+                  }
+                },
+                "response": {
+                  "headers": [],
+                  "body": {
+                    "bytes": 0
+                  }
+                }
+              },
+              "backend": {
+                "request": {
+                  "headers": [],
+                  "body": {
+                    "bytes": 0
+                  }
+                },
+                "response": {
+                  "headers": [],
+                  "body": {
+                    "bytes": 0
+                  }
+                }
+              }
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/diagnostics/azuremonitor",
+            "type": "Microsoft.ApiManagement/service/diagnostics",
+            "name": "azuremonitor",
+            "properties": {
+              "logClientIp": true,
+              "loggerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/loggers/azuremonitor",
+              "sampling": {
+                "samplingType": "fixed",
+                "percentage": 100
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListEmailTemplates.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListEmailTemplates.json
new file mode 100644
index 000000000000..3432a1106c27
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListEmailTemplates.json
@@ -0,0 +1,55 @@
+{
+  "parameters": {
+    "resourceGroupName": "rg1",
+    "serviceName": "apimService1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/templates/ApplicationApprovedNotificationMessage",
+            "type": "Microsoft.ApiManagement/service/templates",
+            "name": "ApplicationApprovedNotificationMessage",
+            "properties": {
+              "subject": "Your application $AppName is published in the application gallery",
+              "body": "<!DOCTYPE html >\r\n<html>\r\n  <head />\r\n  <body>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">Dear $DevFirstName $DevLastName,</p>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">\r\n          We are happy to let you know that your request to publish the $AppName application in the application gallery has been approved. Your application has been published and can be viewed <a href=\"http://$DevPortalUrl/Applications/Details/$AppId\">here</a>.\r\n        </p>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">Best,</p>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">The $OrganizationName API Team</p>\r\n  </body>\r\n</html>",
+              "title": "Application gallery submission approved",
+              "description": "Developers who submitted their application for publication in the application gallery on the developer portal receive this email after their submission is approved.",
+              "isDefault": true,
+              "parameters": [
+                {
+                  "name": "AppId",
+                  "title": "Application id"
+                },
+                {
+                  "name": "AppName",
+                  "title": "Application name"
+                },
+                {
+                  "name": "DevFirstName",
+                  "title": "Developer first name"
+                },
+                {
+                  "name": "DevLastName",
+                  "title": "Developer last name"
+                },
+                {
+                  "name": "OrganizationName",
+                  "title": "Organization name"
+                },
+                {
+                  "name": "DevPortalUrl",
+                  "title": "Developer portal URL"
+                }
+              ]
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListGatewayApis.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListGatewayApis.json
new file mode 100644
index 000000000000..5855ffa8c177
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListGatewayApis.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gw1/apis/57681820a40f7eb6c49f6aca",
+            "type": "Microsoft.ApiManagement/service/gateways/apis",
+            "name": "57681820a40f7eb6c49f6aca",
+            "properties": {
+              "displayName": "api_57681820a40f7eb6c49f6acb",
+              "apiRevision": "1",
+              "description": "description_57681820a40f7eb6c49f6acc",
+              "serviceUrl": "http://contoso/57681820a40f7eb6c49f6acd",
+              "path": "suffix_57681820a40f7eb6c49f6ace",
+              "protocols": [
+                "https"
+              ],
+              "isCurrent": true
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListGatewayHostnameConfigurations.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListGatewayHostnameConfigurations.json
new file mode 100644
index 000000000000..c47c50573eb1
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListGatewayHostnameConfigurations.json
@@ -0,0 +1,38 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gw1/hostnameConfigurations/default",
+            "type": "Microsoft.ApiManagement/service/gateways/hostnameConfigurations",
+            "name": "default",
+            "properties": {
+              "hostname": "*",
+              "certificateId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/cert1",
+              "negotiateClientCertificate": false
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gw1/hostnameConfigurations/hostname1",
+            "type": "Microsoft.ApiManagement/service/gateways/hostnameConfigurations",
+            "name": "default",
+            "properties": {
+              "hostname": "foo.bar.com",
+              "certificateId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/cert2",
+              "negotiateClientCertificate": true
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListGateways.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListGateways.json
new file mode 100644
index 000000000000..5a149618b1fc
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListGateways.json
@@ -0,0 +1,39 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gw1",
+            "type": "Microsoft.ApiManagement/service/gateways",
+            "name": "a1",
+            "properties": {
+              "description": "my gateway 1",
+              "locationData": {
+                "name": "my location 1"
+              }
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gw2",
+            "type": "Microsoft.ApiManagement/service/gateways",
+            "name": "5a73933b8f27f7cc82a2d533",
+            "properties": {
+              "description": "my gateway 2",
+              "locationData": {
+                "name": "my location 2"
+              }
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListGroupUsers.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListGroupUsers.json
new file mode 100644
index 000000000000..baf2caf452a0
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListGroupUsers.json
@@ -0,0 +1,37 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "groupId": "57d2ef278aa04f0888cba3f3"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/kjoshiarmTemplateUser1",
+            "type": "Microsoft.ApiManagement/service/groups/users",
+            "name": "armTemplateUser1",
+            "properties": {
+              "firstName": "user1",
+              "lastName": "lastname1",
+              "email": "user1@live.com",
+              "state": "active",
+              "registrationDate": "2017-05-31T18:54:41.447Z",
+              "note": "note for user 1",
+              "identities": [
+                {
+                  "provider": "Basic",
+                  "id": "user1@live.com"
+                }
+              ]
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListGroups.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListGroups.json
new file mode 100644
index 000000000000..86e460480a91
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListGroups.json
@@ -0,0 +1,62 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/groups/5600b59375ff190048020001",
+            "type": "Microsoft.ApiManagement/service/groups",
+            "name": "5600b59375ff190048020001",
+            "properties": {
+              "displayName": "Administrators",
+              "description": "Administrators is a built-in group. Its membership is managed by the system. Microsoft Azure subscription administrators fall into this group.",
+              "builtIn": true,
+              "type": "system"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/groups/59306a29e4bbd510dc24e5f9",
+            "type": "Microsoft.ApiManagement/service/groups",
+            "name": "59306a29e4bbd510dc24e5f9",
+            "properties": {
+              "displayName": "AwesomeGroup (samiraad.onmicrosoft.com)",
+              "description": "awesome group of people",
+              "builtIn": false,
+              "type": "external",
+              "externalId": "aad://samiraad.onmicrosoft.com/groups/3773adf4-032e-4d25-9988-eaff9ca72eca"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/groups/5600b59375ff190048020002",
+            "type": "Microsoft.ApiManagement/service/groups",
+            "name": "5600b59375ff190048020002",
+            "properties": {
+              "displayName": "Developers",
+              "description": "Developers is a built-in group. Its membership is managed by the system. Signed-in users fall into this group.",
+              "builtIn": true,
+              "type": "system"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/groups/5600b59375ff190048020003",
+            "type": "Microsoft.ApiManagement/service/groups",
+            "name": "5600b59375ff190048020003",
+            "properties": {
+              "displayName": "Guests",
+              "description": "Guests is a built-in group. Its membership is managed by the system. Unauthenticated users visiting the developer portal fall into this group.",
+              "builtIn": true,
+              "type": "system"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListIdentityProviders.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListIdentityProviders.json
new file mode 100644
index 000000000000..b61782e8f681
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListIdentityProviders.json
@@ -0,0 +1,52 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/identityProviders/Google",
+            "type": "Microsoft.ApiManagement/service/identityProviders",
+            "name": "Google",
+            "properties": {
+              "clientId": "googleId",
+              "type": "google"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/identityProviders/Aad",
+            "type": "Microsoft.ApiManagement/service/identityProviders",
+            "name": "Aad",
+            "properties": {
+              "clientId": "aadapplicationid",
+              "type": "aad",
+              "allowedTenants": [
+                "samiraad.onmicrosoft.com"
+              ]
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/identityProviders/AadB2C",
+            "type": "Microsoft.ApiManagement/service/identityProviders",
+            "name": "AadB2C",
+            "properties": {
+              "clientId": "aadb2clientId",
+              "type": "aadB2C",
+              "allowedTenants": [
+                "samirtestbc.onmicrosoft.com"
+              ],
+              "signupPolicyName": "B2C_1_Signup_Default",
+              "signinPolicyName": "B2C_1_Signin_Default"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListIssues.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListIssues.json
new file mode 100644
index 000000000000..b40f61a3a41c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListIssues.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/issues/57d2ef278aa04f0ad01d6cdc",
+            "type": "Microsoft.ApiManagement/service/issues",
+            "name": "57d2ef278aa04f0ad01d6cdc",
+            "properties": {
+              "title": "New API issue",
+              "description": "New API issue description",
+              "createdDate": "2018-02-01T22:21:20.467Z",
+              "state": "open",
+              "userId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/1",
+              "apiId": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListLoggers.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListLoggers.json
new file mode 100644
index 000000000000..732924de4216
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListLoggers.json
@@ -0,0 +1,46 @@
+{
+  "parameters": {
+    "resourceGroupName": "rg1",
+    "serviceName": "apimService1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/loggers/buffered111",
+            "type": "Microsoft.ApiManagement/service/loggers",
+            "name": "buffered111",
+            "properties": {
+              "loggerType": "azureEventHub",
+              "description": "Sample description",
+              "credentials": {
+                "connectionString": "Endpoint=sb://apimaccounts.servicebus.windows.net/;SharedAccessKeyName=Send;SharedAccessKey=*******************h=****"
+              },
+              "isBuffered": true,
+              "resourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.EventHub/namespaces/apimaccounts"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/loggers/loggerId",
+            "type": "Microsoft.ApiManagement/service/loggers",
+            "name": "loggerId",
+            "properties": {
+              "loggerType": "azureEventHub",
+              "description": "adding a new logger",
+              "credentials": {
+                "name": "hydraeventhub",
+                "connectionString": "{{Logger-Credentials-59544ef2e4bbd50d9468c618}}"
+              },
+              "isBuffered": true,
+              "resourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.EventHub/namespaces/hydraeventhub-ns"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListNamedValues.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListNamedValues.json
new file mode 100644
index 000000000000..9ffa921acc1c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListNamedValues.json
@@ -0,0 +1,40 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/namedValues/592f1174cc83890dc4f32686",
+            "type": "Microsoft.ApiManagement/service/namedValues",
+            "name": "592f1174cc83890dc4f32686",
+            "properties": {
+              "displayName": "Logger-Credentials-592f1174cc83890dc4f32687",
+              "value": "propValue",
+              "secret": false
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/namedValues/testarmTemplateproperties2",
+            "type": "Microsoft.ApiManagement/service/namedValues",
+            "name": "testarmTemplateproperties2",
+            "properties": {
+              "displayName": "propName",
+              "tags": [
+                "foo",
+                "bar"
+              ],
+              "secret": true
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListNotificationRecipientEmails.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListNotificationRecipientEmails.json
new file mode 100644
index 000000000000..13e7d42c04bb
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListNotificationRecipientEmails.json
@@ -0,0 +1,42 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "notificationName": "RequestPublisherNotificationMessage"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage/recipientEmails/contoso@live.com",
+            "type": "Microsoft.ApiManagement/service/notifications/recipientEmails",
+            "name": "contoso@live.com",
+            "properties": {
+              "email": "contoso@live.com"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage/recipientEmails/foobar!live",
+            "type": "Microsoft.ApiManagement/service/notifications/recipientEmails",
+            "name": "foobar!live",
+            "properties": {
+              "email": "foobar!live"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage/recipientEmails/foobar@live.com",
+            "type": "Microsoft.ApiManagement/service/notifications/recipientEmails",
+            "name": "foobar@live.com",
+            "properties": {
+              "email": "foobar@live.com"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListNotificationRecipientUsers.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListNotificationRecipientUsers.json
new file mode 100644
index 000000000000..42a21332bcd8
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListNotificationRecipientUsers.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "notificationName": "RequestPublisherNotificationMessage"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage/recipientUsers/576823d0a40f7e74ec07d642",
+            "type": "Microsoft.ApiManagement/service/notifications/recipientUsers",
+            "name": "576823d0a40f7e74ec07d642",
+            "properties": {
+              "userId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/576823d0a40f7e74ec07d642"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListNotifications.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListNotifications.json
new file mode 100644
index 000000000000..ac3a6a632311
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListNotifications.json
@@ -0,0 +1,126 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage",
+            "type": "Microsoft.ApiManagement/service/notifications",
+            "name": "RequestPublisherNotificationMessage",
+            "properties": {
+              "title": "Subscription requests (requiring approval)",
+              "description": "The following email recipients and users will receive email notifications about subscription requests for API products requiring approval.",
+              "recipients": {
+                "emails": [
+                  "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage/recipientEmails/contoso@live.com",
+                  "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage/recipientEmails/foobar!live",
+                  "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage/recipientEmails/foobar@live.com"
+                ],
+                "users": [
+                  "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/576823d0a40f7e74ec07d642"
+                ]
+              }
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/PurchasePublisherNotificationMessage",
+            "type": "Microsoft.ApiManagement/service/notifications",
+            "name": "PurchasePublisherNotificationMessage",
+            "properties": {
+              "title": "New subscriptions",
+              "description": "The following email recipients and users will receive email notifications about new API product subscriptions.",
+              "recipients": {
+                "emails": [
+                  "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage/recipientEmails/contoso@live.com"
+                ],
+                "users": [
+                  "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/1"
+                ]
+              }
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/NewApplicationNotificationMessage",
+            "type": "Microsoft.ApiManagement/service/notifications",
+            "name": "NewApplicationNotificationMessage",
+            "properties": {
+              "title": "Application gallery requests",
+              "description": "The following email recipients and users will receive email notifications when new applications are submitted to the application gallery.",
+              "recipients": {
+                "emails": [
+                  "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage/recipientEmails/contoso@live.com"
+                ],
+                "users": []
+              }
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/BCC",
+            "type": "Microsoft.ApiManagement/service/notifications",
+            "name": "BCC",
+            "properties": {
+              "title": "BCC",
+              "description": "The following recipients will receive blind carbon copies of all emails sent to developers.",
+              "recipients": {
+                "emails": [],
+                "users": []
+              }
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/NewIssuePublisherNotificationMessage",
+            "type": "Microsoft.ApiManagement/service/notifications",
+            "name": "NewIssuePublisherNotificationMessage",
+            "properties": {
+              "title": "New issue or comment",
+              "description": "The following email recipients and users will receive email notifications when a new issue or comment is submitted on the developer portal.",
+              "recipients": {
+                "emails": [],
+                "users": [
+                  "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/1"
+                ]
+              }
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/AccountClosedPublisher",
+            "type": "Microsoft.ApiManagement/service/notifications",
+            "name": "AccountClosedPublisher",
+            "properties": {
+              "title": "Close account message",
+              "description": "The following email recipients and users will receive email notifications when developer closes his account",
+              "recipients": {
+                "emails": [
+                  "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage/recipientEmails/contoso@live.com"
+                ],
+                "users": []
+              }
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/QuotaLimitApproachingPublisherNotificationMessage",
+            "type": "Microsoft.ApiManagement/service/notifications",
+            "name": "QuotaLimitApproachingPublisherNotificationMessage",
+            "properties": {
+              "title": "Approaching subscription quota limit",
+              "description": "The following email recipients and users will receive email notifications when subscription usage gets close to usage quota.",
+              "recipients": {
+                "emails": [],
+                "users": [
+                  "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/1"
+                ]
+              }
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListOpenIdConnectProviders.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListOpenIdConnectProviders.json
new file mode 100644
index 000000000000..4ee94af64e29
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListOpenIdConnectProviders.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "resourceGroupName": "rg1",
+    "serviceName": "apimService1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/openidConnectProviders/templateOpenIdConnect2",
+            "type": "Microsoft.ApiManagement/service/openidconnectproviders",
+            "name": "templateOpenIdConnect2",
+            "properties": {
+              "displayName": "templateoidprovider2",
+              "description": "open id provider template2",
+              "metadataEndpoint": "https://oidprovider-template2.net",
+              "clientId": "oidprovidertemplate2"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListOperations.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListOperations.json
new file mode 100644
index 000000000000..7b956348db16
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListOperations.json
@@ -0,0 +1,59 @@
+{
+  "parameters": {
+    "api-version": "2019-12-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "Microsoft.ApiManagement/service/write",
+            "display": {
+              "provider": "Microsoft API Management",
+              "resource": "Service",
+              "operation": "Create a new instance of API Management Service",
+              "description": "Create a new instance of API Management Service"
+            }
+          },
+          {
+            "name": "Microsoft.ApiManagement/service/read",
+            "display": {
+              "provider": "Microsoft API Management",
+              "resource": "Service",
+              "operation": "Read metadata for an API Management Service instance",
+              "description": "Read metadata for an API Management Service instance"
+            }
+          },
+          {
+            "name": "Microsoft.ApiManagement/service/delete",
+            "display": {
+              "provider": "Microsoft API Management",
+              "resource": "Service",
+              "operation": "Delete API Management Service instance",
+              "description": "Delete API Management Service instance"
+            }
+          },
+          {
+            "origin": "system",
+            "name": "Microsoft.ApiManagement/service/providers/Microsoft.Insights/diagnosticSettings/write",
+            "display": {
+              "provider": "Microsoft API Management",
+              "resource": "Service",
+              "operation": "Write diagnostic setting",
+              "description": "Creates or updates the diagnostic setting for API Management service"
+            }
+          },
+          {
+            "name": "Microsoft.ApiManagement/service/tenant/operationResults/read",
+            "display": {
+              "provider": "Microsoft API Management",
+              "resource": "Results of async operations",
+              "operation": "Get operation results or Get operation result",
+              "description": "Get list of operation results or Get result of a specific operation"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListPolicies.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListPolicies.json
new file mode 100644
index 000000000000..1f5872f376d5
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListPolicies.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "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>"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListPolicyDescriptions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListPolicyDescriptions.json
new file mode 100644
index 000000000000..63c634464738
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListPolicyDescriptions.json
@@ -0,0 +1,36 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "scope": "Api"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/policyDescriptions/authentication-basic",
+            "type": "Microsoft.ApiManagement/service/policyDescriptions",
+            "name": "authentication-basic",
+            "properties": {
+              "description": "Authenticate with the backend service using Basic authentication. Use in the inbound section at API scope.",
+              "scope": 268435471
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/policyDescriptions/authentication-certificate",
+            "type": "Microsoft.ApiManagement/service/policyDescriptions",
+            "name": "authentication-certificate",
+            "properties": {
+              "description": "Authenticate with the backend service using a client certificate. Use in the inbound section at API scope.",
+              "scope": 268435471
+            }
+          }
+        ],
+        "count": 2
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListProductApis.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListProductApis.json
new file mode 100644
index 000000000000..292538cd099d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListProductApis.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "5768181ea40f7eb6c49f6ac7"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5768181ea40f7eb6c49f6ac7/apis/57681820a40f7eb6c49f6aca",
+            "type": "Microsoft.ApiManagement/service/products/apis",
+            "name": "57681820a40f7eb6c49f6aca",
+            "properties": {
+              "displayName": "api_57681820a40f7eb6c49f6acb",
+              "apiRevision": "1",
+              "description": "description_57681820a40f7eb6c49f6acc",
+              "serviceUrl": "http://contoso/57681820a40f7eb6c49f6acd",
+              "path": "suffix_57681820a40f7eb6c49f6ace",
+              "protocols": [
+                "https"
+              ],
+              "isCurrent": true
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListProductGroups.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListProductGroups.json
new file mode 100644
index 000000000000..8cdef2e9f242
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListProductGroups.json
@@ -0,0 +1,51 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "5600b57e7e8880006a060002"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5600b57e7e8880006a060002/groups/5600b57e7e8880006a020001",
+            "type": "Microsoft.ApiManagement/service/products/groups",
+            "name": "5600b57e7e8880006a020001",
+            "properties": {
+              "displayName": "Administrators",
+              "description": "Administrators is a built-in group. Its membership is managed by the system. Microsoft Azure subscription administrators fall into this group.",
+              "builtIn": true,
+              "type": "system"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5600b57e7e8880006a060002/groups/5600b57e7e8880006a020002",
+            "type": "Microsoft.ApiManagement/service/products/groups",
+            "name": "5600b57e7e8880006a020002",
+            "properties": {
+              "displayName": "Developers",
+              "description": "Developers is a built-in group. Its membership is managed by the system. Signed-in users fall into this group.",
+              "builtIn": true,
+              "type": "system"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5600b57e7e8880006a060002/groups/5600b57e7e8880006a020003",
+            "type": "Microsoft.ApiManagement/service/products/groups",
+            "name": "5600b57e7e8880006a020003",
+            "properties": {
+              "displayName": "Guests",
+              "description": "Guests is a built-in group. Its membership is managed by the system. Unauthenticated users visiting the developer portal fall into this group.",
+              "builtIn": true,
+              "type": "system"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListProductPolicies.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListProductPolicies.json
new file mode 100644
index 000000000000..ba70650fe628
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListProductPolicies.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "armTemplateProduct4"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/armTemplateProduct4/policies/policy",
+            "type": "Microsoft.ApiManagement/service/products/policies",
+            "name": "policy",
+            "properties": {
+              "value": "<policies>\r\n  <inbound>\r\n    <base />\r\n  </inbound>\r\n  <backend>\r\n    <base />\r\n  </backend>\r\n  <outbound>\r\n    <base />\r\n  </outbound>\r\n  <on-error>\r\n    <base />\r\n  </on-error>\r\n</policies>"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListProductSubscriptions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListProductSubscriptions.json
new file mode 100644
index 000000000000..78e28dbbafc3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListProductSubscriptions.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "5600b57e7e8880006a060002"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5600b57e7e8880006a060002/subscriptions/5600b57e7e8880006a070002",
+            "type": "Microsoft.ApiManagement/service/products/subscriptions",
+            "name": "5600b57e7e8880006a070002",
+            "properties": {
+              "ownerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/1",
+              "scope": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5600b57e7e8880006a060002",
+              "state": "active",
+              "createdDate": "2015-09-22T01:57:18.723Z"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListProductTags.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListProductTags.json
new file mode 100644
index 000000000000..00748365ad71
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListProductTags.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "57d2ef278aa04f0888cba3f1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/5600b539c53f5b0062060002",
+            "type": "Microsoft.ApiManagement/service/tags",
+            "name": "5600b539c53f5b0062060002",
+            "properties": {
+              "displayName": "tag1"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListProducts.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListProducts.json
new file mode 100644
index 000000000000..b84407644598
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListProducts.json
@@ -0,0 +1,55 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/kjoshiarmtemplateCert1",
+            "type": "Microsoft.ApiManagement/service/products",
+            "name": "kjoshiarmtemplateCert1",
+            "properties": {
+              "displayName": "Dev",
+              "description": "Development Product",
+              "subscriptionRequired": false,
+              "state": "published"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/starter",
+            "type": "Microsoft.ApiManagement/service/products",
+            "name": "starter",
+            "properties": {
+              "displayName": "Starter",
+              "description": "Subscribers will be able to run 5 calls/minute up to a maximum of 100 calls/week.",
+              "terms": "",
+              "subscriptionRequired": true,
+              "approvalRequired": false,
+              "subscriptionsLimit": 1,
+              "state": "published"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/unlimited",
+            "type": "Microsoft.ApiManagement/service/products",
+            "name": "unlimited",
+            "properties": {
+              "displayName": "Unlimited",
+              "description": "Subscribers have completely unlimited access to the API. Administrator approval is required.",
+              "subscriptionRequired": true,
+              "approvalRequired": true,
+              "subscriptionsLimit": 1,
+              "state": "published"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListProductsByTags.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListProductsByTags.json
new file mode 100644
index 000000000000..b933f1a7f3be
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListProductsByTags.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "tag": {
+              "id": "/tags/apitag123",
+              "name": "awesomeTag"
+            },
+            "product": {
+              "id": "/products/starter",
+              "name": "Starter",
+              "description": "Subscribers will be able to run 5 calls/minute up to a maximum of 100 calls/week.",
+              "terms": "",
+              "subscriptionRequired": true,
+              "approvalRequired": false,
+              "subscriptionsLimit": 1,
+              "state": "published"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListRegions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListRegions.json
new file mode 100644
index 000000000000..89a874935a99
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListRegions.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "West US",
+            "isMasterRegion": true,
+            "isDeleted": false
+          }
+        ],
+        "count": 1,
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSKUs-Consumption.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSKUs-Consumption.json
new file mode 100644
index 000000000000..20a41f3a310f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSKUs-Consumption.json
@@ -0,0 +1,24 @@
+{
+  "parameters": {
+    "api-version": "2019-12-01",
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "resourceType": "Microsoft.ApiManagement/service",
+            "sku": {
+              "name": "Consumption"
+            },
+            "capacity": null
+          }
+        ],
+        "nextLink": null
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSKUs-Dedicated.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSKUs-Dedicated.json
new file mode 100644
index 000000000000..14e604edbb44
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSKUs-Dedicated.json
@@ -0,0 +1,65 @@
+{
+  "parameters": {
+    "api-version": "2019-12-01",
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "resourceType": "Microsoft.ApiManagement/service",
+            "sku": {
+              "name": "Developer"
+            },
+            "capacity": {
+              "minimum": 1,
+              "maximum": 1,
+              "default": 1,
+              "scaleType": "none"
+            }
+          },
+          {
+            "resourceType": "Microsoft.ApiManagement/service",
+            "sku": {
+              "name": "Basic"
+            },
+            "capacity": {
+              "minimum": 1,
+              "maximum": 2,
+              "default": 1,
+              "scaleType": "manual"
+            }
+          },
+          {
+            "resourceType": "Microsoft.ApiManagement/service",
+            "sku": {
+              "name": "Standard"
+            },
+            "capacity": {
+              "minimum": 1,
+              "maximum": 4,
+              "default": 1,
+              "scaleType": "automatic"
+            }
+          },
+          {
+            "resourceType": "Microsoft.ApiManagement/service",
+            "sku": {
+              "name": "Premium"
+            },
+            "capacity": {
+              "minimum": 1,
+              "maximum": 10,
+              "default": 1,
+              "scaleType": "automatic"
+            }
+          }
+        ],
+        "nextLink": null
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSecretsAuthorizationServer.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSecretsAuthorizationServer.json
new file mode 100644
index 000000000000..155ae58fbb3a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSecretsAuthorizationServer.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "authsid": "newauthServer2"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "clientSecret": "2"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSecretsIdentityProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSecretsIdentityProvider.json
new file mode 100644
index 000000000000..234938c21985
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSecretsIdentityProvider.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "identityProviderName": "aadB2C"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "clientSecret": "XXXXXXX"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSecretsNamedValue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSecretsNamedValue.json
new file mode 100644
index 000000000000..9e190440257c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSecretsNamedValue.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "namedValueId": "testarmTemplateproperties2"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": "propValue"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSecretsOpenIdConnectProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSecretsOpenIdConnectProvider.json
new file mode 100644
index 000000000000..cff64b91fd20
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSecretsOpenIdConnectProvider.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "opid": "templateOpenIdConnect2"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "clientSecret": "oidsecretproviderTemplate2"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSecretsPortalSettingsValidationKey.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSecretsPortalSettingsValidationKey.json
new file mode 100644
index 000000000000..a35a30f8d338
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSecretsPortalSettingsValidationKey.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "validationKey": "nVF7aKIvr9mV/RM5lOD0sYoi8ThXTRHQP7o66hvUmjCDkPKR3qxPu/otJcNciz2aQdqPuzJH3ECG4TU2yZjQ7Q=="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSecretsSubscription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSecretsSubscription.json
new file mode 100644
index 000000000000..382995492868
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSecretsSubscription.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "sid": "5931a769d8d14f0ad8ce13b8"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "primaryKey": "6de0a3b2da204e459148d2f6785873f0",
+        "secondaryKey": "c6de00b451f64ea780db1eb8dcf30b62"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSecretsTenantAccess.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSecretsTenantAccess.json
new file mode 100644
index 000000000000..330d498ca16d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSecretsTenantAccess.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "accessName": "access"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "5600b59375ff190048030003",
+        "primaryKey": "qr5nbjNoZkgtLojXgU+OA/ntYMgko3XPSVyt+ObwR1sqp2ZkM9tGhwxkeEz7bfAuPS5ss61b2S3ZrZmqa9v3Mw==",
+        "secondaryKey": "2dCJv1CasJl286SZiKxyBFDiIYCUdbwM1YrFNDcFMXCjCKbFzomrGkv+exAbnV5E3DEk91VP4jbeJ2eV/qtejA==",
+        "enabled": true
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListServiceBySubscription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListServiceBySubscription.json
new file mode 100644
index 000000000000..2afc23c8a233
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListServiceBySubscription.json
@@ -0,0 +1,164 @@
+{
+  "parameters": {
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService3",
+            "name": "apimService3",
+            "type": "Microsoft.ApiManagement/service",
+            "tags": {},
+            "location": "West US",
+            "etag": "AAAAAAAXXAQ=",
+            "properties": {
+              "publisherEmail": "admin@live.com",
+              "publisherName": "contoso",
+              "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+              "provisioningState": "Succeeded",
+              "targetProvisioningState": "",
+              "createdAtUtc": "2017-05-27T15:33:55.5426123Z",
+              "gatewayUrl": "https://apimService3.azure-api.net",
+              "portalUrl": "https://apimService3.portal.azure-api.net",
+              "managementApiUrl": "https://apimService3.management.azure-api.net",
+              "scmUrl": "https://apimService3.scm.azure-api.net",
+              "hostnameConfigurations": [],
+              "publicIPAddresses": [
+                "13.88.16.64"
+              ],
+              "additionalLocations": [
+                {
+                  "location": "West Europe",
+                  "sku": {
+                    "name": "Premium",
+                    "capacity": 1
+                  },
+                  "publicIPAddresses": [
+                    "52.233.184.197"
+                  ]
+                }
+              ],
+              "virtualNetworkType": "None"
+            },
+            "sku": {
+              "name": "Premium",
+              "capacity": 1
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.ApiManagement/service/apimService2",
+            "name": "apimService2",
+            "type": "Microsoft.ApiManagement/service",
+            "tags": {},
+            "location": "West US",
+            "etag": "AAAAAAAXW4U=",
+            "properties": {
+              "publisherEmail": "admin@live.com",
+              "publisherName": "MS",
+              "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+              "provisioningState": "Succeeded",
+              "targetProvisioningState": "",
+              "createdAtUtc": "2017-05-26T23:55:31.1405115Z",
+              "gatewayUrl": "https://apimService2.azure-api.net",
+              "portalUrl": "https://apimService2.portal.azure-api.net",
+              "managementApiUrl": "https://apimService2.management.azure-api.net",
+              "scmUrl": "https://apimService2.scm.azure-api.net",
+              "hostnameConfigurations": [],
+              "publicIPAddresses": [
+                "13.64.237.151"
+              ],
+              "virtualNetworkType": "None"
+            },
+            "sku": {
+              "name": "Developer",
+              "capacity": 1
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService5",
+            "name": "apimService5",
+            "type": "Microsoft.ApiManagement/service",
+            "tags": {},
+            "location": "West US",
+            "etag": "AAAAAAAXW5c=",
+            "properties": {
+              "publisherEmail": "admin@live.com",
+              "publisherName": "contoso",
+              "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+              "provisioningState": "Succeeded",
+              "targetProvisioningState": "",
+              "createdAtUtc": "2017-05-26T18:13:02.0196315Z",
+              "gatewayUrl": "https://apimService5.azure-api.net",
+              "portalUrl": "https://apimService5.portal.azure-api.net",
+              "managementApiUrl": "https://apimService5.management.azure-api.net",
+              "scmUrl": "https://apimService5.scm.azure-api.net",
+              "hostnameConfigurations": [
+                {
+                  "type": "Proxy",
+                  "hostName": "proxytemplatehostname1.contoso.com",
+                  "negotiateClientCertificate": false,
+                  "certificate": {
+                    "expiry": "2018-03-17T21:55:07+00:00",
+                    "thumbprint": "DE57B67BA63D21E925DA8BEFA436E6B7553A4C19",
+                    "subject": "CN=proxytemplatehostname1.contoso.com"
+                  }
+                },
+                {
+                  "type": "Proxy",
+                  "hostName": "proxytemplatehostname2.contoso.com",
+                  "negotiateClientCertificate": true,
+                  "certificate": {
+                    "expiry": "2018-03-17T21:55:07+00:00",
+                    "thumbprint": "DE57B67BA63D21E925DA8BEFA436E6B7553A4C19",
+                    "subject": "CN=proxytemplatehostname2.contoso.com"
+                  }
+                },
+                {
+                  "type": "Proxy",
+                  "hostName": "proxytemplatehostname3.azure-api.net",
+                  "negotiateClientCertificate": false,
+                  "certificate": {
+                    "expiry": "2018-03-17T21:55:07+00:00",
+                    "thumbprint": "918D7785B926AC5AEE66322778A147BCE7237CF3",
+                    "subject": "CN=proxytemplatehostname3.contoso.com"
+                  }
+                },
+                {
+                  "type": "Proxy",
+                  "hostName": "proxytemplatehostname4.azure-api.net",
+                  "negotiateClientCertificate": true,
+                  "certificate": {
+                    "expiry": "2018-03-17T21:55:07+00:00",
+                    "thumbprint": "918D7785B926AC5AEE66322778A147BCE7237CF3",
+                    "subject": "CN=proxytemplatehostname4.contoso.com"
+                  }
+                },
+                {
+                  "type": "Portal",
+                  "hostName": "portaltemplatehostname1.contoso.com",
+                  "negotiateClientCertificate": false,
+                  "certificate": {
+                    "expiry": "2018-03-17T21:55:07+00:00",
+                    "thumbprint": "DE57B67BA63D21E925DA8BEFA436E6B7553A4C19",
+                    "subject": "CN=portaltemplatehostname1.contoso.com"
+                  }
+                }
+              ],
+              "publicIPAddresses": [
+                "13.93.167.166"
+              ],
+              "virtualNetworkType": "None"
+            },
+            "sku": {
+              "name": "Premium",
+              "capacity": 1
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListServiceBySubscriptionAndResourceGroup.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListServiceBySubscriptionAndResourceGroup.json
new file mode 100644
index 000000000000..259dddfdace5
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListServiceBySubscriptionAndResourceGroup.json
@@ -0,0 +1,121 @@
+{
+  "parameters": {
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+            "name": "apimService1",
+            "type": "Microsoft.ApiManagement/service",
+            "tags": {
+              "Pool": "Perf",
+              "UID": "98f4a706-98c7-4aec-8e39-51ab2e4aaf22"
+            },
+            "location": "West US",
+            "etag": "AAAAAAAhNiA=",
+            "properties": {
+              "publisherEmail": "admin@live.com",
+              "publisherName": "contoso",
+              "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+              "provisioningState": "Succeeded",
+              "targetProvisioningState": "",
+              "createdAtUtc": "2019-10-13T01:36:27.1706097Z",
+              "gatewayUrl": "https://apimService1.azure-api.net",
+              "gatewayRegionalUrl": "https://apimService1-westus-01.regional.azure-api.net",
+              "portalUrl": "https://apimService1.portal.azure-api.net",
+              "developerPortalUrl": "https://apimService1.developer.azure-api.net",
+              "managementApiUrl": "https://apimService1.management.azure-api.net",
+              "scmUrl": "https://apimService1.scm.azure-api.net",
+              "hostnameConfigurations": [
+                {
+                  "type": "Proxy",
+                  "hostName": "apimService1.azure-api.net",
+                  "negotiateClientCertificate": false,
+                  "defaultSslBinding": true
+                }
+              ],
+              "publicIPAddresses": [
+                "104.42.221.195"
+              ],
+              "customProperties": {
+                "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "False",
+                "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "False",
+                "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Ssl30": "False",
+                "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "False",
+                "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "False",
+                "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "False",
+                "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "False",
+                "Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "False"
+              },
+              "virtualNetworkType": "None",
+              "disableGateway": false,
+              "apiVersionConstraint": {}
+            },
+            "sku": {
+              "name": "Standard",
+              "capacity": 1
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService2",
+            "name": "apimService2",
+            "type": "Microsoft.ApiManagement/service",
+            "tags": {
+              "Pool": "Endurance",
+              "UID": "07d6dd0e-111f-4b5c-81f3-87e5501d0408"
+            },
+            "location": "West US",
+            "etag": "AAAAAAAhNh4=",
+            "properties": {
+              "publisherEmail": "admin@live.com",
+              "publisherName": "contoso",
+              "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+              "provisioningState": "Succeeded",
+              "targetProvisioningState": "",
+              "createdAtUtc": "2019-10-13T01:36:27.4003514Z",
+              "gatewayUrl": "https://apimService2.azure-api.net",
+              "gatewayRegionalUrl": "https://apimService2-westus-01.regional.azure-api.net",
+              "portalUrl": "https://apimService2.portal.azure-api.net",
+              "developerPortalUrl": "https://apimService2.developer.azure-api.net",
+              "managementApiUrl": "https://apimService2.management.azure-api.net",
+              "scmUrl": "https://apimService2.scm.azure-api.net",
+              "hostnameConfigurations": [
+                {
+                  "type": "Proxy",
+                  "hostName": "apimService2.azure-api.net",
+                  "negotiateClientCertificate": false,
+                  "defaultSslBinding": true
+                }
+              ],
+              "publicIPAddresses": [
+                "104.42.220.196"
+              ],
+              "customProperties": {
+                "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "False",
+                "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "False",
+                "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Ssl30": "False",
+                "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "False",
+                "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "False",
+                "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "False",
+                "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "False",
+                "Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "False"
+              },
+              "virtualNetworkType": "None",
+              "disableGateway": false,
+              "apiVersionConstraint": {}
+            },
+            "sku": {
+              "name": "Standard",
+              "capacity": 1
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSubscriptions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSubscriptions.json
new file mode 100644
index 000000000000..45ac0e309787
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListSubscriptions.json
@@ -0,0 +1,55 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/subscriptions/5600b59475ff190048070001",
+            "type": "Microsoft.ApiManagement/service/subscriptions",
+            "name": "5600b59475ff190048070001",
+            "properties": {
+              "ownerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/1",
+              "scope": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5600b59475ff190048060001",
+              "state": "active",
+              "createdDate": "2015-09-22T01:57:40.3Z"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/subscriptions/56eaed3dbaf08b06e46d27fe",
+            "type": "Microsoft.ApiManagement/service/subscriptions",
+            "name": "56eaed3dbaf08b06e46d27fe",
+            "properties": {
+              "ownerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/56eaec62baf08b06e46d27fd",
+              "scope": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5600b59475ff190048060001",
+              "displayName": "Starter",
+              "state": "active",
+              "createdDate": "2016-03-17T17:45:33.837Z",
+              "startDate": "2016-03-17T00:00:00Z",
+              "expirationDate": "2016-04-01T00:00:00Z",
+              "notificationDate": "2016-03-20T00:00:00Z"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/subscriptions/5931a769d8d14f0ad8ce13b8",
+            "type": "Microsoft.ApiManagement/service/subscriptions",
+            "name": "5931a769d8d14f0ad8ce13b8",
+            "properties": {
+              "ownerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/5931a75ae4bbd512a88c680b",
+              "scope": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5600b59475ff190048060002",
+              "displayName": "Unlimited",
+              "state": "submitted",
+              "createdDate": "2017-06-02T17:59:06.223Z"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListTagResources.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListTagResources.json
new file mode 100644
index 000000000000..f74d05edb72b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListTagResources.json
@@ -0,0 +1,61 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "tag": {
+              "id": "/tags/apitag123",
+              "name": "awesomeTag"
+            },
+            "operation": {
+              "id": "/apis/echo-api/operations/create-resource",
+              "apiName": "Echo API",
+              "apiRevision": "1",
+              "name": "Create resource",
+              "method": "POST",
+              "urlTemplate": "/resource",
+              "description": "A demonstration of a POST call based on the echo backend above. The request body is expected to contain JSON-formatted data (see example below). A policy is used to automatically transform any request sent in JSON directly to XML. In a real-world scenario this could be used to enable modern clients to speak to a legacy backend."
+            }
+          },
+          {
+            "tag": {
+              "id": "/tags/apitag123",
+              "name": "awesomeTag"
+            },
+            "api": {
+              "id": "/apis/echo-api",
+              "name": "Echo API",
+              "apiRevision": "1",
+              "serviceUrl": "http://echoapi.cloudapp.net/api",
+              "path": "echo",
+              "isCurrent": true
+            }
+          },
+          {
+            "tag": {
+              "id": "/tags/apitag123",
+              "name": "awesomeTag"
+            },
+            "product": {
+              "id": "/products/starter",
+              "name": "Starter",
+              "description": "Subscribers will be able to run 5 calls/minute up to a maximum of 100 calls/week.",
+              "terms": "",
+              "subscriptionRequired": true,
+              "approvalRequired": false,
+              "subscriptionsLimit": 1,
+              "state": "published"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListTags.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListTags.json
new file mode 100644
index 000000000000..ff37f4df7ec8
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListTags.json
@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/5600b59375ff190048020001",
+            "type": "Microsoft.ApiManagement/service/tags",
+            "name": "5600b59375ff190048020001",
+            "properties": {
+              "displayName": "tag1"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/5600b59375ff190048020002",
+            "type": "Microsoft.ApiManagement/service/tags",
+            "name": "5600b59375ff190048020002",
+            "properties": {
+              "displayName": "tag2"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListUserGroups.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListUserGroups.json
new file mode 100644
index 000000000000..29649b225a8f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListUserGroups.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "userId": "57681833a40f7eb6c49f6acf"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/57681833a40f7eb6c49f6acf/groups/5600b57e7e8880006a020002",
+            "type": "Microsoft.ApiManagement/service/users/groups",
+            "name": "5600b57e7e8880006a020002",
+            "properties": {
+              "displayName": "Developers",
+              "description": "Developers is a built-in group. Its membership is managed by the system. Signed-in users fall into this group.",
+              "builtIn": true,
+              "type": "system"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListUserIdentities.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListUserIdentities.json
new file mode 100644
index 000000000000..78ea66398d60
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListUserIdentities.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "userId": "57f2af53bb17172280f44057"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "provider": "Microsoft",
+            "id": "086cf9********55ab"
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListUserSubscriptions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListUserSubscriptions.json
new file mode 100644
index 000000000000..8e6ae3b3ecc2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListUserSubscriptions.json
@@ -0,0 +1,44 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "userId": "57681833a40f7eb6c49f6acf"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/57681833a40f7eb6c49f6acf/subscriptions/57681850a40f7eb6c49f6ae3",
+            "type": "Microsoft.ApiManagement/service/users/subscriptions",
+            "name": "57681850a40f7eb6c49f6ae3",
+            "properties": {
+              "ownerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/57681833a40f7eb6c49f6acf",
+              "scope": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5768181ea40f7eb6c49f6ac7",
+              "displayName": "57681850a40f7eb6c49f6ae5",
+              "state": "active",
+              "createdDate": "2016-06-20T16:22:39.547Z",
+              "startDate": "2016-06-20T00:00:00Z"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/57681833a40f7eb6c49f6acf/subscriptions/57681850a40f7eb6c49f6b2b",
+            "type": "Microsoft.ApiManagement/service/users/subscriptions",
+            "name": "57681850a40f7eb6c49f6b2b",
+            "properties": {
+              "ownerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/57681833a40f7eb6c49f6acf",
+              "scope": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5768181ea40f7eb6c49f6ac7",
+              "displayName": "57681850a40f7eb6c49f6b2d",
+              "state": "active",
+              "createdDate": "2016-06-20T16:22:41.103Z",
+              "startDate": "2016-06-20T00:00:00Z"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListUsers.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListUsers.json
new file mode 100644
index 000000000000..84d3756a891f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListUsers.json
@@ -0,0 +1,71 @@
+{
+  "parameters": {
+    "resourceGroupName": "rg1",
+    "serviceName": "apimService1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/1",
+            "type": "Microsoft.ApiManagement/service/users",
+            "name": "1",
+            "properties": {
+              "firstName": "Administrator",
+              "lastName": "",
+              "email": "admin@live.com",
+              "state": "active",
+              "registrationDate": "2015-09-22T01:57:39.677Z",
+              "identities": [
+                {
+                  "provider": "Azure",
+                  "id": "admin@live.com"
+                }
+              ]
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/56eaec62baf08b06e46d27fd",
+            "type": "Microsoft.ApiManagement/service/users",
+            "name": "56eaec62baf08b06e46d27fd",
+            "properties": {
+              "firstName": "foo",
+              "lastName": "bar",
+              "email": "foo.bar.83@gmail.com",
+              "state": "active",
+              "registrationDate": "2016-03-17T17:41:56.327Z",
+              "identities": [
+                {
+                  "provider": "Basic",
+                  "id": "foo.bar.83@gmail.com"
+                }
+              ]
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/5931a75ae4bbd512a88c680b",
+            "type": "Microsoft.ApiManagement/service/users",
+            "name": "5931a75ae4bbd512a88c680b",
+            "properties": {
+              "firstName": "foo",
+              "lastName": "bar",
+              "email": "foobar@outlook.com",
+              "state": "active",
+              "registrationDate": "2017-06-02T17:58:50.357Z",
+              "identities": [
+                {
+                  "provider": "Microsoft",
+                  "id": "*************"
+                }
+              ]
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsGetDelegation.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsGetDelegation.json
new file mode 100644
index 000000000000..e86d6bca1dda
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsGetDelegation.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/portalsettings/delegation",
+        "type": "Microsoft.ApiManagement/service/portalsettings",
+        "name": "delegation",
+        "properties": {
+          "url": "http://contoso.com/delegation",
+          "subscriptions": {
+            "enabled": true
+          },
+          "userRegistration": {
+            "enabled": true
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsGetSignIn.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsGetSignIn.json
new file mode 100644
index 000000000000..7ddbe5ac44c2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsGetSignIn.json
@@ -0,0 +1,20 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/portalsettings/signin",
+        "type": "Microsoft.ApiManagement/service/portalsettings",
+        "name": "signin",
+        "properties": {
+          "enabled": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsGetSignUp.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsGetSignUp.json
new file mode 100644
index 000000000000..b72738f3050e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsGetSignUp.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/portalsettings/signup",
+        "type": "Microsoft.ApiManagement/service/portalsettings",
+        "name": "signup",
+        "properties": {
+          "enabled": true,
+          "termsOfService": {
+            "text": "Terms of service text.",
+            "enabled": true,
+            "consentRequired": true
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsPutDelegation.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsPutDelegation.json
new file mode 100644
index 000000000000..c055028f1af6
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsPutDelegation.json
@@ -0,0 +1,40 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "userId": "5931a75ae4bbd512288c680b",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "url": "http://contoso.com/delegation",
+        "validationKey": "nVF7aKIvr9mV/RM5lOD0sYoi8ThXTRHQP7o66hvUmjCDkPKR3qxPu/otJcNciz2aQdqPuzJH3ECG4TU2yZjQ7Q==",
+        "subscriptions": {
+          "enabled": true
+        },
+        "userRegistration": {
+          "enabled": true
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/portalsettings/delegation",
+        "type": "Microsoft.ApiManagement/service/portalsettings",
+        "name": "delegation",
+        "properties": {
+          "url": "http://contoso.com/delegation",
+          "subscriptions": {
+            "enabled": true
+          },
+          "userRegistration": {
+            "enabled": true
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsPutSignIn.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsPutSignIn.json
new file mode 100644
index 000000000000..f171cfa71f2e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsPutSignIn.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "userId": "5931a75ae4bbd512288c680b",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "enabled": true
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/portalsettings/signin",
+        "type": "Microsoft.ApiManagement/service/portalsettings",
+        "name": "signin",
+        "properties": {
+          "enabled": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsPutSignUp.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsPutSignUp.json
new file mode 100644
index 000000000000..40e2693f9f25
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsPutSignUp.json
@@ -0,0 +1,37 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "userId": "5931a75ae4bbd512288c680b",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "enabled": true,
+        "termsOfService": {
+          "enabled": true,
+          "text": "Terms of service text.",
+          "consentRequired": true
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/portalsettings/signup",
+        "type": "Microsoft.ApiManagement/service/portalsettings",
+        "name": "signup",
+        "properties": {
+          "enabled": true,
+          "termsOfService": {
+            "text": "Terms of service text.",
+            "enabled": true,
+            "consentRequired": true
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsUpdateDelegation.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsUpdateDelegation.json
new file mode 100644
index 000000000000..79de717780ff
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsUpdateDelegation.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "userId": "5931a75ae4bbd512288c680b",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "url": "http://contoso.com/delegation",
+        "validationKey": "nVF7aKIvr9mV/RM5lOD0sYoi8ThXTRHQP7o66hvUmjCDkPKR3qxPu/otJcNciz2aQdqPuzJH3ECG4TU2yZjQ7Q==",
+        "subscriptions": {
+          "enabled": true
+        },
+        "userRegistration": {
+          "enabled": true
+        }
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsUpdateSignIn.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsUpdateSignIn.json
new file mode 100644
index 000000000000..37ab432fc876
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsUpdateSignIn.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "userId": "5931a75ae4bbd512288c680b",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "enabled": true
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsUpdateSignUp.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsUpdateSignUp.json
new file mode 100644
index 000000000000..3543d865f71e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementPortalSettingsUpdateSignUp.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "userId": "5931a75ae4bbd512288c680b",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "enabled": true,
+        "termsOfService": {
+          "enabled": true,
+          "text": "Terms of service text.",
+          "consentRequired": true
+        }
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementRestoreService.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementRestoreService.json
new file mode 100644
index 000000000000..55936485b01b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementRestoreService.json
@@ -0,0 +1,126 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "parameters": {
+      "storageAccount": "teststorageaccount",
+      "accessKey": "**************************************************",
+      "containerName": "backupContainer",
+      "backupName": "apimService1backup_2017_03_19"
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/dGVjaGVkX01hbmFnZVJvbGVfNWRiNGI3Ng==?api-version=2019-12-01"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+        "name": "apimService1",
+        "type": "Microsoft.ApiManagement/service",
+        "tags": {
+          "tag1": "value1",
+          "tag2": "value2",
+          "tag3": "value3"
+        },
+        "location": "West US",
+        "etag": "AAAAAAACXok=",
+        "properties": {
+          "publisherEmail": "apim@autorestsdk.com",
+          "publisherName": "autorestsdk",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Succeeded",
+          "targetProvisioningState": "",
+          "createdAtUtc": "2019-12-18T06:26:20.3348609Z",
+          "gatewayUrl": "https://apimService1.azure-api.net",
+          "gatewayRegionalUrl": "https://apimService1-westus-01.regional.azure-api.net",
+          "portalUrl": "https://apimService1.portal.azure-api.net",
+          "developerPortalUrl": "https://apimService1.developer.azure-api.net",
+          "managementApiUrl": "https://apimService1.management.azure-api.net",
+          "scmUrl": "https://apimService1.scm.azure-api.net",
+          "hostnameConfigurations": [
+            {
+              "type": "Proxy",
+              "hostName": "apimService1.azure-api.net",
+              "negotiateClientCertificate": false,
+              "defaultSslBinding": false
+            },
+            {
+              "type": "Proxy",
+              "hostName": "gateway1.msitesting.net",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2036-01-01T07:00:00+00:00",
+                "thumbprint": "8E989XXXXXXXXXXXXXXXXB9C2C91F1D174FDB3A2",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": true
+            },
+            {
+              "type": "Management",
+              "hostName": "mgmt.msitesting.net",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2036-01-01T07:00:00+00:00",
+                "thumbprint": "8E989XXXXXXXXXXXXXXXXB9C2C91F1D174FDB3A2",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": false
+            },
+            {
+              "type": "Portal",
+              "hostName": "portal1.msitesting.net",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2036-01-01T07:00:00+00:00",
+                "thumbprint": "8E989XXXXXXXXXXXXXXXXB9C2C91F1D174FDB3A2",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": false
+            }
+          ],
+          "publicIPAddresses": [
+            "13.91.32.113"
+          ],
+          "additionalLocations": [
+            {
+              "location": "East US",
+              "sku": {
+                "name": "Premium",
+                "capacity": 1
+              },
+              "publicIPAddresses": [
+                "23.101.138.153"
+              ],
+              "gatewayRegionalUrl": "https://apimService1-eastus-01.regional.azure-api.net",
+              "disableGateway": true
+            }
+          ],
+          "customProperties": {
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Ssl30": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "False"
+          },
+          "virtualNetworkType": "None",
+          "disableGateway": false,
+          "apiVersionConstraint": {
+            "minApiVersion": "2019-01-01"
+          }
+        },
+        "sku": {
+          "name": "Premium",
+          "capacity": 1
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceCheckNameAvailability.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceCheckNameAvailability.json
new file mode 100644
index 000000000000..b7bcad0dba80
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceCheckNameAvailability.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "parameters": {
+      "name": "apimService1"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "nameAvailable": true,
+        "reason": "Valid",
+        "message": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceDeleteService.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceDeleteService.json
new file mode 100644
index 000000000000..7a960b693eac
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceDeleteService.json
@@ -0,0 +1,60 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/TGV2eTExMDZtMDJfVGVybV9jMmZlY2QwMA==?api-version=2019-12-01"
+      },
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+        "name": "apimService1",
+        "type": "Microsoft.ApiManagement/service",
+        "tags": {},
+        "location": "West US",
+        "etag": "AAAAAAFfhHY=",
+        "properties": {
+          "publisherEmail": "contoso@live.com",
+          "publisherName": "Microsoft",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Succeeded",
+          "targetProvisioningState": "Deleting",
+          "createdAtUtc": "2016-12-20T19:41:21.5823069Z",
+          "gatewayUrl": "https://apimService1.azure-api.net",
+          "gatewayRegionalUrl": "https://apimService1-westus-01.regional.azure-api.net",
+          "portalUrl": "https://apimService1.portal.azure-api.net",
+          "managementApiUrl": "https://apimService1.management.azure-api.net",
+          "scmUrl": "https://apimService1.scm.azure-api.net",
+          "hostnameConfigurations": [],
+          "publicIPAddresses": [
+            "40.XX.XXX.168"
+          ],
+          "virtualNetworkConfiguration": {
+            "subnetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/BlockVNETSamir/subnets/default"
+          },
+          "customProperties": {
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "True",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "True",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Ssl30": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "True",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "True",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "True",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "False"
+          },
+          "virtualNetworkType": "External"
+        },
+        "sku": {
+          "name": "Developer",
+          "capacity": 1
+        }
+      }
+    },
+    "204": {},
+    "200": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceGetMultiRegionInternalVnet.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceGetMultiRegionInternalVnet.json
new file mode 100644
index 000000000000..cd4cb522b684
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceGetMultiRegionInternalVnet.json
@@ -0,0 +1,98 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimservice1",
+        "name": "apimservice1",
+        "type": "Microsoft.ApiManagement/service",
+        "tags": {},
+        "location": "West US",
+        "etag": "AAAAAADqC0c=",
+        "properties": {
+          "publisherEmail": "abcs@contoso.com",
+          "publisherName": "contoso publisher",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Succeeded",
+          "targetProvisioningState": "",
+          "createdAtUtc": "2019-12-02T01:42:09.1268424Z",
+          "gatewayUrl": "https://apimservice1.azure-api.net",
+          "gatewayRegionalUrl": "https://apimservice1-westus-01.regional.azure-api.net",
+          "portalUrl": "https://apimservice1.portal.azure-api.net",
+          "developerPortalUrl": "https://apimService1.developer.azure-api.net",
+          "managementApiUrl": "https://apimservice1.management.azure-api.net",
+          "scmUrl": "https://apimservice1.scm.azure-api.net",
+          "hostnameConfigurations": [
+            {
+              "type": "Proxy",
+              "hostName": "apimService1.azure-api.net",
+              "negotiateClientCertificate": false,
+              "defaultSslBinding": false
+            },
+            {
+              "type": "Proxy",
+              "hostName": "apimgatewaytest.preview.net",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2019-08-16T16:51:34+00:00",
+                "thumbprint": "B4330123DBAXXXXXXXXX1F35E84493476",
+                "subject": "CN=*.preview.net"
+              },
+              "defaultSslBinding": true
+            }
+          ],
+          "publicIPAddresses": [
+            "137.XXX.11.74"
+          ],
+          "privateIPAddresses": [
+            "172.XX.0.5"
+          ],
+          "additionalLocations": [
+            {
+              "location": "West US 2",
+              "sku": {
+                "name": "Premium",
+                "capacity": 1
+              },
+              "publicIPAddresses": [
+                "40.XXX.79.187"
+              ],
+              "privateIPAddresses": [
+                "10.0.X.6"
+              ],
+              "virtualNetworkConfiguration": {
+                "subnetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/APIMVNet/subnets/apim-internal-sub"
+              },
+              "gatewayRegionalUrl": "https://apimservice1-westus2-01.regional.azure-api.net",
+              "disableGateway": false
+            }
+          ],
+          "virtualNetworkConfiguration": {
+            "subnetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/apim-appGateway-vnet/subnets/apim-subnet"
+          },
+          "customProperties": {
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "True",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "True",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Ssl30": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "True",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "True",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "True",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "False"
+          },
+          "virtualNetworkType": "Internal",
+          "disableGateway": false,
+          "apiVersionConstraint": {}
+        },
+        "sku": {
+          "name": "Premium",
+          "capacity": 1
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceGetNetworkStatus.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceGetNetworkStatus.json
new file mode 100644
index 000000000000..13dff7c0c483
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceGetNetworkStatus.json
@@ -0,0 +1,101 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": [
+        {
+          "location": "West Europe",
+          "networkStatus": {
+            "dnsServers": [
+              "100.78.90.70"
+            ],
+            "connectivityStatus": [
+              {
+                "name": "apimgmtsttgzqxxxxxcrsc.blob.core.windows.net",
+                "status": "success",
+                "error": "",
+                "lastUpdated": "2019-12-18T12:04:43.6997938Z",
+                "lastStatusChange": "2019-01-24T21:47:53.851895Z"
+              },
+              {
+                "name": "apimgmtsttgzqxxxxxcrsc.file.core.windows.net",
+                "status": "success",
+                "error": "",
+                "lastUpdated": "2019-12-18T12:04:44.0439771Z",
+                "lastStatusChange": "2019-05-02T21:22:50.6835366Z"
+              },
+              {
+                "name": "apimgmtsttgzqxxxxxcrsc.queue.core.windows.net",
+                "status": "success",
+                "error": "",
+                "lastUpdated": "2019-12-18T12:04:44.8564232Z",
+                "lastStatusChange": "2019-05-02T20:53:26.6260794Z"
+              },
+              {
+                "name": "apimgmtsttgzqxxxxxcrsc.table.core.windows.net",
+                "status": "success",
+                "error": "",
+                "lastUpdated": "2019-12-18T12:04:44.0439771Z",
+                "lastStatusChange": "2019-05-02T20:53:21.6729263Z"
+              },
+              {
+                "name": "ftmrcxxx.database.windows.net",
+                "status": "success",
+                "error": "",
+                "lastUpdated": "2019-12-18T12:04:44.1845483Z",
+                "lastStatusChange": "2019-05-02T21:02:00.9466899Z"
+              },
+              {
+                "name": "https://prod3.metrics.nsatc.net:1886/RecoveryService",
+                "status": "failure",
+                "error": "Failed to connect to https://prod3.metrics.nsatc.net:1886/RecoveryService with error Unable to connect to the remote server",
+                "lastUpdated": "2019-12-18T12:04:30.1214083Z",
+                "lastStatusChange": "2019-01-24T22:00:04.2450462Z"
+              },
+              {
+                "name": "https://westeurope.prod.warm.ingestion.msftcloudes.com",
+                "status": "success",
+                "error": "",
+                "lastUpdated": "2019-12-18T12:04:43.8251399Z",
+                "lastStatusChange": "2019-12-18T11:14:43.3860126Z"
+              },
+              {
+                "name": "LocalGatewayRedis",
+                "status": "success",
+                "error": "",
+                "lastUpdated": "2019-12-18T12:04:50.6376685Z",
+                "lastStatusChange": "2019-12-18T11:14:44.4966742Z"
+              },
+              {
+                "name": "prod.warmpath.msftcloudes.com",
+                "status": "success",
+                "error": "",
+                "lastUpdated": "2019-12-18T12:04:44.4345454Z",
+                "lastStatusChange": "2019-05-08T00:09:58.031766Z"
+              },
+              {
+                "name": "Scm",
+                "status": "success",
+                "error": "",
+                "lastUpdated": "2019-12-18T12:04:58.4815899Z",
+                "lastStatusChange": "2019-12-18T11:24:48.4795085Z"
+              },
+              {
+                "name": "smtpi-db3.msn.com:25028",
+                "status": "failure",
+                "error": "Connection smtpi-db3.msn.com:25028 failed with Error Unable to connect to the remote server",
+                "lastUpdated": "2019-12-18T12:04:30.1526431Z",
+                "lastStatusChange": "2019-12-18T11:23:05.7709057Z"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceGetNetworkStatusByLocation.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceGetNetworkStatusByLocation.json
new file mode 100644
index 000000000000..4dcb637744d4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceGetNetworkStatusByLocation.json
@@ -0,0 +1,62 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "locationName": "North Central US"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "dnsServers": [
+          "100.78.90.70"
+        ],
+        "connectivityStatus": [
+          {
+            "name": "apimgmtst6mtxxxxxxxx.blob.core.windows.net",
+            "status": "success",
+            "error": "",
+            "lastUpdated": "2018-06-13T22:41:07.3844516Z",
+            "lastStatusChange": "2018-06-13T20:31:06.6590782Z"
+          },
+          {
+            "name": "apimgmtst6mtxxxxxxxx.file.core.windows.net",
+            "status": "success",
+            "error": "",
+            "lastUpdated": "2018-06-13T22:41:08.6657305Z",
+            "lastStatusChange": "2018-06-13T20:31:06.8934611Z"
+          },
+          {
+            "name": "apimgmtst6mtxxxxxxxx.table.core.windows.net",
+            "status": "success",
+            "error": "",
+            "lastUpdated": "2018-06-13T22:41:08.7594708Z",
+            "lastStatusChange": "2018-06-13T20:31:06.7529128Z"
+          },
+          {
+            "name": "https://prod3.metrics.nsatc.net:1886/RecoveryService",
+            "status": "success",
+            "error": "",
+            "lastUpdated": "2018-06-13T22:41:08.6969746Z",
+            "lastStatusChange": "2018-06-13T20:31:07.1125257Z"
+          },
+          {
+            "name": "n20fxxx.database.windows.net",
+            "status": "success",
+            "error": "",
+            "lastUpdated": "2018-06-13T22:41:09.5094848Z",
+            "lastStatusChange": "2018-06-13T20:31:07.0968711Z"
+          },
+          {
+            "name": "Scm",
+            "status": "success",
+            "error": "",
+            "lastUpdated": "2018-06-13T22:41:29.4358865Z",
+            "lastStatusChange": "2018-06-13T20:41:09.8627827Z"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceGetService.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceGetService.json
new file mode 100644
index 000000000000..bd3b962a65a3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceGetService.json
@@ -0,0 +1,115 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+        "name": "apimService1",
+        "type": "Microsoft.ApiManagement/service",
+        "tags": {
+          "tag1": "value1",
+          "tag2": "value2",
+          "tag3": "value3"
+        },
+        "location": "West US",
+        "etag": "AAAAAAACXok=",
+        "properties": {
+          "publisherEmail": "apim@autorestsdk.com",
+          "publisherName": "autorestsdk",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Succeeded",
+          "targetProvisioningState": "",
+          "createdAtUtc": "2019-12-18T06:26:20.3348609Z",
+          "gatewayUrl": "https://apimService1.azure-api.net",
+          "gatewayRegionalUrl": "https://apimService1-westus-01.regional.azure-api.net",
+          "portalUrl": "https://apimService1.portal.azure-api.net",
+          "developerPortalUrl": "https://apimService1.developer.azure-api.net",
+          "managementApiUrl": "https://apimService1.management.azure-api.net",
+          "scmUrl": "https://apimService1.scm.azure-api.net",
+          "hostnameConfigurations": [
+            {
+              "type": "Proxy",
+              "hostName": "apimService1.azure-api.net",
+              "negotiateClientCertificate": false,
+              "defaultSslBinding": false
+            },
+            {
+              "type": "Proxy",
+              "hostName": "gateway1.msitesting.net",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2036-01-01T07:00:00+00:00",
+                "thumbprint": "8E989652CABCF585ACBFCB9C2C91F1D174FDB3A2",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": true
+            },
+            {
+              "type": "Management",
+              "hostName": "mgmt.msitesting.net",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2036-01-01T07:00:00+00:00",
+                "thumbprint": "8E989652CABCF585ACBFCB9C2C91F1D174FDB3A2",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": false
+            },
+            {
+              "type": "Portal",
+              "hostName": "portal1.msitesting.net",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2036-01-01T07:00:00+00:00",
+                "thumbprint": "8E989652CABCF585ACBFCB9C2C91F1D174FDB3A2",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": false
+            }
+          ],
+          "publicIPAddresses": [
+            "13.91.32.113"
+          ],
+          "additionalLocations": [
+            {
+              "location": "East US",
+              "sku": {
+                "name": "Premium",
+                "capacity": 1
+              },
+              "publicIPAddresses": [
+                "23.101.138.153"
+              ],
+              "gatewayRegionalUrl": "https://apimService1-eastus-01.regional.azure-api.net",
+              "disableGateway": true
+            }
+          ],
+          "customProperties": {
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Ssl30": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "False"
+          },
+          "virtualNetworkType": "None",
+          "disableGateway": false,
+          "apiVersionConstraint": {
+            "minApiVersion": "2019-01-01"
+          }
+        },
+        "sku": {
+          "name": "Premium",
+          "capacity": 1
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceGetServiceHavingMsi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceGetServiceHavingMsi.json
new file mode 100644
index 000000000000..eb2dc24a72f9
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceGetServiceHavingMsi.json
@@ -0,0 +1,87 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+        "name": "apimService1",
+        "type": "Microsoft.ApiManagement/service",
+        "tags": {},
+        "location": "West Europe",
+        "etag": "AAAAAAAENfI=",
+        "properties": {
+          "publisherEmail": "foo@contoso.com",
+          "publisherName": "Contoso",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Succeeded",
+          "targetProvisioningState": "",
+          "createdAtUtc": "2016-04-12T00:20:15.6018952Z",
+          "gatewayUrl": "https://apimService1.azure-api.net",
+          "gatewayRegionalUrl": "https://apimService1-westeurope-01.regional.azure-api.net",
+          "portalUrl": "https://apimService1.portal.azure-api.net",
+          "developerPortalUrl": "https://apimService1.developer.azure-api.net",
+          "managementApiUrl": "https://apimService1.management.azure-api.net",
+          "scmUrl": "https://apimService1.scm.azure-api.net",
+          "hostnameConfigurations": [
+            {
+              "type": "Proxy",
+              "hostName": "apimService1.azure-api.net",
+              "negotiateClientCertificate": false,
+              "defaultSslBinding": false
+            },
+            {
+              "type": "Proxy",
+              "hostName": "proxy.msitesting.net",
+              "keyVaultId": "https://samir-msi-keyvault.vault.azure.net/secrets/msicertificate",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2020-12-18T11:11:47+00:00",
+                "thumbprint": "9833D531D7A45XXXXXA85908BD3692E0BD3F",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": true
+            }
+          ],
+          "publicIPAddresses": [
+            "13.94.xxx.188"
+          ],
+          "virtualNetworkConfiguration": {
+            "subnetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/dfVirtualNetwork/subnets/backendSubnet"
+          },
+          "customProperties": {
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "True",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "True",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Ssl30": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "True",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "True",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "True",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "False",
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "False"
+          },
+          "virtualNetworkType": "External",
+          "disableGateway": false
+        },
+        "sku": {
+          "name": "Premium",
+          "capacity": 1
+        },
+        "identity": {
+          "type": "SystemAssigned, UserAssigned",
+          "principalId": "ca1d33f7-xxxx-42ec-xxxx-d526a1ee953a",
+          "tenantId": "72f988bf-xxxx-41af-xxxx-2d7cd011db47",
+          "userAssignedIdentities": {
+            "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/apimService1": {
+              "principalId": "95194df2-9208-xxxx-xxxx-a10d2af9b5a3",
+              "clientId": "aaff9c7d-xxxx-4db2-xxxx-ab0e3e7806cf"
+            }
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceGetSsoToken.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceGetSsoToken.json
new file mode 100644
index 000000000000..725e3d7c0269
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementServiceGetSsoToken.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "redirectUri": "https://apimService1.portal.azure-api.net:443/signin-sso?token=1%26201705301929%26eIkr3%2fnfaLs1GVJ0OVbzkJjAcwPFkEZAPM8VUXvXPf7cJ6lWsB9oUwsk2zln9x0KLkn21txCPJWWheSPq7SNeA%3d%3d"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementSubscriptionRegeneratePrimaryKey.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementSubscriptionRegeneratePrimaryKey.json
new file mode 100644
index 000000000000..f6684622edb6
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementSubscriptionRegeneratePrimaryKey.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "sid": "testsub"
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementSubscriptionRegenerateSecondaryKey.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementSubscriptionRegenerateSecondaryKey.json
new file mode 100644
index 000000000000..f6684622edb6
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementSubscriptionRegenerateSecondaryKey.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "sid": "testsub"
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementTenantAccessRegenerateKey.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementTenantAccessRegenerateKey.json
new file mode 100644
index 000000000000..5873bde3a578
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementTenantAccessRegenerateKey.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "accessName": "access"
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementTenantAccessSyncState.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementTenantAccessSyncState.json
new file mode 100644
index 000000000000..b0fc99b7ebe3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementTenantAccessSyncState.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "configurationName": "configuration"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "branch": "master",
+        "commitId": "44c29c27a876372e2ea18d9c381cc493a6a89fc5",
+        "isExport": true,
+        "isSynced": false,
+        "isGitEnabled": true,
+        "syncDate": "2016-10-24T19:17:14.3641403Z",
+        "configurationChangeDate": "2017-06-03T00:41:30.9670873Z"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementTenantConfigurationDeploy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementTenantConfigurationDeploy.json
new file mode 100644
index 000000000000..c85deb17a62d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementTenantConfigurationDeploy.json
@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "configurationName": "configuration",
+    "parameters": {
+      "properties": {
+        "branch": "master"
+      }
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tenant/operationResults/5a1af4ae2a6d2e0b688d7517?api-version=2019-12-01"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "5a1af4ae2a6d2e0b688d7517",
+        "status": "Failed",
+        "started": "2017-11-26T17:06:54.303Z",
+        "updated": "2017-11-26T17:07:21.777Z",
+        "error": {
+          "code": "ValidationError",
+          "message": "File not found: 'api-management/configuration.json'"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementTenantConfigurationSave.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementTenantConfigurationSave.json
new file mode 100644
index 000000000000..def0d09d07b4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementTenantConfigurationSave.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "configurationName": "configuration",
+    "parameters": {
+      "properties": {
+        "branch": "master"
+      }
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tenant/operationResults/5a1af57d2a6d2e0b688d751b?api-version=2019-12-01"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "5cae98acb597440f487b0d78",
+        "status": "Succeeded",
+        "started": "2019-04-11T01:30:20.883Z",
+        "updated": "2019-04-11T01:30:41.623Z",
+        "resultInfo": "The configuration was successfully saved to master as commit 709678560f72e689e469cf98ba9ba6d1b7736893.",
+        "error": null,
+        "actionLog": []
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementTenantConfigurationValidate.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementTenantConfigurationValidate.json
new file mode 100644
index 000000000000..96e075ef59e7
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementTenantConfigurationValidate.json
@@ -0,0 +1,172 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "configurationName": "configuration",
+    "parameters": {
+      "properties": {
+        "branch": "master"
+      }
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tenant/operationResults/5a1af64e2a6d2e0b688d751e?api-version=2019-12-01"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "5a1af64e2a6d2e0b688d751e",
+        "status": "Succeeded",
+        "started": "2019-04-11T01:30:51.767Z",
+        "updated": "2019-04-11T01:30:57.653Z",
+        "resultInfo": "Validation is successfull",
+        "actionLog": [
+          {
+            "objectType": "ApiSpecificationContract",
+            "action": "Updated",
+            "objectKey": "57914cb351f68a16889be190;rev=1"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "5768181ea40f7eb6c49f6ac7"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "576819c9a40f7e86289fb3e3"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "576819f1a40f7e86289fb6de"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "57681a67a40f7e72b4132522"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "57681a73a40f7e72b413281d"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "57681a7ea40f7e72b4132b18"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "57681b88a40f7ea0f017f099"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "57681b9fa40f7ea0f017f682"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "57681bb5a40f7ea0f017fc6b"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "57681bcaa40f7ea0f0180254"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "57681bdfa40f7ea0f018083d"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "57681bf5a40f7ea0f0180e26"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "57681c0ea40f7ea0f018140f"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "57681c26a40f7ea0f01819f8"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "57681c83a40f7e85f44db237"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "57681cb2a40f7e85f44dbcd0"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "57681ce3a40f7e85f44dc769"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "57681d1fa40f7e85f44dd202"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "57681d60a40f7e85f44ddc9b"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "57681db4a40f7e85f44de735"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "57681e11a40f7e85f44df1ce"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "57681e73a40f7e85f44dfc67"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "57681f06a40f7e74ec07785c"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "5768211fa40f7e74ec07a74a"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "576823cfa40f7e74ec07d63a"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "5600b57e7e8880006a060001"
+          },
+          {
+            "objectType": "ProductSpecificationContract",
+            "action": "Updated",
+            "objectKey": "5600b57e7e8880006a060002"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateApi.json
new file mode 100644
index 000000000000..089a39404373
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateApi.json
@@ -0,0 +1,20 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "echo-api",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "displayName": "Echo API New",
+        "serviceUrl": "http://echoapi.cloudapp.net/api2",
+        "path": "newecho"
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateApiDiagnostic.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateApiDiagnostic.json
new file mode 100644
index 000000000000..34ec8191ee8f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateApiDiagnostic.json
@@ -0,0 +1,60 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "diagnosticId": "applicationinsights",
+    "apiId": "57d1f7558aa04f15146d9d8a",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "alwaysLog": "allErrors",
+        "loggerId": "/loggers/applicationinsights",
+        "sampling": {
+          "samplingType": "fixed",
+          "percentage": 50
+        },
+        "frontend": {
+          "request": {
+            "headers": [
+              "Content-type"
+            ],
+            "body": {
+              "bytes": 512
+            }
+          },
+          "response": {
+            "headers": [
+              "Content-type"
+            ],
+            "body": {
+              "bytes": 512
+            }
+          }
+        },
+        "backend": {
+          "request": {
+            "headers": [
+              "Content-type"
+            ],
+            "body": {
+              "bytes": 512
+            }
+          },
+          "response": {
+            "headers": [
+              "Content-type"
+            ],
+            "body": {
+              "bytes": 512
+            }
+          }
+        }
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateApiIssue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateApiIssue.json
new file mode 100644
index 000000000000..82056fe126b5
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateApiIssue.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "issueId": "57d2ef278aa04f0ad01d6cdc",
+    "apiId": "57d1f7558aa04f15146d9d8a",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "state": "closed"
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateApiOperation.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateApiOperation.json
new file mode 100644
index 000000000000..2651ff2b92c2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateApiOperation.json
@@ -0,0 +1,50 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "echo-api",
+    "operationId": "operationId",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "displayName": "Retrieve resource",
+        "method": "GET",
+        "urlTemplate": "/resource",
+        "templateParameters": [],
+        "request": {
+          "queryParameters": [
+            {
+              "name": "param1",
+              "description": "A sample parameter that is required and has a default value of \"sample\".",
+              "type": "string",
+              "defaultValue": "sample",
+              "required": true,
+              "values": [
+                "sample"
+              ]
+            }
+          ]
+        },
+        "responses": [
+          {
+            "statusCode": 200,
+            "description": "Returned in all cases.",
+            "representations": [],
+            "headers": []
+          },
+          {
+            "statusCode": 500,
+            "description": "Server Error.",
+            "representations": [],
+            "headers": []
+          }
+        ]
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateApiRelease.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateApiRelease.json
new file mode 100644
index 000000000000..89f88d2f0431
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateApiRelease.json
@@ -0,0 +1,20 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "apiId": "a1",
+    "releaseId": "testrev",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "apiId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/a1",
+        "notes": "yahooagain"
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateApiVersionSet.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateApiVersionSet.json
new file mode 100644
index 000000000000..470a29f46e5a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateApiVersionSet.json
@@ -0,0 +1,20 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "versionSetId": "api1",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "displayName": "api set 1",
+        "versioningScheme": "Segment",
+        "description": "Version configuration"
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateAuthorizationServer.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateAuthorizationServer.json
new file mode 100644
index 000000000000..e5f30ca5d35e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateAuthorizationServer.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "authsid": "newauthServer",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "clientId": "update",
+        "clientSecret": "updated"
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateBackend.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateBackend.json
new file mode 100644
index 000000000000..aecab766a724
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateBackend.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "backendId": "proxybackend",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "description": "description5308",
+        "tls": {
+          "validateCertificateChain": false,
+          "validateCertificateName": true
+        }
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateCache.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateCache.json
new file mode 100644
index 000000000000..d947123af871
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateCache.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "cacheId": "westindia",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "description": "Update Cache in west India"
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateDiagnostic.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateDiagnostic.json
new file mode 100644
index 000000000000..b3dc0d5c634c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateDiagnostic.json
@@ -0,0 +1,59 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "diagnosticId": "applicationinsights",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "alwaysLog": "allErrors",
+        "loggerId": "/loggers/applicationinsights",
+        "sampling": {
+          "samplingType": "fixed",
+          "percentage": 50
+        },
+        "frontend": {
+          "request": {
+            "headers": [
+              "Content-type"
+            ],
+            "body": {
+              "bytes": 512
+            }
+          },
+          "response": {
+            "headers": [
+              "Content-type"
+            ],
+            "body": {
+              "bytes": 512
+            }
+          }
+        },
+        "backend": {
+          "request": {
+            "headers": [
+              "Content-type"
+            ],
+            "body": {
+              "bytes": 512
+            }
+          },
+          "response": {
+            "headers": [
+              "Content-type"
+            ],
+            "body": {
+              "bytes": 512
+            }
+          }
+        }
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateEmailTemplate.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateEmailTemplate.json
new file mode 100644
index 000000000000..d1c232e77a05
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateEmailTemplate.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "templateName": "applicationApprovedNotificationMessage",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "subject": "Your application $AppName is published in the gallery",
+        "body": "<!DOCTYPE html >\r\n<html>\r\n  <head />\r\n  <body>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">Dear $DevFirstName $DevLastName,</p>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">\r\n          We are happy to let you know that your request to publish the $AppName application in the gallery has been approved. Your application has been published and can be viewed <a href=\"http://$DevPortalUrl/Applications/Details/$AppId\">here</a>.\r\n        </p>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">Best,</p>\r\n    <p style=\"font-size:12pt;font-family:'Segoe UI'\">The $OrganizationName API Team</p>\r\n  </body>\r\n</html>"
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateGateway.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateGateway.json
new file mode 100644
index 000000000000..3dc6dcc30e96
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateGateway.json
@@ -0,0 +1,21 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "description": "my gateway 1",
+        "locationData": {
+          "name": "my location"
+        }
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateGroup.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateGroup.json
new file mode 100644
index 000000000000..c2b6dfcac83d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateGroup.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "groupId": "tempgroup",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "displayName": "temp group"
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateIdentityProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateIdentityProvider.json
new file mode 100644
index 000000000000..79cbfaad8b0a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateIdentityProvider.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "identityProviderName": "facebook",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "clientId": "updatedfacebookid",
+        "clientSecret": "updatedfacebooksecret"
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateLogger.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateLogger.json
new file mode 100644
index 000000000000..a2198ff06113
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateLogger.json
@@ -0,0 +1,21 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "loggerId": "loggerId",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "credentials": {
+          "name": "hydraeventhub",
+          "connectionString": "Endpoint=sb://hydraeventhub-ns.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=********="
+        }
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateNamedValue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateNamedValue.json
new file mode 100644
index 000000000000..875a34adcfa0
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateNamedValue.json
@@ -0,0 +1,44 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "namedValueId": "testprop2",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "displayName": "prop3name",
+        "value": "propValue",
+        "tags": [
+          "foo",
+          "bar2"
+        ],
+        "secret": false
+      }
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/namedValues/testprop2?api-version=2019-12-01&asyncId=5c730e343244df1b9cb56e85&asyncCode=204"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/namedValues/testprop2",
+        "type": "Microsoft.ApiManagement/service/namedValues",
+        "properties": {
+          "displayName": "prop3name",
+          "value": "propValue",
+          "tags": [
+            "foo",
+            "bar2"
+          ],
+          "secret": false
+        }
+      }
+    },
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateOpenIdConnectProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateOpenIdConnectProvider.json
new file mode 100644
index 000000000000..daefba143640
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateOpenIdConnectProvider.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "opid": "templateOpenIdConnect2",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "clientSecret": "updatedsecret"
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateProduct.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateProduct.json
new file mode 100644
index 000000000000..e18a4e623344
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateProduct.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "productId": "testproduct",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "displayName": "Test Template ProductName 4"
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateQuotaCounterKey.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateQuotaCounterKey.json
new file mode 100644
index 000000000000..e912200c09ab
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateQuotaCounterKey.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "quotaCounterKey": "ba",
+    "parameters": {
+      "callsCount": 0,
+      "kbTransferred": 2.5630078125
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateQuotaCounterKeyByQuotaPeriod.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateQuotaCounterKeyByQuotaPeriod.json
new file mode 100644
index 000000000000..5e43c0fb4956
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateQuotaCounterKeyByQuotaPeriod.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "quotaCounterKey": "ba",
+    "quotaPeriodKey": "0_P3Y6M4DT12H30M5S",
+    "parameters": {
+      "callsCount": 0,
+      "kbTransferred": 0
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateServiceDisableTls10.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateServiceDisableTls10.json
new file mode 100644
index 000000000000..d11fca486730
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateServiceDisableTls10.json
@@ -0,0 +1,92 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "parameters": {
+      "properties": {
+        "customProperties": {
+          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "false"
+        }
+      }
+    }
+  },
+  "responses": {
+    "202": {
+      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+      "name": "apimService1",
+      "type": "Microsoft.ApiManagement/service",
+      "tags": {
+        "TestExpiration": "Thu, 29 Jun 2017 18:50:40 GMT"
+      },
+      "location": "West US",
+      "etag": "AAAAAAAYRPs=",
+      "properties": {
+        "publisherEmail": "admin@live.com",
+        "publisherName": "Contoso",
+        "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+        "provisioningState": "Succeeded",
+        "targetProvisioningState": "",
+        "createdAtUtc": "2017-06-29T17:50:42.3191122Z",
+        "gatewayUrl": "https://apimService1.azure-api.net",
+        "portalUrl": "https://apimService1.portal.azure-api.net",
+        "managementApiUrl": "https://apimService1.management.azure-api.net",
+        "scmUrl": "https://apimService1.scm.azure-api.net",
+        "hostnameConfigurations": [],
+        "publicIPAddresses": [
+          "40.86.176.232"
+        ],
+        "customProperties": {
+          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "False"
+        },
+        "virtualNetworkType": "None"
+      },
+      "sku": {
+        "name": "Standard",
+        "capacity": 1
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+        "name": "apimService1",
+        "type": "Microsoft.ApiManagement/service",
+        "tags": {
+          "Owner": "sasolank",
+          "UID": "4f5025fe-0669-4e2e-8320-5199466e5eb3",
+          "Reserved": "",
+          "TestExpiration": "Thu, 29 Jun 2017 18:50:40 GMT",
+          "Pool": "Manual",
+          "TestSuiteExpiration": "Thu, 29 Jun 2017 18:51:46 GMT"
+        },
+        "location": "West US",
+        "etag": "AAAAAAAYRPs=",
+        "properties": {
+          "publisherEmail": "admin@live.com",
+          "publisherName": "Contoso",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Succeeded",
+          "targetProvisioningState": "",
+          "createdAtUtc": "2017-06-29T17:50:42.3191122Z",
+          "gatewayUrl": "https://apimService1.azure-api.net",
+          "portalUrl": "https://apimService1.portal.azure-api.net",
+          "managementApiUrl": "https://apimService1.management.azure-api.net",
+          "scmUrl": "https://apimService1.scm.azure-api.net",
+          "hostnameConfigurations": [],
+          "publicIPAddresses": [
+            "40.86.176.232"
+          ],
+          "customProperties": {
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "False"
+          },
+          "virtualNetworkType": "None"
+        },
+        "sku": {
+          "name": "Standard",
+          "capacity": 1
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateServicePublisherDetails.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateServicePublisherDetails.json
new file mode 100644
index 000000000000..49006089a137
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateServicePublisherDetails.json
@@ -0,0 +1,91 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "parameters": {
+      "properties": {
+        "publisherEmail": "foobar@live.com",
+        "publisherName": "Contoso Vnext"
+      }
+    }
+  },
+  "responses": {
+    "202": {
+      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+      "name": "apimService1",
+      "type": "Microsoft.ApiManagement/service",
+      "tags": {
+        "TestExpiration": "Thu, 29 Jun 2017 18:50:40 GMT"
+      },
+      "location": "West US",
+      "etag": "AAAAAAAYRPs=",
+      "properties": {
+        "publisherEmail": "admin@live.com",
+        "publisherName": "Contoso",
+        "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+        "provisioningState": "Succeeded",
+        "targetProvisioningState": "",
+        "createdAtUtc": "2017-06-29T17:50:42.3191122Z",
+        "gatewayUrl": "https://apimService1.azure-api.net",
+        "portalUrl": "https://apimService1.portal.azure-api.net",
+        "managementApiUrl": "https://apimService1.management.azure-api.net",
+        "scmUrl": "https://apimService1.scm.azure-api.net",
+        "hostnameConfigurations": [],
+        "publicIPAddresses": [
+          "40.86.176.232"
+        ],
+        "customProperties": {
+          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "False"
+        },
+        "virtualNetworkType": "None"
+      },
+      "sku": {
+        "name": "Standard",
+        "capacity": 1
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+        "name": "apimService1",
+        "type": "Microsoft.ApiManagement/service",
+        "tags": {
+          "Owner": "sasolank",
+          "UID": "4f5025fe-0669-4e2e-8320-5199466e5eb3",
+          "Reserved": "",
+          "TestExpiration": "Thu, 29 Jun 2017 18:50:40 GMT",
+          "Pool": "Manual",
+          "TestSuiteExpiration": "Thu, 29 Jun 2017 18:51:46 GMT"
+        },
+        "location": "West US",
+        "etag": "AAAAAAAYRPs=",
+        "properties": {
+          "publisherEmail": "foobar@live.com",
+          "publisherName": "Contoso Vnext",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Succeeded",
+          "targetProvisioningState": "",
+          "createdAtUtc": "2017-06-29T17:50:42.3191122Z",
+          "gatewayUrl": "https://apimService1.azure-api.net",
+          "portalUrl": "https://apimService1.portal.azure-api.net",
+          "managementApiUrl": "https://apimService1.management.azure-api.net",
+          "scmUrl": "https://apimService1.scm.azure-api.net",
+          "hostnameConfigurations": [],
+          "publicIPAddresses": [
+            "40.86.176.232"
+          ],
+          "customProperties": {
+            "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "False"
+          },
+          "virtualNetworkType": "None"
+        },
+        "sku": {
+          "name": "Standard",
+          "capacity": 1
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateSubscription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateSubscription.json
new file mode 100644
index 000000000000..df1350c11170
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateSubscription.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "sid": "testsub",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "displayName": "testsub"
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateTag.json
new file mode 100644
index 000000000000..2f303b4499db
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateTag.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "tagId": "temptag",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "displayName": "temp tag"
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateTenantAccess.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateTenantAccess.json
new file mode 100644
index 000000000000..f5557f535861
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateTenantAccess.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "If-Match": "*",
+    "accessName": "access",
+    "parameters": {
+      "properties": {
+        "enabled": true
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateUser.json
new file mode 100644
index 000000000000..2940dd294984
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUpdateUser.json
@@ -0,0 +1,20 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "userId": "5931a75ae4bbd512288c680b",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "firstName": "foo",
+        "lastName": "bar",
+        "email": "foobar@outlook.com"
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUserConfirmationPasswordSend.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUserConfirmationPasswordSend.json
new file mode 100644
index 000000000000..d70945f936e4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUserConfirmationPasswordSend.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "userId": "57127d485157a511ace86ae7"
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUserGenerateSsoUrl.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUserGenerateSsoUrl.json
new file mode 100644
index 000000000000..eedfa578f37d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUserGenerateSsoUrl.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "userId": "57127d485157a511ace86ae7"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": "https://apimService1.portal.azure-api.net/signin-sso?token=57127d485157a511ace86ae7%26201706051624%267VY18MlwAom***********2bYr2bDQHg21OzQsNakExQ%3d%3d"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUserToken.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUserToken.json
new file mode 100644
index 000000000000..725308f3c6d0
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementUserToken.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-12-01",
+    "subscriptionId": "subid",
+    "userId": "userId1718",
+    "parameters": {
+      "properties": {
+        "keyType": "primary",
+        "expiry": "2019-04-21T00:44:24.2845269Z"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": "userId1718&201904210044&9A1GR1f5WIhFvFmzQG+xxxxxxxxxxx/kBeu87DWad3tkasUXuvPL+MgzlwUHyg=="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/readme.go.md b/specification/apimanagement/resource-manager/readme.go.md
index 0c9af5512386..13dd80276077 100644
--- a/specification/apimanagement/resource-manager/readme.go.md
+++ b/specification/apimanagement/resource-manager/readme.go.md
@@ -13,6 +13,7 @@ go:
 
 ``` yaml $(go) && $(multiapi)
 batch:
+  - tag: package-2019-12
   - tag: package-preview-2019-12
   - tag: package-2019-01
   - tag: package-2018-06-preview
@@ -22,6 +23,15 @@ batch:
   - tag: package-2016-07
 ```
 
+### Tag: package-2019-12 and go
+
+These settings apply only when `--tag=package-2019-12 --go` is specified on the command line.
+Please also specify `--go-sdk-folder=<path to the root directory of your azure-sdk-for-go clone>`.
+
+``` yaml $(tag) == 'package-2019-12' && $(go)
+output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2019-12-01/$(namespace)
+```
+
 ### Tag: package-preview-2019-12 and go
 
 These settings apply only when `--tag=package-preview-2019-12 --go` is specified on the command line.
diff --git a/specification/apimanagement/resource-manager/readme.java.md b/specification/apimanagement/resource-manager/readme.java.md
index 05b9c45f8911..3151673d46c4 100644
--- a/specification/apimanagement/resource-manager/readme.java.md
+++ b/specification/apimanagement/resource-manager/readme.java.md
@@ -16,6 +16,7 @@ output-folder: $(azure-libraries-for-java-folder)/azure-mgmt-apimanagement
 
 ``` yaml $(java) && $(multiapi)
 batch:
+  - tag: package-2019-12
   - tag: package-2019-01
   - tag: package-2018-06-preview
   - tag: package-2018-01
@@ -24,6 +25,19 @@ batch:
   - tag: package-2016-07
 ```
 
+### Tag: package-2019-12 and java
+
+These settings apply only when `--tag=package-2019-12 --java` is specified on the command line.
+Please also specify `--azure-libraries-for-java=<path to the root directory of your azure-sdk-for-java clone>`.
+
+``` yaml $(tag) == 'package-2019-12' && $(java) && $(multiapi)
+java:
+  namespace: com.microsoft.azure.management.apimanagement.v2019_12_01
+  output-folder: $(azure-libraries-for-java-folder)/sdk/apimanagement/mgmt-v2019_12_01
+regenerate-manager: true
+generate-interface: true
+```
+
 ### Tag: package-2019-01 and java
 
 These settings apply only when `--tag=package-2019-01 --java` is specified on the command line.
diff --git a/specification/apimanagement/resource-manager/readme.md b/specification/apimanagement/resource-manager/readme.md
index 97872265b06c..8898b1f52777 100644
--- a/specification/apimanagement/resource-manager/readme.md
+++ b/specification/apimanagement/resource-manager/readme.md
@@ -28,15 +28,56 @@ These are the global settings for the ApiManagement API.
 title: ApiManagementClient
 description: ApiManagement Client
 openapi-type: arm
-tag: package-preview-2019-12
+tag: package-2019-12
 ```
 
 
+### Tag: package-2019-12
+
+These settings apply only when `--tag=package-2019-12` is specified on the command line.
+
+``` yaml $(tag) == 'package-2019-12'
+input-file:
+  - Microsoft.ApiManagement/stable/2019-12-01/apimanagement.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimapis.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimapisByTags.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimapiversionsets.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimauthorizationservers.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimbackends.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimcaches.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimcertificates.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimdeployment.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimdiagnostics.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimemailtemplates.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimgateways.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimgroups.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimidentityprovider.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimissues.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimloggers.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimnamedvalues.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimnetworkstatus.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimnotifications.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimopenidconnectproviders.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimpolicies.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimpolicydescriptions.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimportalsettings.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimproducts.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimproductsByTags.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimquotas.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimregions.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimreports.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimsubscriptions.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimtagresources.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimtags.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimtenant.json
+  - Microsoft.ApiManagement/stable/2019-12-01/apimusers.json
+  - Microsoft.ApiManagement/stable/2019-12-01/definitions.json
+```
 ### Tag: package-preview-2019-12
 
 These settings apply only when `--tag=package-preview-2019-12` is specified on the command line.
 
-```yaml $(tag) == 'package-preview-2019-12'
+``` yaml $(tag) == 'package-preview-2019-12'
 input-file:
   - Microsoft.ApiManagement/preview/2019-12-01-preview/apimanagement.json
   - Microsoft.ApiManagement/preview/2019-12-01-preview/apimapis.json
@@ -73,11 +114,12 @@ input-file:
   - Microsoft.ApiManagement/preview/2019-12-01-preview/apimusers.json
   - Microsoft.ApiManagement/preview/2019-12-01-preview/definitions.json
 ```
+
 ### Tag: package-2019-01
 
 These settings apply only when `--tag=package-2019-01` is specified on the command line.
 
-```yaml $(tag) == 'package-2019-01'
+``` yaml $(tag) == 'package-2019-01'
 input-file:
   - Microsoft.ApiManagement/stable/2019-01-01/apimanagement.json
   - Microsoft.ApiManagement/stable/2019-01-01/apimapis.json
@@ -342,6 +384,40 @@ require: $(this-folder)/../../../profiles/readme.md
 
 # all the input files across all versions
 input-file:
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimanagement.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimapis.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimapisByTags.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimapiversionsets.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimauthorizationservers.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimbackends.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimcaches.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimcertificates.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimdeployment.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimdiagnostics.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimemailtemplates.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimgateways.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimgroups.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimidentityprovider.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimissues.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimloggers.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimnamedvalues.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimnetworkstatus.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimnotifications.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimopenidconnectproviders.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimpolicies.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimpolicydescriptions.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimportalsettings.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimproducts.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimproductsByTags.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimquotas.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimregions.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimreports.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimsubscriptions.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimtagresources.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimtags.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimtenant.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/apimusers.json
+  - $(this-folder)/Microsoft.ApiManagement/stable/2019-12-01/definitions.json
   - $(this-folder)/Microsoft.ApiManagement/preview/2019-12-01-preview/apimanagement.json
   - $(this-folder)/Microsoft.ApiManagement/preview/2019-12-01-preview/apimapis.json
   - $(this-folder)/Microsoft.ApiManagement/preview/2019-12-01-preview/apimapisByTags.json
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2019-11-01-preview/examples/ConfigurationStoresCreate.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2019-11-01-preview/examples/ConfigurationStoresCreate.json
index 00828632bdc6..e167cae4c1e2 100644
--- a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2019-11-01-preview/examples/ConfigurationStoresCreate.json
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2019-11-01-preview/examples/ConfigurationStoresCreate.json
@@ -7,7 +7,7 @@
     "configStoreCreationParameters": {
       "location": "westus",
       "sku": {
-        "name": "Free"
+        "name": "Standard"
       },
       "tags": {
         "myTag": "myTagValue"
@@ -30,7 +30,7 @@
           }
         },
         "sku": {
-          "name": "Free"
+          "name": "Standard"
         },
         "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso",
         "name": "contoso",
@@ -55,7 +55,7 @@
           }
         },
         "sku": {
-          "name": "Free"
+          "name": "Standard"
         },
         "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso",
         "name": "contoso",
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2019-11-01-preview/examples/ConfigurationStoresCreateWithIdentity.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2019-11-01-preview/examples/ConfigurationStoresCreateWithIdentity.json
index 2b33cac0dcf9..44fbe46621c5 100644
--- a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2019-11-01-preview/examples/ConfigurationStoresCreateWithIdentity.json
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2019-11-01-preview/examples/ConfigurationStoresCreateWithIdentity.json
@@ -7,7 +7,7 @@
     "configStoreCreationParameters": {
       "location": "westus",
       "sku": {
-        "name": "Free"
+        "name": "Standard"
       },
       "tags": {
         "myTag": "myTagValue"
@@ -36,7 +36,7 @@
           }
         },
         "sku": {
-          "name": "Free"
+          "name": "Standard"
         },
         "identity": {
           "principalId": "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA",
@@ -72,7 +72,7 @@
           }
         },
         "sku": {
-          "name": "Free"
+          "name": "Standard"
         },
         "identity": {
           "principalId": "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA",
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2019-11-01-preview/examples/ConfigurationStoresGet.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2019-11-01-preview/examples/ConfigurationStoresGet.json
index 7b235423347f..cf2f127f1a63 100644
--- a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2019-11-01-preview/examples/ConfigurationStoresGet.json
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2019-11-01-preview/examples/ConfigurationStoresGet.json
@@ -21,7 +21,7 @@
           }
         },
         "sku": {
-          "name": "Free"
+          "name": "Standard"
         },
         "identity": {
           "principalId": "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA",
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2019-11-01-preview/examples/ConfigurationStoresList.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2019-11-01-preview/examples/ConfigurationStoresList.json
index 07b7476e3fb4..c445586d33c3 100644
--- a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2019-11-01-preview/examples/ConfigurationStoresList.json
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2019-11-01-preview/examples/ConfigurationStoresList.json
@@ -21,7 +21,7 @@
               }
             },
             "sku": {
-              "name": "Free"
+              "name": "Standard"
             },
             "identity": {
               "principalId": "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA",
@@ -47,7 +47,7 @@
               }
             },
             "sku": {
-              "name": "Free"
+              "name": "Standard"
             },
             "identity": {
               "principalId": "CCCCCCCC-CCCC-CCCC-CCCC-CCCCCCCCCCCC",
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2019-11-01-preview/examples/ConfigurationStoresListByResourceGroup.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2019-11-01-preview/examples/ConfigurationStoresListByResourceGroup.json
index b661aacd4cee..cfb5b11382be 100644
--- a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2019-11-01-preview/examples/ConfigurationStoresListByResourceGroup.json
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2019-11-01-preview/examples/ConfigurationStoresListByResourceGroup.json
@@ -22,7 +22,7 @@
               }
             },
             "sku": {
-              "name": "Free"
+              "name": "Standard"
             },
             "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso",
             "name": "contoso",
@@ -43,7 +43,7 @@
               }
             },
             "sku": {
-              "name": "Free"
+              "name": "Standard"
             },
             "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso2",
             "name": "contoso2",
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/stable/2019-10-01/examples/ConfigurationStoresCreate.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/stable/2019-10-01/examples/ConfigurationStoresCreate.json
index 2920e1843a1d..e321e0cbe41e 100644
--- a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/stable/2019-10-01/examples/ConfigurationStoresCreate.json
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/stable/2019-10-01/examples/ConfigurationStoresCreate.json
@@ -7,7 +7,7 @@
     "configStoreCreationParameters": {
       "location": "westus",
       "sku": {
-        "name": "Free"
+        "name": "Standard"
       },
       "tags": {
         "myTag": "myTagValue"
@@ -24,7 +24,7 @@
           "endpoint": "https://contoso.azconfig.io"
         },
         "sku": {
-          "name": "Free"
+          "name": "Standard"
         },
         "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso",
         "name": "contoso",
@@ -43,7 +43,7 @@
           "endpoint": "https://contoso.azconfig.io"
         },
         "sku": {
-          "name": "Free"
+          "name": "Standard"
         },
         "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso",
         "name": "contoso",
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/stable/2019-10-01/examples/ConfigurationStoresCreateWithIdentity.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/stable/2019-10-01/examples/ConfigurationStoresCreateWithIdentity.json
index 3cbc337a1050..6e0499da6823 100644
--- a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/stable/2019-10-01/examples/ConfigurationStoresCreateWithIdentity.json
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/stable/2019-10-01/examples/ConfigurationStoresCreateWithIdentity.json
@@ -7,7 +7,7 @@
     "configStoreCreationParameters": {
       "location": "westus",
       "sku": {
-        "name": "Free"
+        "name": "Standard"
       },
       "tags": {
         "myTag": "myTagValue"
@@ -30,7 +30,7 @@
           "endpoint": "https://contoso.azconfig.io"
         },
         "sku": {
-          "name": "Free"
+          "name": "Standard"
         },
         "identity": {
           "principalId": "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA",
@@ -60,7 +60,7 @@
           "endpoint": "https://contoso.azconfig.io"
         },
         "sku": {
-          "name": "Free"
+          "name": "Standard"
         },
         "identity": {
           "principalId": "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA",
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/stable/2019-10-01/examples/ConfigurationStoresGet.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/stable/2019-10-01/examples/ConfigurationStoresGet.json
index d7ebe442f94c..4a224773c768 100644
--- a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/stable/2019-10-01/examples/ConfigurationStoresGet.json
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/stable/2019-10-01/examples/ConfigurationStoresGet.json
@@ -15,7 +15,7 @@
           "endpoint": "https://contoso.azconfig.io"
         },
         "sku": {
-          "name": "Free"
+          "name": "Standard"
         },
         "identity": {
           "principalId": "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA",
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/stable/2019-10-01/examples/ConfigurationStoresList.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/stable/2019-10-01/examples/ConfigurationStoresList.json
index cf2acb8b5872..ec7dd6e4c3d1 100644
--- a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/stable/2019-10-01/examples/ConfigurationStoresList.json
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/stable/2019-10-01/examples/ConfigurationStoresList.json
@@ -15,7 +15,7 @@
               "endpoint": "https://contoso.azconfig.io"
             },
             "sku": {
-              "name": "Free"
+              "name": "Standard"
             },
             "identity": {
               "principalId": "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA",
@@ -35,7 +35,7 @@
               "endpoint": "https://contoso2.azconfig.io"
             },
             "sku": {
-              "name": "Free"
+              "name": "Standard"
             },
             "identity": {
               "principalId": "CCCCCCCC-CCCC-CCCC-CCCC-CCCCCCCCCCCC",
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/stable/2019-10-01/examples/ConfigurationStoresListByResourceGroup.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/stable/2019-10-01/examples/ConfigurationStoresListByResourceGroup.json
index cbbcd48ce240..80ca3dbf46e3 100644
--- a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/stable/2019-10-01/examples/ConfigurationStoresListByResourceGroup.json
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/stable/2019-10-01/examples/ConfigurationStoresListByResourceGroup.json
@@ -16,7 +16,7 @@
               "endpoint": "https://contoso.azconfig.io"
             },
             "sku": {
-              "name": "Free"
+              "name": "Standard"
             },
             "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso",
             "name": "contoso",
@@ -31,7 +31,7 @@
               "endpoint": "https://contoso2.azconfig.io"
             },
             "sku": {
-              "name": "Free"
+              "name": "Standard"
             },
             "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso2",
             "name": "contoso2",
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/componentProactiveDetection_API.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/componentProactiveDetection_API.json
index 60b21037da39..0402072c012c 100644
--- a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/componentProactiveDetection_API.json
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/componentProactiveDetection_API.json
@@ -40,13 +40,13 @@
         "operationId": "ProactiveDetectionConfigurations_List",
         "parameters": [
           {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
           },
           {
-            "$ref": "#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
           },
           {
             "$ref": "#/parameters/ResourceNameParameter"
@@ -73,13 +73,13 @@
         "operationId": "ProactiveDetectionConfigurations_Get",
         "parameters": [
           {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
           },
           {
-            "$ref": "#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
           },
           {
             "$ref": "#/parameters/ResourceNameParameter"
@@ -107,13 +107,13 @@
         "operationId": "ProactiveDetectionConfigurations_Update",
         "parameters": [
           {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
           },
           {
-            "$ref": "#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
           },
           {
             "$ref": "#/parameters/ResourceNameParameter"
@@ -268,28 +268,6 @@
     }
   },
   "parameters": {
-    "SubscriptionIdParameter": {
-      "name": "subscriptionId",
-      "in": "path",
-      "required": true,
-      "type": "string",
-      "description": "The Azure subscription ID."
-    },
-    "ApiVersionParameter": {
-      "name": "api-version",
-      "in": "query",
-      "required": true,
-      "type": "string",
-      "description": "Client Api Version."
-    },
-    "ResourceGroupNameParameter": {
-      "name": "resourceGroupName",
-      "in": "path",
-      "required": true,
-      "type": "string",
-      "description": "The name of the resource group.",
-      "x-ms-parameter-location": "method"
-    },
     "ResourceNameParameter": {
       "name": "resourceName",
       "in": "path",
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/components_API.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/components_API.json
new file mode 100644
index 000000000000..fc10d313cfce
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/components_API.json
@@ -0,0 +1,697 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApplicationInsightsManagementClient",
+    "description": "Azure Application Insights client for Components.",
+    "version": "2018-05-01-preview"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Insights/components": {
+      "get": {
+        "description": "Gets a list of all Application Insights components within a subscription.",
+        "operationId": "Components_List",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A list containing 0 or more Application Insights component definitions.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationInsightsComponentListResult"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ComponentsList.json": {
+            "$ref": "./examples/ComponentsList.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components": {
+      "get": {
+        "description": "Gets a list of Application Insights components within a resource group.",
+        "operationId": "Components_ListByResourceGroup",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A list containing 0 or more Application Insights component definitions.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationInsightsComponentListResult"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ComponentListByResourceGroup": {
+            "$ref": "./examples/ComponentsListByResourceGroup.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components/{resourceName}": {
+      "delete": {
+        "description": "Deletes an Application Insights component.",
+        "operationId": "Components_Delete",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful request when deleting an Application Insights component."
+          },
+          "204": {
+            "description": "The specified component does not exist."
+          }
+        },
+        "x-ms-examples": {
+          "ComponentsDelete": {
+            "$ref": "./examples/ComponentsDelete.json"
+          }
+        }
+      },
+      "get": {
+        "description": "Returns an Application Insights component.",
+        "operationId": "Components_Get",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "An Application Insights Component definition.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationInsightsComponent"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ComponentGet": {
+            "$ref": "./examples/ComponentsGet.json"
+          }
+        }
+      },
+      "put": {
+        "description": "Creates (or updates) an Application Insights component. Note: You cannot specify a different value for InstrumentationKey nor AppId in the Put operation.",
+        "operationId": "Components_CreateOrUpdate",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceNameParameter"
+          },
+          {
+            "name": "InsightProperties",
+            "description": "Properties that need to be specified to create an Application Insights component.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ApplicationInsightsComponent"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful request when creating or updating an Application Insights component. The updated component is returned.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationInsightsComponent"
+            }
+          },
+          "201": {
+            "description": "Updating the Application Insights component's tags was successful. Component tags are updated and returned with the rest of the Component's object properties.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationInsightsComponent"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ComponentCreate": {
+            "$ref": "./examples/ComponentsCreate.json"
+          },
+          "ComponentUpdate": {
+            "$ref": "./examples/ComponentsUpdate.json"
+          }
+        }
+      },
+      "patch": {
+        "description": "Updates an existing component's tags. To update other fields use the CreateOrUpdate method.",
+        "operationId": "Components_UpdateTags",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceNameParameter"
+          },
+          {
+            "name": "ComponentTags",
+            "description": "Updated tag information to set into the component instance.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/TagsResource"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Updating the Application Insights component's tags was successful. Component tags are updated and returned with the rest of the Component's object properties.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationInsightsComponent"
+            }
+          },
+          "201": {
+            "description": "Updating the Application Insights component's tags was successful. Component tags are updated and returned with the rest of the Component's object properties.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationInsightsComponent"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ComponentUpdateTagsOnly": {
+            "$ref": "./examples/ComponentsUpdateTagsOnly.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components/{resourceName}/purge": {
+      "post": {
+        "description": "Purges data in an Application Insights component by a set of user-defined filters.\n\nIn order to manage system resources, purge requests are throttled at 50 requests per hour. You should batch the execution of purge requests by sending a single command whose predicate includes all user identities that require purging. Use the in operator to specify multiple identities. You should run the query prior to using for a purge request to verify that the results are expected.",
+        "operationId": "Components_Purge",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ComponentPurgeParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Accepted request for purging an Application Insights component.",
+            "schema": {
+              "$ref": "#/definitions/ComponentPurgeResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ComponentPurge": {
+            "$ref": "./examples/ComponentsPurge.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components/{resourceName}/operations/{purgeId}": {
+      "get": {
+        "description": "Get status for an ongoing purge operation.",
+        "operationId": "Components_GetPurgeStatus",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ComponentPurgeIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Returns status of purge operation in body of response. e.g.:  running, completed.",
+            "schema": {
+              "$ref": "#/definitions/ComponentPurgeStatusResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ComponentPurge": {
+            "$ref": "./examples/ComponentsPurgeStatus.json"
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "ComponentsResource": {
+      "properties": {
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Azure resource Id"
+        },
+        "name": {
+          "type": "string",
+          "description": "Azure resource name",
+          "readOnly": true
+        },
+        "type": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Azure resource type"
+        },
+        "location": {
+          "type": "string",
+          "description": "Resource location",
+          "x-ms-mutability": [
+            "create",
+            "read"
+          ]
+        },
+        "tags": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Resource tags"
+        }
+      },
+      "required": [
+        "location"
+      ],
+      "x-ms-azure-resource": true,
+      "description": "An azure resource object"
+    },
+    "TagsResource": {
+      "properties": {
+        "tags": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Resource tags"
+        }
+      },
+      "description": "A container holding only the Tags for a resource, allowing the user to update the tags on a WebTest instance."
+    },
+    "ApplicationInsightsComponent": {
+      "properties": {
+        "kind": {
+          "type": "string",
+          "description": "The kind of application that this component refers to, used to customize UI. This value is a freeform string, values should typically be one of the following: web, ios, other, store, java, phone."
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "Properties that define an Application Insights component resource.",
+          "$ref": "#/definitions/ApplicationInsightsComponentProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ComponentsResource"
+        }
+      ],
+      "required": [
+        "kind"
+      ],
+      "description": "An Application Insights component definition."
+    },
+    "ApplicationInsightsComponentProperties": {
+      "description": "Properties that define an Application Insights component resource.",
+      "properties": {
+        "ApplicationId": {
+          "type": "string",
+          "description": "The unique ID of your application. This field mirrors the 'Name' field and cannot be changed.",
+          "readOnly": true
+        },
+        "AppId": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Application Insights Unique ID for your Application."
+        },
+        "Application_Type": {
+          "type": "string",
+          "description": "Type of application being monitored.",
+          "default": "web",
+          "enum": [
+            "web",
+            "other"
+          ],
+          "x-ms-enum": {
+            "name": "ApplicationType",
+            "modelAsString": true
+          },
+          "x-ms-mutability": [
+            "create",
+            "read"
+          ]
+        },
+        "Flow_Type": {
+          "type": "string",
+          "description": "Used by the Application Insights system to determine what kind of flow this component was created by. This is to be set to 'Bluefield' when creating/updating a component via the REST API.",
+          "default": "Bluefield",
+          "enum": [
+            "Bluefield"
+          ],
+          "x-ms-enum": {
+            "name": "FlowType",
+            "modelAsString": true
+          }
+        },
+        "Request_Source": {
+          "type": "string",
+          "description": "Describes what tool created this Application Insights component. Customers using this API should set this to the default 'rest'.",
+          "default": "rest",
+          "enum": [
+            "rest"
+          ],
+          "x-ms-enum": {
+            "name": "RequestSource",
+            "modelAsString": true
+          }
+        },
+        "InstrumentationKey": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Application Insights Instrumentation key. A read-only value that applications can use to identify the destination for all telemetry sent to Azure Application Insights. This value will be supplied upon construction of each new Application Insights component."
+        },
+        "CreationDate": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Creation Date for the Application Insights component, in ISO 8601 format.",
+          "format": "date-time"
+        },
+        "TenantId": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Azure Tenant Id."
+        },
+        "HockeyAppId": {
+          "type": "string",
+          "description": "The unique application ID created when a new application is added to HockeyApp, used for communications with HockeyApp.",
+          "externalDocs": {
+            "url": "https://aka.ms/ewjuel"
+          }
+        },
+        "HockeyAppToken": {
+          "type": "string",
+          "description": "Token used to authenticate communications with between Application Insights and HockeyApp.",
+          "readOnly": true,
+          "externalDocs": {
+            "url": "https://aka.ms/sls76s"
+          }
+        },
+        "provisioningState": {
+          "type": "string",
+          "description": "Current state of this component: whether or not is has been provisioned within the resource group it is defined. Users cannot change this value but are able to read from it. Values will include Succeeded, Deploying, Canceled, and Failed.",
+          "readOnly": true
+        },
+        "SamplingPercentage": {
+          "type": "number",
+          "format": "double",
+          "description": "Percentage of the data produced by the application being monitored that is being sampled for Application Insights telemetry.",
+          "externalDocs": {
+            "url": "https://aka.ms/sl0yqd"
+          }
+        },
+        "ConnectionString": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Application Insights component connection string."
+        },
+        "RetentionInDays": {
+          "type": "integer",
+          "description": "Retention period in days.",
+          "default": 90
+        },
+        "DisableIpMasking": {
+          "type": "boolean",
+          "description": "Disable IP masking."
+        },
+        "ImmediatePurgeDataOn30Days": {
+          "type": "boolean",
+          "description": "Purge data immediately after 30 days."
+        },
+        "PrivateLinkScopedResources": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/PrivateLinkScopedResource"
+          },
+          "description": "List of linked private link scope resources."
+        },
+        "publicNetworkAccessForIngestion": {
+          "description": "The network access type for accessing Application Insights ingestion.",
+          "$ref": "#/definitions/PublicNetworkAccessType"
+        },
+        "publicNetworkAccessForQuery": {
+          "description": "The network access type for accessing Application Insights query.",
+          "$ref": "#/definitions/PublicNetworkAccessType"
+        }
+      },
+      "required": [
+        "Application_Type"
+      ]
+    },
+    "PrivateLinkScopedResource": {
+      "properties": {
+        "ResourceId": {
+          "type": "string",
+          "description": "The full resource Id of the private link scope resource."
+        },
+        "ScopeId": {
+          "type": "string",
+          "description": "The private link scope unique Identifier."
+        }
+      },
+      "description": "The private link scope resource reference."
+    },
+    "ApplicationInsightsComponentListResult": {
+      "description": "Describes the list of Application Insights Resources.",
+      "required": [
+        "value"
+      ],
+      "properties": {
+        "value": {
+          "type": "array",
+          "description": "List of Application Insights component definitions.",
+          "items": {
+            "$ref": "#/definitions/ApplicationInsightsComponent"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "The URI to get the next set of Application Insights component definitions if too many components where returned in the result set."
+        }
+      }
+    },
+    "ComponentPurgeBody": {
+      "description": "Describes the body of a purge request for an App Insights component",
+      "required": [
+        "table",
+        "filters"
+      ],
+      "properties": {
+        "table": {
+          "type": "string",
+          "description": "Table from which to purge data."
+        },
+        "filters": {
+          "type": "array",
+          "description": "The set of columns and filters (queries) to run over them to purge the resulting data.",
+          "items": {
+            "$ref": "#/definitions/ComponentPurgeBodyFilters"
+          }
+        }
+      }
+    },
+    "ComponentPurgeBodyFilters": {
+      "description": "User-defined filters to return data which will be purged from the table.",
+      "properties": {
+        "column": {
+          "description": "The column of the table over which the given query should run",
+          "type": "string"
+        },
+        "operator": {
+          "description": "A query operator to evaluate over the provided column and value(s). Supported operators are ==, =~, in, in~, >, >=, <, <=, between, and have the same behavior as they would in a KQL query.",
+          "type": "string"
+        },
+        "value": {
+          "description": "the value for the operator to function over. This can be a number (e.g., > 100), a string (timestamp >= '2017-09-01') or array of values."
+        },
+        "key": {
+          "description": "When filtering over custom dimensions, this key will be used as the name of the custom dimension.",
+          "type": "string"
+        }
+      }
+    },
+    "ComponentPurgeResponse": {
+      "description": "Response containing operationId for a specific purge action.",
+      "properties": {
+        "operationId": {
+          "description": "Id to use when querying for status for a particular purge operation.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "operationId"
+      ]
+    },
+    "ComponentPurgeStatusResponse": {
+      "description": "Response containing status for a specific purge operation.",
+      "properties": {
+        "status": {
+          "description": "Status of the operation represented by the requested Id.",
+          "type": "string",
+          "enum": [
+            "pending",
+            "completed"
+          ],
+          "x-ms-enum": {
+            "name": "PurgeState",
+            "modelAsString": true
+          }
+        }
+      },
+      "required": [
+        "status"
+      ]
+    },
+    "PublicNetworkAccessType": {
+      "type": "string",
+      "description": "The network access type for operating on the Application Insights Component. By default it is Enabled",
+      "default": "Enabled",
+      "enum": [
+        "Enabled",
+        "Disabled"
+      ],
+      "x-ms-enum": {
+        "name": "PublicNetworkAccessType",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Enabled",
+            "description": "Enables connectivity to Application Insights through public DNS."
+          },
+          {
+            "value": "Disabled",
+            "description": "Disables public connectivity to Application Insights through public DNS."
+          }
+        ]
+      }
+    }
+  },
+  "parameters": {
+    "ResourceNameParameter": {
+      "name": "resourceName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The name of the Application Insights component resource.",
+      "x-ms-parameter-location": "method"
+    },
+    "ComponentPurgeParameter": {
+      "name": "body",
+      "in": "body",
+      "description": "Describes the body of a request to purge data in a single table of an Application Insights component",
+      "required": true,
+      "schema": {
+        "$ref": "#/definitions/ComponentPurgeBody"
+      },
+      "x-ms-parameter-location": "method"
+    },
+    "ComponentPurgeIdParameter": {
+      "name": "purgeId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "In a purge status request, this is the Id of the operation the status of which is returned.",
+      "x-ms-parameter-location": "method"
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsCreate.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsCreate.json
new file mode 100644
index 000000000000..17a28fdee20e
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsCreate.json
@@ -0,0 +1,79 @@
+{
+  "parameters": {
+    "api-version": "2018-05-01-preview",
+    "subscriptionId": "subid",
+    "resourceGroupName": "my-resource-group",
+    "resourceName": "my-component",
+    "InsightProperties": {
+      "location": "South Central US",
+      "kind": "web",
+      "properties": {
+        "Application_Type": "web",
+        "Flow_Type": "Bluefield",
+        "Request_Source": "rest"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component",
+        "name": "my-component",
+        "type": "Microsoft.Insights/components",
+        "location": "South Central US",
+        "tags": "",
+        "kind": "web",
+        "properties": {
+          "ApplicationId": "my-component",
+          "AppId": "887f4bfd-b5fd-40d7-9fc3-123456789abc",
+          "Application_Type": "web",
+          "Flow_Type": "Bluefield",
+          "Request_Source": "rest",
+          "InstrumentationKey": "bc095013-3cf2-45ac-ab47-123456789abc",
+          "CreationDate": "2017-01-24T01:05:38.5934061+00:00",
+          "TenantId": "f438d567-7177-4fe1-a5e3-123456789abc",
+          "HockeyAppId": "",
+          "HockeyAppToken": "",
+          "provisioningState": "Succeeded",
+          "SamplingPercentage": 100.0,
+          "RetentionInDays": 90,
+          "ConnectionString": "InstrumentationKey=bc095013-3cf2-45ac-ab47-123456789abc",
+          "DisableIpMasking": false,
+          "ImmediatePurgeDataOn30Days": false,
+          "publicNetworkAccessForQuery": "Enabled",
+          "publicNetworkAccessForIngestion": "Enabled"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component",
+        "name": "my-component",
+        "type": "Microsoft.Insights/components",
+        "location": "South Central US",
+        "tags": "",
+        "kind": "web",
+        "properties": {
+          "ApplicationId": "my-component",
+          "AppId": "887f4bfd-b5fd-40d7-9fc3-123456789abc",
+          "Application_Type": "web",
+          "Flow_Type": "Bluefield",
+          "Request_Source": "rest",
+          "InstrumentationKey": "bc095013-3cf2-45ac-ab47-123456789abc",
+          "CreationDate": "2017-01-24T01:05:38.5934061+00:00",
+          "TenantId": "f438d567-7177-4fe1-a5e3-123456789abc",
+          "HockeyAppId": "",
+          "HockeyAppToken": "",
+          "provisioningState": "Succeeded",
+          "SamplingPercentage": 100.0,
+          "RetentionInDays": 90,
+          "ConnectionString": "InstrumentationKey=bc095013-3cf2-45ac-ab47-123456789abc",
+          "DisableIpMasking": false,
+          "ImmediatePurgeDataOn30Days": false,
+          "publicNetworkAccessForQuery": "Enabled",
+          "publicNetworkAccessForIngestion": "Enabled"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsDelete.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsDelete.json
new file mode 100644
index 000000000000..523972ebd3d7
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsDelete.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "api-version": "2018-05-01-preview",
+    "subscriptionId": "subid",
+    "resourceGroupName": "my-resource-group",
+    "resourceName": "my-component"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsGet.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsGet.json
new file mode 100644
index 000000000000..3ace22b9672d
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsGet.json
@@ -0,0 +1,40 @@
+{
+  "parameters": {
+    "api-version": "2018-05-01-preview",
+    "subscriptionId": "subid",
+    "resourceGroupName": "my-resource-group",
+    "resourceName": "my-component"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component",
+        "name": "my-component",
+        "type": "Microsoft.Insights/components",
+        "location": "South Central US",
+        "tags": "",
+        "kind": "web",
+        "properties": {
+          "ApplicationId": "my-component",
+          "AppId": "887f4bfd-b5fd-40d7-9fc3-123456789abc",
+          "Application_Type": "web",
+          "Flow_Type": "Bluefield",
+          "Request_Source": "rest",
+          "InstrumentationKey": "bc095013-3cf2-45ac-ab47-123456789abc",
+          "CreationDate": "2017-01-24T01:05:38.5934061+00:00",
+          "TenantId": "f438d567-7177-4fe1-a5e3-123456789abc",
+          "HockeyAppId": "",
+          "HockeyAppToken": "",
+          "provisioningState": "Succeeded",
+          "SamplingPercentage": 100.0,
+          "RetentionInDays": 90,
+          "ConnectionString": "InstrumentationKey=bc095013-3cf2-45ac-ab47-123456789abc",
+          "DisableIpMasking": false,
+          "ImmediatePurgeDataOn30Days": false,
+          "publicNetworkAccessForQuery": "Enabled",
+          "publicNetworkAccessForIngestion": "Enabled"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsList.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsList.json
new file mode 100644
index 000000000000..281a057d8188
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsList.json
@@ -0,0 +1,71 @@
+{
+  "parameters": {
+    "api-version": "2018-05-01-preview",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component",
+            "name": "my-component",
+            "type": "Microsoft.Insights/components",
+            "location": "South Central US",
+            "tags": "",
+            "kind": "web",
+            "properties": {
+              "ApplicationId": "my-component",
+              "AppId": "16526d1a-dfba-4362-a9e9-123456789abc",
+              "Application_Type": "web",
+              "Flow_Type": "Bluefield",
+              "Request_Source": "rest",
+              "InstrumentationKey": "dc5931c7-a7ad-4ad0-89d6-123456789abc",
+              "CreationDate": "2017-02-14T12:24:05.0041213+00:00",
+              "TenantId": "f438d567-7177-4fe1-a5e3-123456789abc",
+              "HockeyAppId": "",
+              "HockeyAppToken": "",
+              "provisioningState": "Succeeded",
+              "SamplingPercentage": 75.0,
+              "RetentionInDays": 90,
+              "ConnectionString": "InstrumentationKey=dc5931c7-a7ad-4ad0-89d6-123456789abc",
+              "DisableIpMasking": false,
+              "ImmediatePurgeDataOn30Days": false,
+              "publicNetworkAccessForQuery": "Enabled",
+              "publicNetworkAccessForIngestion": "Enabled"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/my-other-resource-group/providers/Microsoft.Insights/components/my-other-component",
+            "name": "my-other-component",
+            "type": "Microsoft.Insights/components",
+            "location": "South Central US",
+            "tags": "",
+            "kind": "web",
+            "properties": {
+              "ApplicationId": "my-other-component",
+              "AppId": "887f4bfd-b5fd-40d7-9fc3-123456789abc",
+              "Application_Type": "web",
+              "Flow_Type": "Bluefield",
+              "Request_Source": "rest",
+              "InstrumentationKey": "bc095013-3cf2-45ac-ab47-123456789abc",
+              "CreationDate": "2017-01-24T01:05:38.5934061+00:00",
+              "TenantId": "f438d567-7177-4fe1-a5e3-123456789abc",
+              "HockeyAppId": "",
+              "HockeyAppToken": "",
+              "provisioningState": "Succeeded",
+              "SamplingPercentage": 30.0,
+              "RetentionInDays": 90,
+              "ConnectionString": "InstrumentationKey=bc095013-3cf2-45ac-ab47-123456789abc",
+              "DisableIpMasking": false,
+              "ImmediatePurgeDataOn30Days": false,
+              "publicNetworkAccessForQuery": "Enabled",
+              "publicNetworkAccessForIngestion": "Enabled"
+            }
+          }
+        ],
+        "nextLink": null
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsListByResourceGroup.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsListByResourceGroup.json
new file mode 100644
index 000000000000..cee24e3764c9
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsListByResourceGroup.json
@@ -0,0 +1,72 @@
+{
+  "parameters": {
+    "api-version": "2018-05-01-preview",
+    "subscriptionId": "subid",
+    "resourceGroupName": "my-resource-group"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component",
+            "name": "my-component",
+            "type": "Microsoft.Insights/components",
+            "location": "South Central US",
+            "tags": "",
+            "kind": "web",
+            "properties": {
+              "ApplicationId": "my-component",
+              "AppId": "16526d1a-dfba-4362-a9e9-123456789abc",
+              "Application_Type": "web",
+              "Flow_Type": "Bluefield",
+              "Request_Source": "rest",
+              "InstrumentationKey": "dc5931c7-a7ad-4ad0-89d6-123456789abc",
+              "CreationDate": "2017-02-14T12:24:05.0041213+00:00",
+              "TenantId": "f438d567-7177-4fe1-a5e3-123456789abc",
+              "HockeyAppId": "",
+              "HockeyAppToken": "",
+              "provisioningState": "Succeeded",
+              "SamplingPercentage": 100.0,
+              "RetentionInDays": 90,
+              "ConnectionString": "InstrumentationKey=dc5931c7-a7ad-4ad0-89d6-123456789abc",
+              "DisableIpMasking": false,
+              "ImmediatePurgeDataOn30Days": false,
+              "publicNetworkAccessForQuery": "Enabled",
+              "publicNetworkAccessForIngestion": "Enabled"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/my-other-resource-group/providers/Microsoft.Insights/components/my-other-component",
+            "name": "my-other-component",
+            "type": "Microsoft.Insights/components",
+            "location": "South Central US",
+            "tags": "",
+            "kind": "web",
+            "properties": {
+              "ApplicationId": "my-other-component",
+              "AppId": "887f4bfd-b5fd-40d7-9fc3-123456789abc",
+              "Application_Type": "web",
+              "Flow_Type": "Bluefield",
+              "Request_Source": "rest",
+              "InstrumentationKey": "bc095013-3cf2-45ac-ab47-123456789abc",
+              "CreationDate": "2017-01-24T01:05:38.5934061+00:00",
+              "TenantId": "f438d567-7177-4fe1-a5e3-123456789abc",
+              "HockeyAppId": "",
+              "HockeyAppToken": "",
+              "provisioningState": "Succeeded",
+              "SamplingPercentage": 50.0,
+              "RetentionInDays": 90,
+              "ConnectionString": "InstrumentationKey=bc095013-3cf2-45ac-ab47-123456789abc",
+              "DisableIpMasking": false,
+              "ImmediatePurgeDataOn30Days": false,
+              "publicNetworkAccessForQuery": "Enabled",
+              "publicNetworkAccessForIngestion": "Enabled"
+            }
+          }
+        ],
+        "nextLink": null
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsPurge.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsPurge.json
new file mode 100644
index 000000000000..181a3fffda45
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsPurge.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "resourceGroupName": "OIAutoRest5123",
+    "resourceName": "aztest5048",
+    "api-version": "2015-03-20",
+    "subscriptionId": "00000000-0000-0000-0000-00000000000",
+    "body": {
+      "table": "Heartbeat",
+      "filters": [
+        {
+          "column": "TimeGenerated",
+          "operator": ">",
+          "value": "2017-09-01T00:00:00"
+        }
+      ]
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "x-ms-status-location": "https://management.azure.com/subscriptions/b96161de-b34a-480f-7343-59b099299283/resourceGroups/example/providers/microsoft.insights/components/test/operations/purge-970318e7-b859-4edb-8903-83b1b54d0b74?api-version=2018-05-01-preview"
+      },
+      "body": {
+        "operationId": "7d7cf277-9113-4ab3-8359-d0364b74d01d"
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsPurgeStatus.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsPurgeStatus.json
new file mode 100644
index 000000000000..43af39e5e253
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsPurgeStatus.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "resourceGroupName": "OIAutoRest5123",
+    "resourceName": "aztest5048",
+    "api-version": "2018-05-01-preview",
+    "subscriptionId": "00000000-0000-0000-0000-00000000000",
+    "purgeId": "purge-970318e7-b859-4edb-8903-83b1b54d0b74"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "status": "completed"
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsUpdate.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsUpdate.json
new file mode 100644
index 000000000000..b9df659a3d3f
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsUpdate.json
@@ -0,0 +1,84 @@
+{
+  "parameters": {
+    "api-version": "2018-05-01-preview",
+    "subscriptionId": "subid",
+    "resourceGroupName": "my-resource-group",
+    "resourceName": "my-component",
+    "InsightProperties": {
+      "location": "South Central US",
+      "kind": "web",
+      "tags": {
+        "ApplicationGatewayType": "Internal-Only",
+        "BillingEntity": "Self"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component",
+        "name": "my-component",
+        "type": "Microsoft.Insights/components",
+        "location": "South Central US",
+        "tags": {
+          "ApplicationGatewayType": "Internal-Only",
+          "BillingEntity": "Self"
+        },
+        "kind": "web",
+        "properties": {
+          "ApplicationId": "my-component",
+          "AppId": "887f4bfd-b5fd-40d7-9fc3-123456789abc",
+          "Application_Type": "web",
+          "Flow_Type": "Bluefield",
+          "Request_Source": "rest",
+          "InstrumentationKey": "bc095013-3cf2-45ac-ab47-123456789abc",
+          "CreationDate": "2017-01-24T01:05:38.5934061+00:00",
+          "TenantId": "f438d567-7177-4fe1-a5e3-123456789abc",
+          "HockeyAppId": "",
+          "HockeyAppToken": "",
+          "provisioningState": "Succeeded",
+          "SamplingPercentage": 100.0,
+          "RetentionInDays": 90,
+          "ConnectionString": "InstrumentationKey=bc095013-3cf2-45ac-ab47-123456789abc",
+          "DisableIpMasking": false,
+          "ImmediatePurgeDataOn30Days": false,
+          "publicNetworkAccessForQuery": "Enabled",
+          "publicNetworkAccessForIngestion": "Enabled"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component",
+        "name": "my-component",
+        "type": "Microsoft.Insights/components",
+        "location": "South Central US",
+        "tags": {
+          "ApplicationGatewayType": "Internal-Only",
+          "BillingEntity": "Self"
+        },
+        "kind": "web",
+        "properties": {
+          "ApplicationId": "my-component",
+          "AppId": "887f4bfd-b5fd-40d7-9fc3-123456789abc",
+          "Application_Type": "web",
+          "Flow_Type": "Bluefield",
+          "Request_Source": "rest",
+          "InstrumentationKey": "bc095013-3cf2-45ac-ab47-123456789abc",
+          "CreationDate": "2017-01-24T01:05:38.5934061+00:00",
+          "TenantId": "f438d567-7177-4fe1-a5e3-123456789abc",
+          "HockeyAppId": "",
+          "HockeyAppToken": "",
+          "provisioningState": "Succeeded",
+          "SamplingPercentage": 100.0,
+          "RetentionInDays": 90,
+          "ConnectionString": "InstrumentationKey=bc095013-3cf2-45ac-ab47-123456789abc",
+          "DisableIpMasking": false,
+          "ImmediatePurgeDataOn30Days": false,
+          "publicNetworkAccessForQuery": "Enabled",
+          "publicNetworkAccessForIngestion": "Enabled"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsUpdateTagsOnly.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsUpdateTagsOnly.json
new file mode 100644
index 000000000000..9d8d07877055
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ComponentsUpdateTagsOnly.json
@@ -0,0 +1,91 @@
+{
+  "parameters": {
+    "api-version": "2018-05-01-preview",
+    "subscriptionId": "subid",
+    "resourceGroupName": "my-resource-group",
+    "resourceName": "my-component",
+    "ComponentTags": {
+      "tags": {
+        "ApplicationGatewayType": "Internal-Only",
+        "BillingEntity": "Self",
+        "Color": "AzureBlue",
+        "CustomField_01": "Custom text in some random field named randomly",
+        "NodeType": "Edge"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component",
+        "name": "my-component",
+        "type": "Microsoft.Insights/components",
+        "location": "South Central US",
+        "tags": {
+          "ApplicationGatewayType": "Internal-Only",
+          "BillingEntity": "Self",
+          "Color": "AzureBlue",
+          "CustomField_01": "Custom text in some random field named randomly",
+          "NodeType": "Edge"
+        },
+        "kind": "web",
+        "properties": {
+          "ApplicationId": "my-component",
+          "AppId": "887f4bfd-b5fd-40d7-9fc3-123456789abc",
+          "Application_Type": "web",
+          "Flow_Type": "Bluefield",
+          "Request_Source": "rest",
+          "InstrumentationKey": "bc095013-3cf2-45ac-ab47-123456789abc",
+          "CreationDate": "2017-01-24T01:05:38.5934061+00:00",
+          "TenantId": "f438d567-7177-4fe1-a5e3-123456789abc",
+          "HockeyAppId": "",
+          "HockeyAppToken": "",
+          "provisioningState": "Succeeded",
+          "SamplingPercentage": 100.0,
+          "RetentionInDays": 90,
+          "ConnectionString": "InstrumentationKey=bc095013-3cf2-45ac-ab47-123456789abc",
+          "DisableIpMasking": false,
+          "ImmediatePurgeDataOn30Days": false,
+          "publicNetworkAccessForQuery": "Enabled",
+          "publicNetworkAccessForIngestion": "Enabled"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component",
+        "name": "my-component",
+        "type": "Microsoft.Insights/components",
+        "location": "South Central US",
+        "tags": {
+          "ApplicationGatewayType": "Internal-Only",
+          "BillingEntity": "Self",
+          "Color": "AzureBlue",
+          "CustomField_01": "Custom text in some random field named randomly",
+          "NodeType": "Edge"
+        },
+        "kind": "web",
+        "properties": {
+          "ApplicationId": "my-component",
+          "AppId": "887f4bfd-b5fd-40d7-9fc3-123456789abc",
+          "Application_Type": "web",
+          "Flow_Type": "Bluefield",
+          "Request_Source": "rest",
+          "InstrumentationKey": "bc095013-3cf2-45ac-ab47-123456789abc",
+          "CreationDate": "2017-01-24T01:05:38.5934061+00:00",
+          "TenantId": "f438d567-7177-4fe1-a5e3-123456789abc",
+          "HockeyAppId": "",
+          "HockeyAppToken": "",
+          "provisioningState": "Succeeded",
+          "SamplingPercentage": 100.0,
+          "RetentionInDays": 90,
+          "ConnectionString": "InstrumentationKey=bc095013-3cf2-45ac-ab47-123456789abc",
+          "DisableIpMasking": false,
+          "ImmediatePurgeDataOn30Days": false,
+          "publicNetworkAccessForQuery": "Enabled",
+          "publicNetworkAccessForIngestion": "Enabled"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ProactiveDetectionConfigurationUpdate.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ProactiveDetectionConfigurationUpdate.json
index fe45f18b7301..67b1b1f8ba85 100644
--- a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ProactiveDetectionConfigurationUpdate.json
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2018-05-01/examples/ProactiveDetectionConfigurationUpdate.json
@@ -9,7 +9,6 @@
       "name": "slowpageloadtime",
       "location": "South Central US",
       "properties": {
-        "Name": "slowpageloadtime",
         "Enabled": true,
         "SendEmailsToSubscriptionOwners": true,
         "CustomEmails": [
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/components_API.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/components_API.json
new file mode 100644
index 000000000000..71cb6350a36c
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/components_API.json
@@ -0,0 +1,690 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApplicationInsightsManagementClient",
+    "description": "Azure Application Insights client for Components",
+    "version": "2020-02-02-preview"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Insights/components": {
+      "get": {
+        "description": "Gets a list of all Application Insights components within a subscription.",
+        "operationId": "Components_List",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A list containing 0 or more Application Insights component definitions.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationInsightsComponentListResult"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ComponentsList.json": {
+            "$ref": "./examples/ComponentsList.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components": {
+      "get": {
+        "description": "Gets a list of Application Insights components within a resource group.",
+        "operationId": "Components_ListByResourceGroup",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A list containing 0 or more Application Insights component definitions.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationInsightsComponentListResult"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ComponentListByResourceGroup": {
+            "$ref": "./examples/ComponentsListByResourceGroup.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components/{resourceName}": {
+      "delete": {
+        "description": "Deletes an Application Insights component.",
+        "operationId": "Components_Delete",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful request when deleting an Application Insights component."
+          },
+          "204": {
+            "description": "The specified component does not exist."
+          }
+        },
+        "x-ms-examples": {
+          "ComponentsDelete": {
+            "$ref": "./examples/ComponentsDelete.json"
+          }
+        }
+      },
+      "get": {
+        "description": "Returns an Application Insights component.",
+        "operationId": "Components_Get",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "An Application Insights Component definition.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationInsightsComponent"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ComponentGet": {
+            "$ref": "./examples/ComponentsGet.json"
+          }
+        }
+      },
+      "put": {
+        "description": "Creates (or updates) an Application Insights component. Note: You cannot specify a different value for InstrumentationKey nor AppId in the Put operation.",
+        "operationId": "Components_CreateOrUpdate",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceNameParameter"
+          },
+          {
+            "name": "InsightProperties",
+            "description": "Properties that need to be specified to create an Application Insights component.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ApplicationInsightsComponent"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful request when creating or updating an Application Insights component. The updated component is returned.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationInsightsComponent"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ComponentCreate": {
+            "$ref": "./examples/ComponentsCreate.json"
+          },
+          "ComponentUpdate": {
+            "$ref": "./examples/ComponentsUpdate.json"
+          }
+        }
+      },
+      "patch": {
+        "description": "Updates an existing component's tags. To update other fields use the CreateOrUpdate method.",
+        "operationId": "Components_UpdateTags",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceNameParameter"
+          },
+          {
+            "name": "ComponentTags",
+            "description": "Updated tag information to set into the component instance.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/TagsResource"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Updating the Application Insights component's tags was successful. Component tags are updated and returned with the rest of the Component's object properties.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationInsightsComponent"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ComponentUpdateTagsOnly": {
+            "$ref": "./examples/ComponentsUpdateTagsOnly.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components/{resourceName}/purge": {
+      "post": {
+        "description": "Purges data in an Application Insights component by a set of user-defined filters.\n\nIn order to manage system resources, purge requests are throttled at 50 requests per hour. You should batch the execution of purge requests by sending a single command whose predicate includes all user identities that require purging. Use the in operator to specify multiple identities. You should run the query prior to using for a purge request to verify that the results are expected.",
+        "operationId": "Components_Purge",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ComponentPurgeParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Accepted request for purging an Application Insights component.",
+            "schema": {
+              "$ref": "#/definitions/ComponentPurgeResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ComponentPurge": {
+            "$ref": "./examples/ComponentsPurge.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components/{resourceName}/operations/{purgeId}": {
+      "get": {
+        "description": "Get status for an ongoing purge operation.",
+        "operationId": "Components_GetPurgeStatus",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ComponentPurgeIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Returns status of purge operation in body of response. e.g.:  running, completed.",
+            "schema": {
+              "$ref": "#/definitions/ComponentPurgeStatusResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ComponentPurge": {
+            "$ref": "./examples/ComponentsPurgeStatus.json"
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "ComponentsResource": {
+      "properties": {
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Azure resource Id"
+        },
+        "name": {
+          "type": "string",
+          "description": "Azure resource name",
+          "readOnly": true
+        },
+        "type": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Azure resource type"
+        },
+        "location": {
+          "type": "string",
+          "description": "Resource location",
+          "x-ms-mutability": [
+            "create",
+            "read"
+          ]
+        },
+        "tags": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Resource tags"
+        }
+      },
+      "required": [
+        "location"
+      ],
+      "x-ms-azure-resource": true,
+      "description": "An azure resource object"
+    },
+    "TagsResource": {
+      "properties": {
+        "tags": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Resource tags"
+        }
+      },
+      "description": "A container holding only the Tags for a resource, allowing the user to update the tags on a WebTest instance."
+    },
+    "ApplicationInsightsComponent": {
+      "properties": {
+        "kind": {
+          "type": "string",
+          "description": "The kind of application that this component refers to, used to customize UI. This value is a freeform string, values should typically be one of the following: web, ios, other, store, java, phone."
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "Properties that define an Application Insights component resource.",
+          "$ref": "#/definitions/ApplicationInsightsComponentProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ComponentsResource"
+        }
+      ],
+      "required": [
+        "kind"
+      ],
+      "description": "An Application Insights component definition."
+    },
+    "ApplicationInsightsComponentProperties": {
+      "description": "Properties that define an Application Insights component resource.",
+      "properties": {
+        "ApplicationId": {
+          "type": "string",
+          "description": "The unique ID of your application. This field mirrors the 'Name' field and cannot be changed.",
+          "readOnly": true
+        },
+        "AppId": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Application Insights Unique ID for your Application."
+        },
+        "Application_Type": {
+          "type": "string",
+          "description": "Type of application being monitored.",
+          "default": "web",
+          "enum": [
+            "web",
+            "other"
+          ],
+          "x-ms-enum": {
+            "name": "ApplicationType",
+            "modelAsString": true
+          },
+          "x-ms-mutability": [
+            "create",
+            "read"
+          ]
+        },
+        "Flow_Type": {
+          "type": "string",
+          "description": "Used by the Application Insights system to determine what kind of flow this component was created by. This is to be set to 'Bluefield' when creating/updating a component via the REST API.",
+          "default": "Bluefield",
+          "enum": [
+            "Bluefield"
+          ],
+          "x-ms-enum": {
+            "name": "FlowType",
+            "modelAsString": true
+          }
+        },
+        "Request_Source": {
+          "type": "string",
+          "description": "Describes what tool created this Application Insights component. Customers using this API should set this to the default 'rest'.",
+          "default": "rest",
+          "enum": [
+            "rest"
+          ],
+          "x-ms-enum": {
+            "name": "RequestSource",
+            "modelAsString": true
+          }
+        },
+        "InstrumentationKey": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Application Insights Instrumentation key. A read-only value that applications can use to identify the destination for all telemetry sent to Azure Application Insights. This value will be supplied upon construction of each new Application Insights component."
+        },
+        "CreationDate": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Creation Date for the Application Insights component, in ISO 8601 format.",
+          "format": "date-time"
+        },
+        "TenantId": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Azure Tenant Id."
+        },
+        "HockeyAppId": {
+          "type": "string",
+          "description": "The unique application ID created when a new application is added to HockeyApp, used for communications with HockeyApp.",
+          "externalDocs": {
+            "url": "https://aka.ms/ewjuel"
+          }
+        },
+        "HockeyAppToken": {
+          "type": "string",
+          "description": "Token used to authenticate communications with between Application Insights and HockeyApp.",
+          "readOnly": true,
+          "externalDocs": {
+            "url": "https://aka.ms/sls76s"
+          }
+        },
+        "provisioningState": {
+          "type": "string",
+          "description": "Current state of this component: whether or not is has been provisioned within the resource group it is defined. Users cannot change this value but are able to read from it. Values will include Succeeded, Deploying, Canceled, and Failed.",
+          "readOnly": true
+        },
+        "SamplingPercentage": {
+          "type": "number",
+          "format": "double",
+          "description": "Percentage of the data produced by the application being monitored that is being sampled for Application Insights telemetry.",
+          "externalDocs": {
+            "url": "https://aka.ms/sl0yqd"
+          }
+        },
+        "ConnectionString": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Application Insights component connection string."
+        },
+        "RetentionInDays": {
+          "type": "integer",
+          "description": "Retention period in days.",
+          "readOnly": true
+        },
+        "DisableIpMasking": {
+          "type": "boolean",
+          "description": "Disable IP masking."
+        },
+        "ImmediatePurgeDataOn30Days": {
+          "type": "boolean",
+          "description": "Purge data immediately after 30 days."
+        },
+        "WorkspaceResourceId": {
+          "type": "string",
+          "description": "ResourceId of the log analytics workspace which the data will be ingested to."
+        },
+        "PrivateLinkScopedResources": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/PrivateLinkScopedResource"
+          },
+          "description": "List of linked private link scope resources."
+        },
+        "publicNetworkAccessForIngestion": {
+          "description": "The network access type for accessing Application Insights ingestion.",
+          "$ref": "#/definitions/PublicNetworkAccessType"
+        },
+        "publicNetworkAccessForQuery": {
+          "description": "The network access type for accessing Application Insights query.",
+          "$ref": "#/definitions/PublicNetworkAccessType"
+        }
+      },
+      "required": [
+        "Application_Type",
+        "WorkspaceResourceId"
+      ]
+    },
+    "PrivateLinkScopedResource": {
+      "properties": {
+        "ResourceId": {
+          "type": "string",
+          "description": "The full resource Id of the private link scope resource."
+        },
+        "ScopeId": {
+          "type": "string",
+          "description": "The private link scope unique Identifier."
+        }
+      },
+      "description": "The private link scope resource reference."
+    },
+    "ApplicationInsightsComponentListResult": {
+      "description": "Describes the list of Application Insights Resources.",
+      "required": [
+        "value"
+      ],
+      "properties": {
+        "value": {
+          "type": "array",
+          "description": "List of Application Insights component definitions.",
+          "items": {
+            "$ref": "#/definitions/ApplicationInsightsComponent"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "The URI to get the next set of Application Insights component definitions if too many components where returned in the result set."
+        }
+      }
+    },
+    "ComponentPurgeBody": {
+      "description": "Describes the body of a purge request for an App Insights component",
+      "required": [
+        "table",
+        "filters"
+      ],
+      "properties": {
+        "table": {
+          "type": "string",
+          "description": "Table from which to purge data."
+        },
+        "filters": {
+          "type": "array",
+          "description": "The set of columns and filters (queries) to run over them to purge the resulting data.",
+          "items": {
+            "$ref": "#/definitions/ComponentPurgeBodyFilters"
+          }
+        }
+      }
+    },
+    "ComponentPurgeBodyFilters": {
+      "description": "User-defined filters to return data which will be purged from the table.",
+      "properties": {
+        "column": {
+          "description": "The column of the table over which the given query should run",
+          "type": "string"
+        },
+        "operator": {
+          "description": "A query operator to evaluate over the provided column and value(s). Supported operators are ==, =~, in, in~, >, >=, <, <=, between, and have the same behavior as they would in a KQL query.",
+          "type": "string"
+        },
+        "value": {
+          "description": "the value for the operator to function over. This can be a number (e.g., > 100), a string (timestamp >= '2017-09-01') or array of values."
+        },
+        "key": {
+          "description": "When filtering over custom dimensions, this key will be used as the name of the custom dimension.",
+          "type": "string"
+        }
+      }
+    },
+    "ComponentPurgeResponse": {
+      "description": "Response containing operationId for a specific purge action.",
+      "properties": {
+        "operationId": {
+          "description": "Id to use when querying for status for a particular purge operation.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "operationId"
+      ]
+    },
+    "ComponentPurgeStatusResponse": {
+      "description": "Response containing status for a specific purge operation.",
+      "properties": {
+        "status": {
+          "description": "Status of the operation represented by the requested Id.",
+          "type": "string",
+          "enum": [
+            "pending",
+            "completed"
+          ],
+          "x-ms-enum": {
+            "name": "PurgeState",
+            "modelAsString": true
+          }
+        }
+      },
+      "required": [
+        "status"
+      ]
+    },
+    "PublicNetworkAccessType": {
+      "type": "string",
+      "description": "The network access type for operating on the Application Insights Component. By default it is Enabled",
+      "default": "Enabled",
+      "enum": [
+        "Enabled",
+        "Disabled"
+      ],
+      "x-ms-enum": {
+        "name": "PublicNetworkAccessType",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Enabled",
+            "description": "Enables connectivity to Application Insights through public DNS."
+          },
+          {
+            "value": "Disabled",
+            "description": "Disables public connectivity to Application Insights through public DNS."
+          }
+        ]
+      }
+    }
+  },
+  "parameters": {
+    "ResourceNameParameter": {
+      "name": "resourceName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The name of the Application Insights component resource.",
+      "x-ms-parameter-location": "method"
+    },
+    "ComponentPurgeParameter": {
+      "name": "body",
+      "in": "body",
+      "description": "Describes the body of a request to purge data in a single table of an Application Insights component",
+      "required": true,
+      "schema": {
+        "$ref": "#/definitions/ComponentPurgeBody"
+      },
+      "x-ms-parameter-location": "method"
+    },
+    "ComponentPurgeIdParameter": {
+      "name": "purgeId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "In a purge status request, this is the Id of the operation the status of which is returned.",
+      "x-ms-parameter-location": "method"
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsCreate.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsCreate.json
new file mode 100644
index 000000000000..b60e0da5861a
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsCreate.json
@@ -0,0 +1,49 @@
+{
+  "parameters": {
+    "api-version": "2020-02-02-preview",
+    "subscriptionId": "subid",
+    "resourceGroupName": "my-resource-group",
+    "resourceName": "my-component",
+    "InsightProperties": {
+      "location": "South Central US",
+      "kind": "web",
+      "properties": {
+        "Application_Type": "web",
+        "Flow_Type": "Bluefield",
+        "WorkspaceResourceId": "/subscriptions/subid/resourcegroups/my-resource-group/providers/microsoft.operationalinsights/workspaces/my-workspace",
+        "Request_Source": "rest"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component",
+        "name": "my-component",
+        "type": "Microsoft.Insights/components",
+        "location": "South Central US",
+        "tags": "",
+        "kind": "web",
+        "properties": {
+          "ApplicationId": "my-component",
+          "AppId": "887f4bfd-b5fd-40d7-9fc3-123456789abc",
+          "Application_Type": "web",
+          "Flow_Type": "Bluefield",
+          "Request_Source": "rest",
+          "InstrumentationKey": "bc095013-3cf2-45ac-ab47-123456789abc",
+          "CreationDate": "2017-01-24T01:05:38.5934061+00:00",
+          "TenantId": "f438d567-7177-4fe1-a5e3-123456789abc",
+          "HockeyAppId": "",
+          "HockeyAppToken": "",
+          "provisioningState": "Succeeded",
+          "SamplingPercentage": 100.0,
+          "WorkspaceResourceId": "/subscriptions/subid/resourcegroups/my-resource-group/providers/microsoft.operationalinsights/workspaces/my-workspace",
+          "ConnectionString": "InstrumentationKey=bc095013-3cf2-45ac-ab47-123456789abc",
+          "DisableIpMasking": false,
+          "publicNetworkAccessForQuery": "Enabled",
+          "publicNetworkAccessForIngestion": "Enabled"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsDelete.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsDelete.json
new file mode 100644
index 000000000000..ad8c111fcdba
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsDelete.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "api-version": "2020-02-02-preview",
+    "subscriptionId": "subid",
+    "resourceGroupName": "my-resource-group",
+    "resourceName": "my-component"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsGet.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsGet.json
new file mode 100644
index 000000000000..8dc5e137725f
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsGet.json
@@ -0,0 +1,39 @@
+{
+  "parameters": {
+    "api-version": "2020-02-02-preview",
+    "subscriptionId": "subid",
+    "resourceGroupName": "my-resource-group",
+    "resourceName": "my-component"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component",
+        "name": "my-component",
+        "type": "Microsoft.Insights/components",
+        "location": "South Central US",
+        "tags": "",
+        "kind": "web",
+        "properties": {
+          "ApplicationId": "my-component",
+          "AppId": "887f4bfd-b5fd-40d7-9fc3-123456789abc",
+          "Application_Type": "web",
+          "Flow_Type": "Bluefield",
+          "Request_Source": "rest",
+          "InstrumentationKey": "bc095013-3cf2-45ac-ab47-123456789abc",
+          "CreationDate": "2017-01-24T01:05:38.5934061+00:00",
+          "TenantId": "f438d567-7177-4fe1-a5e3-123456789abc",
+          "HockeyAppId": "",
+          "HockeyAppToken": "",
+          "provisioningState": "Succeeded",
+          "SamplingPercentage": 100.0,
+          "WorkspaceResourceId": "/subscriptions/subid/resourcegroups/my-resource-group/providers/microsoft.operationalinsights/workspaces/my-workspace",
+          "ConnectionString": "InstrumentationKey=bc095013-3cf2-45ac-ab47-123456789abc",
+          "DisableIpMasking": false,
+          "publicNetworkAccessForQuery": "Enabled",
+          "publicNetworkAccessForIngestion": "Enabled"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsList.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsList.json
new file mode 100644
index 000000000000..1a0e3d80e2eb
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsList.json
@@ -0,0 +1,69 @@
+{
+  "parameters": {
+    "api-version": "2020-02-02-preview",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component",
+            "name": "my-component",
+            "type": "Microsoft.Insights/components",
+            "location": "South Central US",
+            "tags": "",
+            "kind": "web",
+            "properties": {
+              "ApplicationId": "my-component",
+              "AppId": "16526d1a-dfba-4362-a9e9-123456789abc",
+              "Application_Type": "web",
+              "Flow_Type": "Bluefield",
+              "Request_Source": "rest",
+              "InstrumentationKey": "dc5931c7-a7ad-4ad0-89d6-123456789abc",
+              "CreationDate": "2017-02-14T12:24:05.0041213+00:00",
+              "TenantId": "f438d567-7177-4fe1-a5e3-123456789abc",
+              "HockeyAppId": "",
+              "HockeyAppToken": "",
+              "provisioningState": "Succeeded",
+              "SamplingPercentage": 75.0,
+              "WorkspaceResourceId": "/subscriptions/subid/resourcegroups/my-resource-group/providers/microsoft.operationalinsights/workspaces/my-workspace",
+              "ConnectionString": "InstrumentationKey=dc5931c7-a7ad-4ad0-89d6-123456789abc",
+              "DisableIpMasking": false,
+              "publicNetworkAccessForQuery": "Enabled",
+              "publicNetworkAccessForIngestion": "Enabled"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/my-other-resource-group/providers/Microsoft.Insights/components/my-other-component",
+            "name": "my-other-component",
+            "type": "Microsoft.Insights/components",
+            "location": "South Central US",
+            "tags": "",
+            "kind": "web",
+            "properties": {
+              "ApplicationId": "my-other-component",
+              "AppId": "887f4bfd-b5fd-40d7-9fc3-123456789abc",
+              "Application_Type": "web",
+              "Flow_Type": "Bluefield",
+              "Request_Source": "rest",
+              "InstrumentationKey": "bc095013-3cf2-45ac-ab47-123456789abc",
+              "CreationDate": "2017-01-24T01:05:38.5934061+00:00",
+              "TenantId": "f438d567-7177-4fe1-a5e3-123456789abc",
+              "HockeyAppId": "",
+              "HockeyAppToken": "",
+              "provisioningState": "Succeeded",
+              "SamplingPercentage": 30.0,
+              "WorkspaceResourceId": "/subscriptions/subid/resourcegroups/my-resource-group/providers/microsoft.operationalinsights/workspaces/my-workspace",
+              "ConnectionString": "InstrumentationKey=bc095013-3cf2-45ac-ab47-123456789abc",
+              "DisableIpMasking": false,
+              "publicNetworkAccessForQuery": "Enabled",
+              "publicNetworkAccessForIngestion": "Enabled"
+            }
+          }
+        ],
+        "nextLink": null
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsListByResourceGroup.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsListByResourceGroup.json
new file mode 100644
index 000000000000..93423a2b9955
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsListByResourceGroup.json
@@ -0,0 +1,70 @@
+{
+  "parameters": {
+    "api-version": "2020-02-02-preview",
+    "subscriptionId": "subid",
+    "resourceGroupName": "my-resource-group"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component",
+            "name": "my-component",
+            "type": "Microsoft.Insights/components",
+            "location": "South Central US",
+            "tags": "",
+            "kind": "web",
+            "properties": {
+              "ApplicationId": "my-component",
+              "AppId": "16526d1a-dfba-4362-a9e9-123456789abc",
+              "Application_Type": "web",
+              "Flow_Type": "Bluefield",
+              "Request_Source": "rest",
+              "InstrumentationKey": "dc5931c7-a7ad-4ad0-89d6-123456789abc",
+              "CreationDate": "2017-02-14T12:24:05.0041213+00:00",
+              "TenantId": "f438d567-7177-4fe1-a5e3-123456789abc",
+              "HockeyAppId": "",
+              "HockeyAppToken": "",
+              "provisioningState": "Succeeded",
+              "SamplingPercentage": 100.0,
+              "WorkspaceResourceId": "/subscriptions/subid/resourcegroups/my-resource-group/providers/microsoft.operationalinsights/workspaces/my-workspace",
+              "ConnectionString": "InstrumentationKey=dc5931c7-a7ad-4ad0-89d6-123456789abc",
+              "DisableIpMasking": false,
+              "publicNetworkAccessForQuery": "Enabled",
+              "publicNetworkAccessForIngestion": "Enabled"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/my-other-resource-group/providers/Microsoft.Insights/components/my-other-component",
+            "name": "my-other-component",
+            "type": "Microsoft.Insights/components",
+            "location": "South Central US",
+            "tags": "",
+            "kind": "web",
+            "properties": {
+              "ApplicationId": "my-other-component",
+              "AppId": "887f4bfd-b5fd-40d7-9fc3-123456789abc",
+              "Application_Type": "web",
+              "Flow_Type": "Bluefield",
+              "Request_Source": "rest",
+              "InstrumentationKey": "bc095013-3cf2-45ac-ab47-123456789abc",
+              "CreationDate": "2017-01-24T01:05:38.5934061+00:00",
+              "TenantId": "f438d567-7177-4fe1-a5e3-123456789abc",
+              "HockeyAppId": "",
+              "HockeyAppToken": "",
+              "provisioningState": "Succeeded",
+              "SamplingPercentage": 50.0,
+              "WorkspaceResourceId": "/subscriptions/subid/resourcegroups/my-resource-group/providers/microsoft.operationalinsights/workspaces/my-workspace",
+              "ConnectionString": "InstrumentationKey=bc095013-3cf2-45ac-ab47-123456789abc",
+              "DisableIpMasking": false,
+              "publicNetworkAccessForQuery": "Enabled",
+              "publicNetworkAccessForIngestion": "Enabled"
+            }
+          }
+        ],
+        "nextLink": null
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsPurge.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsPurge.json
new file mode 100644
index 000000000000..7d4def360af2
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsPurge.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "resourceGroupName": "OIAutoRest5123",
+    "resourceName": "aztest5048",
+    "api-version": "2020-02-02-preview",
+    "subscriptionId": "00000000-0000-0000-0000-00000000000",
+    "body": {
+      "table": "Heartbeat",
+      "filters": [
+        {
+          "column": "TimeGenerated",
+          "operator": ">",
+          "value": "2017-09-01T00:00:00"
+        }
+      ]
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "x-ms-status-location": "https://management.azure.com/subscriptions/b96161de-b34a-480f-7343-59b099299283/resourceGroups/example/providers/microsoft.insights/components/test/operations/purge-970318e7-b859-4edb-8903-83b1b54d0b74?api-version=2015-05-01"
+      },
+      "body": {
+        "operationId": "7d7cf277-9113-4ab3-8359-d0364b74d01d"
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsPurgeStatus.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsPurgeStatus.json
new file mode 100644
index 000000000000..c288ee449b8e
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsPurgeStatus.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "resourceGroupName": "OIAutoRest5123",
+    "resourceName": "aztest5048",
+    "api-version": "2020-02-02-preview",
+    "subscriptionId": "00000000-0000-0000-0000-00000000000",
+    "purgeId": "purge-970318e7-b859-4edb-8903-83b1b54d0b74"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "status": "completed"
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsUpdate.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsUpdate.json
new file mode 100644
index 000000000000..e02186407ca7
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsUpdate.json
@@ -0,0 +1,50 @@
+{
+  "parameters": {
+    "api-version": "2020-02-02-preview",
+    "subscriptionId": "subid",
+    "resourceGroupName": "my-resource-group",
+    "resourceName": "my-component",
+    "InsightProperties": {
+      "location": "South Central US",
+      "kind": "web",
+      "tags": {
+        "ApplicationGatewayType": "Internal-Only",
+        "BillingEntity": "Self"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component",
+        "name": "my-component",
+        "type": "Microsoft.Insights/components",
+        "location": "South Central US",
+        "tags": {
+          "ApplicationGatewayType": "Internal-Only",
+          "BillingEntity": "Self"
+        },
+        "kind": "web",
+        "properties": {
+          "ApplicationId": "my-component",
+          "AppId": "887f4bfd-b5fd-40d7-9fc3-123456789abc",
+          "Application_Type": "web",
+          "Flow_Type": "Bluefield",
+          "Request_Source": "rest",
+          "InstrumentationKey": "bc095013-3cf2-45ac-ab47-123456789abc",
+          "CreationDate": "2017-01-24T01:05:38.5934061+00:00",
+          "TenantId": "f438d567-7177-4fe1-a5e3-123456789abc",
+          "HockeyAppId": "",
+          "HockeyAppToken": "",
+          "provisioningState": "Succeeded",
+          "SamplingPercentage": 100.0,
+          "WorkspaceResourceId": "/subscriptions/subid/resourcegroups/my-resource-group/providers/microsoft.operationalinsights/workspaces/my-workspace",
+          "ConnectionString": "InstrumentationKey=bc095013-3cf2-45ac-ab47-123456789abc",
+          "DisableIpMasking": false,
+          "publicNetworkAccessForQuery": "Enabled",
+          "publicNetworkAccessForIngestion": "Enabled"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsUpdateTagsOnly.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsUpdateTagsOnly.json
new file mode 100644
index 000000000000..806476c3cf96
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-02-02-preview/examples/ComponentsUpdateTagsOnly.json
@@ -0,0 +1,54 @@
+{
+  "parameters": {
+    "api-version": "2020-02-02-preview",
+    "subscriptionId": "subid",
+    "resourceGroupName": "my-resource-group",
+    "resourceName": "my-component",
+    "ComponentTags": {
+      "tags": {
+        "ApplicationGatewayType": "Internal-Only",
+        "BillingEntity": "Self",
+        "Color": "AzureBlue",
+        "CustomField_01": "Custom text in some random field named randomly",
+        "NodeType": "Edge"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component",
+        "name": "my-component",
+        "type": "Microsoft.Insights/components",
+        "location": "South Central US",
+        "tags": {
+          "ApplicationGatewayType": "Internal-Only",
+          "BillingEntity": "Self",
+          "Color": "AzureBlue",
+          "CustomField_01": "Custom text in some random field named randomly",
+          "NodeType": "Edge"
+        },
+        "kind": "web",
+        "properties": {
+          "ApplicationId": "my-component",
+          "AppId": "887f4bfd-b5fd-40d7-9fc3-123456789abc",
+          "Application_Type": "web",
+          "Flow_Type": "Bluefield",
+          "Request_Source": "rest",
+          "InstrumentationKey": "bc095013-3cf2-45ac-ab47-123456789abc",
+          "CreationDate": "2017-01-24T01:05:38.5934061+00:00",
+          "TenantId": "f438d567-7177-4fe1-a5e3-123456789abc",
+          "HockeyAppId": "",
+          "HockeyAppToken": "",
+          "provisioningState": "Succeeded",
+          "SamplingPercentage": 100.0,
+          "WorkspaceResourceId": "/subscriptions/subid/resourcegroups/my-resource-group/providers/microsoft.operationalinsights/workspaces/my-workspace",
+          "ConnectionString": "InstrumentationKey=bc095013-3cf2-45ac-ab47-123456789abc",
+          "DisableIpMasking": false,
+          "publicNetworkAccessForQuery": "Enabled",
+          "publicNetworkAccessForIngestion": "Enabled"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-03-01-preview/componentLinkedStorageAccounts_API.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-03-01-preview/componentLinkedStorageAccounts_API.json
index 6bdbfd715db4..68751bbebe02 100644
--- a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-03-01-preview/componentLinkedStorageAccounts_API.json
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-03-01-preview/componentLinkedStorageAccounts_API.json
@@ -282,7 +282,14 @@
       "in": "path",
       "required": true,
       "type": "string",
-      "description": "The type of the Application Insights component linked storage account.",
+      "enum": [
+        "ServiceProfiler"
+      ],
+      "x-ms-enum": {
+        "name": "StorageType",
+        "modelAsString": true
+      },
+      "description": "The type of the Application Insights component data source for the linked storage account.",
       "x-ms-parameter-location": "method"
     }
   }
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-03-01-preview/examples/ComponentLinkedStorageAccountsCreateAndUpdate.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-03-01-preview/examples/ComponentLinkedStorageAccountsCreateAndUpdate.json
index b7b464c0f018..8283ea527f45 100644
--- a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-03-01-preview/examples/ComponentLinkedStorageAccountsCreateAndUpdate.json
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-03-01-preview/examples/ComponentLinkedStorageAccountsCreateAndUpdate.json
@@ -4,7 +4,7 @@
     "subscriptionId": "86dc51d3-92ed-4d7e-947a-775ea79b4918",
     "resourceGroupName": "someResourceGroupName",
     "resourceName": "myComponent",
-    "storageType": "serviceprofiler",
+    "storageType": "ServiceProfiler",
     "LinkedStorageAccountsProperties": {
       "properties": {
         "linkedStorageAccount": "/subscriptions/86dc51d3-92ed-4d7e-947a-775ea79b4918/resourceGroups/someResourceGroupName/providers/Microsoft.Storage/storageAccounts/storageaccountname"
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-03-01-preview/examples/ComponentLinkedStorageAccountsDelete.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-03-01-preview/examples/ComponentLinkedStorageAccountsDelete.json
index 55cba7ebe2a9..1dfd3f4e1e99 100644
--- a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-03-01-preview/examples/ComponentLinkedStorageAccountsDelete.json
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-03-01-preview/examples/ComponentLinkedStorageAccountsDelete.json
@@ -4,7 +4,7 @@
     "subscriptionId": "86dc51d3-92ed-4d7e-947a-775ea79b4918",
     "resourceGroupName": "someResourceGroupName",
     "resourceName": "myComponent",
-    "storageType": "serviceprofiler"
+    "storageType": "ServiceProfiler"
   },
   "responses": {
     "200": {},
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-03-01-preview/examples/ComponentLinkedStorageAccountsGet.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-03-01-preview/examples/ComponentLinkedStorageAccountsGet.json
index 6f36db8d5000..dedc1b4aa6f0 100644
--- a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-03-01-preview/examples/ComponentLinkedStorageAccountsGet.json
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-03-01-preview/examples/ComponentLinkedStorageAccountsGet.json
@@ -4,7 +4,7 @@
     "subscriptionId": "86dc51d3-92ed-4d7e-947a-775ea79b4918",
     "resourceGroupName": "someResourceGroupName",
     "resourceName": "myComponent",
-    "storageType": "serviceprofiler"
+    "storageType": "ServiceProfiler"
   },
   "responses": {
     "200": {
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-03-01-preview/examples/ComponentLinkedStorageAccountsUpdate.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-03-01-preview/examples/ComponentLinkedStorageAccountsUpdate.json
index 4b73bb4c01da..e73f9d2db797 100644
--- a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-03-01-preview/examples/ComponentLinkedStorageAccountsUpdate.json
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-03-01-preview/examples/ComponentLinkedStorageAccountsUpdate.json
@@ -4,7 +4,7 @@
     "subscriptionId": "86dc51d3-92ed-4d7e-947a-775ea79b4918",
     "resourceGroupName": "someResourceGroupName",
     "resourceName": "myComponent",
-    "storageType": "serviceprofiler",
+    "storageType": "ServiceProfiler",
     "LinkedStorageAccountsProperties": {
       "properties": {
         "linkedStorageAccount": "/subscriptions/86dc51d3-92ed-4d7e-947a-775ea79b4918/resourceGroups/someResourceGroupName/providers/Microsoft.Storage/storageAccounts/storageaccountname"
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/stable/2015-05-01/components_API.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/stable/2015-05-01/components_API.json
index 57efc81be161..507d3910d1b1 100644
--- a/specification/applicationinsights/resource-manager/Microsoft.Insights/stable/2015-05-01/components_API.json
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/stable/2015-05-01/components_API.json
@@ -504,12 +504,33 @@
         "ImmediatePurgeDataOn30Days": {
           "type": "boolean",
           "description": "Purge data immediately after 30 days."
+        },
+        "PrivateLinkScopedResources": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/PrivateLinkScopedResource"
+          },
+          "description": "List of linked private link scope resources."
         }
       },
       "required": [
         "Application_Type"
       ]
     },
+    "PrivateLinkScopedResource": {
+      "properties": {
+        "ResourceId": {
+          "type": "string",
+          "description": "The full resource Id of the private link scope resource."
+        },
+        "ScopeId": {
+          "type": "string",
+          "description": "The private link scope unique Identifier."
+        }
+      },
+      "description": "The private link scope resource reference."
+    },
     "ApplicationInsightsComponentListResult": {
       "description": "Describes the list of Application Insights Resources.",
       "required": [
diff --git a/specification/applicationinsights/resource-manager/readme.md b/specification/applicationinsights/resource-manager/readme.md
index 5f72c85b3d6f..d492fd78fb97 100644
--- a/specification/applicationinsights/resource-manager/readme.md
+++ b/specification/applicationinsights/resource-manager/readme.md
@@ -293,6 +293,7 @@ These settings apply only when `--tag=package-2018-05-01-preview` is specified o
 ``` yaml $(tag) == 'package-2018-05-01-preview'
 input-file:
 - Microsoft.Insights/preview/2018-05-01/componentProactiveDetection_API.json
+- Microsoft.Insights/preview/2018-05-01/components_API.json
 ```
 
 ### Tag: package-2019-09-01-preview
@@ -305,6 +306,15 @@ input-file:
 - Microsoft.Insights/preview/2019-09-01-preview/QueryPacks_API.json
 ```
 
+### Tag: package-2020-02-02-preview
+
+These settings apply only when `--tag=package-2020-02-02-preview` is specified on the command line.
+
+``` yaml $(tag) == 'package-2020-02-02-preview'
+input-file:
+- Microsoft.Insights/preview/2020-02-02-preview/components_API.json
+```
+
 ### Tag: package-2020-03-01-preview
 
 These settings apply only when `--tag=package-2020-03-01-preview` is specified on the command line.
@@ -425,8 +435,10 @@ input-file:
   - $(this-folder)/Microsoft.Insights/preview/2018-06-17-preview/workbooks_API.json
   - $(this-folder)/Microsoft.Insights/preview/2019-10-17-preview/workbookTemplates_API.json
   - $(this-folder)/Microsoft.Insights/preview/2018-05-01/componentProactiveDetection_API.json
+  - $(this-folder)/Microsoft.Insights/preview/2018-05-01/components_API.json
   - $(this-folder)/Microsoft.Insights/preview/2019-09-01-preview/QueryPackQueries_API.json
   - $(this-folder)/Microsoft.Insights/preview/2019-09-01-preview/QueryPacks_API.json
+  - $(this-folder)/Microsoft.Insights/preview/2020-02-02-preview/components_API.json
   - $(this-folder)/Microsoft.Insights/preview/2020-03-01-preview/componentLinkedStorageAccounts_API.json
 
 ```
diff --git a/specification/azsadmin/resource-manager/compute/Microsoft.Compute.Admin/preview/2018-07-30-preview/DiskMigrationJobs.json b/specification/azsadmin/resource-manager/compute/Microsoft.Compute.Admin/preview/2018-07-30-preview/DiskMigrationJobs.json
index a682c9357128..2456dcf23c55 100644
--- a/specification/azsadmin/resource-manager/compute/Microsoft.Compute.Admin/preview/2018-07-30-preview/DiskMigrationJobs.json
+++ b/specification/azsadmin/resource-manager/compute/Microsoft.Compute.Admin/preview/2018-07-30-preview/DiskMigrationJobs.json
@@ -114,6 +114,12 @@
           {
             "$ref": "DiskMigrationJobs.json#/parameters/TargetShareParameter"
           },
+          {
+            "$ref": "DiskMigrationJobs.json#/parameters/TargetScaleUnitParameter"
+          },
+          {
+            "$ref": "DiskMigrationJobs.json#/parameters/TargetVolumeLabelParameter"
+          },
           {
             "$ref": "DiskMigrationJobs.json#/parameters/DiskListParameter"
           },
@@ -378,7 +384,23 @@
       "description": "The target share name.",
       "name": "targetShare",
       "in": "query",
-      "required": true,
+      "required": false,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "TargetScaleUnitParameter": {
+      "description": "The target scale unit name.",
+      "name": "targetScaleUnit",
+      "in": "query",
+      "required": false,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "TargetVolumeLabelParameter": {
+      "description": "The target volume label.",
+      "name": "targetVolumeLabel",
+      "in": "query",
+      "required": false,
       "type": "string",
       "x-ms-parameter-location": "method"
     },
diff --git a/specification/azsadmin/resource-manager/compute/Microsoft.Compute.Admin/preview/2018-07-30-preview/Disks.json b/specification/azsadmin/resource-manager/compute/Microsoft.Compute.Admin/preview/2018-07-30-preview/Disks.json
index 17f577faa01c..b0bfd8aa99e9 100644
--- a/specification/azsadmin/resource-manager/compute/Microsoft.Compute.Admin/preview/2018-07-30-preview/Disks.json
+++ b/specification/azsadmin/resource-manager/compute/Microsoft.Compute.Admin/preview/2018-07-30-preview/Disks.json
@@ -44,6 +44,12 @@
           {
             "$ref": "Disks.json#/parameters/SourceSharePathParameter"
           },
+          {
+            "$ref": "Disks.json#/parameters/SourceScaleUnitParameter"
+          },
+          {
+            "$ref": "Disks.json#/parameters/SourceVolumeLabelParameter"
+          },
           {
             "$ref": "Disks.json#/parameters/DiskCountParameter"
           },
@@ -267,13 +273,29 @@
       "x-ms-parameter-location": "method"
     },
     "SourceSharePathParameter": {
-      "description": "The source share which the resource belongs to.",
+      "description": "The share which the resource belongs to.",
       "name": "sharePath",
       "in": "query",
       "required": false,
       "type": "string",
       "x-ms-parameter-location": "method"
     },
+    "SourceScaleUnitParameter": {
+      "description": "The scale unit which the resource belongs to.",
+      "name": "scaleUnit",
+      "in": "query",
+      "required": false,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "SourceVolumeLabelParameter": {
+      "description": "The volume label of the volume which the resource belongs to.",
+      "name": "volumeLabel",
+      "in": "query",
+      "required": false,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
     "DiskCountParameter": {
       "description": "The maximum number of disks to return.",
       "name": "count",
diff --git a/specification/azure-kusto/resource-manager/readme.az.md b/specification/azure-kusto/resource-manager/readme.az.md
new file mode 100644
index 000000000000..758e5e24f256
--- /dev/null
+++ b/specification/azure-kusto/resource-manager/readme.az.md
@@ -0,0 +1,13 @@
+## AZ
+
+These settings apply only when `--az` is specified on the command line.
+
+``` yaml $(az)
+az:
+  extensions: kusto
+  namespace: azure.mgmt.kusto
+  package-name: azure-mgmt-kusto
+python-sdk-output-folder: "$(output-folder)/src/kusto/azext_kusto/vendored_sdks/kusto"
+
+
+```
diff --git a/specification/azure-kusto/resource-manager/readme.md b/specification/azure-kusto/resource-manager/readme.md
index ecc908804f55..ef252e846aa8 100644
--- a/specification/azure-kusto/resource-manager/readme.md
+++ b/specification/azure-kusto/resource-manager/readme.md
@@ -162,6 +162,7 @@ swagger-to-sdk:
   - repo: azure-sdk-for-python
   - repo: azure-sdk-for-go
   - repo: azure-sdk-for-java
+  - repo: azure-cli-extensions
 ```
 
 ## C#
diff --git a/specification/billing/resource-manager/Microsoft.Billing/preview/2019-10-01-preview/billing.json b/specification/billing/resource-manager/Microsoft.Billing/preview/2019-10-01-preview/billing.json
index 4b17b08b0676..474087d42ac9 100644
--- a/specification/billing/resource-manager/Microsoft.Billing/preview/2019-10-01-preview/billing.json
+++ b/specification/billing/resource-manager/Microsoft.Billing/preview/2019-10-01-preview/billing.json
@@ -33,14 +33,14 @@
           }
         },
         "operationId": "BillingAccounts_List",
-        "description": "Lists all billing accounts for a user which he has access to.",
+        "description": "Lists the billing accounts that a user has access to.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
           },
           {
             "name": "$expand",
-            "description": "May be used to expand the address, invoiceSections and billingProfiles.",
+            "description": "May be used to expand the address, invoice sections and billing profiles.",
             "in": "query",
             "required": false,
             "type": "string"
@@ -76,7 +76,7 @@
           }
         },
         "operationId": "BillingAccounts_Get",
-        "description": "Get the billing account by id.",
+        "description": "Gets a billing account by its ID.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -86,7 +86,7 @@
           },
           {
             "name": "$expand",
-            "description": "May be used to expand the address, invoiceSections and billingProfiles.",
+            "description": "May be used to expand the address, invoice sections and billing profiles.",
             "in": "query",
             "required": false,
             "type": "string"
@@ -116,7 +116,7 @@
         "x-ms-long-running-operation-options": {
           "final-state-via": "azure-async-operation"
         },
-        "description": "The operation to update a billing account.",
+        "description": "Updates the properties of a billing account. Currently, displayName and address can be updated. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.",
         "x-ms-examples": {
           "UpdateBillingAccount": {
             "$ref": "./examples/UpdateBillingAccount.json"
@@ -136,7 +136,7 @@
             "schema": {
               "$ref": "#/definitions/BillingAccountUpdateRequest"
             },
-            "description": "Request parameters supplied to the update billing account operation."
+            "description": "Request parameters that are provided to the update billing account operation."
           }
         ],
         "responses": {
@@ -169,7 +169,7 @@
           }
         },
         "operationId": "BillingAccounts_ListInvoiceSectionsByCreateSubscriptionPermission",
-        "description": "Lists all invoice sections with create subscription permission for a user.",
+        "description": "Lists the invoice sections for which the user has permission to create Azure subscriptions. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -203,7 +203,7 @@
           "PaymentMethods"
         ],
         "operationId": "PaymentMethods_ListByBillingAccount",
-        "description": "Lists the Payment Methods by billing account Id.",
+        "description": "Lists the payment Methods for a billing account. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.",
         "externalDocs": {
           "url": "https://docs.microsoft.com/en-us/rest/api/billing/2019-10-01-preview/paymentmethods"
         },
@@ -253,7 +253,7 @@
           }
         },
         "operationId": "Address_Validate",
-        "description": "Validates the address.",
+        "description": "Validates an address. Use the operation to validate an address before using it as a billing account or a billing profile address.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -289,7 +289,7 @@
           "AvailableBalances"
         ],
         "operationId": "AvailableBalances_GetByBillingProfile",
-        "description": "The latest available credit balance for a given billingAccountName and billingProfileName.",
+        "description": "The available credit balance for a billing profile. This is the balance that can be used for pay now to settle due or past due invoices. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.",
         "x-ms-examples": {
           "AvailableBalanceByBillingProfile": {
             "$ref": "./examples/AvailableBalanceByBillingProfile.json"
@@ -378,7 +378,7 @@
           }
         },
         "operationId": "Instructions_Get",
-        "description": "Get the instruction by name.",
+        "description": "Get the instruction by name. These are custom billing instructions and are only applicable for certain customers.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -413,7 +413,7 @@
           "Instructions"
         ],
         "operationId": "Instructions_Put",
-        "description": "The operation to create or update a instruction.",
+        "description": "Creates or updates an instruction. These are custom billing instructions and are only applicable for certain customers.",
         "x-ms-examples": {
           "PutInstruction": {
             "$ref": "./examples/PutInstruction.json"
@@ -464,7 +464,7 @@
           "PaymentMethods"
         ],
         "operationId": "PaymentMethods_ListByBillingProfile",
-        "description": "Lists the Payment Methods by billing profile Id.",
+        "description": "Lists the payment Methods for a billing profile. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.",
         "externalDocs": {
           "url": "https://docs.microsoft.com/en-us/rest/api/billing/"
         },
@@ -517,7 +517,7 @@
           }
         },
         "operationId": "BillingProfiles_ListByBillingAccount",
-        "description": "Lists all billing profiles for a user which that user has access to.",
+        "description": "Lists the billing profiles that a user has access to. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -527,7 +527,7 @@
           },
           {
             "name": "$expand",
-            "description": "May be used to expand the invoiceSections.",
+            "description": "May be used to expand the invoice sections.",
             "in": "query",
             "required": false,
             "type": "string"
@@ -563,7 +563,7 @@
           }
         },
         "operationId": "BillingProfiles_Get",
-        "description": "Get the billing profile by id.",
+        "description": "Gets a billing profile by its ID. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -576,7 +576,7 @@
           },
           {
             "name": "$expand",
-            "description": "May be used to expand the invoiceSections.",
+            "description": "May be used to expand the invoice sections.",
             "in": "query",
             "required": false,
             "type": "string"
@@ -603,7 +603,7 @@
         ],
         "operationId": "BillingProfiles_Create",
         "x-ms-long-running-operation": true,
-        "description": "The operation to create a BillingProfile.",
+        "description": "Creates a billing profile. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.",
         "x-ms-examples": {
           "CreateBillingProfile": {
             "$ref": "./examples/CreateBillingProfile.json"
@@ -626,7 +626,7 @@
             "schema": {
               "$ref": "#/definitions/BillingProfileCreationRequest"
             },
-            "description": "Request parameters supplied to the Create BillingProfile operation."
+            "description": "Request parameters that are provided to the create billing profile operation."
           }
         ],
         "responses": {
@@ -644,7 +644,7 @@
                 "type": "string"
               },
               "Retry-After": {
-                "description": "Recommends the retryable time after receiving this.",
+                "description": "Recommended time to wait before making another request to check the status of the operation. The time is specified in seconds.",
                 "type": "integer"
               }
             }
@@ -663,7 +663,7 @@
         ],
         "operationId": "BillingProfiles_Update",
         "x-ms-long-running-operation": true,
-        "description": "The operation to update a billing profile.",
+        "description": "Updates the properties of a billing profile. Currently, displayName, poNumber, bill-to address and invoiceEmailOptIn can be updated. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.",
         "x-ms-examples": {
           "UpdateBillingProfile": {
             "$ref": "./examples/UpdateBillingProfile.json"
@@ -729,7 +729,7 @@
           }
         },
         "operationId": "Customers_ListByBillingProfile",
-        "description": "Lists customers by billing profile which the current user can work with on-behalf of a partner.",
+        "description": "Lists the customers that are billed to a billing profile. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -785,7 +785,7 @@
           }
         },
         "operationId": "InvoiceSections_ListByBillingProfile",
-        "description": "Lists all invoice sections for a user which he has access to.",
+        "description": "Lists the invoice sections that a user has access to. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -824,7 +824,7 @@
           }
         },
         "operationId": "InvoiceSections_Get",
-        "description": "Get the InvoiceSection by id.",
+        "description": "Gets an invoice section by its ID. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -860,7 +860,7 @@
         ],
         "operationId": "InvoiceSections_Create",
         "x-ms-long-running-operation": true,
-        "description": "The operation to create an invoice section.",
+        "description": "Creates an invoice section. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.",
         "x-ms-examples": {
           "CreateInvoiceSection": {
             "$ref": "./examples/CreateInvoiceSection.json"
@@ -886,7 +886,7 @@
             "schema": {
               "$ref": "#/definitions/InvoiceSectionCreationRequest"
             },
-            "description": "Request parameters supplied to the Create InvoiceSection operation."
+            "description": "Request parameters that are provided to the create invoice section operation."
           }
         ],
         "responses": {
@@ -904,7 +904,7 @@
                 "type": "string"
               },
               "Retry-After": {
-                "description": "Recommends the retryable time after receiving this.",
+                "description": "Recommended time to wait before making another request to check the status of the operation. The time is specified in seconds.",
                 "type": "integer"
               }
             }
@@ -923,7 +923,7 @@
         ],
         "operationId": "InvoiceSections_Update",
         "x-ms-long-running-operation": true,
-        "description": "The operation to update a InvoiceSection.",
+        "description": "Updates an invoice section. Currently, only displayName can be updated. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.",
         "x-ms-examples": {
           "UpdateInvoiceSection": {
             "$ref": "./examples/UpdateInvoiceSection.json"
@@ -949,7 +949,7 @@
             "schema": {
               "$ref": "#/definitions/InvoiceSection"
             },
-            "description": "Request parameters supplied to the Create InvoiceSection operation."
+            "description": "Request parameters that are provided to the update invoice section operation."
           }
         ],
         "responses": {
@@ -992,7 +992,7 @@
           }
         },
         "operationId": "Customers_ListByBillingAccount",
-        "description": "Lists customers which the current user can work with on-behalf of a partner.",
+        "description": "Lists the customers that are billed to a billing account. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -1048,7 +1048,7 @@
           }
         },
         "operationId": "Customers_Get",
-        "description": "Gets a customer by its id.",
+        "description": "Gets a customer by its ID. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -1061,7 +1061,7 @@
           },
           {
             "name": "$expand",
-            "description": "May be used to expand enabledAzurePlans, resellers.",
+            "description": "May be used to expand enabledAzurePlans and resellers",
             "in": "query",
             "required": false,
             "type": "string"
@@ -1094,7 +1094,7 @@
           }
         },
         "operationId": "BillingPermissions_ListByCustomer",
-        "description": "Lists all billing permissions the caller has for a customer.",
+        "description": "Lists the billing permissions the caller has for a customer.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -1128,9 +1128,9 @@
           "BillingSubscriptions"
         ],
         "operationId": "BillingSubscriptions_ListByCustomer",
-        "description": "Lists billing subscription by customer id.",
+        "description": "Lists the subscriptions for a customer. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.",
         "externalDocs": {
-          "url": "https://docs.microsoft.com/en-us/rest/api/consumption/"
+          "url": "https://docs.microsoft.com/en-us/rest/api/billing/"
         },
         "x-ms-examples": {
           "BillingSubscriptionsListByCustomer": {
@@ -1173,9 +1173,9 @@
           "BillingSubscriptions"
         ],
         "operationId": "BillingSubscriptions_GetByCustomer",
-        "description": "Get a single billing subscription by id.",
+        "description": "Gets a subscription by its ID. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.",
         "externalDocs": {
-          "url": "https://docs.microsoft.com/en-us/rest/api/consumption/"
+          "url": "https://docs.microsoft.com/en-us/rest/api/billing/"
         },
         "x-ms-examples": {
           "BillingSubscriptionByCustomer": {
@@ -1218,7 +1218,7 @@
           "Products"
         ],
         "operationId": "Products_ListByCustomer",
-        "description": "Lists products by customer id.",
+        "description": "Lists the products for a customer. These don't include products billed based on usage.The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.",
         "externalDocs": {
           "url": "https://docs.microsoft.com/en-us/rest/api/billing/"
         },
@@ -1239,7 +1239,7 @@
           },
           {
             "name": "$filter",
-            "description": "May be used to filter by product type. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value is separated by a colon (:).",
+            "description": "May be used to filter by product type. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value are separated by a colon (:).",
             "in": "query",
             "required": false,
             "type": "string"
@@ -1267,7 +1267,7 @@
           "Products"
         ],
         "operationId": "Products_GetByCustomer",
-        "description": "Get a customer's product by name.",
+        "description": "Gets a product by ID. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.",
         "externalDocs": {
           "url": "https://docs.microsoft.com/en-us/rest/api/billing/"
         },
@@ -1314,7 +1314,7 @@
         "operationId": "Transactions_ListByCustomer",
         "description": "Lists the billed and unbilled transactions by customer id for given start date and end date. Transactions include purchases, refunds and Azure usage charges. Unbilled transactions are listed under pending invoice Id and do not include tax. Tax is added to the amount once an invoice is generated.",
         "externalDocs": {
-          "url": "https://docs.microsoft.com/en-us/rest/api/consumption/"
+          "url": "https://docs.microsoft.com/en-us/rest/api/billing/"
         },
         "x-ms-examples": {
           "TransactionsListByCustomer": {
@@ -1337,20 +1337,20 @@
           {
             "name": "periodStartDate",
             "in": "query",
-            "description": "Start date",
+            "description": "The start date to fetch the transactions. The date should be specified in MM-DD-YYYY format.",
             "required": true,
             "type": "string"
           },
           {
             "name": "periodEndDate",
             "in": "query",
-            "description": "End date",
+            "description": "The end date to fetch the transactions. The date should be specified in MM-DD-YYYY format.",
             "required": true,
             "type": "string"
           },
           {
             "name": "$filter",
-            "description": "May be used to filter by transaction kind. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value is separated by a colon (:).",
+            "description": "May be used to filter by transaction type. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value are separated by a colon (:).",
             "in": "query",
             "required": false,
             "type": "string"
@@ -1389,7 +1389,7 @@
           }
         },
         "operationId": "Departments_ListByBillingAccountName",
-        "description": "Lists all departments for a user which he has access to.",
+        "description": "Lists the departments that a user has access to. The operation is supported only for billing accounts with agreement type Enterprise Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -1399,14 +1399,14 @@
           },
           {
             "name": "$expand",
-            "description": "May be used to expand the enrollmentAccounts.",
+            "description": "May be used to expand the enrollment accounts.",
             "in": "query",
             "required": false,
             "type": "string"
           },
           {
             "name": "$filter",
-            "description": "The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value is separated by a colon (:).",
+            "description": "May be used to filter by department name. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value are separated by a colon (:).",
             "in": "query",
             "required": false,
             "type": "string"
@@ -1442,7 +1442,7 @@
           }
         },
         "operationId": "Departments_Get",
-        "description": "Get the department by id.",
+        "description": "Gets a department by ID. The operation is supported only for billing accounts with agreement type Enterprise Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -1455,14 +1455,14 @@
           },
           {
             "name": "$expand",
-            "description": "May be used to expand the enrollmentAccounts.",
+            "description": "May be used to expand the enrollment accounts.",
             "in": "query",
             "required": false,
             "type": "string"
           },
           {
             "name": "$filter",
-            "description": "The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value is separated by a colon (:).",
+            "description": "May be used to filter by department name. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value are separated by a colon (:).",
             "in": "query",
             "required": false,
             "type": "string"
@@ -1498,7 +1498,7 @@
           }
         },
         "operationId": "EnrollmentAccounts_ListByBillingAccountName",
-        "description": "Lists all Enrollment Accounts for a user which he has access to.",
+        "description": "Lists the enrollment accounts for a billing account. The operation is supported only for billing accounts with agreement type Enterprise Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -1515,7 +1515,7 @@
           },
           {
             "name": "$filter",
-            "description": "The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value is separated by a colon (:).",
+            "description": "May be used to filter by account name. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value are separated by a colon (:).",
             "in": "query",
             "required": false,
             "type": "string"
@@ -1551,7 +1551,7 @@
           }
         },
         "operationId": "EnrollmentAccounts_GetByEnrollmentAccountId",
-        "description": "Get the enrollment account by id.",
+        "description": "Gets an enrollment account by ID. The operation is supported only for billing accounts with agreement type Enterprise Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -1564,14 +1564,14 @@
           },
           {
             "name": "$expand",
-            "description": "May be used to expand the Department.",
+            "description": "May be used to expand the department.",
             "in": "query",
             "required": false,
             "type": "string"
           },
           {
             "name": "$filter",
-            "description": "The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value is separated by a colon (:).",
+            "description": "May be used to filter by account name. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value are separated by a colon (:).",
             "in": "query",
             "required": false,
             "type": "string"
@@ -1604,7 +1604,7 @@
           }
         },
         "operationId": "Invoices_ListByBillingAccount",
-        "description": "List of invoices for a billing account.",
+        "description": "Lists the invoices for a billing account for a given start date and end date. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -1614,14 +1614,14 @@
           },
           {
             "name": "periodStartDate",
-            "description": "Invoice period start date.",
+            "description": "The start date to fetch the invoices. The date should be specified in MM-DD-YYYY format.",
             "in": "query",
             "required": true,
             "type": "string"
           },
           {
             "name": "periodEndDate",
-            "description": "Invoice period end date.",
+            "description": "The end date to fetch the invoices. The date should be specified in MM-DD-YYYY format.",
             "in": "query",
             "required": true,
             "type": "string"
@@ -1658,7 +1658,7 @@
         "x-ms-long-running-operation-options": {
           "final-state-via": "location"
         },
-        "description": "Download price sheet for an invoice.",
+        "description": "Gets a URL to download the pricesheet for an invoice. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -1721,7 +1721,7 @@
         "x-ms-long-running-operation-options": {
           "final-state-via": "location"
         },
-        "description": "Download price sheet for a billing profile.",
+        "description": "Gets a URL to download the current month's pricesheet for a billing profile. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -1777,7 +1777,7 @@
           }
         },
         "operationId": "Invoices_ListByBillingProfile",
-        "description": "List of invoices for a billing profile.",
+        "description": "Lists the invoices for a billing profile for a given start date and end date. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -1790,14 +1790,14 @@
           },
           {
             "name": "periodStartDate",
-            "description": "Invoice period start date.",
+            "description": "The start date to fetch the invoices. The date should be specified in MM-DD-YYYY format.",
             "in": "query",
             "required": true,
             "type": "string"
           },
           {
             "name": "periodEndDate",
-            "description": "Invoice period end date.",
+            "description": "The end date to fetch the invoices. The date should be specified in MM-DD-YYYY format.",
             "in": "query",
             "required": true,
             "type": "string"
@@ -1830,7 +1830,7 @@
           }
         },
         "operationId": "Invoices_Get",
-        "description": "Get the invoice by name.",
+        "description": "Gets an invoice by ID. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -1867,7 +1867,7 @@
           "BillingSubscriptions"
         ],
         "operationId": "BillingSubscriptions_ListByBillingAccount",
-        "description": "Lists billing subscriptions by billing account name.",
+        "description": "Lists the subscriptions for a billing account. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.",
         "externalDocs": {
           "url": "https://docs.microsoft.com/en-us/rest/api/billing/"
         },
@@ -1909,7 +1909,7 @@
           "Invoices"
         ],
         "operationId": "Invoices_ListByBillingSubscription",
-        "description": "Lists invoices by billing subscriptions name.",
+        "description": "Lists the invoices for a subscription.",
         "externalDocs": {
           "url": "https://docs.microsoft.com/en-us/rest/api/billing/"
         },
@@ -1968,7 +1968,7 @@
           "Invoices"
         ],
         "operationId": "Invoices_GetById",
-        "description": "Gets the invoice by name.",
+        "description": "Gets an invoice by ID.",
         "externalDocs": {
           "url": "https://docs.microsoft.com/en-us/rest/api/billing/"
         },
@@ -2013,7 +2013,7 @@
           "BillingSubscriptions"
         ],
         "operationId": "BillingSubscriptions_ListByBillingProfile",
-        "description": "Lists billing subscriptions by billing profile name.",
+        "description": "Lists the subscriptions that are billed to a billing profile. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.",
         "externalDocs": {
           "url": "https://docs.microsoft.com/en-us/rest/api/billing/"
         },
@@ -2055,7 +2055,7 @@
           "BillingSubscriptions"
         ],
         "operationId": "BillingSubscriptions_ListByInvoiceSection",
-        "description": "Lists billing subscription by invoice section name.",
+        "description": "Lists the subscriptions that are billed to an invoice section. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.",
         "externalDocs": {
           "url": "https://docs.microsoft.com/en-us/rest/api/billing/"
         },
@@ -2100,7 +2100,7 @@
           "BillingSubscriptions"
         ],
         "operationId": "BillingSubscriptions_Get",
-        "description": "Get a single billing subscription by name.",
+        "description": "Gets a subscription by its ID. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.",
         "externalDocs": {
           "url": "https://docs.microsoft.com/en-us/rest/api/billing/"
         },
@@ -2144,7 +2144,7 @@
     },
     "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingSubscriptions/{billingSubscriptionName}/transfer": {
       "post": {
-        "description": "Transfers the subscription from one invoice section to another within a billing account.",
+        "description": "Moves a subscription's charges to a new invoice section. The new invoice section must belong to the same billing profile as the existing invoice section. This operation is supported only for products that are purchased with a recurring charge and for billing accounts with agreement type Microsoft Customer Agreement.",
         "operationId": "BillingSubscriptions_Transfer",
         "x-ms-long-running-operation": true,
         "x-ms-examples": {
@@ -2172,7 +2172,7 @@
             "schema": {
               "$ref": "#/definitions/TransferBillingSubscriptionRequestProperties"
             },
-            "description": "Request parameters supplied to the Transfer Billing Subscription operation."
+            "description": "Request parameters that are provided to the transfer product operation."
           }
         ],
         "responses": {
@@ -2190,7 +2190,7 @@
                 "type": "string"
               },
               "Retry-After": {
-                "description": "Recommends the retryable time after receiving this.",
+                "description": "Recommended time to wait before making another request to check the status of the operation. The time is specified in seconds.",
                 "type": "integer"
               }
             }
@@ -2215,7 +2215,7 @@
           }
         },
         "operationId": "BillingSubscriptions_ValidateTransfer",
-        "description": "Validates the transfer of billing subscriptions across invoice sections.",
+        "description": "Validates if a subscription's charges can be moved to a new invoice section. This operation is supported only for products that are purchased with a recurring charge and for billing accounts with agreement type Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/billingAccountNameParameter"
@@ -2236,7 +2236,7 @@
             "schema": {
               "$ref": "#/definitions/TransferBillingSubscriptionRequestProperties"
             },
-            "description": "Parameters supplied to the Transfer Billing Subscription operation."
+            "description": "Request parameters that are provided to the validate transfer eligibility operation."
           }
         ],
         "responses": {
@@ -2261,7 +2261,7 @@
           "Products"
         ],
         "operationId": "Products_ListByBillingAccount",
-        "description": "Lists products by billing account name.",
+        "description": "Lists the products for a billing account. These don't include products billed based on usage. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.",
         "externalDocs": {
           "url": "https://docs.microsoft.com/en-us/rest/api/billing/"
         },
@@ -2279,7 +2279,7 @@
           },
           {
             "name": "$filter",
-            "description": "May be used to filter by product type. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value is separated by a colon (:).",
+            "description": "May be used to filter by product type. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value are separated by a colon (:).",
             "in": "query",
             "required": false,
             "type": "string"
@@ -2310,7 +2310,7 @@
           "Products"
         ],
         "operationId": "Products_ListByInvoiceSection",
-        "description": "Lists products by invoice section name.",
+        "description": "Lists the products for an invoice section. These don't include products billed based on usage. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.",
         "externalDocs": {
           "url": "https://docs.microsoft.com/en-us/rest/api/billing/"
         },
@@ -2334,7 +2334,7 @@
           },
           {
             "name": "$filter",
-            "description": "May be used to filter by product type. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value is separated by a colon (:).",
+            "description": "May be used to filter by product type. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value are separated by a colon (:).",
             "in": "query",
             "required": false,
             "type": "string"
@@ -2362,7 +2362,7 @@
           "Products"
         ],
         "operationId": "Products_Get",
-        "description": "Get a single product by name.",
+        "description": "Gets a product by ID. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.",
         "externalDocs": {
           "url": "https://docs.microsoft.com/en-us/rest/api/billing/"
         },
@@ -2410,7 +2410,7 @@
           "Products"
         ],
         "operationId": "Products_Transfer",
-        "description": "The operation to transfer a Product to another invoice section.",
+        "description": "Moves a product's charges to a new invoice section. The new invoice section must belong to the same billing profile as the existing invoice section. This operation is supported only for products that are purchased with a recurring charge and for billing accounts with agreement type Microsoft Customer Agreement.",
         "x-ms-examples": {
           "TransferProduct": {
             "$ref": "./examples/TransferProduct.json"
@@ -2439,7 +2439,7 @@
             "schema": {
               "$ref": "#/definitions/TransferProductRequestProperties"
             },
-            "description": "Parameters supplied to the Transfer Product operation."
+            "description": "Request parameters that are provided to the transfer product operation."
           }
         ],
         "responses": {
@@ -2457,7 +2457,7 @@
                 "type": "string"
               },
               "Retry-After": {
-                "description": "Recommends the retryable time after receiving this.",
+                "description": "Recommended time to wait before making another request to check the status of the operation. The time is specified in seconds.",
                 "type": "integer"
               }
             }
@@ -2482,7 +2482,7 @@
           }
         },
         "operationId": "Products_ValidateTransfer",
-        "description": "Validates the transfer of products across invoice sections.",
+        "description": "Validates if a product's charges can be moved to a new invoice section. This operation is supported only for products that are purchased with a recurring charge and for billing accounts with agreement type Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/billingAccountNameParameter"
@@ -2503,7 +2503,7 @@
             "schema": {
               "$ref": "#/definitions/TransferProductRequestProperties"
             },
-            "description": "Parameters supplied to the Transfer Products operation."
+            "description": "Request parameters that are provided to the validate transfer eligibility operation."
           }
         ],
         "responses": {
@@ -2550,20 +2550,20 @@
           {
             "name": "periodStartDate",
             "in": "query",
-            "description": "Start date",
+            "description": "The start date to fetch the transactions. The date should be specified in MM-DD-YYYY format.",
             "required": true,
             "type": "string"
           },
           {
             "name": "periodEndDate",
             "in": "query",
-            "description": "End date",
+            "description": "The end date to fetch the transactions. The date should be specified in MM-DD-YYYY format.",
             "required": true,
             "type": "string"
           },
           {
             "name": "$filter",
-            "description": "May be used to filter by transaction kind. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value is separated by a colon (:).",
+            "description": "May be used to filter by transaction type. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value are separated by a colon (:).",
             "in": "query",
             "required": false,
             "type": "string"
@@ -2619,20 +2619,20 @@
           {
             "name": "periodStartDate",
             "in": "query",
-            "description": "Start date",
+            "description": "The start date to fetch the transactions. The date should be specified in MM-DD-YYYY format.",
             "required": true,
             "type": "string"
           },
           {
             "name": "periodEndDate",
             "in": "query",
-            "description": "End date",
+            "description": "The end date to fetch the transactions. The date should be specified in MM-DD-YYYY format.",
             "required": true,
             "type": "string"
           },
           {
             "name": "$filter",
-            "description": "May be used to filter by transaction kind. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value is separated by a colon (:).",
+            "description": "May be used to filter by transaction type. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value are separated by a colon (:).",
             "in": "query",
             "required": false,
             "type": "string"
@@ -2688,20 +2688,20 @@
           {
             "name": "periodStartDate",
             "in": "query",
-            "description": "Start date",
+            "description": "The start date to fetch the transactions. The date should be specified in MM-DD-YYYY format.",
             "required": true,
             "type": "string"
           },
           {
             "name": "periodEndDate",
             "in": "query",
-            "description": "End date",
+            "description": "The end date to fetch the transactions. The date should be specified in MM-DD-YYYY format.",
             "required": true,
             "type": "string"
           },
           {
             "name": "$filter",
-            "description": "May be used to filter by transaction kind. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value is separated by a colon (:).",
+            "description": "May be used to filter by transaction type. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value are separated by a colon (:).",
             "in": "query",
             "required": false,
             "type": "string"
@@ -2729,7 +2729,7 @@
           "Transactions"
         ],
         "operationId": "Transactions_ListByInvoice",
-        "description": "Lists the transactions by invoice. Transactions include purchases, refunds and Azure usage charges.",
+        "description": "Lists the transactions for an invoice. Transactions include purchases, refunds and Azure usage charges.",
         "externalDocs": {
           "url": "https://docs.microsoft.com/en-us/rest/api/billing/"
         },
@@ -2777,7 +2777,7 @@
           "Transactions"
         ],
         "operationId": "Transactions_Get",
-        "description": "Get the transaction.",
+        "description": "Gets a transaction by ID. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.",
         "externalDocs": {
           "url": "https://docs.microsoft.com/en-us/rest/api/billing/"
         },
@@ -2799,14 +2799,14 @@
           {
             "name": "periodStartDate",
             "in": "query",
-            "description": "Start date",
+            "description": "The start date to fetch the transactions. The date should be specified in MM-DD-YYYY format.",
             "required": true,
             "type": "string"
           },
           {
             "name": "periodEndDate",
             "in": "query",
-            "description": "End date",
+            "description": "The end date to fetch the transactions. The date should be specified in MM-DD-YYYY format.",
             "required": true,
             "type": "string"
           },
@@ -2836,7 +2836,7 @@
           "Policies"
         ],
         "operationId": "Policies_GetByBillingProfile",
-        "description": "The policy for a given billing account name and billing profile name.",
+        "description": "Lists the policies for a billing profile. This operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.",
         "externalDocs": {
           "url": "https://docs.microsoft.com/en-us/rest/api/billing/"
         },
@@ -2876,7 +2876,7 @@
           "Policies"
         ],
         "operationId": "Policies_Update",
-        "description": "The operation to update a policy.",
+        "description": "Updates the policies for a billing profile. This operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.",
         "x-ms-examples": {
           "UpdateBillingProfile": {
             "$ref": "./examples/UpdatePolicy.json"
@@ -2899,7 +2899,7 @@
             "schema": {
               "$ref": "#/definitions/Policy"
             },
-            "description": "Parameters supplied to the update policy operation."
+            "description": "Request parameters that are provided to the update policies operation."
           }
         ],
         "responses": {
@@ -2924,7 +2924,7 @@
           "Policies"
         ],
         "operationId": "Policies_GetByCustomer",
-        "description": "The policy for a given billing account name and customer name.",
+        "description": "Lists the policies for a customer. This operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.",
         "externalDocs": {
           "url": "https://docs.microsoft.com/en-us/rest/api/billing/"
         },
@@ -2964,7 +2964,7 @@
           "Policies"
         ],
         "operationId": "Policies_UpdateCustomer",
-        "description": "The operation to update a Customer policy.",
+        "description": "Updates the policies for a customer. This operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.",
         "x-ms-examples": {
           "UpdateCustomer": {
             "$ref": "./examples/UpdateCustomerPolicy.json"
@@ -2987,7 +2987,7 @@
             "schema": {
               "$ref": "#/definitions/CustomerPolicy"
             },
-            "description": "Parameters supplied to the update customer policy operation."
+            "description": "Request parameters that are provided to the update policies operation."
           }
         ],
         "responses": {
@@ -3012,7 +3012,7 @@
           "BillingProperties"
         ],
         "operationId": "BillingProperty_Get",
-        "description": "Get billing property by subscription Id.",
+        "description": "Get the billing properties for a subscription. This operation is not supported for billing accounts with agreement type Enterprise Agreement.",
         "externalDocs": {
           "url": "https://docs.microsoft.com/en-us/rest/api/billing/"
         },
@@ -3098,7 +3098,7 @@
         "tags": [
           "InvoiceSections"
         ],
-        "description": "Elevates the caller's access to match their billing profile access.",
+        "description": "Gives the caller permissions on an invoice section based on their billing profile access.  The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.",
         "operationId": "InvoiceSections_ElevateToBillingProfile",
         "x-ms-examples": {
           "Elevate": {
@@ -3134,7 +3134,7 @@
         "tags": [
           "Transfers"
         ],
-        "description": "Initiates the request to transfer the legacy subscriptions or RIs.",
+        "description": "Sends a request to a user in another billing account to transfer billing ownership of their subscriptions. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.",
         "operationId": "Transfers_Initiate",
         "x-ms-examples": {
           "InitiateTransfer": {
@@ -3158,7 +3158,7 @@
             "schema": {
               "$ref": "#/definitions/InitiateTransferRequest"
             },
-            "description": "Parameters supplied to initiate the transfer."
+            "description": "Request parameters that are provided to the initiate transfer operation."
           }
         ],
         "responses": {
@@ -3182,7 +3182,7 @@
         "tags": [
           "Transfers"
         ],
-        "description": "Gets the transfer details for given transfer Id.",
+        "description": "Gets a transfer request by ID. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.",
         "operationId": "Transfers_Get",
         "x-ms-examples": {
           "TransferGet": {
@@ -3222,7 +3222,7 @@
         "tags": [
           "Transfers"
         ],
-        "description": "Cancels the transfer for given transfer Id.",
+        "description": "Cancels a transfer request. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.",
         "operationId": "Transfers_Cancel",
         "x-ms-examples": {
           "TransferCancel": {
@@ -3264,7 +3264,7 @@
         "tags": [
           "Transfers"
         ],
-        "description": "Lists all transfer's details initiated from given invoice section.",
+        "description": "Lists the transfer requests for an invoice section. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.",
         "operationId": "Transfers_List",
         "x-ms-examples": {
           "TransfersList": {
@@ -3306,7 +3306,7 @@
         "tags": [
           "Transfers"
         ],
-        "description": "Initiates the request to transfer the legacy subscriptions or RIs.",
+        "description": "Sends a request to a user in a customer's billing account to transfer billing ownership of their subscriptions. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.",
         "operationId": "PartnerTransfers_Initiate",
         "x-ms-examples": {
           "InitiatePartnerTransfer": {
@@ -3330,7 +3330,7 @@
             "schema": {
               "$ref": "#/definitions/InitiateTransferRequest"
             },
-            "description": "Parameters supplied to initiate the transfer."
+            "description": "Request parameters that are provided to the initiate transfer operation."
           }
         ],
         "responses": {
@@ -3354,7 +3354,7 @@
         "tags": [
           "Transfers"
         ],
-        "description": "Gets the transfer details for given transfer Id.",
+        "description": "Gets a transfer request by ID. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.",
         "operationId": "PartnerTransfers_Get",
         "x-ms-examples": {
           "TransferGet": {
@@ -3394,7 +3394,7 @@
         "tags": [
           "Transfers"
         ],
-        "description": "Cancels the transfer for given transfer Id.",
+        "description": "Cancels a transfer request. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.",
         "operationId": "PartnerTransfers_Cancel",
         "x-ms-examples": {
           "TransferCancel": {
@@ -3436,7 +3436,7 @@
         "tags": [
           "Transfers"
         ],
-        "description": "Lists all transfer's details initiated from given invoice section.",
+        "description": "Lists the transfer requests sent to a customer. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.",
         "operationId": "PartnerTransfers_List",
         "x-ms-examples": {
           "TransfersList": {
@@ -3478,7 +3478,7 @@
         "tags": [
           "RecipientTransfers"
         ],
-        "summary": "Accepts the transfer with given transfer Id.",
+        "summary": "Accepts a transfer request.",
         "operationId": "RecipientTransfers_Accept",
         "x-ms-examples": {
           "AcceptTransfer": {
@@ -3496,7 +3496,7 @@
             "schema": {
               "$ref": "#/definitions/AcceptTransferRequest"
             },
-            "description": "Parameters supplied to accept the transfer."
+            "description": "Request parameters that are provided to the accept transfer operation."
           }
         ],
         "responses": {
@@ -3520,7 +3520,7 @@
         "tags": [
           "RecipientTransfers"
         ],
-        "summary": "Validates if the products can be transferred in the context of the given transfer name.",
+        "summary": "Validates if a subscription or a reservation can be transferred. Use this operation to validate your subscriptions or reservation before using the accept transfer operation.",
         "operationId": "RecipientTransfers_Validate",
         "x-ms-examples": {
           "ValidateTransfer": {
@@ -3538,7 +3538,7 @@
             "schema": {
               "$ref": "#/definitions/AcceptTransferRequest"
             },
-            "description": "Parameters supplied to validate the transfer."
+            "description": "Request parameters that are provided to the validate transfer operation."
           }
         ],
         "responses": {
@@ -3562,7 +3562,7 @@
         "tags": [
           "RecipientTransfers"
         ],
-        "summary": "Declines the transfer with given transfer Id.",
+        "summary": "Declines a transfer request.",
         "operationId": "RecipientTransfers_Decline",
         "x-ms-examples": {
           "DeclineTransfer": {
@@ -3595,7 +3595,7 @@
         "tags": [
           "RecipientTransfers"
         ],
-        "summary": "Gets the transfer with given transfer Id.",
+        "summary": "Gets a transfer request by ID. The caller must be the recipient of the transfer request.",
         "operationId": "RecipientTransfers_Get",
         "x-ms-examples": {
           "RecipientTransferGet": {
@@ -3628,7 +3628,7 @@
         "tags": [
           "RecipientTransfers"
         ],
-        "summary": "Lists the transfers received by caller.",
+        "summary": "Lists the transfer requests received by the caller.",
         "operationId": "RecipientTransfers_List",
         "x-ms-examples": {
           "RecipientTransfersList": {
@@ -3660,7 +3660,7 @@
           "Operations"
         ],
         "operationId": "Operations_List",
-        "description": "Lists all of the available billing REST API operations.",
+        "description": "Lists the available billing REST API operations.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -3696,7 +3696,7 @@
           }
         },
         "operationId": "BillingPermissions_ListByBillingAccount",
-        "description": "Lists all billing permissions for the caller under a billing account.",
+        "description": "Lists the billing permissions the caller has on a billing account.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -3732,7 +3732,7 @@
           }
         },
         "operationId": "BillingPermissions_ListByInvoiceSections",
-        "description": "Lists all billing permissions for the caller under invoice section.",
+        "description": "Lists the billing permissions the caller has on an invoice section.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -3774,7 +3774,7 @@
           }
         },
         "operationId": "BillingPermissions_ListByBillingProfile",
-        "description": "Lists all billing permissions the caller has for a billing account.",
+        "description": "Lists the billing permissions the caller has on a billing profile.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -3813,7 +3813,7 @@
           }
         },
         "operationId": "BillingRoleDefinitions_GetByBillingAccount",
-        "description": "Gets the role definition for a role",
+        "description": "Gets the definition for a role on a billing account. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -3852,7 +3852,7 @@
           }
         },
         "operationId": "BillingRoleDefinitions_GetByInvoiceSection",
-        "description": "Gets the role definition for a role",
+        "description": "Gets the definition for a role on an invoice section. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -3897,7 +3897,7 @@
           }
         },
         "operationId": "BillingRoleDefinitions_GetByBillingProfile",
-        "description": "Gets the role definition for a role",
+        "description": "Gets the definition for a role on a billing profile. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -3939,7 +3939,7 @@
           }
         },
         "operationId": "BillingRoleDefinitions_ListByBillingAccount",
-        "description": "Lists the role definition for a billing account",
+        "description": "Lists the role definitions for a billing account. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -3975,7 +3975,7 @@
           }
         },
         "operationId": "BillingRoleDefinitions_ListByInvoiceSection",
-        "description": "Lists the role definition for an invoice Section",
+        "description": "Lists the role definitions for an invoice section. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -4017,7 +4017,7 @@
           }
         },
         "operationId": "BillingRoleDefinitions_ListByBillingProfile",
-        "description": "Lists the role definition for a Billing Profile",
+        "description": "Lists the role definitions for a billing profile. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -4056,7 +4056,7 @@
           }
         },
         "operationId": "BillingRoleAssignments_GetByBillingAccount",
-        "description": "Get the role assignment for the caller",
+        "description": "Gets a role assignment for the caller on a billing account. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -4093,7 +4093,7 @@
           }
         },
         "operationId": "BillingRoleAssignments_DeleteByBillingAccount",
-        "description": "Delete the role assignment on this billing account",
+        "description": "Deletes a role assignment for the caller on a billing account. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -4132,7 +4132,7 @@
           }
         },
         "operationId": "BillingRoleAssignments_GetByInvoiceSection",
-        "description": "Get the role assignment for the caller on the invoice Section",
+        "description": "Gets a role assignment for the caller on an invoice section. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -4175,7 +4175,7 @@
           }
         },
         "operationId": "BillingRoleAssignments_DeleteByInvoiceSection",
-        "description": "Delete the role assignment on the invoice Section",
+        "description": "Deletes a role assignment for the caller on an invoice section. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -4220,7 +4220,7 @@
           }
         },
         "operationId": "BillingRoleAssignments_GetByBillingProfile",
-        "description": "Get the role assignment for the caller on the Billing Profile",
+        "description": "Gets a role assignment for the caller on a billing profile. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -4260,7 +4260,7 @@
           }
         },
         "operationId": "BillingRoleAssignments_DeleteByBillingProfile",
-        "description": "Delete the role assignment on this Billing Profile",
+        "description": "Deletes a role assignment for the caller on a billing profile. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -4302,7 +4302,7 @@
           }
         },
         "operationId": "BillingRoleAssignments_ListByBillingAccount",
-        "description": "Get the role assignments on the Billing Account",
+        "description": "Lists the role assignments for the caller on a billing account. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -4333,7 +4333,7 @@
           "BillingRoleAssignments"
         ],
         "operationId": "BillingRoleAssignments_AddByBillingAccount",
-        "description": "The operation to add a role assignment to a billing account.",
+        "description": "Adds a role assignment on a billing account. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement.",
         "x-ms-examples": {
           "AddRoleAssignmentToBillingAccount": {
             "$ref": "./examples/AddRoleAssignmentToBillingAccount.json"
@@ -4353,7 +4353,7 @@
             "schema": {
               "$ref": "#/definitions/BillingRoleAssignmentPayload"
             },
-            "description": "Parameters supplied to add a role assignment."
+            "description": "Request parameters that are provided to the create billing role assignment operation."
           }
         ],
         "responses": {
@@ -4383,7 +4383,7 @@
           }
         },
         "operationId": "BillingRoleAssignments_ListByInvoiceSection",
-        "description": "Get the role assignments on the invoice Section",
+        "description": "Lists the role assignments for the caller on an invoice section. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -4420,7 +4420,7 @@
           "BillingRoleAssignments"
         ],
         "operationId": "BillingRoleAssignments_AddByInvoiceSection",
-        "description": "The operation to add a role assignment to a invoice Section.",
+        "description": "Adds a role assignment on an invoice section. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement.",
         "x-ms-examples": {
           "AddRoleAssignmentToInvoiceSection": {
             "$ref": "./examples/AddRoleAssignmentToInvoiceSection.json"
@@ -4446,7 +4446,7 @@
             "schema": {
               "$ref": "#/definitions/BillingRoleAssignmentPayload"
             },
-            "description": "Parameters supplied to add a role assignment."
+            "description": "Request parameters that are provided to the create billing role assignment operation."
           }
         ],
         "responses": {
@@ -4476,7 +4476,7 @@
           }
         },
         "operationId": "BillingRoleAssignments_ListByBillingProfile",
-        "description": "Get the role assignments on the Billing Profile",
+        "description": "Lists the role assignments for the caller on a billing profile. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -4510,7 +4510,7 @@
           "BillingRoleAssignments"
         ],
         "operationId": "BillingRoleAssignments_AddByBillingProfile",
-        "description": "The operation to add a role assignment to a billing profile.",
+        "description": "Adds a role assignment on a billing profile. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement.",
         "x-ms-examples": {
           "AddRoleAssignmentToBillingProfile": {
             "$ref": "./examples/AddRoleAssignmentToBillingProfile.json"
@@ -4533,7 +4533,7 @@
             "schema": {
               "$ref": "#/definitions/BillingRoleAssignmentPayload"
             },
-            "description": "Parameters supplied to add a role assignment."
+            "description": "Request parameters that are provided to the create billing role assignment operation."
           }
         ],
         "responses": {
@@ -4563,7 +4563,7 @@
           }
         },
         "operationId": "Agreements_ListByBillingAccount",
-        "description": "Lists all agreements for a billing account.",
+        "description": "Lists the agreements for a billing account.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -4606,7 +4606,7 @@
           }
         },
         "operationId": "Agreements_Get",
-        "description": "Get the agreement by name.",
+        "description": "Gets an agreement by ID.",
         "parameters": [
           {
             "$ref": "#/parameters/apiVersionParameter"
@@ -4644,7 +4644,7 @@
   },
   "definitions": {
     "CustomerListResult": {
-      "description": "Result of listing customers.",
+      "description": "The list of customers.",
       "properties": {
         "value": {
           "description": "The list of customers.",
@@ -4685,14 +4685,14 @@
           "type": "string"
         },
         "enabledAzurePlans": {
-          "description": "Information about the product.",
+          "description": "Azure plans enabled for the customer.",
           "type": "array",
           "items": {
             "$ref": "#/definitions/AzurePlan"
           }
         },
         "resellers": {
-          "description": "The resellers which are allowed to provide service to this customer.",
+          "description": "The list of resellers for which an Azure plan is enabled for the customer.",
           "type": "array",
           "items": {
             "$ref": "#/definitions/Reseller"
@@ -4720,7 +4720,7 @@
           "$ref": "#/definitions/AddressValidationStatus"
         },
         "suggestedAddresses": {
-          "description": "list of suggested addresses.",
+          "description": "The list of suggested addresses.",
           "type": "array",
           "items": {
             "$ref": "#/definitions/AddressDetails"
@@ -4734,7 +4734,7 @@
     },
     "AddressValidationStatus": {
       "type": "string",
-      "description": "Status of the address validation response.",
+      "description": "Status of the address validation.",
       "enum": [
         "Valid",
         "Invalid"
@@ -4750,11 +4750,11 @@
       "properties": {
         "recipientEmailId": {
           "type": "string",
-          "description": "Email Id of recipient for transfer."
+          "description": "The email ID of the recipient to whom the transfer request is sent."
         },
         "resellerId": {
           "type": "string",
-          "description": "Optional reseller Id for transfer."
+          "description": "Optional MPN ID of the reseller for transfer requests that are sent from a Microsoft Partner Agreement billing account."
         }
       }
     },
@@ -4784,21 +4784,21 @@
     },
     "ProductDetails": {
       "type": "object",
-      "description": "Details of the product to be transferred.",
+      "description": "Details of the product that is transferred.",
       "properties": {
         "productType": {
-          "description": "Type of the product to be transferred.",
+          "description": "Type of the product that is transferred.",
           "$ref": "#/definitions/ProductType"
         },
         "productId": {
           "type": "string",
-          "description": "Id of product to be transferred."
+          "description": "The ID of the product that is transferred."
         }
       }
     },
     "ProductType": {
       "type": "string",
-      "description": "Type of the product to be transferred.",
+      "description": "The type of product that is transferred.",
       "enum": [
         "AzureSubscription",
         "AzureReservation"
@@ -4838,12 +4838,12 @@
           "type": "string",
           "$ref": "#/definitions/ProductType",
           "readOnly": true,
-          "description": "Type of product being transferred."
+          "description": "Type of product that is transferred."
         },
         "productId": {
           "type": "string",
           "readOnly": true,
-          "description": "Id of product being transferred."
+          "description": "The ID of the product that is transferred."
         },
         "transferStatus": {
           "type": "string",
@@ -4892,43 +4892,43 @@
         "creationTime": {
           "type": "string",
           "format": "date-time",
-          "description": "Transfer creation time.",
+          "description": "The time at which the transfer request was created.",
           "readOnly": true
         },
         "expirationTime": {
           "type": "string",
           "format": "date-time",
           "readOnly": true,
-          "description": "Transfer expiration time."
+          "description": "The time at which the transfer request expires."
         },
         "invoiceSectionId": {
           "type": "string",
-          "description": "Target invoice section Id.",
+          "description": "The ID of the invoice section to which the product is billed after the transfer request is completed.",
           "readOnly": true
         },
         "billingAccountId": {
           "type": "string",
-          "description": "Target billing account Id.",
+          "description": "The ID of the billing account to which the product is billed after the transfer request is completed.",
           "readOnly": true
         },
         "resellerId": {
           "type": "string",
-          "description": "Reseller Id for transfer.",
+          "description": "Optional MPN ID of the reseller for transfer requests that are sent from a Microsoft Partner Agreement billing account.",
           "readOnly": true
         },
         "resellerName": {
           "type": "string",
-          "description": "Reseller name for transfer.",
+          "description": "Optional name of the reseller for transfer requests that are sent from Microsoft Partner Agreement billing account.",
           "readOnly": true
         },
         "initiatorCustomerType": {
           "type": "string",
-          "description": "Customer type of the initiator.",
+          "description": "The type of customer who sent the transfer request.",
           "readOnly": true
         },
         "billingProfileId": {
           "type": "string",
-          "description": "Target billing profile Id.",
+          "description": "The ID of the billing profile to which the product will be billed after the transfer.",
           "readOnly": true
         },
         "transferStatus": {
@@ -4940,23 +4940,23 @@
         "recipientEmailId": {
           "type": "string",
           "readOnly": true,
-          "description": "Email Id of recipient of transfer."
+          "description": "The email ID of the user to whom the transfer request was sent."
         },
         "initiatorEmailId": {
           "type": "string",
           "readOnly": true,
-          "description": "Email Id of initiator of transfer."
+          "description": "The email ID of the user who sent the transfer request."
         },
         "canceledBy": {
           "type": "string",
           "readOnly": true,
-          "description": "Email Id who user canceled the transfer."
+          "description": "The email ID of the user who canceled the transfer request."
         },
         "lastModifiedTime": {
           "type": "string",
           "format": "date-time",
           "readOnly": true,
-          "description": "Transfer last modification time."
+          "description": "The time at which the transfer request was last modified."
         },
         "detailedTransferStatus": {
           "type": "array",
@@ -4975,14 +4975,14 @@
         "creationTime": {
           "type": "string",
           "format": "date-time",
-          "description": "Transfer creation time.",
+          "description": "The time at which the transfer request was created.",
           "readOnly": true
         },
         "expirationTime": {
           "type": "string",
           "format": "date-time",
           "readOnly": true,
-          "description": "Transfer expiration time."
+          "description": "The time at which the transfer request expires."
         },
         "allowedProductType": {
           "type": "array",
@@ -5001,38 +5001,38 @@
         "recipientEmailId": {
           "type": "string",
           "readOnly": true,
-          "description": "Email Id of recipient of transfer."
+          "description": "The email ID of the user to whom the transfer request was sent."
         },
         "initiatorEmailId": {
           "type": "string",
           "readOnly": true,
-          "description": "Email Id of initiator of transfer."
+          "description": "The email ID of the user who sent the transfer request."
         },
         "resellerId": {
           "type": "string",
-          "description": "Reseller Id for transfer.",
+          "description": "Optional MPN ID of the reseller for transfer requests that are sent from a Microsoft Partner Agreement billing account.",
           "readOnly": true
         },
         "resellerName": {
           "type": "string",
-          "description": "Reseller name for transfer.",
+          "description": "Optional name of the reseller for transfer requests that are sent from Microsoft Partner Agreement billing account.",
           "readOnly": true
         },
         "initiatorCustomerType": {
           "type": "string",
-          "description": "Customer type of the initiator.",
+          "description": "The type of customer who sent the transfer request.",
           "readOnly": true
         },
         "canceledBy": {
           "type": "string",
           "readOnly": true,
-          "description": "Email Id who user canceled the transfer."
+          "description": "The email ID of the user who canceled the transfer request."
         },
         "lastModifiedTime": {
           "type": "string",
           "format": "date-time",
           "readOnly": true,
-          "description": "Transfer last modification time."
+          "description": "The time at which the transfer request was last modified."
         },
         "detailedTransferStatus": {
           "type": "array",
@@ -5046,7 +5046,7 @@
     },
     "TransferStatus": {
       "type": "string",
-      "description": "Possible transfer status.",
+      "description": "The status of a transfer.",
       "enum": [
         "Pending",
         "InProgress",
@@ -5063,7 +5063,7 @@
     },
     "ProductTransferStatus": {
       "type": "string",
-      "description": "Possible transfer status.",
+      "description": "The status of a transfer.",
       "enum": [
         "NotStarted",
         "InProgress",
@@ -5076,7 +5076,7 @@
       }
     },
     "RecipientTransferDetailsListResult": {
-      "description": "Result of listing details of the transfer received by caller.",
+      "description": "The list of transfers received by caller.",
       "properties": {
         "value": {
           "description": "The list of transfers received by caller.",
@@ -5094,7 +5094,7 @@
       }
     },
     "TransferDetailsListResult": {
-      "description": "Result of listing details of the transfer initiated by caller.",
+      "description": "The list of transfers initiated by caller.",
       "properties": {
         "value": {
           "description": "The list of transfers initiated by caller.",
@@ -5126,10 +5126,10 @@
     },
     "TransferBillingSubscriptionResult": {
       "type": "object",
-      "description": "Request parameters to transfer billing subscription.",
+      "description": "Result of the transfer billing subscription operation.",
       "properties": {
         "properties": {
-          "description": "Request parameters to transfer billing subscription.",
+          "description": "Properties of the transfer billing subscription operation result.",
           "x-ms-client-flatten": true,
           "$ref": "#/definitions/TransferBillingSubscriptionResultProperties"
         }
@@ -5137,7 +5137,7 @@
     },
     "TransferBillingSubscriptionResultProperties": {
       "type": "object",
-      "description": "Transfer billing subscription result properties.",
+      "description": "Properties of the transfer billing subscription operation result.",
       "properties": {
         "billingSubscriptionName": {
           "type": "string",
@@ -5175,7 +5175,7 @@
       "description": "Result of the transfer eligibility validation.",
       "properties": {
         "isTransferEligible": {
-          "description": "Specifies whether the transfer is eligible or not.",
+          "description": "Specifies whether the subscription is eligible to be transferred.",
           "type": "boolean",
           "readOnly": true
         },
@@ -5223,7 +5223,7 @@
     },
     "UpdateAutoRenewOperation": {
       "type": "object",
-      "description": "Summary of cancel product operation",
+      "description": "Result of the update auto renew operation",
       "properties": {
         "properties": {
           "description": "Summary of update auto renew operation properties",
@@ -5234,17 +5234,17 @@
     },
     "UpdateAutoRenewOperationProperties": {
       "type": "object",
-      "description": "update auto renew operation properties",
+      "description": "Summary of update auto renew operation properties",
       "properties": {
         "endDate": {
           "type": "string",
           "format": "date-time",
-          "description": "The end date of this asset"
+          "description": "The date at which the product will be canceled."
         }
       }
     },
     "BillingAccountListResult": {
-      "description": "Result of listing billing accounts.",
+      "description": "The list of billing accounts.",
       "properties": {
         "value": {
           "description": "The list of billing accounts.",
@@ -5262,7 +5262,7 @@
       }
     },
     "BillingAccount": {
-      "description": "A billing account resource.",
+      "description": "A billing account.",
       "type": "object",
       "allOf": [
         {
@@ -5271,7 +5271,7 @@
       ],
       "properties": {
         "properties": {
-          "description": "A billing account.",
+          "description": "The properties of the billing account.",
           "x-ms-client-flatten": true,
           "$ref": "#/definitions/BillingAccountProperties"
         }
@@ -5286,7 +5286,7 @@
           "readOnly": true
         },
         "address": {
-          "description": "The address associated with billing account.",
+          "description": "The address associated with the billing account.",
           "$ref": "#/definitions/AddressDetails"
         },
         "agreementType": {
@@ -5333,7 +5333,7 @@
           }
         },
         "billingProfiles": {
-          "description": "The billing profiles associated to the billing account. By default this is not populated, unless it's specified in $expand.",
+          "description": "The billing profiles associated with the billing account. By default this is not populated, unless it's specified in $expand.",
           "type": "array",
           "items": {
             "$ref": "#/definitions/BillingProfile"
@@ -5376,7 +5376,7 @@
       }
     },
     "BillingProperty": {
-      "description": "A billing property resource.",
+      "description": "A billing property.",
       "type": "object",
       "allOf": [
         {
@@ -5395,27 +5395,27 @@
       "description": "The billing property.",
       "properties": {
         "billingTenantId": {
-          "description": "Billing tenant Id.",
+          "description": "The Azure AD tenant ID of the billing account for the subscription.",
           "type": "string",
           "readOnly": true
         },
         "billingAccountId": {
-          "description": "Billing account Id.",
+          "description": "The ID of the billing account to which the subscription is billed.",
           "type": "string",
           "readOnly": true
         },
         "billingAccountDisplayName": {
-          "description": "Billing account display name.",
+          "description": "The name of the billing account to which the subscription is billed.",
           "type": "string",
           "readOnly": true
         },
         "billingProfileId": {
-          "description": "Billing profile Id.",
+          "description": "The ID of the billing profile to which the subscription is billed.",
           "type": "string",
           "readOnly": true
         },
         "billingProfileDisplayName": {
-          "description": "Billing profile display name.",
+          "description": "The name of the billing profile to which the subscription is billed.",
           "type": "string",
           "readOnly": true
         },
@@ -5459,119 +5459,119 @@
           }
         },
         "costCenter": {
-          "description": "Cost center name.",
+          "description": "The cost center applied to the subscription.",
           "type": "string",
           "readOnly": true
         },
         "invoiceSectionId": {
-          "description": "Invoice Section Id.",
+          "description": "The ID of the invoice section to which the subscription is billed.",
           "type": "string",
           "readOnly": true
         },
         "invoiceSectionDisplayName": {
-          "description": "Invoice Section display name.",
+          "description": "The name of the invoice section to which the subscription is billed.",
           "type": "string",
           "readOnly": true
         },
         "productId": {
-          "description": "Product Id.",
+          "description": "The product ID of the Azure plan.",
           "type": "string",
           "readOnly": true
         },
         "productName": {
-          "description": "Product name.",
+          "description": "The product name of the Azure plan.",
           "type": "string",
           "readOnly": true
         },
         "skuId": {
-          "description": "SKU Id.",
+          "description": "The sku ID of the Azure plan for the subscription.",
           "type": "string",
           "readOnly": true
         },
         "skuDescription": {
-          "description": "SKU description.",
+          "description": "The sku description of the Azure plan for the subscription.",
           "type": "string",
           "readOnly": true
         }
       }
     },
     "Enrollment": {
-      "description": "Current entity level details",
+      "description": "The properties of an enrollment.",
       "properties": {
         "startDate": {
-          "description": "Enrollment Start Date",
+          "description": "The start date of the enrollment.",
           "type": "string",
           "format": "date-time"
         },
         "endDate": {
-          "description": "Enrollment End Date",
+          "description": "The end date of the enrollment.",
           "type": "string",
           "format": "date-time"
         },
         "currency": {
-          "description": "The currency associated with enrollment",
+          "description": "The billing currency for the enrollment.",
           "type": "string",
           "readOnly": true
         },
         "channel": {
-          "description": "The channel for Enrollment",
+          "description": "The channel type of the enrollment.",
           "type": "string",
           "readOnly": true
         },
         "policies": {
-          "description": "The attributes associated with legacy enrollment.",
+          "description": "The policies for Enterprise Agreement enrollments.",
           "$ref": "#/definitions/EnrollmentPolicies",
           "readOnly": true
         },
         "language": {
-          "description": "The language for Enrollment",
+          "description": "The language for the enrollment.",
           "type": "string",
           "readOnly": true
         },
         "countryCode": {
-          "description": "The countryCode for Enrollment",
+          "description": "The country code of the enrollment.",
           "type": "string",
           "readOnly": true
         },
         "status": {
-          "description": "Enrollment status",
+          "description": "The current status of the enrollment.",
           "type": "string",
           "readOnly": true
         },
         "billingCycle": {
-          "description": "Enrollment billing cycle",
+          "description": "The billing cycle for the enrollment.",
           "type": "string",
           "readOnly": true
         }
       }
     },
     "EnrollmentPolicies": {
-      "description": "The attributes associated with legacy enrollment",
+      "description": "The policies for Enterprise Agreement enrollments.",
       "properties": {
         "accountOwnerViewCharges": {
-          "description": "The accountOwnerViewCharges flag for Enrollment",
+          "description": "The policy that controls whether Account Owners can view charges.",
           "type": "boolean",
           "readOnly": true
         },
         "departmentAdminViewCharges": {
-          "description": "The departmentAdminViewCharges flag for Enrollment",
+          "description": "The policy that controls whether Department Administrators can view charges.",
           "type": "boolean",
           "readOnly": true
         },
         "marketplacesEnabled": {
-          "description": "The marketplaces flag for Enrollment",
+          "description": "The policy that controls whether Azure marketplace purchases are allowed in the enrollment.",
           "type": "boolean",
           "readOnly": true
         },
         "reservedInstancesEnabled": {
-          "description": "The reserved instances flag for Enrollment",
+          "description": "The policy that controls whether Azure reservation purchases are allowed in the enrollment.",
           "type": "boolean",
           "readOnly": true
         }
       }
     },
     "DepartmentListResult": {
-      "description": "Result of listing departments.",
+      "description": "The list of departments.",
       "properties": {
         "value": {
           "description": "The list of departments.",
@@ -5589,7 +5589,7 @@
       }
     },
     "Department": {
-      "description": "A department resource.",
+      "description": "A department.",
       "type": "object",
       "allOf": [
         {
@@ -5605,18 +5605,18 @@
       }
     },
     "DepartmentProperties": {
-      "description": "The properties of the department.",
+      "description": "The properties of a department.",
       "properties": {
         "departmentName": {
-          "description": "The name for department.",
+          "description": "The name of the department.",
           "type": "string"
         },
         "costCenter": {
-          "description": "The cost center name.",
+          "description": "The cost center associated with the department.",
           "type": "string"
         },
         "status": {
-          "description": "The status for department.",
+          "description": "The status of the department.",
           "type": "string"
         },
         "enrollmentAccounts": {
@@ -5629,7 +5629,7 @@
       }
     },
     "EnrollmentAccountListResult": {
-      "description": "Result of listing enrollment accounts.",
+      "description": "The list of enrollment accounts.",
       "properties": {
         "value": {
           "description": "The list of enrollment accounts.",
@@ -5647,7 +5647,7 @@
       }
     },
     "EnrollmentAccount": {
-      "description": "An account resource.",
+      "description": "An enrollment account.",
       "type": "object",
       "allOf": [
         {
@@ -5656,38 +5656,38 @@
       ],
       "properties": {
         "properties": {
-          "description": "An account.",
+          "description": "The properties of an enrollment account.",
           "x-ms-client-flatten": true,
           "$ref": "#/definitions/EnrollmentAccountProperties"
         }
       }
     },
     "EnrollmentAccountProperties": {
-      "description": "The properties of the account.",
+      "description": "The properties of an enrollment account.",
       "properties": {
         "accountName": {
-          "description": "The account name.",
+          "description": "The name of the enrollment account.",
           "type": "string"
         },
         "costCenter": {
-          "description": "The cost center name.",
+          "description": "The cost center associated with the enrollment account.",
           "type": "string"
         },
         "accountOwner": {
-          "description": "The account owner",
+          "description": "The owner of the enrollment account.",
           "type": "string"
         },
         "status": {
-          "description": "The status for account.",
+          "description": "The status of the enrollment account.",
           "type": "string"
         },
         "startDate": {
-          "description": "Account Start Date",
+          "description": "The start date of the enrollment account.",
           "type": "string",
           "format": "date-time"
         },
         "endDate": {
-          "description": "Account End Date",
+          "description": "The end date of the enrollment account.",
           "type": "string",
           "format": "date-time"
         },
@@ -5698,10 +5698,10 @@
       }
     },
     "InstructionListResult": {
-      "description": "Result of listing instructions.",
+      "description": "The list of billing instructions used during invoice generation.",
       "properties": {
         "value": {
-          "description": "The list of instructions.",
+          "description": "The list of billing instructions used during invoice generation.",
           "type": "array",
           "readOnly": true,
           "items": {
@@ -5716,7 +5716,7 @@
       }
     },
     "BillingProfileListResult": {
-      "description": "Result of listing billing profiles.",
+      "description": "The list of billing profiles.",
       "properties": {
         "value": {
           "description": "The list of billing profiles.",
@@ -5734,7 +5734,7 @@
       }
     },
     "BillingProfile": {
-      "description": "A billing profile resource.",
+      "description": "A billing profile.",
       "type": "object",
       "allOf": [
         {
@@ -5743,14 +5743,14 @@
       ],
       "properties": {
         "properties": {
-          "description": "A billing profile.",
+          "description": "The properties of the billing profile.",
           "x-ms-client-flatten": true,
           "$ref": "#/definitions/BillingProfileProperties"
         }
       }
     },
     "Instruction": {
-      "description": "A instruction resource.",
+      "description": "An instruction.",
       "type": "object",
       "allOf": [
         {
@@ -5759,7 +5759,7 @@
       ],
       "properties": {
         "properties": {
-          "description": "A billing instruction.",
+          "description": "A billing instruction used during invoice generation.",
           "x-ms-client-flatten": true,
           "$ref": "#/definitions/InstructionProperties"
         }
@@ -5798,11 +5798,11 @@
       "description": "The request parameters for creating a new billing profile.",
       "properties": {
         "displayName": {
-          "description": "The billing profile name.",
+          "description": "The name of the billing profile.",
           "type": "string"
         },
         "poNumber": {
-          "description": "Purchase order number.",
+          "description": "The purchase order name that will appear on the invoices generated for the billing profile.",
           "type": "string"
         },
         "address": {
@@ -5810,11 +5810,11 @@
           "$ref": "#/definitions/AddressDetails"
         },
         "invoiceEmailOptIn": {
-          "description": "If the billing profile is opted in to receive invoices via email.",
+          "description": "Flag controlling whether the invoices for the billing profile are sent through email.",
           "type": "boolean"
         },
         "enabledAzurePlans": {
-          "description": "Enabled azure plans for this billing profile.",
+          "description": "Enabled azure plans for the billing profile.",
           "type": "array",
           "items": {
             "$ref": "#/definitions/AzurePlan"
@@ -5826,11 +5826,11 @@
       "description": "The properties of the billing profile.",
       "properties": {
         "displayName": {
-          "description": "The billing profile name.",
+          "description": "The name of the billing profile.",
           "type": "string"
         },
         "poNumber": {
-          "description": "Purchase order number.",
+          "description": "The purchase order name that will appear on the invoices generated for the billing profile.",
           "type": "string"
         },
         "address": {
@@ -5838,16 +5838,16 @@
           "$ref": "#/definitions/AddressDetails"
         },
         "invoiceEmailOptIn": {
-          "description": "If the billing profile is opted in to receive invoices via email.",
+          "description": "Flag controlling whether the invoices for the billing profile are sent through email.",
           "type": "boolean"
         },
         "invoiceDay": {
-          "description": "Invoice day.",
+          "description": "The day of the month when the invoice for the billing profile is generated.",
           "type": "integer",
           "readOnly": true
         },
         "currency": {
-          "description": "The currency associated with the billing profile.",
+          "description": "The currency in which the charges for the billing profile are billed.",
           "type": "string",
           "readOnly": true
         },
@@ -5911,35 +5911,35 @@
       "description": "Address details.",
       "properties": {
         "firstName": {
-          "description": "First Name.",
+          "description": "First name.",
           "type": "string"
         },
         "lastName": {
-          "description": "Last Name.",
+          "description": "Last name.",
           "type": "string"
         },
         "companyName": {
-          "description": "Company Name.",
+          "description": "Company name.",
           "type": "string"
         },
         "addressLine1": {
-          "description": "Address Line1.",
+          "description": "Address line 1.",
           "type": "string"
         },
         "addressLine2": {
-          "description": "Address Line2.",
+          "description": "Address line 2.",
           "type": "string"
         },
         "addressLine3": {
-          "description": "Address Line3.",
+          "description": "Address line 3.",
           "type": "string"
         },
         "city": {
-          "description": "Address City.",
+          "description": "Address city.",
           "type": "string"
         },
         "region": {
-          "description": "Address Region.",
+          "description": "Address region.",
           "type": "string"
         },
         "country": {
@@ -5947,22 +5947,22 @@
           "type": "string"
         },
         "postalCode": {
-          "description": "Address Postal Code.",
+          "description": "Postal code.",
           "type": "string"
         }
       }
     },
     "InvoiceSectionCreationRequest": {
-      "description": "The properties of an InvoiceSection.",
+      "description": "The properties of the invoice section.",
       "properties": {
         "displayName": {
-          "description": "The name of the InvoiceSection.",
+          "description": "The name of the invoice section.",
           "type": "string"
         }
       }
     },
     "InvoiceSectionListResult": {
-      "description": "Result of listing invoice sections.",
+      "description": "The list of invoice sections.",
       "properties": {
         "value": {
           "description": "The list of invoice sections.",
@@ -5980,7 +5980,7 @@
       }
     },
     "InvoiceSection": {
-      "description": "An InvoiceSection resource.",
+      "description": "An invoice section.",
       "type": "object",
       "allOf": [
         {
@@ -5989,24 +5989,24 @@
       ],
       "properties": {
         "properties": {
-          "description": "The InvoiceSection.",
+          "description": "The properties of an invoice section.",
           "x-ms-client-flatten": true,
           "$ref": "#/definitions/InvoiceSectionProperties"
         }
       }
     },
     "InvoiceSectionProperties": {
-      "description": "The properties of an InvoiceSection.",
+      "description": "The properties of an invoice section.",
       "properties": {
         "displayName": {
-          "description": "The name of the InvoiceSection.",
+          "description": "The name of the invoice section.",
           "type": "string"
         }
       }
     },
     "InvoiceSectionListWithCreateSubPermissionResult": {
       "type": "object",
-      "description": "Result of listing invoice section properties with create subscription permission.",
+      "description": "The list of invoice section properties with create subscription permission.",
       "properties": {
         "value": {
           "description": "The list of invoice section properties with create subscription permission.",
@@ -6026,22 +6026,22 @@
       "description": "Invoice section properties with create subscription permission.",
       "properties": {
         "invoiceSectionId": {
-          "description": "Invoice Section Id.",
+          "description": "The ID of the invoice section.",
           "type": "string",
           "readOnly": true
         },
         "invoiceSectionDisplayName": {
-          "description": "Invoice Section display name.",
+          "description": "The name of the invoice section.",
           "type": "string",
           "readOnly": true
         },
         "billingProfileId": {
-          "description": "Billing profile Id.",
+          "description": "The ID of the billing profile for the invoice section.",
           "type": "string",
           "readOnly": true
         },
         "billingProfileDisplayName": {
-          "description": "Billing profile display name.",
+          "description": "The name of the billing profile for the invoice section.",
           "type": "string",
           "readOnly": true
         },
@@ -6095,7 +6095,7 @@
       }
     },
     "AzurePlan": {
-      "description": "Details about the azure plan.",
+      "description": "Details of the Azure plan.",
       "properties": {
         "skuId": {
           "description": "The sku id.",
@@ -6112,7 +6112,7 @@
       "description": "A secure URL that can be used to download a an entity until the URL expires.",
       "properties": {
         "expiryTime": {
-          "description": "The time in UTC at which this download URL will expire.",
+          "description": "The time in UTC when the download URL will expire.",
           "type": "string",
           "format": "date-time",
           "readOnly": true
@@ -6155,15 +6155,15 @@
       }
     },
     "Reseller": {
-      "description": "Details about a reseller.",
+      "description": "Details of the reseller.",
       "properties": {
         "resellerId": {
-          "description": "The reseller id.",
+          "description": "The MPN ID of the reseller.",
           "type": "string",
           "readOnly": true
         },
         "description": {
-          "description": "A description of the reseller.",
+          "description": "The name of the reseller.",
           "type": "string",
           "readOnly": true
         }
@@ -6191,7 +6191,7 @@
       "x-ms-azure-resource": true
     },
     "InvoiceListResult": {
-      "description": "Result of listing invoices.",
+      "description": "The list of invoices.",
       "properties": {
         "value": {
           "description": "The list of invoices.",
@@ -6209,7 +6209,7 @@
       }
     },
     "Invoice": {
-      "description": "An invoice resource.",
+      "description": "An invoice.",
       "type": "object",
       "allOf": [
         {
@@ -6228,19 +6228,19 @@
       "description": "The properties of the invoice.",
       "properties": {
         "dueDate": {
-          "description": "The due date for invoice.",
+          "description": "The due date for the invoice.",
           "type": "string",
           "format": "date-time",
           "readOnly": true
         },
         "invoiceDate": {
-          "description": "The date when invoice was created.",
+          "description": "The date when the invoice was generated.",
           "type": "string",
           "format": "date-time",
           "readOnly": true
         },
         "status": {
-          "description": "Invoice status.",
+          "description": "The current status of the invoice.",
           "type": "string",
           "enum": [
             "Due",
@@ -6294,13 +6294,13 @@
           "$ref": "#/definitions/Amount"
         },
         "invoicePeriodStartDate": {
-          "description": "The start date of the billing period.",
+          "description": "The start date of the billing period for which the invoice is generated.",
           "type": "string",
           "format": "date-time",
           "readOnly": true
         },
         "invoicePeriodEndDate": {
-          "description": "The end date of the billing period.",
+          "description": "The end date of the billing period for which the invoice is generated.",
           "type": "string",
           "format": "date-time",
           "readOnly": true
@@ -6325,22 +6325,22 @@
           "readOnly": true
         },
         "billingProfileId": {
-          "description": "The billing profile id this invoice belongs to.",
+          "description": "The ID of the billing profile for which the invoice is generated.",
           "type": "string",
           "readOnly": true
         },
         "billingProfileDisplayName": {
-          "description": "The billing profile display name this invoice belongs to.",
+          "description": "The name of the billing profile for which the invoice is generated.",
           "type": "string",
           "readOnly": true
         },
         "purchaseOrderNumber": {
-          "description": "An optional purchase order number used for the invoice.",
+          "description": "An optional purchase order number for the invoice.",
           "type": "string",
           "readOnly": true
         },
         "documents": {
-          "description": "List of documents available to download including invoice and tax documents.",
+          "description": "List of documents available to download such as invoice and tax receipt.",
           "type": "array",
           "readOnly": true,
           "items": {
@@ -6356,14 +6356,14 @@
           }
         },
         "subscriptionId": {
-          "description": "The subscription id this invoice belongs to.",
+          "description": "The ID of the subscription for which the invoice is generated.",
           "type": "string",
           "readOnly": true
         }
       }
     },
     "PaymentProperties": {
-      "description": "The properties of the payment.",
+      "description": "The properties of a payment.",
       "properties": {
         "paymentType": {
           "description": "The type of payment.",
@@ -6376,13 +6376,13 @@
           "$ref": "#/definitions/Amount"
         },
         "date": {
-          "description": "The date of the payment.",
+          "description": "The date when the payment was made.",
           "type": "string",
           "format": "date-time",
           "readOnly": true
         },
         "paymentMethodFamily": {
-          "description": "The payment method family.",
+          "description": "The family of payment method.",
           "type": "string",
           "enum": [
             "Credits",
@@ -6403,10 +6403,10 @@
       }
     },
     "Document": {
-      "description": "The properties of the invoice download.",
+      "description": "The properties of a document.",
       "properties": {
         "kind": {
-          "description": "Document type.",
+          "description": "The type of the document.",
           "type": "string",
           "enum": [
             "Invoice",
@@ -6428,7 +6428,7 @@
       }
     },
     "ProductsListResult": {
-      "description": "Result of listing products. It contains a list of available products summaries in reverse chronological order by purchase date.",
+      "description": "The list of products. It contains a list of available product summaries in reverse chronological order by purchase date.",
       "properties": {
         "value": {
           "description": "The list of products.",
@@ -6446,7 +6446,7 @@
       }
     },
     "Product": {
-      "description": "A product resource.",
+      "description": "A product.",
       "type": "object",
       "allOf": [
         {
@@ -6462,7 +6462,7 @@
       }
     },
     "ProductProperties": {
-      "description": "The properties of the product.",
+      "description": "The properties of a product.",
       "properties": {
         "displayName": {
           "description": "The display name of the product.",
@@ -6470,23 +6470,23 @@
           "readOnly": true
         },
         "purchaseDate": {
-          "description": "The date of purchase.",
+          "description": "The date when the product was purchased.",
           "type": "string",
           "format": "date-time",
           "readOnly": true
         },
         "productTypeId": {
-          "description": "The product type id.",
+          "description": "The ID of the type of product.",
           "type": "string",
           "readOnly": true
         },
         "productType": {
-          "description": "The type of product.",
+          "description": "The description of the type of product.",
           "type": "string",
           "readOnly": true
         },
         "status": {
-          "description": "Product status.",
+          "description": "The current status of the product.",
           "type": "string",
           "enum": [
             "Active",
@@ -6504,13 +6504,13 @@
           }
         },
         "endDate": {
-          "description": "end date.",
+          "description": "The date when the product will be renewed or canceled.",
           "type": "string",
           "format": "date-time",
           "readOnly": true
         },
         "billingFrequency": {
-          "description": "Billing frequency.",
+          "description": "The frequency at which the product will be billed.",
           "type": "string",
           "enum": [
             "OneTime",
@@ -6523,7 +6523,7 @@
           }
         },
         "lastCharge": {
-          "description": "Last month charges.",
+          "description": "The last month charges.",
           "readOnly": true,
           "$ref": "#/definitions/Amount"
         },
@@ -6534,17 +6534,17 @@
           "readOnly": true
         },
         "quantity": {
-          "description": "The purchased product quantity.",
+          "description": "The quantity purchased for the product.",
           "type": "number",
           "readOnly": true
         },
         "skuId": {
-          "description": "Sku Id.",
+          "description": "The sku ID of the product.",
           "type": "string",
           "readOnly": true
         },
         "skuDescription": {
-          "description": "Sku description.",
+          "description": "The sku description of the product.",
           "type": "string",
           "readOnly": true
         },
@@ -6554,42 +6554,42 @@
           "readOnly": true
         },
         "availabilityId": {
-          "description": "Availability Id.",
+          "description": "The availability of the product.",
           "type": "string",
           "readOnly": true
         },
         "parentProductId": {
-          "description": "Parent Product Id.",
+          "description": "Parent product Id.",
           "type": "string",
           "readOnly": true
         },
         "invoiceSectionId": {
-          "description": "Invoice section id to which this product belongs.",
+          "description": "The ID of the invoice section to which the product is billed.",
           "type": "string",
           "readOnly": true
         },
         "invoiceSectionDisplayName": {
-          "description": "Invoice section display name to which this product belongs.",
+          "description": "The name of the invoice section to which the product is billed.",
           "type": "string",
           "readOnly": true
         },
         "billingProfileId": {
-          "description": "Billing Profile id to which this product belongs.",
+          "description": "The ID of the billing profile to which the product is billed.",
           "type": "string",
           "readOnly": true
         },
         "billingProfileDisplayName": {
-          "description": "Billing Profile display name to which this product belongs.",
+          "description": "The name of the billing profile to which the product is billed.",
           "type": "string",
           "readOnly": true
         },
         "customerId": {
-          "description": "Customer id to which this product belongs.",
+          "description": "The ID of the customer for whom the product was purchased. The field is applicable only for Microsoft Partner Agreement billing account.",
           "type": "string",
           "readOnly": true
         },
         "customerDisplayName": {
-          "description": "Display name of customer to which this product belongs.",
+          "description": "The name of the customer for whom the product was purchased. The field is applicable only for Microsoft Partner Agreement billing account.",
           "type": "string",
           "readOnly": true
         },
@@ -6653,7 +6653,7 @@
       }
     },
     "BillingSubscriptionsListResult": {
-      "description": "Result of listing billing subscriptions.",
+      "description": "The list of billing subscriptions.",
       "properties": {
         "value": {
           "description": "The list of billing subscriptions.",
@@ -6671,7 +6671,7 @@
       }
     },
     "BillingSubscription": {
-      "description": "A billing Subscription resource.",
+      "description": "A billing subscription.",
       "type": "object",
       "allOf": [
         {
@@ -6687,21 +6687,21 @@
       }
     },
     "BillingSubscriptionProperties": {
-      "description": "The usage context properties.",
+      "description": "The billing properties of a subscription.",
       "properties": {
         "displayName": {
-          "description": "display name.",
+          "description": "The name of the subscription.",
           "type": "string",
           "readOnly": true
         },
         "subscriptionId": {
-          "description": "Subscription Id.",
+          "description": "The ID of the subscription.",
           "type": "string",
           "format": "uuid",
           "readOnly": true
         },
         "subscriptionBillingStatus": {
-          "description": "Subscription billing status.",
+          "description": "The current billing status of the subscription.",
           "type": "string",
           "enum": [
             "Active",
@@ -6716,42 +6716,42 @@
           }
         },
         "lastMonthCharges": {
-          "description": "Last month charges.",
+          "description": "The last month charges.",
           "readOnly": true,
           "$ref": "#/definitions/Amount"
         },
         "monthToDateCharges": {
-          "description": "Month to date charges.",
+          "description": "The current month to date charges.",
           "readOnly": true,
           "$ref": "#/definitions/Amount"
         },
         "billingProfileId": {
-          "description": "Billing Profile id to which this product belongs.",
+          "description": "The ID of the billing profile to which the subscription is billed.",
           "type": "string",
           "readOnly": true
         },
         "billingProfileDisplayName": {
-          "description": "Billing Profile display name to which this product belongs.",
+          "description": "The name of the billing profile to which the subscription is billed.",
           "type": "string",
           "readOnly": true
         },
         "customerId": {
-          "description": "Customer id to which this product belongs.",
+          "description": "The ID of the customer for whom the subscription was created. The field is applicable only for Microsoft Partner Agreement billing account.",
           "type": "string",
           "readOnly": true
         },
         "customerDisplayName": {
-          "description": "Display name of customer to which this product belongs.",
+          "description": "The name of the customer for whom the subscription was created. The field is applicable only for Microsoft Partner Agreement billing account.",
           "type": "string",
           "readOnly": true
         },
         "invoiceSectionId": {
-          "description": "Invoice section id to which this product belongs.",
+          "description": "The ID of the invoice section to which the subscription is billed.",
           "type": "string",
           "readOnly": true
         },
         "invoiceSectionDisplayName": {
-          "description": "Invoice section display name to which this product belongs.",
+          "description": "The name of the invoice section to which the subscription is billed.",
           "type": "string",
           "readOnly": true
         },
@@ -6761,44 +6761,44 @@
           "$ref": "#/definitions/Reseller"
         },
         "skuId": {
-          "description": "The sku id.",
+          "description": "The sku ID of the Azure plan for the subscription.",
           "type": "string"
         },
         "skuDescription": {
-          "description": "The sku description.",
+          "description": "The sku description of the Azure plan for the subscription.",
           "type": "string",
           "readOnly": true
         }
       }
     },
     "EnrollmentAccountContext": {
-      "description": "The rating context.",
+      "description": "The enrollment account context",
       "properties": {
         "costCenter": {
-          "description": "The cost center name.",
+          "description": "The cost center associated with the enrollment account.",
           "type": "string"
         },
         "startDate": {
-          "description": "Account Start Date",
+          "description": "The start date of the enrollment account.",
           "type": "string",
           "format": "date-time"
         },
         "endDate": {
-          "description": "Account End Date",
+          "description": "The end date of the enrollment account.",
           "type": "string",
           "format": "date-time"
         },
         "enrollmentAccountName": {
-          "description": "The enrollment account id.",
+          "description": "The ID of the enrollment account.",
           "type": "string"
         }
       }
     },
     "TransactionListResult": {
-      "description": "Result of listing reservation transactions.",
+      "description": "The list of transactions.",
       "properties": {
         "value": {
-          "description": "The list of reservation transactions.",
+          "description": "The list of transactions.",
           "type": "array",
           "readOnly": true,
           "items": {
@@ -6813,7 +6813,7 @@
       }
     },
     "Transaction": {
-      "description": "A reservation transaction resource.",
+      "description": "A transaction.",
       "type": "object",
       "allOf": [
         {
@@ -6824,16 +6824,16 @@
         "properties": {
           "x-ms-client-flatten": true,
           "$ref": "#/definitions/TransactionProperties",
-          "title": "Reservation transaction properties"
+          "title": "Transaction properties"
         }
       }
     },
     "TransactionProperties": {
-      "description": "The properties of the reservation transaction.",
+      "description": "The properties of a transaction.",
       "properties": {
         "kind": {
           "type": "string",
-          "description": "The kind of transaction. Choices are all and reservation.",
+          "description": "The kind of transaction. Options are all or reservation.",
           "enum": [
             "all",
             "reservation"
@@ -6844,48 +6844,48 @@
           }
         },
         "date": {
-          "description": "The date of reservation transaction.",
+          "description": "The date of transaction.",
           "type": "string",
           "format": "date-time",
           "readOnly": true
         },
         "invoice": {
-          "description": "Invoice number or 'pending' if not invoiced.",
+          "description": "Invoice on which the transaction was billed or 'pending' if the transaction is not billed.",
           "type": "string",
           "readOnly": true
         },
         "orderId": {
-          "description": "The reservation order id.",
+          "description": "The order ID of the reservation. The field is only applicable for transaction of kind reservation.",
           "type": "string",
           "readOnly": true
         },
         "orderName": {
-          "description": "The reservation order name.",
+          "description": "The name of the reservation order. The field is only applicable for transactions of kind reservation.",
           "type": "string",
           "readOnly": true
         },
         "productFamily": {
-          "description": "The product family.",
+          "description": "The family of the product for which the transaction took place.",
           "type": "string",
           "readOnly": true
         },
         "productTypeId": {
-          "description": "The product type id.",
+          "description": "The ID of the product type for which the transaction took place.",
           "type": "string",
           "readOnly": true
         },
         "productType": {
-          "description": "The type of product.",
+          "description": "The type of the product for which the transaction took place.",
           "type": "string",
           "readOnly": true
         },
         "productDescription": {
-          "description": "Product description.",
+          "description": "The description of the product for which the transaction took place.",
           "type": "string",
           "readOnly": true
         },
         "transactionType": {
-          "description": "Transaction types.",
+          "description": "The type of transaction.",
           "type": "string",
           "enum": [
             "Purchase",
@@ -6897,52 +6897,52 @@
           }
         },
         "transactionAmount": {
-          "description": "Last charge associated with the purchase.",
+          "description": "The charge associated with the transaction.",
           "readOnly": true,
           "$ref": "#/definitions/Amount"
         },
         "quantity": {
-          "description": "Purchase quantity.",
+          "description": "The quantity purchased in the transaction.",
           "type": "integer",
           "readOnly": true
         },
         "invoiceSectionId": {
-          "description": "Invoice section id to which this product belongs.",
+          "description": "The ID of the invoice section which will be billed for the transaction.",
           "type": "string",
           "readOnly": true
         },
         "invoiceSectionDisplayName": {
-          "description": "Invoice section display name to which this product belongs.",
+          "description": "The name of the invoice section which will be billed for the transaction.",
           "type": "string",
           "readOnly": true
         },
         "billingProfileId": {
-          "description": "Billing Profile id to which this product belongs.",
+          "description": "The ID of the billing profile which will be billed for the transaction.",
           "type": "string",
           "readOnly": true
         },
         "billingProfileDisplayName": {
-          "description": "Billing Profile display name to which this product belongs.",
+          "description": "The name of the billing profile which will be billed for the transaction.",
           "type": "string",
           "readOnly": true
         },
         "customerId": {
-          "description": "Customer id to which this product belongs.",
+          "description": "The ID of the customer for which the transaction took place. The field is applicable only for Microsoft Partner Agreement billing account.",
           "type": "string",
           "readOnly": true
         },
         "customerDisplayName": {
-          "description": "Display name of customer to which this product belongs.",
+          "description": "The name of the customer for which the transaction took place. The field is applicable only for Microsoft Partner Agreement billing account.",
           "type": "string",
           "readOnly": true
         },
         "subscriptionId": {
-          "description": "The subscription id.",
+          "description": "The ID of the subscription that was used for the transaction. The field is only applicable for transaction of kind reservation.",
           "type": "string",
           "readOnly": true
         },
         "subscriptionName": {
-          "description": "The subscription name.",
+          "description": "The name of the subscription that was used for the transaction. The field is only applicable for transaction of kind reservation.",
           "type": "string",
           "readOnly": true
         },
@@ -7021,7 +7021,7 @@
       }
     },
     "Policy": {
-      "description": "The Policy.",
+      "description": "A policy.",
       "type": "object",
       "allOf": [
         {
@@ -7037,10 +7037,10 @@
       }
     },
     "PolicyProperties": {
-      "description": "The properties of policy.",
+      "description": "The properties of a policy.",
       "properties": {
         "marketplacePurchases": {
-          "description": "The marketplace purchases are free, allowed or not allowed.",
+          "description": "The policy that controls whether Azure marketplace purchases are allowed for a billing profile.",
           "type": "string",
           "enum": [
             "AllAllowed",
@@ -7053,7 +7053,7 @@
           }
         },
         "reservationPurchases": {
-          "description": "The reservation purchases allowed or not.",
+          "description": "The policy that controls whether Azure reservation purchases are allowed for a billing profile.",
           "type": "string",
           "enum": [
             "Allowed",
@@ -7065,7 +7065,7 @@
           }
         },
         "viewCharges": {
-          "description": "Who can view charges.",
+          "description": "The policy that controls whether users with Azure RBAC access to a subscription can view its charges.",
           "type": "string",
           "enum": [
             "Allowed",
@@ -7079,7 +7079,7 @@
       }
     },
     "CustomerPolicy": {
-      "description": "The Customer's Policy.",
+      "description": "The customer's Policy.",
       "type": "object",
       "allOf": [
         {
@@ -7095,10 +7095,10 @@
       }
     },
     "CustomerPolicyProperties": {
-      "description": "The properties of a Customer's policy.",
+      "description": "The properties of a customer's policy.",
       "properties": {
         "viewCharges": {
-          "description": "Customer can view retail prices.",
+          "description": "The policy that controls whether the users in customer's organization can view charges at pay-as-you-go prices.",
           "type": "string",
           "enum": [
             "Allowed",
@@ -7112,7 +7112,7 @@
       }
     },
     "AvailableBalance": {
-      "description": "Latest available balance on Monetary Credit PI.",
+      "description": "The latest Azure credit balance. This is the balance available for pay now.",
       "type": "object",
       "allOf": [
         {
@@ -7131,14 +7131,14 @@
       "description": "The properties of available balance.",
       "properties": {
         "amount": {
-          "description": "Balance Amount.",
+          "description": "Balance amount.",
           "readOnly": true,
           "$ref": "#/definitions/Amount"
         }
       }
     },
     "Amount": {
-      "description": "The Amount.",
+      "description": "The amount.",
       "properties": {
         "currency": {
           "description": "The currency for the amount value.",
@@ -7152,7 +7152,7 @@
       }
     },
     "PaymentMethodsListResult": {
-      "description": "Result of listing payment methods.",
+      "description": "The list of payment methods.",
       "properties": {
         "value": {
           "description": "The list of payment methods.",
@@ -7170,7 +7170,7 @@
       }
     },
     "PaymentMethod": {
-      "description": "A payment method resource.",
+      "description": "A payment method.",
       "type": "object",
       "allOf": [
         {
@@ -7186,10 +7186,10 @@
       }
     },
     "PaymentMethodProperties": {
-      "description": "The properties of the payment method.",
+      "description": "The properties of a payment method.",
       "properties": {
         "paymentMethodType": {
-          "description": "Payment method type.",
+          "description": "The type of payment method.",
           "type": "string",
           "enum": [
             "Credits",
@@ -7219,10 +7219,10 @@
     },
     "UpdateAutoRenewRequest": {
       "type": "object",
-      "description": "Request parameters to update auto renew for support product.",
+      "description": "Request parameters to update auto renew settings for a product.",
       "properties": {
         "autoRenew": {
-          "description": "Request parameters to update auto renew policy a product.",
+          "description": "The flag that determines the auto-renew settings for a product.",
           "type": "string",
           "enum": [
             "true",
@@ -7253,12 +7253,12 @@
               "readOnly": true
             },
             "resource": {
-              "description": "Resource on which the operation is performed: Invoice, etc.",
+              "description": "Resource on which the operation is performed such as invoice and billing subscription.",
               "type": "string",
               "readOnly": true
             },
             "operation": {
-              "description": "Operation type: Read, write, delete, etc.",
+              "description": "Operation type such as read, write and delete.",
               "type": "string",
               "readOnly": true
             }
@@ -7267,10 +7267,10 @@
       }
     },
     "OperationListResult": {
-      "description": "Result listing billing operations. It contains a list of operations and a URL link to get the next set of results.",
+      "description": "The list of billing operations and a URL link to get the next set of results.",
       "properties": {
         "value": {
-          "description": "List of billing operations supported by the Microsoft.Billing resource provider.",
+          "description": "The list of billing operations supported by the Microsoft.Billing resource provider.",
           "type": "array",
           "readOnly": true,
           "items": {
@@ -7298,10 +7298,10 @@
       }
     },
     "BillingRoleAssignmentListResult": {
-      "description": "Result of get list of role assignments",
+      "description": "The list of role assignments.",
       "properties": {
         "value": {
-          "description": "The list role assignments",
+          "description": "The list of role assignments.",
           "type": "array",
           "readOnly": true,
           "items": {
@@ -7311,7 +7311,7 @@
       }
     },
     "BillingRoleAssignment": {
-      "description": "a role assignment",
+      "description": "The role assignment",
       "type": "object",
       "allOf": [
         {
@@ -7320,57 +7320,57 @@
       ],
       "properties": {
         "properties": {
-          "description": "The role assignment the caller has",
+          "description": "The properties of the role assignment.",
           "x-ms-client-flatten": true,
           "$ref": "#/definitions/BillingRoleAssignmentProperties"
         }
       }
     },
     "BillingRoleAssignmentProperties": {
-      "description": "The properties of the a role assignment.",
+      "description": "The properties of the role assignment.",
       "properties": {
         "createdOn": {
-          "description": "the date the role assignment is created",
+          "description": "The date the role assignment was created.",
           "type": "string",
           "readOnly": true
         },
         "createdByPrincipalTenantId": {
-          "description": "the creator's tenant Id",
+          "description": "The tenant Id of the user who created the role assignment.",
           "type": "string",
           "readOnly": true
         },
         "createdByPrincipalId": {
-          "description": "the creator's principal Id",
+          "description": "The principal Id of the user who created the role assignment.",
           "type": "string",
           "readOnly": true
         },
         "name": {
-          "description": "the name of the role assignment",
+          "description": "The name of the role assignment.",
           "type": "string",
           "readOnly": true
         },
         "principalId": {
-          "description": "The user's principal id that the role gets assigned to",
+          "description": "The principal id of the user to whom the role was assigned.",
           "type": "string",
           "readOnly": true
         },
         "roleDefinitionName": {
-          "description": "The role definition id",
+          "description": "The ID of the role definition.",
           "type": "string",
           "readOnly": true
         },
         "scope": {
-          "description": "The scope the role get assigned to",
+          "description": "The scope at which the role was assigned.",
           "type": "string",
           "readOnly": true
         }
       }
     },
     "BillingRoleDefinitionListResult": {
-      "description": "list the role definitions.",
+      "description": "The list of role definitions.",
       "properties": {
         "value": {
-          "description": "The list of role definitions.",
+          "description": "The role definitions.",
           "type": "array",
           "readOnly": true,
           "items": {
@@ -7380,7 +7380,7 @@
       }
     },
     "BillingRoleDefinition": {
-      "description": "Result of get role definition for a role.",
+      "description": "The properties of a role definition.",
       "type": "object",
       "allOf": [
         {
@@ -7389,7 +7389,7 @@
       ],
       "properties": {
         "properties": {
-          "description": "The role definition for a role.",
+          "description": "The properties of the a role definition.",
           "x-ms-client-flatten": true,
           "$ref": "#/definitions/BillingRoleDefinitionProperties"
         }
@@ -7435,7 +7435,7 @@
       "type": "object",
       "properties": {
         "actions": {
-          "description": "The set of actions that the caller is allowed to do",
+          "description": "The set of actions that the caller is allowed to perform.",
           "type": "array",
           "readOnly": true,
           "items": {
@@ -7443,7 +7443,7 @@
           }
         },
         "notActions": {
-          "description": "The set of actions the caller is not allowed to do",
+          "description": "The set of actions that the caller is not allowed to perform.",
           "type": "array",
           "readOnly": true,
           "items": {
@@ -7471,7 +7471,7 @@
       }
     },
     "Agreement": {
-      "description": "An agreement resource.",
+      "description": "An agreement.",
       "type": "object",
       "allOf": [
         {
@@ -7480,23 +7480,23 @@
       ],
       "properties": {
         "properties": {
-          "description": "An agreement.",
+          "description": "The properties of an agreement.",
           "x-ms-client-flatten": true,
           "$ref": "#/definitions/AgreementProperties"
         }
       }
     },
     "AgreementProperties": {
-      "description": "The properties of the agreement.",
+      "description": "The properties of an agreement.",
       "properties": {
         "agreementLink": {
-          "description": "The link to the agreement.",
+          "description": "The URL to download the agreement.",
           "type": "string",
           "readOnly": true
         },
         "category": {
           "type": "string",
-          "description": "Category of the agreement signed by customer.",
+          "description": "The category of the agreement signed by a customer.",
           "readOnly": true,
           "enum": [
             "MicrosoftCustomerAgreement",
@@ -7523,26 +7523,26 @@
           }
         },
         "effectiveDate": {
-          "description": "Effective date.",
+          "description": "The date from which the agreement is effective.",
           "type": "string",
           "format": "date-time",
           "readOnly": true
         },
         "expirationDate": {
-          "description": "Expiration date.",
+          "description": "The date when the agreement expires.",
           "type": "string",
           "format": "date-time",
           "readOnly": true
         },
         "participants": {
-          "description": "Participants or signer of the agreement.",
+          "description": "The list of participants that participates in acceptance of an agreement.",
           "type": "array",
           "items": {
             "$ref": "#/definitions/Participants"
           }
         },
         "status": {
-          "description": "The agreement status",
+          "description": "The current status of the agreement.",
           "type": "string",
           "readOnly": true
         }
@@ -7566,7 +7566,7 @@
       "description": "Transfer validation response.",
       "properties": {
         "properties": {
-          "description": "Transfer validation response properties.",
+          "description": "The properties of transfer validation response.",
           "x-ms-client-flatten": true,
           "$ref": "#/definitions/ValidateTransferResponseProperties"
         }
@@ -7574,7 +7574,7 @@
     },
     "ValidateTransferResponseProperties": {
       "type": "object",
-      "description": "Properties of transfer validation response.",
+      "description": "The properties of transfer validation response.",
       "properties": {
         "status": {
           "description": "The status of validation",
@@ -7587,7 +7587,7 @@
           "readOnly": true
         },
         "results": {
-          "description": "Array of validation results.",
+          "description": "The array of validation results.",
           "type": "array",
           "items": {
             "$ref": "#/definitions/ValidationResultProperties"
@@ -7616,33 +7616,33 @@
       }
     },
     "Participants": {
-      "description": "Details about the participant or signer.",
+      "description": "The details about a participant.",
       "properties": {
         "status": {
-          "description": "The signing status",
+          "description": "The acceptance status of the participant.",
           "type": "string",
           "readOnly": true
         },
         "statusDate": {
-          "description": "The date when status got changed.",
+          "description": "The date when the status got changed.",
           "type": "string",
           "format": "date-time",
           "readOnly": true
         },
         "email": {
-          "description": "The email address of the participant or signer.",
+          "description": "The email address of the participant.",
           "type": "string",
           "readOnly": true
         }
       }
     },
     "Action": {
-      "description": "the action the caller allowed to do",
+      "description": "The action the caller is allowed to perform.",
       "type": "string",
       "readOnly": true
     },
     "NotAction": {
-      "description": "the action the caller doesn't allowed to do",
+      "description": "The set of actions that the caller is not allowed to perform.",
       "type": "string",
       "readOnly": true
     }
@@ -7653,19 +7653,19 @@
       "in": "query",
       "required": true,
       "type": "string",
-      "description": "Version of the API to be used with the client request. The current version is 2019-10-01-preview."
+      "description": "The version of the API to be used with the client request. The current version is 2019-10-01-preview."
     },
     "subscriptionIdParameter": {
       "name": "subscriptionId",
       "in": "path",
-      "description": "Azure Subscription ID.",
+      "description": "The ID that uniquely identifies an Azure subscription.",
       "required": true,
       "type": "string"
     },
     "billingAccountNameParameter": {
       "name": "billingAccountName",
       "in": "path",
-      "description": "billing Account Id.",
+      "description": "The ID that uniquely identifies a billing account.",
       "required": true,
       "type": "string",
       "x-ms-parameter-location": "method"
@@ -7673,7 +7673,7 @@
     "invoiceSectionNameParameter": {
       "name": "invoiceSectionName",
       "in": "path",
-      "description": "InvoiceSection Id.",
+      "description": "The ID that uniquely identifies an invoice section.",
       "required": true,
       "type": "string",
       "x-ms-parameter-location": "method"
@@ -7681,7 +7681,7 @@
     "enrollmentAccountNameParameter": {
       "name": "enrollmentAccountName",
       "in": "path",
-      "description": "Enrollment Account Id.",
+      "description": "The ID that uniquely identifies an enrollment account.",
       "required": true,
       "type": "string",
       "x-ms-parameter-location": "method"
@@ -7689,7 +7689,7 @@
     "departmentNameParameter": {
       "name": "departmentName",
       "in": "path",
-      "description": "Department Id.",
+      "description": "The ID that uniquely identifies a department.",
       "required": true,
       "type": "string",
       "x-ms-parameter-location": "method"
@@ -7705,7 +7705,7 @@
     "billingProfileNameParameter": {
       "name": "billingProfileName",
       "in": "path",
-      "description": "Billing Profile Id.",
+      "description": "The ID that uniquely identifies a billing profile.",
       "required": true,
       "type": "string",
       "x-ms-parameter-location": "method"
@@ -7721,7 +7721,7 @@
     "billingRoleDefinitionNameParameter": {
       "name": "billingRoleDefinitionName",
       "in": "path",
-      "description": "role definition id.",
+      "description": "The ID that uniquely identifies a role definition.",
       "required": true,
       "type": "string",
       "x-ms-parameter-location": "method"
@@ -7729,7 +7729,7 @@
     "billingRoleAssignmentNameParameter": {
       "name": "billingRoleAssignmentName",
       "in": "path",
-      "description": "role assignment id.",
+      "description": "The ID that uniquely identifies a role assignment.",
       "required": true,
       "type": "string",
       "x-ms-parameter-location": "method"
@@ -7737,7 +7737,7 @@
     "invoiceNameParameter": {
       "name": "invoiceName",
       "in": "path",
-      "description": "Invoice Id.",
+      "description": "The ID that uniquely identifies an invoice.",
       "required": true,
       "type": "string",
       "x-ms-parameter-location": "method"
@@ -7745,7 +7745,7 @@
     "productNameParameter": {
       "name": "productName",
       "in": "path",
-      "description": "Invoice Id.",
+      "description": "The ID that uniquely identifies a product.",
       "required": true,
       "type": "string",
       "x-ms-parameter-location": "method"
@@ -7753,7 +7753,7 @@
     "billingSubscriptionNameParameter": {
       "name": "billingSubscriptionName",
       "in": "path",
-      "description": "Billing Subscription Id.",
+      "description": "The ID that uniquely identifies a subscription.",
       "required": true,
       "type": "string",
       "x-ms-parameter-location": "method"
@@ -7764,12 +7764,12 @@
       "in": "path",
       "required": true,
       "type": "string",
-      "description": "Transfer Name."
+      "description": "The ID that uniquely identifies a transfer request."
     },
     "agreementNameParameter": {
       "name": "agreementName",
       "in": "path",
-      "description": "Agreement Id.",
+      "description": "The ID that uniquely identifies an agreement.",
       "required": true,
       "type": "string",
       "x-ms-parameter-location": "method"
@@ -7777,7 +7777,7 @@
     "transactionNameParameter": {
       "name": "transactionName",
       "in": "path",
-      "description": "Transaction name.",
+      "description": "The ID that uniquely identifies a transaction.",
       "required": true,
       "type": "string",
       "x-ms-parameter-location": "method"
@@ -7787,7 +7787,7 @@
       "x-ms-parameter-location": "method",
       "in": "body",
       "required": true,
-      "description": "Update auto renew request parameters.",
+      "description": "Request parameters that are provided to the update auto renew operation.",
       "schema": {
         "$ref": "#/definitions/UpdateAutoRenewRequest"
       }
@@ -7795,7 +7795,7 @@
     "customerNameParameter": {
       "name": "customerName",
       "in": "path",
-      "description": "Customer name.",
+      "description": "The ID that uniquely identifies a customer.",
       "required": true,
       "type": "string",
       "x-ms-parameter-location": "method"
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/preview/2019-06-15-preview/cdnwebapplicationfirewall.json b/specification/cdn/resource-manager/Microsoft.Cdn/preview/2019-06-15-preview/cdnwebapplicationfirewall.json
index a00cb37d490d..350a0ed69090 100644
--- a/specification/cdn/resource-manager/Microsoft.Cdn/preview/2019-06-15-preview/cdnwebapplicationfirewall.json
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/preview/2019-06-15-preview/cdnwebapplicationfirewall.json
@@ -463,10 +463,13 @@
         "defaultCustomBlockResponseStatusCode": {
           "description": "If the action type is block, this field defines the default customer overridable http response status code.",
           "type": "integer",
-          "maximum": 599,
-          "exclusiveMaximum": false,
-          "minimum": 200,
-          "exclusiveMinimum": false
+          "enum": [
+            200,
+            403,
+            405,
+            406,
+            429
+          ]
         },
         "defaultCustomBlockResponseBody": {
           "description": "If the action type is block, customer can override the response body. The body must be specified in base64 encoding.",
@@ -599,7 +602,7 @@
           "type": "string",
           "enum": [
             "RemoteAddr",
-            "Country",
+            "SocketAddr",
             "RequestMethod",
             "RequestHeader",
             "RequestUri",
@@ -614,7 +617,7 @@
           }
         },
         "selector": {
-          "description": "Selector can used to match a specific key for QueryString, RequestUri, RequestHeaders or RequestBody.",
+          "description": "Selector can used to match a specific key for QueryString, Cookies, RequestHeader or PostArgs.",
           "type": "string"
         },
         "operator": {
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/preview/2019-06-15-preview/examples/WafListPolicies.json b/specification/cdn/resource-manager/Microsoft.Cdn/preview/2019-06-15-preview/examples/WafListPolicies.json
index 6b5c2b894cd2..f1731a643beb 100644
--- a/specification/cdn/resource-manager/Microsoft.Cdn/preview/2019-06-15-preview/examples/WafListPolicies.json
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/preview/2019-06-15-preview/examples/WafListPolicies.json
@@ -27,7 +27,7 @@
                 "enabledState": "Enabled",
                 "mode": "Prevention",
                 "defaultRedirectUrl": "http://www.bing.com",
-                "defaultCustomBlockResponseStatusCode": 499,
+                "defaultCustomBlockResponseStatusCode": 429,
                 "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
               },
               "rateLimitRules": {
@@ -154,7 +154,7 @@
                 "enabledState": "Enabled",
                 "mode": "Prevention",
                 "defaultRedirectUrl": "http://www.bing.com",
-                "defaultCustomBlockResponseStatusCode": 499,
+                "defaultCustomBlockResponseStatusCode": 429,
                 "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
               },
               "rateLimitRules": {
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/preview/2019-06-15-preview/examples/WafPatchPolicy.json b/specification/cdn/resource-manager/Microsoft.Cdn/preview/2019-06-15-preview/examples/WafPatchPolicy.json
index f2511b72fd82..5abe9d3f2477 100644
--- a/specification/cdn/resource-manager/Microsoft.Cdn/preview/2019-06-15-preview/examples/WafPatchPolicy.json
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/preview/2019-06-15-preview/examples/WafPatchPolicy.json
@@ -30,7 +30,7 @@
             "enabledState": "Enabled",
             "mode": "Prevention",
             "defaultRedirectUrl": "http://www.bing.com",
-            "defaultCustomBlockResponseStatusCode": 499,
+            "defaultCustomBlockResponseStatusCode": 403,
             "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
           },
           "rateLimitRules": {
@@ -159,7 +159,7 @@
             "enabledState": "Enabled",
             "mode": "Prevention",
             "defaultRedirectUrl": "http://www.bing.com",
-            "defaultCustomBlockResponseStatusCode": 499,
+            "defaultCustomBlockResponseStatusCode": 403,
             "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
           },
           "rateLimitRules": {
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/preview/2019-06-15-preview/examples/WafPolicyCreateOrUpdate.json b/specification/cdn/resource-manager/Microsoft.Cdn/preview/2019-06-15-preview/examples/WafPolicyCreateOrUpdate.json
index 3ce2f5a82cac..58e9a8e5629c 100644
--- a/specification/cdn/resource-manager/Microsoft.Cdn/preview/2019-06-15-preview/examples/WafPolicyCreateOrUpdate.json
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/preview/2019-06-15-preview/examples/WafPolicyCreateOrUpdate.json
@@ -12,7 +12,7 @@
       "properties": {
         "policySettings": {
           "defaultRedirectUrl": "http://www.bing.com",
-          "defaultCustomBlockResponseStatusCode": 499,
+          "defaultCustomBlockResponseStatusCode": 200,
           "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
         },
         "rateLimitRules": {
@@ -134,7 +134,7 @@
             "enabledState": "Enabled",
             "mode": "Prevention",
             "defaultRedirectUrl": "http://www.bing.com",
-            "defaultCustomBlockResponseStatusCode": 499,
+            "defaultCustomBlockResponseStatusCode": 200,
             "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
           },
           "rateLimitRules": {
@@ -263,7 +263,7 @@
             "enabledState": "Enabled",
             "mode": "Prevention",
             "defaultRedirectUrl": "http://www.bing.com",
-            "defaultCustomBlockResponseStatusCode": 499,
+            "defaultCustomBlockResponseStatusCode": 200,
             "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
           },
           "rateLimitRules": {
@@ -392,7 +392,7 @@
             "enabledState": "Enabled",
             "mode": "Prevention",
             "defaultRedirectUrl": "http://www.bing.com",
-            "defaultCustomBlockResponseStatusCode": 499,
+            "defaultCustomBlockResponseStatusCode": 200,
             "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
           },
           "rateLimitRules": {
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/preview/2019-06-15-preview/examples/WafPolicyGet.json b/specification/cdn/resource-manager/Microsoft.Cdn/preview/2019-06-15-preview/examples/WafPolicyGet.json
index 3cfd8e73d78c..c168c9bb43af 100644
--- a/specification/cdn/resource-manager/Microsoft.Cdn/preview/2019-06-15-preview/examples/WafPolicyGet.json
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/preview/2019-06-15-preview/examples/WafPolicyGet.json
@@ -26,7 +26,7 @@
             "enabledState": "Enabled",
             "mode": "Prevention",
             "defaultRedirectUrl": "http://www.bing.com",
-            "defaultCustomBlockResponseStatusCode": 499,
+            "defaultCustomBlockResponseStatusCode": 429,
             "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
           },
           "rateLimitRules": {
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/cdn.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/cdn.json
new file mode 100644
index 000000000000..e2b319a2e9d7
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/cdn.json
@@ -0,0 +1,4605 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "version": "2019-06-15",
+    "title": "CdnManagementClient",
+    "description": "Use these APIs to manage Azure CDN resources through the Azure Resource Manager. You must make sure that requests made to these resources are secure."
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Cdn/profiles": {
+      "get": {
+        "tags": [
+          "Profiles"
+        ],
+        "description": "Lists all of the CDN profiles within an Azure subscription.",
+        "operationId": "Profiles_List",
+        "x-ms-examples": {
+          "Profiles_List": {
+            "$ref": "./examples/Profiles_List.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/ProfileListResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles": {
+      "get": {
+        "tags": [
+          "Profiles"
+        ],
+        "description": "Lists all of the CDN profiles within a resource group.",
+        "operationId": "Profiles_ListByResourceGroup",
+        "x-ms-examples": {
+          "Profiles_ListByResourceGroup": {
+            "$ref": "./examples/Profiles_ListByResourceGroup.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/ProfileListResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}": {
+      "get": {
+        "tags": [
+          "Profiles"
+        ],
+        "description": "Gets a CDN profile with the specified profile name under the specified subscription and resource group.",
+        "operationId": "Profiles_Get",
+        "x-ms-examples": {
+          "Profiles_Get": {
+            "$ref": "./examples/Profiles_Get.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/Profile"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Profiles"
+        ],
+        "description": "Creates a new CDN profile with a profile name under the specified subscription and resource group.",
+        "operationId": "Profiles_Create",
+        "x-ms-examples": {
+          "Profiles_Create": {
+            "$ref": "./examples/Profiles_Create.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "description": "Profile properties needed to create a new profile.",
+            "in": "body",
+            "name": "profile",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/Profile"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/Profile"
+            }
+          },
+          "201": {
+            "description": "Created. The request has been fulfilled and a new profile has been created.",
+            "schema": {
+              "$ref": "#/definitions/Profile"
+            }
+          },
+          "202": {
+            "description": "Accepted. The request has been accepted for processing and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/Profile"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "patch": {
+        "tags": [
+          "Profiles"
+        ],
+        "description": "Updates an existing CDN profile with the specified profile name under the specified subscription and resource group.",
+        "operationId": "Profiles_Update",
+        "x-ms-examples": {
+          "Profiles_Update": {
+            "$ref": "./examples/Profiles_Update.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "profileUpdateParameters",
+            "in": "body",
+            "description": "Profile properties needed to update an existing profile.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ProfileUpdateParameters"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/Profile"
+            }
+          },
+          "202": {
+            "description": "Accepted. The request has been accepted for processing and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/Profile"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "delete": {
+        "tags": [
+          "Profiles"
+        ],
+        "description": "Deletes an existing CDN profile with the specified parameters. Deleting a profile will result in the deletion of all of the sub-resources including endpoints, origins and custom domains.",
+        "operationId": "Profiles_Delete",
+        "x-ms-examples": {
+          "Profiles_Delete": {
+            "$ref": "./examples/Profiles_Delete.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Accepted. The request has been accepted for processing and the operation will complete asynchronously."
+          },
+          "204": {
+            "description": "No Content. The request has been accepted but the profile was not found."
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/generateSsoUri": {
+      "post": {
+        "tags": [
+          "Profiles"
+        ],
+        "description": "Generates a dynamic SSO URI used to sign in to the CDN supplemental portal. Supplemental portal is used to configure advanced feature capabilities that are not yet available in the Azure portal, such as core reports in a standard profile; rules engine, advanced HTTP reports, and real-time stats and alerts in a premium profile. The SSO URI changes approximately every 10 minutes.",
+        "operationId": "Profiles_GenerateSsoUri",
+        "x-ms-examples": {
+          "Profiles_GenerateSsoUri": {
+            "$ref": "./examples/Profiles_GenerateSsoUri.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/SsoUri"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/getSupportedOptimizationTypes": {
+      "post": {
+        "tags": [
+          "Profiles"
+        ],
+        "description": "Gets the supported optimization types for the current profile. A user can create an endpoint with an optimization type from the listed values.",
+        "operationId": "Profiles_ListSupportedOptimizationTypes",
+        "x-ms-examples": {
+          "Profiles_ListSupportedOptimizationTypes": {
+            "$ref": "./examples/Profiles_ListSupportedOptimizationTypes.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/SupportedOptimizationTypesListResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/checkResourceUsage": {
+      "post": {
+        "tags": [
+          "Profiles"
+        ],
+        "description": "Checks the quota and actual usage of endpoints under the given CDN profile.",
+        "operationId": "Profiles_ListResourceUsage",
+        "x-ms-examples": {
+          "Profiles_ListResourceUsage": {
+            "$ref": "./examples/Profiles_ListResourceUsage.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/ResourceUsageListResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints": {
+      "get": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Lists existing CDN endpoints.",
+        "operationId": "Endpoints_ListByProfile",
+        "x-ms-examples": {
+          "Endpoints_ListByProfile": {
+            "$ref": "./examples/Endpoints_ListByProfile.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/EndpointListResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}": {
+      "get": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Gets an existing CDN endpoint with the specified endpoint name under the specified subscription, resource group and profile.",
+        "operationId": "Endpoints_Get",
+        "x-ms-examples": {
+          "Endpoints_Get": {
+            "$ref": "./examples/Endpoints_Get.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Creates a new CDN endpoint with the specified endpoint name under the specified subscription, resource group and profile.",
+        "operationId": "Endpoints_Create",
+        "x-ms-examples": {
+          "Endpoints_Create": {
+            "$ref": "./examples/Endpoints_Create.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpoint",
+            "in": "body",
+            "description": "Endpoint properties",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          "201": {
+            "description": "Created. The request has been fulfilled and a new endpoint has been created.",
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "patch": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Updates an existing CDN endpoint with the specified endpoint name under the specified subscription, resource group and profile. Only tags and Origin HostHeader can be updated after creating an endpoint. To update origins, use the Update Origin operation. To update custom domains, use the Update Custom Domain operation.",
+        "operationId": "Endpoints_Update",
+        "x-ms-examples": {
+          "Endpoints_Update": {
+            "$ref": "./examples/Endpoints_Update.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointUpdateProperties",
+            "in": "body",
+            "description": "Endpoint update properties",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/EndpointUpdateParameters"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously",
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "delete": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Deletes an existing CDN endpoint with the specified endpoint name under the specified subscription, resource group and profile.",
+        "operationId": "Endpoints_Delete",
+        "x-ms-examples": {
+          "Endpoints_Delete": {
+            "$ref": "./examples/Endpoints_Delete.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously."
+          },
+          "204": {
+            "description": "No Content. The request has been accepted but the endpoint was not found."
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/start": {
+      "post": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Starts an existing CDN endpoint that is on a stopped state.",
+        "operationId": "Endpoints_Start",
+        "x-ms-examples": {
+          "Endpoints_Start": {
+            "$ref": "./examples/Endpoints_Start.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/stop": {
+      "post": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Stops an existing running CDN endpoint.",
+        "operationId": "Endpoints_Stop",
+        "x-ms-examples": {
+          "Endpoints_Stop": {
+            "$ref": "./examples/Endpoints_Stop.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/purge": {
+      "post": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Removes a content from CDN.",
+        "operationId": "Endpoints_PurgeContent",
+        "x-ms-examples": {
+          "Endpoints_PurgeContent": {
+            "$ref": "./examples/Endpoints_PurgeContent.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "contentFilePaths",
+            "in": "body",
+            "description": "The path to the content to be purged. Path can be a full URL, e.g. '/pictures/city.png' which removes a single file, or a directory with a wildcard, e.g. '/pictures/*' which removes all folders and files in the directory.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/PurgeParameters"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded."
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously."
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/load": {
+      "post": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Pre-loads a content to CDN. Available for Verizon Profiles.",
+        "operationId": "Endpoints_LoadContent",
+        "x-ms-examples": {
+          "Endpoints_LoadContent": {
+            "$ref": "./examples/Endpoints_LoadContent.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "contentFilePaths",
+            "in": "body",
+            "description": "The path to the content to be loaded. Path should be a full URL, e.g. ‘/pictures/city.png' which loads a single file ",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/LoadParameters"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded."
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously."
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/validateCustomDomain": {
+      "post": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Validates the custom domain mapping to ensure it maps to the correct CDN endpoint in DNS.",
+        "operationId": "Endpoints_ValidateCustomDomain",
+        "x-ms-examples": {
+          "Endpoints_ValidateCustomDomain": {
+            "$ref": "./examples/Endpoints_ValidateCustomDomain.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "customDomainProperties",
+            "in": "body",
+            "description": "Custom domain to be validated.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ValidateCustomDomainInput"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/ValidateCustomDomainOutput"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/checkResourceUsage": {
+      "post": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Checks the quota and usage of geo filters and custom domains under the given endpoint.",
+        "operationId": "Endpoints_ListResourceUsage",
+        "x-ms-examples": {
+          "Endpoints_ListResourceUsage": {
+            "$ref": "./examples/Endpoints_ListResourceUsage.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/ResourceUsageListResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/origins": {
+      "get": {
+        "tags": [
+          "Origins"
+        ],
+        "description": "Lists all of the existing origins within an endpoint.",
+        "operationId": "Origins_ListByEndpoint",
+        "x-ms-examples": {
+          "Origins_ListByEndpoint": {
+            "$ref": "./examples/Origins_ListByEndpoint.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/OriginListResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/origins/{originName}": {
+      "get": {
+        "tags": [
+          "Origins"
+        ],
+        "description": "Gets an existing origin within an endpoint.",
+        "operationId": "Origins_Get",
+        "x-ms-examples": {
+          "Origins_Get": {
+            "$ref": "./examples/Origins_Get.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "originName",
+            "in": "path",
+            "description": "Name of the origin which is unique within the endpoint.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/Origin"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "Origins"
+        ],
+        "description": "Updates an existing origin within an endpoint.",
+        "operationId": "Origins_Update",
+        "x-ms-examples": {
+          "Origins_Update": {
+            "$ref": "./examples/Origins_Update.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "originName",
+            "in": "path",
+            "description": "Name of the origin which is unique within the endpoint.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "originUpdateProperties",
+            "in": "body",
+            "description": "Origin properties",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/OriginUpdateParameters"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/Origin"
+            }
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/Origin"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/customDomains": {
+      "get": {
+        "tags": [
+          "CustomDomains"
+        ],
+        "description": "Lists all of the existing custom domains within an endpoint.",
+        "operationId": "CustomDomains_ListByEndpoint",
+        "x-ms-examples": {
+          "CustomDomains_ListByEndpoint": {
+            "$ref": "./examples/CustomDomains_ListByEndpoint.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/CustomDomainListResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/customDomains/{customDomainName}": {
+      "get": {
+        "tags": [
+          "CustomDomains"
+        ],
+        "description": "Gets an existing custom domain within an endpoint.",
+        "operationId": "CustomDomains_Get",
+        "x-ms-examples": {
+          "CustomDomains_Get": {
+            "$ref": "./examples/CustomDomains_Get.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "customDomainName",
+            "in": "path",
+            "description": "Name of the custom domain within an endpoint.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/CustomDomain"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "CustomDomains"
+        ],
+        "description": "Creates a new custom domain within an endpoint.",
+        "operationId": "CustomDomains_Create",
+        "x-ms-examples": {
+          "CustomDomains_Create": {
+            "$ref": "./examples/CustomDomains_Create.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "customDomainName",
+            "in": "path",
+            "description": "Name of the custom domain within an endpoint.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "customDomainProperties",
+            "in": "body",
+            "description": "Properties required to create a new custom domain.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/CustomDomainParameters"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/CustomDomain"
+            }
+          },
+          "201": {
+            "description": "Created. The request has been fulfilled and a new custom domain has been created.",
+            "schema": {
+              "$ref": "#/definitions/CustomDomain"
+            }
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/CustomDomain"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "delete": {
+        "tags": [
+          "CustomDomains"
+        ],
+        "description": "Deletes an existing custom domain within an endpoint.",
+        "operationId": "CustomDomains_Delete",
+        "x-ms-examples": {
+          "CustomDomains_Delete": {
+            "$ref": "./examples/CustomDomains_Delete.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "customDomainName",
+            "in": "path",
+            "description": "Name of the custom domain within an endpoint.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded."
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/CustomDomain"
+            }
+          },
+          "204": {
+            "description": "No Content. The request has been accepted but the custom domain was not found"
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/customDomains/{customDomainName}/disableCustomHttps": {
+      "post": {
+        "tags": [
+          "CustomDomains"
+        ],
+        "description": "Disable https delivery of the custom domain.",
+        "operationId": "CustomDomains_DisableCustomHttps",
+        "x-ms-examples": {
+          "CustomDomains_DisableCustomHttps": {
+            "$ref": "./examples/CustomDomains_DisableCustomHttps.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "customDomainName",
+            "in": "path",
+            "description": "Name of the custom domain within an endpoint.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded."
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/CustomDomain"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/customDomains/{customDomainName}/enableCustomHttps": {
+      "post": {
+        "tags": [
+          "CustomDomains"
+        ],
+        "description": "Enable https delivery of the custom domain.",
+        "operationId": "CustomDomains_EnableCustomHttps",
+        "x-ms-examples": {
+          "CustomDomains_EnableCustomHttpsUsingYourOwnCertificate": {
+            "$ref": "./examples/CustomDomains_EnableCustomHttpsUsingBYOC.json"
+          },
+          "CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate": {
+            "$ref": "./examples/CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "customDomainName",
+            "in": "path",
+            "description": "Name of the custom domain within an endpoint.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "customDomainHttpsParameters",
+            "in": "body",
+            "description": "The configuration specifying how to enable HTTPS for the custom domain - using CDN managed certificate or user's own certificate. If not specified, enabling ssl uses CDN managed certificate by default.",
+            "required": false,
+            "schema": {
+              "$ref": "#/definitions/CustomDomainHttpsParameters"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded."
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/CustomDomain"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/providers/Microsoft.Cdn/checkNameAvailability": {
+      "post": {
+        "tags": [
+          "CheckNameAvailability"
+        ],
+        "description": "Check the availability of a resource name. This is needed for resources where name is globally unique, such as a CDN endpoint.",
+        "operationId": "CheckNameAvailability",
+        "x-ms-examples": {
+          "CheckNameAvailability": {
+            "$ref": "./examples/CheckNameAvailability.json"
+          }
+        },
+        "parameters": [
+          {
+            "name": "checkNameAvailabilityInput",
+            "in": "body",
+            "description": "Input to check.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/CheckNameAvailabilityInput"
+            }
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/CheckNameAvailabilityOutput"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Cdn/checkNameAvailability": {
+      "post": {
+        "tags": [
+          "CheckNameAvailabilityWithSubscription"
+        ],
+        "description": "Check the availability of a resource name. This is needed for resources where name is globally unique, such as a CDN endpoint.",
+        "operationId": "CheckNameAvailabilityWithSubscription",
+        "x-ms-examples": {
+          "CheckNameAvailabilityWithSubscription": {
+            "$ref": "./examples/CheckNameAvailabilityWithSubscription.json"
+          }
+        },
+        "parameters": [
+          {
+            "name": "checkNameAvailabilityInput",
+            "in": "body",
+            "description": "Input to check.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/CheckNameAvailabilityInput"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/CheckNameAvailabilityOutput"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Cdn/validateProbe": {
+      "post": {
+        "tags": [
+          "ValidateProbe"
+        ],
+        "description": "Check if the probe path is a valid path and the file can be accessed. Probe path is the path to a file hosted on the origin server to help accelerate the delivery of dynamic content via the CDN endpoint. This path is relative to the origin path specified in the endpoint configuration.",
+        "operationId": "ValidateProbe",
+        "x-ms-examples": {
+          "ValidateProbe": {
+            "$ref": "./examples/ValidateProbe.json"
+          }
+        },
+        "parameters": [
+          {
+            "name": "validateProbeInput",
+            "in": "body",
+            "description": "Input to check.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ValidateProbeInput"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/ValidateProbeOutput"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Cdn/checkResourceUsage": {
+      "post": {
+        "tags": [
+          "CheckResourceUsage"
+        ],
+        "description": "Check the quota and actual usage of the CDN profiles under the given subscription.",
+        "operationId": "ResourceUsage_List",
+        "x-ms-examples": {
+          "ResourceUsage_List": {
+            "$ref": "./examples/ResourceUsage_List.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/ResourceUsageListResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/providers/Microsoft.Cdn/operations": {
+      "get": {
+        "tags": [
+          "Operations"
+        ],
+        "description": "Lists all of the available CDN REST API operations.",
+        "operationId": "Operations_List",
+        "x-ms-examples": {
+          "Operations_List": {
+            "$ref": "./examples/Operations_List.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/OperationsListResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/providers/Microsoft.Cdn/edgenodes": {
+      "get": {
+        "tags": [
+          "Edgenodes"
+        ],
+        "description": "Edgenodes are the global Point of Presence (POP) locations used to deliver CDN content to end users.",
+        "operationId": "EdgeNodes_List",
+        "x-ms-examples": {
+          "EdgeNodes_List": {
+            "$ref": "./examples/EdgeNodes_List.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/EdgenodeResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    }
+  },
+  "definitions": {
+    "Profile": {
+      "description": "CDN profile is a logical grouping of endpoints that share the same settings, such as CDN provider and pricing tier.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/TrackedResource"
+        }
+      ],
+      "properties": {
+        "sku": {
+          "description": "The pricing tier (defines a CDN provider, feature list and rate) of the CDN profile.",
+          "$ref": "#/definitions/Sku"
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ProfileProperties"
+        }
+      },
+      "required": [
+        "sku"
+      ]
+    },
+    "ProfileProperties": {
+      "description": "The JSON object that contains the properties required to create a profile.",
+      "properties": {
+        "resourceState": {
+          "description": "Resource status of the profile.",
+          "readOnly": true,
+          "enum": [
+            "Creating",
+            "Active",
+            "Deleting",
+            "Disabled"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "ProfileResourceState",
+            "modelAsString": true
+          }
+        },
+        "provisioningState": {
+          "readOnly": true,
+          "description": "Provisioning status of the profile.",
+          "type": "string"
+        }
+      }
+    },
+    "ProfileListResult": {
+      "description": "Result of the request to list profiles. It contains a list of profile objects and a URL link to get the next set of results.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/Profile"
+          },
+          "description": "List of CDN profiles within a resource group."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of profile objects if there are any."
+        }
+      }
+    },
+    "ProfileUpdateParameters": {
+      "type": "object",
+      "description": "Properties required to update a profile.",
+      "properties": {
+        "tags": {
+          "description": "Profile tags",
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "SsoUri": {
+      "description": "The URI required to login to the supplemental portal from the Azure portal.",
+      "type": "object",
+      "properties": {
+        "ssoUriValue": {
+          "description": "The URI used to login to the supplemental portal.",
+          "readOnly": true,
+          "type": "string"
+        }
+      }
+    },
+    "SupportedOptimizationTypesListResult": {
+      "description": "The result of the GetSupportedOptimizationTypes API",
+      "type": "object",
+      "properties": {
+        "supportedOptimizationTypes": {
+          "description": "Supported optimization types for a profile.",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/OptimizationType"
+          },
+          "type": "array"
+        }
+      }
+    },
+    "Endpoint": {
+      "description": "CDN endpoint is the entity within a CDN profile containing configuration information such as origin, protocol, content caching and delivery behavior. The CDN endpoint uses the URL format <endpointname>.azureedge.net.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/TrackedResource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/EndpointProperties"
+        }
+      }
+    },
+    "EndpointProperties": {
+      "description": "The JSON object that contains the properties required to create an endpoint.",
+      "required": [
+        "origins"
+      ],
+      "allOf": [
+        {
+          "$ref": "#/definitions/EndpointPropertiesUpdateParameters"
+        }
+      ],
+      "properties": {
+        "hostName": {
+          "description": "The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net",
+          "type": "string",
+          "readOnly": true
+        },
+        "origins": {
+          "description": "The source of the content being delivered via CDN.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DeepCreatedOrigin"
+          }
+        },
+        "resourceState": {
+          "description": "Resource status of the endpoint.",
+          "readOnly": true,
+          "enum": [
+            "Creating",
+            "Deleting",
+            "Running",
+            "Starting",
+            "Stopped",
+            "Stopping"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "EndpointResourceState",
+            "modelAsString": true
+          }
+        },
+        "provisioningState": {
+          "readOnly": true,
+          "description": "Provisioning status of the endpoint.",
+          "type": "string"
+        }
+      }
+    },
+    "EndpointListResult": {
+      "description": "Result of the request to list endpoints. It contains a list of endpoint objects and a URL link to get the next set of results.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/Endpoint"
+          },
+          "description": "List of CDN endpoints within a profile"
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of endpoint objects if there is any."
+        }
+      }
+    },
+    "EndpointUpdateParameters": {
+      "type": "object",
+      "description": "Properties required to create or update an endpoint.",
+      "properties": {
+        "tags": {
+          "description": "Endpoint tags.",
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/EndpointPropertiesUpdateParameters"
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "EndpointPropertiesUpdateParameters": {
+      "description": "The JSON object containing endpoint update parameters.",
+      "properties": {
+        "originHostHeader": {
+          "description": "The host header value sent to the origin with each request. If you leave this blank, the request hostname determines this value. Azure CDN origins, such as Web Apps, Blob Storage, and Cloud Services require this host header value to match the origin hostname by default.",
+          "type": "string"
+        },
+        "originPath": {
+          "description": "A directory path on the origin that CDN can use to retrieve content from, e.g. contoso.cloudapp.net/originpath.",
+          "type": "string"
+        },
+        "contentTypesToCompress": {
+          "description": "List of content types on which compression applies. The value should be a valid MIME type.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "isCompressionEnabled": {
+          "description": "Indicates whether content compression is enabled on CDN. Default value is false. If compression is enabled, content will be served as compressed if user requests for a compressed version. Content won't be compressed on CDN when requested content is smaller than 1 byte or larger than 1 MB.",
+          "type": "boolean"
+        },
+        "isHttpAllowed": {
+          "description": "Indicates whether HTTP traffic is allowed on the endpoint. Default value is true. At least one protocol (HTTP or HTTPS) must be allowed.",
+          "type": "boolean"
+        },
+        "isHttpsAllowed": {
+          "description": "Indicates whether HTTPS traffic is allowed on the endpoint. Default value is true. At least one protocol (HTTP or HTTPS) must be allowed.",
+          "type": "boolean"
+        },
+        "queryStringCachingBehavior": {
+          "description": "Defines how CDN caches requests that include query strings. You can ignore any query strings when caching, bypass caching to prevent requests that contain query strings from being cached, or cache every request with a unique URL.",
+          "$ref": "#/definitions/QueryStringCachingBehavior"
+        },
+        "optimizationType": {
+          "description": "Specifies what scenario the customer wants this CDN endpoint to optimize for, e.g. Download, Media services. With this information, CDN can apply scenario driven optimization.",
+          "$ref": "#/definitions/OptimizationType"
+        },
+        "probePath": {
+          "description": "Path to a file hosted on the origin which helps accelerate delivery of the dynamic content and calculate the most optimal routes for the CDN. This is relative to the origin path.",
+          "type": "string"
+        },
+        "geoFilters": {
+          "description": "List of rules defining the user's geo access within a CDN endpoint. Each geo filter defines an access rule to a specified path or content, e.g. block APAC for path /pictures/",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/GeoFilter"
+          }
+        },
+        "deliveryPolicy": {
+          "description": "A policy that specifies the delivery rules to be used for an endpoint.",
+          "type": "object",
+          "required": [
+            "rules"
+          ],
+          "properties": {
+            "description": {
+              "description": "User-friendly description of the policy.",
+              "type": "string"
+            },
+            "rules": {
+              "description": "A list of the delivery rules.",
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/DeliveryRule"
+              }
+            }
+          }
+        },
+        "webApplicationFirewallPolicyLink": {
+          "description": "Defines the Web Application Firewall policy for the endpoint (if applicable)",
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string",
+              "description": "Resource ID."
+            }
+          }
+        }
+      }
+    },
+    "DeliveryRule": {
+      "description": "A rule that specifies a set of actions and conditions",
+      "type": "object",
+      "required": [
+        "order",
+        "actions"
+      ],
+      "properties": {
+        "name": {
+          "description": "Name of the rule",
+          "type": "string"
+        },
+        "order": {
+          "description": "The order in which the rules are applied for the endpoint. Possible values {0,1,2,3,………}. A rule with a lesser order will be applied before a rule with a greater order. Rule with order 0 is a special rule. It does not require any condition and actions listed in it will always be applied.",
+          "type": "integer"
+        },
+        "conditions": {
+          "description": "A list of conditions that must be matched for the actions to be executed",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DeliveryRuleCondition"
+          }
+        },
+        "actions": {
+          "description": "A list of actions that are executed when all the conditions of a rule are satisfied.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DeliveryRuleAction"
+          }
+        }
+      }
+    },
+    "DeliveryRuleCondition": {
+      "description": "A condition for the delivery rule.",
+      "discriminator": "name",
+      "required": [
+        "name"
+      ],
+      "properties": {
+        "name": {
+          "description": "The name of the condition for the delivery rule.",
+          "type": "string",
+          "enum": [
+            "RemoteAddress",
+            "RequestMethod",
+            "QueryString",
+            "PostArgs",
+            "RequestUri",
+            "RequestHeader",
+            "RequestBody",
+            "RequestScheme",
+            "UrlPath",
+            "UrlFileExtension",
+            "UrlFileName",
+            "HttpVersion",
+            "Cookies",
+            "IsDevice"
+          ],
+          "x-ms-enum": {
+            "name": "MatchVariable",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "DeliveryRuleRemoteAddressCondition": {
+      "description": "Defines the RemoteAddress condition for the delivery rule.",
+      "x-ms-discriminator-value": "RemoteAddress",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/RemoteAddressMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleRequestMethodCondition": {
+      "description": "Defines the RequestMethod condition for the delivery rule.",
+      "x-ms-discriminator-value": "RequestMethod",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/RequestMethodMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleQueryStringCondition": {
+      "description": "Defines the QueryString condition for the delivery rule.",
+      "x-ms-discriminator-value": "QueryString",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/QueryStringMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRulePostArgsCondition": {
+      "description": "Defines the PostArgs condition for the delivery rule.",
+      "x-ms-discriminator-value": "PostArgs",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/PostArgsMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleRequestUriCondition": {
+      "description": "Defines the RequestUri condition for the delivery rule.",
+      "x-ms-discriminator-value": "RequestUri",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/RequestUriMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleRequestHeaderCondition": {
+      "description": "Defines the RequestHeader condition for the delivery rule.",
+      "x-ms-discriminator-value": "RequestHeader",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/RequestHeaderMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleRequestBodyCondition": {
+      "description": "Defines the RequestBody condition for the delivery rule.",
+      "x-ms-discriminator-value": "RequestBody",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/RequestBodyMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleRequestSchemeCondition": {
+      "description": "Defines the RequestScheme condition for the delivery rule.",
+      "x-ms-discriminator-value": "RequestScheme",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/RequestSchemeMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleUrlPathCondition": {
+      "description": "Defines the UrlPath condition for the delivery rule.",
+      "x-ms-discriminator-value": "UrlPath",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/UrlPathMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleUrlFileExtensionCondition": {
+      "description": "Defines the UrlFileExtension condition for the delivery rule.",
+      "x-ms-discriminator-value": "UrlFileExtension",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/UrlFileExtensionMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleUrlFileNameCondition": {
+      "description": "Defines the UrlFileName condition for the delivery rule.",
+      "x-ms-discriminator-value": "UrlFileName",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/UrlFileNameMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleHttpVersionCondition": {
+      "description": "Defines the HttpVersion condition for the delivery rule.",
+      "x-ms-discriminator-value": "HttpVersion",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/HttpVersionMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleCookiesCondition": {
+      "description": "Defines the Cookies condition for the delivery rule.",
+      "x-ms-discriminator-value": "Cookies",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/CookiesMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleIsDeviceCondition": {
+      "description": "Defines the IsDevice condition for the delivery rule.",
+      "x-ms-discriminator-value": "IsDevice",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/IsDeviceMatchConditionParameters"
+        }
+      }
+    },
+    "RemoteAddressMatchConditionParameters": {
+      "description": "Defines the parameters for RemoteAddress match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleRemoteAddressConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "IPMatch",
+            "GeoMatch"
+          ],
+          "x-ms-enum": {
+            "name": "RemoteAddressOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "Match values to match against. The operator will apply to each value in here with OR semantics. If any of them match the variable with the given operator this match condition is considered a match.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "RequestMethodMatchConditionParameters": {
+      "description": "Defines the parameters for RequestMethod match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestMethodConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Equal"
+          ],
+          "x-ms-enum": {
+            "name": "RequestMethodOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "GET",
+              "HEAD",
+              "POST",
+              "PUT",
+              "DELETE",
+              "OPTIONS",
+              "TRACE"
+            ]
+          }
+        }
+      }
+    },
+    "QueryStringMatchConditionParameters": {
+      "description": "Defines the parameters for QueryString match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleQueryStringConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "Equal",
+            "Contains",
+            "BeginsWith",
+            "EndsWith",
+            "LessThan",
+            "LessThanOrEqual",
+            "GreaterThan",
+            "GreaterThanOrEqual"
+          ],
+          "x-ms-enum": {
+            "name": "QueryStringOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "PostArgsMatchConditionParameters": {
+      "description": "Defines the parameters for PostArgs match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "selector",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRulePostArgsConditionParameters"
+          ]
+        },
+        "selector": {
+          "description": "Name of PostArg to be matched",
+          "type": "string"
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "Equal",
+            "Contains",
+            "BeginsWith",
+            "EndsWith",
+            "LessThan",
+            "LessThanOrEqual",
+            "GreaterThan",
+            "GreaterThanOrEqual"
+          ],
+          "x-ms-enum": {
+            "name": "PostArgsOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "RequestUriMatchConditionParameters": {
+      "description": "Defines the parameters for RequestUri match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestUriConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "Equal",
+            "Contains",
+            "BeginsWith",
+            "EndsWith",
+            "LessThan",
+            "LessThanOrEqual",
+            "GreaterThan",
+            "GreaterThanOrEqual"
+          ],
+          "x-ms-enum": {
+            "name": "RequestUriOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "RequestHeaderMatchConditionParameters": {
+      "description": "Defines the parameters for RequestHeader match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "selector",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestHeaderConditionParameters"
+          ]
+        },
+        "selector": {
+          "description": "Name of Header to be matched",
+          "type": "string"
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "Equal",
+            "Contains",
+            "BeginsWith",
+            "EndsWith",
+            "LessThan",
+            "LessThanOrEqual",
+            "GreaterThan",
+            "GreaterThanOrEqual"
+          ],
+          "x-ms-enum": {
+            "name": "RequestHeaderOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "RequestBodyMatchConditionParameters": {
+      "description": "Defines the parameters for RequestBody match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestBodyConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "Equal",
+            "Contains",
+            "BeginsWith",
+            "EndsWith",
+            "LessThan",
+            "LessThanOrEqual",
+            "GreaterThan",
+            "GreaterThanOrEqual"
+          ],
+          "x-ms-enum": {
+            "name": "RequestBodyOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "RequestSchemeMatchConditionParameters": {
+      "description": "Defines the parameters for RequestScheme match conditions ",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestSchemeConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Equal"
+          ]
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "HTTP",
+              "HTTPS"
+            ]
+          }
+        }
+      }
+    },
+    "UrlPathMatchConditionParameters": {
+      "description": "Defines the parameters for UrlPath match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlPathMatchConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "Equal",
+            "Contains",
+            "BeginsWith",
+            "EndsWith",
+            "LessThan",
+            "LessThanOrEqual",
+            "GreaterThan",
+            "GreaterThanOrEqual",
+            "Wildcard"
+          ],
+          "x-ms-enum": {
+            "name": "UrlPathOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "UrlFileExtensionMatchConditionParameters": {
+      "description": "Defines the parameters for UrlFileExtension match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlFileExtensionMatchConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "Equal",
+            "Contains",
+            "BeginsWith",
+            "EndsWith",
+            "LessThan",
+            "LessThanOrEqual",
+            "GreaterThan",
+            "GreaterThanOrEqual"
+          ],
+          "x-ms-enum": {
+            "name": "UrlFileExtensionOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "UrlFileNameMatchConditionParameters": {
+      "description": "Defines the parameters for UrlFilename match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlFilenameConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "Equal",
+            "Contains",
+            "BeginsWith",
+            "EndsWith",
+            "LessThan",
+            "LessThanOrEqual",
+            "GreaterThan",
+            "GreaterThanOrEqual"
+          ],
+          "x-ms-enum": {
+            "name": "UrlFileNameOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "HttpVersionMatchConditionParameters": {
+      "description": "Defines the parameters for HttpVersion match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleHttpVersionConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Equal"
+          ],
+          "x-ms-enum": {
+            "name": "HttpVersionOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "CookiesMatchConditionParameters": {
+      "description": "Defines the parameters for Cookies match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "selector",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleCookiesConditionParameters"
+          ]
+        },
+        "selector": {
+          "description": "Name of Cookies to be matched",
+          "type": "string"
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "Equal",
+            "Contains",
+            "BeginsWith",
+            "EndsWith",
+            "LessThan",
+            "LessThanOrEqual",
+            "GreaterThan",
+            "GreaterThanOrEqual"
+          ],
+          "x-ms-enum": {
+            "name": "CookiesOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "IsDeviceMatchConditionParameters": {
+      "description": "Defines the parameters for IsDevice match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleIsDeviceConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Equal"
+          ],
+          "x-ms-enum": {
+            "name": "IsDeviceOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "Mobile",
+              "Desktop"
+            ]
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "DeliveryRuleAction": {
+      "description": "An action for the delivery rule.",
+      "discriminator": "name",
+      "required": [
+        "name"
+      ],
+      "properties": {
+        "name": {
+          "description": "The name of the action for the delivery rule.",
+          "type": "string",
+          "enum": [
+            "CacheExpiration",
+            "CacheKeyQueryString",
+            "ModifyRequestHeader",
+            "ModifyResponseHeader",
+            "UrlRedirect",
+            "UrlRewrite"
+          ],
+          "x-ms-enum": {
+            "name": "DeliveryRuleAction",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "UrlRedirectAction": {
+      "description": "Defines the url redirect action for the delivery rule.",
+      "x-ms-discriminator-value": "UrlRedirect",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleAction"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the action.",
+          "$ref": "#/definitions/UrlRedirectActionParameters"
+        }
+      }
+    },
+    "UrlRedirectActionParameters": {
+      "description": "Defines the parameters for the url redirect action.",
+      "required": [
+        "redirectType",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlRedirectActionParameters"
+          ]
+        },
+        "redirectType": {
+          "description": "The redirect type the rule will use when redirecting traffic.",
+          "type": "string",
+          "enum": [
+            "Moved",
+            "Found",
+            "TemporaryRedirect",
+            "PermanentRedirect"
+          ],
+          "x-ms-enum": {
+            "name": "RedirectType",
+            "modelAsString": true
+          }
+        },
+        "destinationProtocol": {
+          "description": "Protocol to use for the redirect. The default value is MatchRequest",
+          "type": "string",
+          "enum": [
+            "MatchRequest",
+            "Http",
+            "Https"
+          ],
+          "x-ms-enum": {
+            "name": "DestinationProtocol",
+            "modelAsString": true
+          }
+        },
+        "customPath": {
+          "description": "The full path to redirect. Path cannot be empty and must start with /. Leave empty to use the incoming path as destination path.",
+          "type": "string"
+        },
+        "customHostname": {
+          "description": "Host to redirect. Leave empty to use the incoming host as the destination host.",
+          "type": "string"
+        },
+        "customQueryString": {
+          "description": "The set of query strings to be placed in the redirect URL. Setting this value would replace any existing query string; leave empty to preserve the incoming query string. Query string must be in <key>=<value> format. ? and & will be added automatically so do not include them.",
+          "type": "string"
+        },
+        "customFragment": {
+          "type": "string",
+          "description": "Fragment to add to the redirect URL. Fragment is the part of the URL that comes after #. Do not include the #."
+        }
+      }
+    },
+    "UrlRewriteAction": {
+      "description": "Defines the url rewrite action for the delivery rule.",
+      "x-ms-discriminator-value": "UrlRewrite",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleAction"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the action.",
+          "$ref": "#/definitions/UrlRewriteActionParameters"
+        }
+      }
+    },
+    "UrlRewriteActionParameters": {
+      "description": "Defines the parameters for the url rewrite action.",
+      "required": [
+        "sourcePattern",
+        "destination",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlRewriteActionParameters"
+          ]
+        },
+        "sourcePattern": {
+          "description": "define a request URI pattern that identifies the type of requests that may be rewritten. Currently, source pattern uses a prefix-based match. To match all URL paths, use \"/\" as the source pattern value. To match only the root directory and re-write this path, use the origin path field",
+          "type": "string"
+        },
+        "destination": {
+          "description": "Define the destination path for be used in the rewrite. This will overwrite the source pattern ",
+          "type": "string"
+        },
+        "preserveUnmatchedPath": {
+          "description": "If True, the remaining path after the source pattern will be appended to the new destination path.  ",
+          "type": "boolean"
+        }
+      }
+    },
+    "DeliveryRuleRequestHeaderAction": {
+      "description": "Defines the request header action for the delivery rule.",
+      "x-ms-discriminator-value": "ModifyRequestHeader",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleAction"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the action.",
+          "$ref": "#/definitions/HeaderActionParameters"
+        }
+      }
+    },
+    "DeliveryRuleResponseHeaderAction": {
+      "description": "Defines the response header action for the delivery rule.",
+      "x-ms-discriminator-value": "ModifyResponseHeader",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleAction"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the action.",
+          "$ref": "#/definitions/HeaderActionParameters"
+        }
+      }
+    },
+    "HeaderActionParameters": {
+      "description": "Defines the parameters for the request header action.",
+      "required": [
+        "headerAction",
+        "headerName",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleHeaderActionParameters"
+          ]
+        },
+        "headerAction": {
+          "description": "Action to perform",
+          "type": "string",
+          "enum": [
+            "Append",
+            "Overwrite",
+            "Delete"
+          ],
+          "x-ms-enum": {
+            "name": "HeaderAction",
+            "modelAsString": true
+          }
+        },
+        "headerName": {
+          "description": "Name of the header to modify",
+          "type": "string"
+        },
+        "value": {
+          "description": "Value for the specified action",
+          "type": "string"
+        }
+      }
+    },
+    "DeliveryRuleCacheExpirationAction": {
+      "description": "Defines the cache expiration action for the delivery rule.",
+      "x-ms-discriminator-value": "CacheExpiration",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleAction"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the action.",
+          "$ref": "#/definitions/CacheExpirationActionParameters"
+        }
+      }
+    },
+    "CacheExpirationActionParameters": {
+      "description": "Defines the parameters for the cache expiration action.",
+      "required": [
+        "cacheBehavior",
+        "cacheType",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleCacheExpirationActionParameters"
+          ]
+        },
+        "cacheBehavior": {
+          "description": "Caching behavior for the requests",
+          "type": "string",
+          "enum": [
+            "BypassCache",
+            "Override",
+            "SetIfMissing"
+          ],
+          "x-ms-enum": {
+            "name": "cacheBehavior",
+            "modelAsString": true
+          }
+        },
+        "cacheType": {
+          "description": "The level at which the content needs to be cached.",
+          "type": "string",
+          "enum": [
+            "All"
+          ],
+          "x-ms-enum": {
+            "name": "CacheType",
+            "modelAsString": true
+          }
+        },
+        "cacheDuration": {
+          "description": "The duration for which the content needs to be cached. Allowed format is [d.]hh:mm:ss",
+          "type": "string",
+          "x-nullable": true
+        }
+      }
+    },
+    "DeliveryRuleCacheKeyQueryStringAction": {
+      "description": "Defines the cache-key query string action for the delivery rule.",
+      "x-ms-discriminator-value": "CacheKeyQueryString",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleAction"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the action.",
+          "$ref": "#/definitions/CacheKeyQueryStringActionParameters"
+        }
+      }
+    },
+    "CacheKeyQueryStringActionParameters": {
+      "description": "Defines the parameters for the cache-key query string action.",
+      "required": [
+        "queryStringBehavior",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleCacheKeyQueryStringBehaviorActionParameters"
+          ]
+        },
+        "queryStringBehavior": {
+          "description": "Caching behavior for the requests",
+          "type": "string",
+          "enum": [
+            "Include",
+            "IncludeAll",
+            "Exclude",
+            "ExcludeAll"
+          ],
+          "x-ms-enum": {
+            "name": "queryStringBehavior",
+            "modelAsString": true
+          }
+        },
+        "queryParameters": {
+          "description": "query parameters to include or exclude (comma separated).",
+          "type": "string",
+          "x-nullable": true
+        }
+      }
+    },
+    "transform": {
+      "description": "Describes what transforms are applied before matching",
+      "type": "string",
+      "enum": [
+        "Lowercase",
+        "Uppercase"
+      ],
+      "x-ms-enum": {
+        "name": "transform",
+        "modelAsString": true
+      }
+    },
+    "DeepCreatedOrigin": {
+      "description": "The main origin of CDN content which is added when creating a CDN endpoint.",
+      "type": "object",
+      "required": [
+        "name"
+      ],
+      "properties": {
+        "name": {
+          "description": "Origin name",
+          "type": "string"
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/DeepCreatedOriginProperties"
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "DeepCreatedOriginProperties": {
+      "description": "Properties of the origin created on the CDN endpoint.",
+      "type": "object",
+      "required": [
+        "hostName"
+      ],
+      "properties": {
+        "hostName": {
+          "description": "The address of the origin. It can be a domain name, IPv4 address, or IPv6 address.",
+          "type": "string"
+        },
+        "httpPort": {
+          "description": "The value of the HTTP port. Must be between 1 and 65535",
+          "type": "integer",
+          "maximum": 65535,
+          "exclusiveMaximum": false,
+          "minimum": 1,
+          "exclusiveMinimum": false
+        },
+        "httpsPort": {
+          "description": "The value of the HTTPS port. Must be between 1 and 65535",
+          "type": "integer",
+          "maximum": 65535,
+          "exclusiveMaximum": false,
+          "minimum": 1,
+          "exclusiveMinimum": false
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "GeoFilter": {
+      "description": "Rules defining user's geo access within a CDN endpoint.",
+      "type": "object",
+      "required": [
+        "relativePath",
+        "action",
+        "countryCodes"
+      ],
+      "properties": {
+        "relativePath": {
+          "description": "Relative path applicable to geo filter. (e.g. '/mypictures', '/mypicture/kitty.jpg', and etc.)",
+          "type": "string"
+        },
+        "action": {
+          "description": "Action of the geo filter, i.e. allow or block access.",
+          "enum": [
+            "Block",
+            "Allow"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "GeoFilterActions",
+            "modelAsString": false
+          }
+        },
+        "countryCodes": {
+          "description": "Two letter country codes defining user country access in a geo filter, e.g. AU, MX, US.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "PurgeParameters": {
+      "type": "object",
+      "description": "Parameters required for content purge.",
+      "required": [
+        "contentPaths"
+      ],
+      "properties": {
+        "contentPaths": {
+          "description": "The path to the content to be purged. Can describe a file path or a wild card directory.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "LoadParameters": {
+      "type": "object",
+      "description": "Parameters required for content load.",
+      "required": [
+        "contentPaths"
+      ],
+      "properties": {
+        "contentPaths": {
+          "description": "The path to the content to be loaded. Path should be a relative file URL of the origin.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "Origin": {
+      "description": "CDN origin is the source of the content being delivered via CDN. When the edge nodes represented by an endpoint do not have the requested content cached, they attempt to fetch it from one or more of the configured origins.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/TrackedResource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/OriginProperties"
+        }
+      }
+    },
+    "OriginProperties": {
+      "description": "The JSON object that contains the properties of the origin.",
+      "required": [
+        "hostName"
+      ],
+      "properties": {
+        "hostName": {
+          "description": "The address of the origin. Domain names, IPv4 addresses, and IPv6 addresses are supported.",
+          "type": "string"
+        },
+        "httpPort": {
+          "description": "The value of the HTTP port. Must be between 1 and 65535.",
+          "type": "integer",
+          "maximum": 65535,
+          "exclusiveMaximum": false,
+          "minimum": 1,
+          "exclusiveMinimum": false
+        },
+        "httpsPort": {
+          "description": "The value of the https port. Must be between 1 and 65535.",
+          "type": "integer",
+          "maximum": 65535,
+          "exclusiveMaximum": false,
+          "minimum": 1,
+          "exclusiveMinimum": false
+        },
+        "resourceState": {
+          "description": "Resource status of the origin.",
+          "readOnly": true,
+          "enum": [
+            "Creating",
+            "Active",
+            "Deleting"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "OriginResourceState",
+            "modelAsString": true
+          }
+        },
+        "provisioningState": {
+          "readOnly": true,
+          "description": "Provisioning status of the origin.",
+          "type": "string"
+        }
+      }
+    },
+    "OriginUpdateParameters": {
+      "type": "object",
+      "description": "Origin properties needed for origin creation or update.",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/OriginPropertiesParameters"
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "OriginPropertiesParameters": {
+      "description": "The JSON object that contains the properties of the origin.",
+      "properties": {
+        "hostName": {
+          "description": "The address of the origin. Domain names, IPv4 addresses, and IPv6 addresses are supported.",
+          "type": "string"
+        },
+        "httpPort": {
+          "description": "The value of the HTTP port. Must be between 1 and 65535.",
+          "type": "integer",
+          "maximum": 65535,
+          "exclusiveMaximum": false,
+          "minimum": 1,
+          "exclusiveMinimum": false
+        },
+        "httpsPort": {
+          "description": "The value of the HTTPS port. Must be between 1 and 65535.",
+          "type": "integer",
+          "maximum": 65535,
+          "exclusiveMaximum": false,
+          "minimum": 1,
+          "exclusiveMinimum": false
+        }
+      }
+    },
+    "OriginListResult": {
+      "description": "Result of the request to list origins. It contains a list of origin objects and a URL link to get the next set of results.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/Origin"
+          },
+          "description": "List of CDN origins within an endpoint"
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of origin objects if there are any."
+        }
+      }
+    },
+    "CustomDomain": {
+      "description": "Friendly domain name mapping to the endpoint hostname that the customer provides for branding purposes, e.g. www.contoso.com.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ProxyResource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/CustomDomainProperties"
+        }
+      }
+    },
+    "CustomDomainProperties": {
+      "description": "The JSON object that contains the properties of the custom domain to create.",
+      "required": [
+        "hostName"
+      ],
+      "properties": {
+        "hostName": {
+          "description": "The host name of the custom domain. Must be a domain name.",
+          "type": "string"
+        },
+        "resourceState": {
+          "description": "Resource status of the custom domain.",
+          "readOnly": true,
+          "enum": [
+            "Creating",
+            "Active",
+            "Deleting"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "CustomDomainResourceState",
+            "modelAsString": true
+          }
+        },
+        "customHttpsProvisioningState": {
+          "description": "Provisioning status of Custom Https of the custom domain.",
+          "readOnly": true,
+          "enum": [
+            "Enabling",
+            "Enabled",
+            "Disabling",
+            "Disabled",
+            "Failed"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "CustomHttpsProvisioningState",
+            "modelAsString": true
+          }
+        },
+        "customHttpsProvisioningSubstate": {
+          "description": "Provisioning substate shows the progress of custom HTTPS enabling/disabling process step by step.",
+          "readOnly": true,
+          "enum": [
+            "SubmittingDomainControlValidationRequest",
+            "PendingDomainControlValidationREquestApproval",
+            "DomainControlValidationRequestApproved",
+            "DomainControlValidationRequestRejected",
+            "DomainControlValidationRequestTimedOut",
+            "IssuingCertificate",
+            "DeployingCertificate",
+            "CertificateDeployed",
+            "DeletingCertificate",
+            "CertificateDeleted"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "CustomHttpsProvisioningSubstate",
+            "modelAsString": true
+          }
+        },
+        "customHttpsParameters": {
+          "description": "Certificate parameters for securing custom HTTPS",
+          "$ref": "#/definitions/CustomDomainHttpsParameters"
+        },
+        "validationData": {
+          "description": "Special validation or data may be required when delivering CDN to some regions due to local compliance reasons. E.g. ICP license number of a custom domain is required to deliver content in China.",
+          "type": "string"
+        },
+        "provisioningState": {
+          "readOnly": true,
+          "description": "Provisioning status of the custom domain.",
+          "type": "string"
+        }
+      }
+    },
+    "CustomDomainParameters": {
+      "description": "The customDomain JSON object required for custom domain creation or update.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/CustomDomainPropertiesParameters"
+        }
+      }
+    },
+    "CustomDomainPropertiesParameters": {
+      "description": "The JSON object that contains the properties of the custom domain to create.",
+      "required": [
+        "hostName"
+      ],
+      "properties": {
+        "hostName": {
+          "description": "The host name of the custom domain. Must be a domain name.",
+          "type": "string"
+        }
+      }
+    },
+    "CustomDomainHttpsParameters": {
+      "description": "The JSON object that contains the properties to secure a custom domain.",
+      "discriminator": "certificateSource",
+      "required": [
+        "certificateSource",
+        "protocolType"
+      ],
+      "properties": {
+        "certificateSource": {
+          "description": "Defines the source of the SSL certificate.",
+          "enum": [
+            "AzureKeyVault",
+            "Cdn"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "CertificateSource",
+            "modelAsString": true
+          }
+        },
+        "protocolType": {
+          "description": "Defines the TLS extension protocol that is used for secure delivery.",
+          "enum": [
+            "ServerNameIndication",
+            "IPBased"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "ProtocolType",
+            "modelAsString": true
+          }
+        },
+        "minimumTlsVersion": {
+          "description": "TLS protocol version that will be used for Https",
+          "enum": [
+            "None",
+            "TLS10",
+            "TLS12"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "minimumTlsVersion",
+            "modelAsString": false
+          }
+        }
+      }
+    },
+    "CdnManagedHttpsParameters": {
+      "description": "Defines the certificate source parameters using CDN managed certificate for enabling SSL.",
+      "x-ms-discriminator-value": "Cdn",
+      "allOf": [
+        {
+          "$ref": "#/definitions/CustomDomainHttpsParameters"
+        }
+      ],
+      "required": [
+        "certificateSourceParameters"
+      ],
+      "properties": {
+        "certificateSourceParameters": {
+          "description": "Defines the certificate source parameters using CDN managed certificate for enabling SSL.",
+          "$ref": "#/definitions/CdnCertificateSourceParameters"
+        }
+      }
+    },
+    "CdnCertificateSourceParameters": {
+      "description": "Defines the parameters for using CDN managed certificate for securing custom domain.",
+      "required": [
+        "@odata.type",
+        "certificateType"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.CdnCertificateSourceParameters"
+          ]
+        },
+        "certificateType": {
+          "description": "Type of certificate used",
+          "enum": [
+            "Shared",
+            "Dedicated"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "CertificateType",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "UserManagedHttpsParameters": {
+      "description": "Defines the certificate source parameters using user's keyvault certificate for enabling SSL.",
+      "x-ms-discriminator-value": "AzureKeyVault",
+      "allOf": [
+        {
+          "$ref": "#/definitions/CustomDomainHttpsParameters"
+        }
+      ],
+      "required": [
+        "certificateSourceParameters"
+      ],
+      "properties": {
+        "certificateSourceParameters": {
+          "description": "Defines the certificate source parameters using user's keyvault certificate for enabling SSL.",
+          "$ref": "#/definitions/KeyVaultCertificateSourceParameters"
+        }
+      }
+    },
+    "KeyVaultCertificateSourceParameters": {
+      "description": "Describes the parameters for using a user's KeyVault certificate for securing custom domain.",
+      "required": [
+        "@odata.type",
+        "subscriptionId",
+        "resourceGroupName",
+        "vaultName",
+        "secretName",
+        "secretVersion",
+        "updateRule",
+        "deleteRule"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.KeyVaultCertificateSourceParameters"
+          ]
+        },
+        "subscriptionId": {
+          "description": "Subscription Id of the user's Key Vault containing the SSL certificate",
+          "type": "string"
+        },
+        "resourceGroupName": {
+          "description": "Resource group of the user's Key Vault containing the SSL certificate",
+          "type": "string"
+        },
+        "vaultName": {
+          "description": "The name of the user's Key Vault containing the SSL certificate",
+          "type": "string"
+        },
+        "secretName": {
+          "description": "The name of Key Vault Secret (representing the full certificate PFX) in Key Vault.",
+          "type": "string"
+        },
+        "secretVersion": {
+          "description": "The version(GUID) of Key Vault Secret in Key Vault.",
+          "type": "string"
+        },
+        "updateRule": {
+          "description": "Describes the action that shall be taken when the certificate is updated in Key Vault.",
+          "type": "string",
+          "enum": [
+            "NoAction"
+          ],
+          "x-ms-enum": {
+            "name": "UpdateRule",
+            "modelAsString": true
+          }
+        },
+        "deleteRule": {
+          "description": "Describes the action that shall be taken when the certificate is removed from Key Vault.",
+          "type": "string",
+          "enum": [
+            "NoAction"
+          ],
+          "x-ms-enum": {
+            "name": "DeleteRule",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "CustomDomainListResult": {
+      "description": "Result of the request to list custom domains. It contains a list of custom domain objects and a URL link to get the next set of results.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/CustomDomain"
+          },
+          "description": "List of CDN CustomDomains within an endpoint."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of custom domain objects if there are any."
+        }
+      }
+    },
+    "ValidateCustomDomainInput": {
+      "description": "Input of the custom domain to be validated for DNS mapping.",
+      "type": "object",
+      "required": [
+        "hostName"
+      ],
+      "properties": {
+        "hostName": {
+          "description": "The host name of the custom domain. Must be a domain name.",
+          "type": "string"
+        }
+      }
+    },
+    "ValidateCustomDomainOutput": {
+      "description": "Output of custom domain validation.",
+      "type": "object",
+      "properties": {
+        "customDomainValidated": {
+          "description": "Indicates whether the custom domain is valid or not.",
+          "readOnly": true,
+          "type": "boolean"
+        },
+        "reason": {
+          "description": "The reason why the custom domain is not valid.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "message": {
+          "description": "Error message describing why the custom domain is not valid.",
+          "readOnly": true,
+          "type": "string"
+        }
+      }
+    },
+    "CheckNameAvailabilityInput": {
+      "description": "Input of CheckNameAvailability API.",
+      "type": "object",
+      "required": [
+        "name",
+        "type"
+      ],
+      "properties": {
+        "name": {
+          "description": "The resource name to validate.",
+          "type": "string"
+        },
+        "type": {
+          "description": "The type of the resource whose name is to be validated.",
+          "$ref": "#/definitions/ResourceType"
+        }
+      }
+    },
+    "CheckNameAvailabilityOutput": {
+      "description": "Output of check name availability API.",
+      "type": "object",
+      "properties": {
+        "nameAvailable": {
+          "description": "Indicates whether the name is available.",
+          "readOnly": true,
+          "type": "boolean"
+        },
+        "reason": {
+          "description": "The reason why the name is not available.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "message": {
+          "description": "The detailed error message describing why the name is not available.",
+          "readOnly": true,
+          "type": "string"
+        }
+      }
+    },
+    "ValidateProbeInput": {
+      "description": "Input of the validate probe API.",
+      "properties": {
+        "probeURL": {
+          "description": "The probe URL to validate.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "probeURL"
+      ],
+      "type": "object"
+    },
+    "ValidateProbeOutput": {
+      "description": "Output of the validate probe API.",
+      "properties": {
+        "isValid": {
+          "description": "Indicates whether the probe URL is accepted or not.",
+          "readOnly": true,
+          "type": "boolean"
+        },
+        "errorCode": {
+          "description": "Specifies the error code when the probe url is not accepted.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "message": {
+          "description": "The detailed error message describing why the probe URL is not accepted.",
+          "readOnly": true,
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "ResourceUsageListResult": {
+      "description": "Output of check resource usage API.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/ResourceUsage"
+          },
+          "description": "List of resource usages."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of custom domain objects if there are any."
+        }
+      }
+    },
+    "ResourceUsage": {
+      "description": "Output of check resource usage API.",
+      "type": "object",
+      "properties": {
+        "resourceType": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource type for which the usage is provided."
+        },
+        "unit": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Unit of the usage. e.g. Count."
+        },
+        "currentValue": {
+          "type": "integer",
+          "readOnly": true,
+          "description": "Actual value of usage on the specified resource type."
+        },
+        "limit": {
+          "type": "integer",
+          "readOnly": true,
+          "description": "Quota of the specified resource type."
+        }
+      }
+    },
+    "ResourceType": {
+      "description": "Type of CDN resource used in CheckNameAvailability.",
+      "enum": [
+        "Microsoft.Cdn/Profiles/Endpoints"
+      ],
+      "type": "string",
+      "x-ms-enum": {
+        "name": "ResourceType",
+        "modelAsString": false
+      }
+    },
+    "Operation": {
+      "description": "CDN REST API operation",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "Operation name: {provider}/{resource}/{operation}",
+          "readOnly": true,
+          "type": "string"
+        },
+        "display": {
+          "description": "The object that represents the operation.",
+          "properties": {
+            "provider": {
+              "description": "Service provider: Microsoft.Cdn",
+              "readOnly": true,
+              "type": "string"
+            },
+            "resource": {
+              "description": "Resource on which the operation is performed: Profile, endpoint, etc.",
+              "readOnly": true,
+              "type": "string"
+            },
+            "operation": {
+              "description": "Operation type: Read, write, delete, etc.",
+              "readOnly": true,
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "OperationsListResult": {
+      "description": "Result of the request to list CDN operations. It contains a list of operations and a URL link to get the next set of results.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/Operation"
+          },
+          "description": "List of CDN operations supported by the CDN resource provider."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of operation list results if there are any."
+        }
+      }
+    },
+    "EdgenodeResult": {
+      "description": "Result of the request to list CDN edgenodes. It contains a list of ip address group and a URL link to get the next set of results.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/EdgeNode"
+          },
+          "description": "Edge node of CDN service."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of edgenode list results if there are any."
+        }
+      }
+    },
+    "EdgeNode": {
+      "description": "Edgenode is a global Point of Presence (POP) location used to deliver CDN content to end users.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ProxyResource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/EdgeNodeProperties"
+        }
+      }
+    },
+    "EdgeNodeProperties": {
+      "description": "The JSON object that contains the properties required to create an edgenode.",
+      "required": [
+        "ipAddressGroups"
+      ],
+      "properties": {
+        "ipAddressGroups": {
+          "description": "List of ip address groups.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/IpAddressGroup"
+          }
+        }
+      }
+    },
+    "IpAddressGroup": {
+      "description": "CDN Ip address group",
+      "type": "object",
+      "properties": {
+        "deliveryRegion": {
+          "description": "The delivery region of the ip address group",
+          "type": "string"
+        },
+        "ipv4Addresses": {
+          "description": "The list of ip v4 addresses.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/cidrIpAddress"
+          }
+        },
+        "ipv6Addresses": {
+          "description": "The list of ip v6 addresses.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/cidrIpAddress"
+          }
+        }
+      }
+    },
+    "cidrIpAddress": {
+      "description": "CIDR Ip address",
+      "type": "object",
+      "properties": {
+        "baseIpAddress": {
+          "description": "Ip address itself.",
+          "type": "string"
+        },
+        "prefixLength": {
+          "description": "The length of the prefix of the ip address.",
+          "type": "integer"
+        }
+      }
+    },
+    "Resource": {
+      "description": "The core properties of ARM resources",
+      "properties": {
+        "id": {
+          "description": "Resource ID.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "name": {
+          "description": "Resource name.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "type": {
+          "description": "Resource type.",
+          "readOnly": true,
+          "type": "string"
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "TrackedResource": {
+      "description": "The resource model definition for a ARM tracked top level resource.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/Resource"
+        }
+      ],
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "Resource location."
+        },
+        "tags": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "x-ms-mutability": [
+            "read",
+            "create",
+            "update"
+          ],
+          "description": "Resource tags."
+        }
+      },
+      "required": [
+        "location"
+      ]
+    },
+    "ProxyResource": {
+      "description": "The resource model definition for a ARM proxy resource. It will have everything other than required location and tags",
+      "allOf": [
+        {
+          "$ref": "#/definitions/Resource"
+        }
+      ]
+    },
+    "QueryStringCachingBehavior": {
+      "description": "Defines how CDN caches requests that include query strings. You can ignore any query strings when caching, bypass caching to prevent requests that contain query strings from being cached, or cache every request with a unique URL.",
+      "enum": [
+        "IgnoreQueryString",
+        "BypassCaching",
+        "UseQueryString",
+        "NotSet"
+      ],
+      "type": "string",
+      "x-ms-enum": {
+        "name": "QueryStringCachingBehavior",
+        "modelAsString": false
+      }
+    },
+    "Sku": {
+      "description": "The pricing tier (defines a CDN provider, feature list and rate) of the CDN profile.",
+      "properties": {
+        "name": {
+          "description": "Name of the pricing tier.",
+          "enum": [
+            "Standard_Verizon",
+            "Premium_Verizon",
+            "Custom_Verizon",
+            "Standard_Akamai",
+            "Standard_ChinaCdn",
+            "Standard_Microsoft",
+            "Premium_ChinaCdn"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "SkuName",
+            "modelAsString": true
+          }
+        }
+      },
+      "type": "object"
+    },
+    "OptimizationType": {
+      "description": "Specifies what scenario the customer wants this CDN endpoint to optimize, e.g. Download, Media services. With this information we can apply scenario driven optimization.",
+      "enum": [
+        "GeneralWebDelivery",
+        "GeneralMediaStreaming",
+        "VideoOnDemandMediaStreaming",
+        "LargeFileDownload",
+        "DynamicSiteAcceleration"
+      ],
+      "type": "string",
+      "x-ms-enum": {
+        "name": "OptimizationType",
+        "modelAsString": true
+      }
+    },
+    "ErrorResponse": {
+      "description": "Error response indicates CDN service is not able to process the incoming request. The reason is provided in the error message.",
+      "type": "object",
+      "properties": {
+        "code": {
+          "description": "Error code.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "message": {
+          "description": "Error message indicating why the operation failed.",
+          "readOnly": true,
+          "type": "string"
+        }
+      }
+    }
+  },
+  "parameters": {
+    "subscriptionIdParameter": {
+      "name": "subscriptionId",
+      "in": "path",
+      "description": "Azure Subscription ID.",
+      "required": true,
+      "type": "string"
+    },
+    "apiVersionParameter": {
+      "name": "api-version",
+      "in": "query",
+      "required": true,
+      "type": "string",
+      "description": "Version of the API to be used with the client request. Current version is 2017-04-02."
+    },
+    "resourceGroupNameParameter": {
+      "name": "resourceGroupName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "pattern": "^[-\\w\\._\\(\\)]+$",
+      "minLength": 1,
+      "maxLength": 90,
+      "x-ms-parameter-location": "method",
+      "description": "Name of the Resource group within the Azure subscription."
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/cdnwebapplicationfirewall.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/cdnwebapplicationfirewall.json
new file mode 100644
index 000000000000..5dd299660337
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/cdnwebapplicationfirewall.json
@@ -0,0 +1,926 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "version": "2019-06-15",
+    "title": "Azure CDN WebApplicationFirewallManagement",
+    "description": "APIs to manage web application firewall rules for Azure CDN"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies": {
+      "get": {
+        "tags": [
+          "WebApplicationFirewallPolicies"
+        ],
+        "description": "Lists all of the protection policies within a resource group.",
+        "operationId": "Policies_List",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/CdnWebApplicationFirewallPolicyList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./cdn.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-examples": {
+          "List Policies in a Resource Group": {
+            "$ref": "./examples/WafListPolicies.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/{policyName}": {
+      "get": {
+        "tags": [
+          "WebApplicationFirewallPolicies"
+        ],
+        "description": "Retrieve protection policy with specified name within a resource group.",
+        "operationId": "Policies_Get",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/PolicyNameParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/CdnWebApplicationFirewallPolicy"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./cdn.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Get Policy": {
+            "$ref": "./examples/WafPolicyGet.json"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "WebApplicationFirewallPolicies"
+        ],
+        "description": "Create or update policy with specified rule set name within a resource group.",
+        "operationId": "Policies_CreateOrUpdate",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/PolicyNameParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "description": "Policy to be created.",
+            "in": "body",
+            "name": "cdnWebApplicationFirewallPolicy",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/CdnWebApplicationFirewallPolicy"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/CdnWebApplicationFirewallPolicy"
+            }
+          },
+          "201": {
+            "description": "Created. The request has been fulfilled and a new protection policy has been created.",
+            "schema": {
+              "$ref": "#/definitions/CdnWebApplicationFirewallPolicy"
+            }
+          },
+          "202": {
+            "description": "Accepted. The request has been accepted for processing and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/CdnWebApplicationFirewallPolicy"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./cdn.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Creates specific policy": {
+            "$ref": "./examples/WafPolicyCreateOrUpdate.json"
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "patch": {
+        "tags": [
+          "WebApplicationFirewallPolicies"
+        ],
+        "description": "Update an existing CdnWebApplicationFirewallPolicy with the specified policy name under the specified subscription and resource group",
+        "operationId": "Policies_Update",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/PolicyNameParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "description": "CdnWebApplicationFirewallPolicy parameters to be patched.",
+            "in": "body",
+            "name": "cdnWebApplicationFirewallPolicyPatchParameters",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/CdnWebApplicationFirewallPolicyPatchParameters"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/CdnWebApplicationFirewallPolicy"
+            }
+          },
+          "202": {
+            "description": "Accepted. The request has been accepted for processing and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/CdnWebApplicationFirewallPolicy"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./cdn.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Creates specific policy": {
+            "$ref": "./examples/WafPatchPolicy.json"
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "delete": {
+        "tags": [
+          "WebApplicationFirewallPolicies"
+        ],
+        "description": "Deletes Policy",
+        "operationId": "Policies_Delete",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/PolicyNameParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Delete successful."
+          },
+          "204": {
+            "description": "No Content. The request has been accepted but the policy was not found."
+          }
+        },
+        "x-ms-examples": {
+          "Delete protection policy": {
+            "$ref": "./examples/WafPolicyDelete.json"
+          }
+        },
+        "x-ms-long-running-operation": false
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Cdn/CdnWebApplicationFirewallManagedRuleSets": {
+      "get": {
+        "tags": [
+          "WebApplicationFirewallManagedRuleSets"
+        ],
+        "description": "Lists all available managed rule sets.",
+        "operationId": "ManagedRuleSets_List",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success. The operation returns a list of all available web application firewall managed rule sets.",
+            "schema": {
+              "$ref": "#/definitions/ManagedRuleSetDefinitionList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./cdn.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-examples": {
+          "List Policies in a Resource Group": {
+            "$ref": "./examples/WafListManagedRuleSets.json"
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "CdnWebApplicationFirewallPolicyList": {
+      "description": "Defines a list of WebApplicationFirewallPolicies for Azure CDN. It contains a list of WebApplicationFirewallPolicy objects and a URL link to get the next set of results.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/CdnWebApplicationFirewallPolicy"
+          },
+          "description": "List of Azure CDN WebApplicationFirewallPolicies within a resource group."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of WebApplicationFirewallPolicy objects if there are any."
+        }
+      }
+    },
+    "CdnWebApplicationFirewallPolicy": {
+      "description": "Defines web application firewall policy for Azure CDN.",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "Properties of the web application firewall policy.",
+          "$ref": "#/definitions/CdnWebApplicationFirewallPolicyProperties"
+        },
+        "etag": {
+          "type": "string",
+          "description": "Gets a unique read-only string that changes whenever the resource is updated."
+        },
+        "sku": {
+          "description": "The pricing tier (defines a CDN provider, feature list and rate) of the CdnWebApplicationFirewallPolicy.",
+          "$ref": "./cdn.json#/definitions/Sku"
+        }
+      },
+      "required": [
+        "sku"
+      ],
+      "allOf": [
+        {
+          "$ref": "./cdn.json#/definitions/TrackedResource"
+        }
+      ]
+    },
+    "CdnWebApplicationFirewallPolicyPatchParameters": {
+      "type": "object",
+      "description": "Properties required to update a CdnWebApplicationFirewallPolicy.",
+      "properties": {
+        "tags": {
+          "description": "CdnWebApplicationFirewallPolicy tags",
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "CdnWebApplicationFirewallPolicyProperties": {
+      "description": "Defines CDN web application firewall policy properties.",
+      "properties": {
+        "policySettings": {
+          "description": "Describes  policySettings for policy",
+          "$ref": "#/definitions/policySettings"
+        },
+        "rateLimitRules": {
+          "description": "Describes rate limit rules inside the policy.",
+          "$ref": "#/definitions/RateLimitRuleList"
+        },
+        "customRules": {
+          "description": "Describes custom rules inside the policy.",
+          "$ref": "#/definitions/CustomRuleList"
+        },
+        "managedRules": {
+          "description": "Describes managed rules inside the policy.",
+          "$ref": "#/definitions/ManagedRuleSetList"
+        },
+        "endpointLinks": {
+          "description": "Describes Azure CDN endpoints associated with this Web Application Firewall policy.",
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/CdnEndpoint"
+          }
+        },
+        "provisioningState": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Provisioning state of the WebApplicationFirewallPolicy.",
+          "enum": [
+            "Creating",
+            "Succeeded",
+            "Failed"
+          ],
+          "x-ms-enum": {
+            "name": "ProvisioningState",
+            "modelAsString": true
+          }
+        },
+        "resourceState": {
+          "title": "Resource status of the policy.",
+          "readOnly": true,
+          "enum": [
+            "Creating",
+            "Enabling",
+            "Enabled",
+            "Disabling",
+            "Disabled",
+            "Deleting"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "PolicyResourceState",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "policySettings": {
+      "description": "Defines contents of a web application firewall global configuration",
+      "properties": {
+        "enabledState": {
+          "description": "describes if the policy is in enabled state or disabled state",
+          "type": "string",
+          "enum": [
+            "Disabled",
+            "Enabled"
+          ],
+          "x-ms-enum": {
+            "name": "PolicyEnabledState",
+            "modelAsString": true
+          }
+        },
+        "mode": {
+          "description": "Describes if it is in detection mode or prevention mode at policy level.",
+          "type": "string",
+          "enum": [
+            "Prevention",
+            "Detection"
+          ],
+          "x-ms-enum": {
+            "name": "PolicyMode",
+            "modelAsString": true
+          }
+        },
+        "defaultRedirectUrl": {
+          "description": "If action type is redirect, this field represents the default redirect URL for the client.",
+          "type": "string"
+        },
+        "defaultCustomBlockResponseStatusCode": {
+          "description": "If the action type is block, this field defines the default customer overridable http response status code.",
+          "type": "integer",
+          "enum": [
+            200,
+            403,
+            405,
+            406,
+            429
+          ]
+        },
+        "defaultCustomBlockResponseBody": {
+          "description": "If the action type is block, customer can override the response body. The body must be specified in base64 encoding.",
+          "type": "string",
+          "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{4})$"
+        }
+      }
+    },
+    "CdnEndpoint": {
+      "description": "Defines the ARM Resource ID for the linked endpoints",
+      "type": "object",
+      "readOnly": true,
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "ARM Resource ID string."
+        }
+      }
+    },
+    "CustomRuleList": {
+      "description": "Defines contents of custom rules",
+      "properties": {
+        "rules": {
+          "description": "List of rules",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/CustomRule"
+          }
+        }
+      }
+    },
+    "CustomRule": {
+      "description": "Defines the common attributes for a custom rule that can be included in a waf policy",
+      "type": "object",
+      "required": [
+        "name",
+        "priority",
+        "matchConditions",
+        "action"
+      ],
+      "properties": {
+        "name": {
+          "description": "Defines the name of the custom rule",
+          "type": "string"
+        },
+        "enabledState": {
+          "description": "Describes if the custom rule is in enabled or disabled state. Defaults to Enabled if not specified.",
+          "type": "string",
+          "enum": [
+            "Disabled",
+            "Enabled"
+          ],
+          "x-ms-enum": {
+            "name": "CustomRuleEnabledState",
+            "modelAsString": true
+          }
+        },
+        "priority": {
+          "description": "Defines in what order this rule be evaluated in the overall list of custom rules",
+          "type": "integer",
+          "maximum": 1000,
+          "exclusiveMaximum": false,
+          "minimum": 0,
+          "exclusiveMinimum": false
+        },
+        "matchConditions": {
+          "description": "List of match conditions.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/MatchCondition"
+          }
+        },
+        "action": {
+          "description": "Describes what action to be applied when rule matches",
+          "$ref": "#/definitions/ActionType"
+        }
+      }
+    },
+    "RateLimitRuleList": {
+      "description": "Defines contents of rate limit rules",
+      "properties": {
+        "rules": {
+          "description": "List of rules",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/RateLimitRule"
+          }
+        }
+      }
+    },
+    "RateLimitRule": {
+      "description": "Defines a rate limiting rule that can be included in a waf policy",
+      "type": "object",
+      "required": [
+        "rateLimitThreshold",
+        "rateLimitDurationInMinutes"
+      ],
+      "properties": {
+        "rateLimitThreshold": {
+          "description": "Defines rate limit threshold.",
+          "type": "integer",
+          "minimum": 0,
+          "exclusiveMinimum": false
+        },
+        "rateLimitDurationInMinutes": {
+          "description": "Defines rate limit duration. Default is 1 minute.",
+          "type": "integer",
+          "maximum": 60,
+          "exclusiveMaximum": false,
+          "minimum": 0,
+          "exclusiveMinimum": false
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/CustomRule"
+        }
+      ]
+    },
+    "MatchCondition": {
+      "description": "Define match conditions",
+      "required": [
+        "matchVariable",
+        "operator",
+        "matchValue"
+      ],
+      "properties": {
+        "matchVariable": {
+          "description": "Match variable to compare against.",
+          "type": "string",
+          "enum": [
+            "RemoteAddr",
+            "SocketAddr",
+            "RequestMethod",
+            "RequestHeader",
+            "RequestUri",
+            "QueryString",
+            "RequestBody",
+            "Cookies",
+            "PostArgs"
+          ],
+          "x-ms-enum": {
+            "name": "MatchVariable",
+            "modelAsString": true
+          }
+        },
+        "selector": {
+          "description": "Selector can used to match a specific key for QueryString, Cookies, RequestHeader or PostArgs.",
+          "type": "string"
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "IPMatch",
+            "GeoMatch",
+            "Equal",
+            "Contains",
+            "LessThan",
+            "GreaterThan",
+            "LessThanOrEqual",
+            "GreaterThanOrEqual",
+            "BeginsWith",
+            "EndsWith",
+            "RegEx"
+          ],
+          "x-ms-enum": {
+            "name": "operator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if the result of this condition should be negated.",
+          "type": "boolean"
+        },
+        "matchValue": {
+          "description": "List of possible match values.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/TransformType"
+          }
+        }
+      }
+    },
+    "TransformType": {
+      "description": "Describes what transforms were applied before matching.",
+      "type": "string",
+      "enum": [
+        "Lowercase",
+        "Uppercase",
+        "Trim",
+        "UrlDecode",
+        "UrlEncode",
+        "RemoveNulls"
+      ],
+      "x-ms-enum": {
+        "name": "TransformType",
+        "modelAsString": true
+      }
+    },
+    "ManagedRuleSetList": {
+      "description": "Defines the list of managed rule sets for the policy.",
+      "properties": {
+        "managedRuleSets": {
+          "description": "List of rule sets.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ManagedRuleSet"
+          }
+        }
+      }
+    },
+    "ManagedRuleSet": {
+      "type": "object",
+      "description": "Defines a managed rule set.",
+      "required": [
+        "ruleSetType",
+        "ruleSetVersion"
+      ],
+      "properties": {
+        "ruleSetType": {
+          "description": "Defines the rule set type to use.",
+          "type": "string"
+        },
+        "ruleSetVersion": {
+          "description": "Defines the version of the rule set to use.",
+          "type": "string"
+        },
+        "anomalyScore": {
+          "description": "Verizon only : If the rule set supports anomaly detection mode, this describes the threshold for blocking requests.",
+          "type": "integer",
+          "maximum": 20,
+          "exclusiveMaximum": false,
+          "minimum": 0,
+          "exclusiveMinimum": false
+        },
+        "ruleGroupOverrides": {
+          "description": "Defines the rule overrides to apply to the rule set.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ManagedRuleGroupOverride"
+          }
+        }
+      }
+    },
+    "ManagedRuleGroupOverride": {
+      "description": "Defines a managed rule group override setting.",
+      "required": [
+        "ruleGroupName"
+      ],
+      "properties": {
+        "ruleGroupName": {
+          "description": "Describes the managed rule group within the rule set to override",
+          "type": "string"
+        },
+        "rules": {
+          "description": "List of rules that will be disabled. If none specified, all rules in the group will be disabled.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ManagedRuleOverride"
+          }
+        }
+      }
+    },
+    "ManagedRuleOverride": {
+      "description": "Defines a managed rule group override setting.",
+      "required": [
+        "ruleId"
+      ],
+      "properties": {
+        "ruleId": {
+          "description": "Identifier for the managed rule.",
+          "type": "string"
+        },
+        "enabledState": {
+          "description": "Describes if the managed rule is in enabled or disabled state. Defaults to Disabled if not specified.",
+          "type": "string",
+          "enum": [
+            "Disabled",
+            "Enabled"
+          ],
+          "x-ms-enum": {
+            "name": "ManagedRuleEnabledState",
+            "modelAsString": true
+          }
+        },
+        "action": {
+          "description": "Describes the override action to be applied when rule matches.",
+          "$ref": "#/definitions/ActionType"
+        }
+      }
+    },
+    "ManagedRuleSetDefinitionList": {
+      "description": "List of managed rule set definitions available for use in a policy.",
+      "properties": {
+        "value": {
+          "description": "List of managed rule set definitions.",
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ManagedRuleSetDefinition"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to retrieve next set of managed rule set definitions."
+        }
+      }
+    },
+    "ManagedRuleSetDefinition": {
+      "description": "Describes a managed rule set definition.",
+      "properties": {
+        "properties": {
+          "description": "Describes managed rule set definition properties.",
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ManagedRuleSetDefinitionProperties"
+        },
+        "sku": {
+          "description": "The pricing tier (defines a CDN provider, feature list and rate) of the CdnWebApplicationFirewallPolicy.",
+          "$ref": "./cdn.json#/definitions/Sku"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./cdn.json#/definitions/Resource"
+        }
+      ]
+    },
+    "ManagedRuleSetDefinitionProperties": {
+      "description": "Properties for a managed rule set definition.",
+      "properties": {
+        "provisioningState": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Provisioning state of the managed rule set."
+        },
+        "ruleSetType": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Type of the managed rule set."
+        },
+        "ruleSetVersion": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Version of the managed rule set type."
+        },
+        "ruleGroups": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/ManagedRuleGroupDefinition"
+          },
+          "description": "Rule groups of the managed rule set."
+        }
+      }
+    },
+    "ManagedRuleGroupDefinition": {
+      "description": "Describes a managed rule group.",
+      "properties": {
+        "ruleGroupName": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Name of the managed rule group."
+        },
+        "description": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Description of the managed rule group."
+        },
+        "rules": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/ManagedRuleDefinition"
+          },
+          "description": "List of rules within the managed rule group."
+        }
+      }
+    },
+    "ManagedRuleDefinition": {
+      "description": "Describes a managed rule definition.",
+      "properties": {
+        "ruleId": {
+          "description": "Identifier for the managed rule.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "description": {
+          "description": "Describes the functionality of the managed rule.",
+          "readOnly": true,
+          "type": "string"
+        }
+      }
+    },
+    "ActionType": {
+      "description": "Defines the action to take on rule match.",
+      "type": "string",
+      "enum": [
+        "Allow",
+        "Block",
+        "Log",
+        "Redirect"
+      ],
+      "x-ms-enum": {
+        "name": "ActionType",
+        "modelAsString": true
+      }
+    }
+  },
+  "parameters": {
+    "SubscriptionIdParameter": {
+      "name": "subscriptionId",
+      "in": "path",
+      "description": "Azure Subscription ID.",
+      "required": true,
+      "type": "string"
+    },
+    "ApiVersionParameter": {
+      "name": "api-version",
+      "in": "query",
+      "required": true,
+      "type": "string",
+      "description": "Version of the API to be used with the client request. Current version is 2017-04-02."
+    },
+    "PolicyNameParameter": {
+      "name": "policyName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "maxLength": 128,
+      "x-ms-parameter-location": "method",
+      "description": "The name of the CdnWebApplicationFirewallPolicy."
+    },
+    "ResourceGroupNameParameter": {
+      "name": "resourceGroupName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "pattern": "^[a-zA-Z0-9_\\-\\(\\)\\.]*[^\\.]$",
+      "minLength": 1,
+      "maxLength": 80,
+      "x-ms-parameter-location": "method",
+      "description": "Name of the Resource group within the Azure subscription."
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CheckNameAvailability.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CheckNameAvailability.json
new file mode 100644
index 000000000000..2b96a7206b92
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CheckNameAvailability.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "checkNameAvailabilityInput": {
+      "name": "sampleName",
+      "type": "Microsoft.Cdn/Profiles/Endpoints"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "nameAvailable": false,
+        "reason": "Name is already in use",
+        "message": "Name not available"
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CheckNameAvailabilityWithSubscription.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CheckNameAvailabilityWithSubscription.json
new file mode 100644
index 000000000000..c0c3b1b13ad7
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CheckNameAvailabilityWithSubscription.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "checkNameAvailabilityInput": {
+      "name": "sampleName",
+      "type": "Microsoft.Cdn/Profiles/Endpoints"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "nameAvailable": false,
+        "reason": "Name is already in use",
+        "message": "Name not available"
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CustomDomains_Create.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CustomDomains_Create.json
new file mode 100644
index 000000000000..8929b9d3daa4
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CustomDomains_Create.json
@@ -0,0 +1,62 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "customDomainName": "www-someDomain-net",
+    "customDomainProperties": {
+      "properties": {
+        "hostName": "www.someDomain.net"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "www-someDomain-net",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "customHttpsProvisioningState": "Enabling",
+          "customHttpsProvisioningSubstate": "PendingDomainControlValidationREquestApproval",
+          "validationData": null
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "name": "www-someDomain-net",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "customHttpsProvisioningState": "Enabling",
+          "customHttpsProvisioningSubstate": "PendingDomainControlValidationREquestApproval",
+          "validationData": null
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "www-someDomain-net",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "customHttpsProvisioningState": "Enabling",
+          "customHttpsProvisioningSubstate": "PendingDomainControlValidationREquestApproval",
+          "validationData": null
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CustomDomains_Delete.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CustomDomains_Delete.json
new file mode 100644
index 000000000000..1763355d6bd9
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CustomDomains_Delete.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "customDomainName": "www-someDomain-net"
+  },
+  "responses": {
+    "200": {},
+    "202": {
+      "body": {
+        "name": "www-someDomain-net",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "customHttpsProvisioningState": "Enabling",
+          "customHttpsProvisioningSubstate": "PendingDomainControlValidationREquestApproval",
+          "validationData": null
+        }
+      }
+    },
+    "204": {}
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CustomDomains_DisableCustomHttps.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CustomDomains_DisableCustomHttps.json
new file mode 100644
index 000000000000..f1d21c2526f9
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CustomDomains_DisableCustomHttps.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "customDomainName": "www-someDomain-net"
+  },
+  "responses": {
+    "200": {},
+    "202": {
+      "body": {
+        "name": "www-someDomain-net",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "customHttpsProvisioningState": "Enabling",
+          "customHttpsProvisioningSubstate": "PendingDomainControlValidationREquestApproval",
+          "validationData": null
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CustomDomains_EnableCustomHttpsUsingBYOC.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CustomDomains_EnableCustomHttpsUsingBYOC.json
new file mode 100644
index 000000000000..68f5dd4d2b3a
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CustomDomains_EnableCustomHttpsUsingBYOC.json
@@ -0,0 +1,42 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "customDomainName": "www-someDomain-net",
+    "customHttpsParameters": {
+      "certificateSource": "AzureKeyVault",
+      "protocolType": "ServerNameIndication",
+      "certificateSourceParameters": {
+        "OData.type": "#Microsoft.Azure.Cdn.Models.KeyVaultCertificateSourceParameters",
+        "subscriptionId": "subid",
+        "resourceGroupName": "RG",
+        "vaultName": "kv",
+        "secretName": "secret1",
+        "secretVersion": "00000000-0000-0000-0000-000000000000",
+        "updateRule": "NoAction",
+        "deleteRule": "NoAction"
+      }
+    }
+  },
+  "responses": {
+    "200": {},
+    "202": {
+      "body": {
+        "name": "www-someDomain-net",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "customHttpsProvisioningState": "Enabling",
+          "customHttpsProvisioningSubstate": "PendingDomainControlValidationREquestApproval",
+          "validationData": "validationdata"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate.json
new file mode 100644
index 000000000000..72580d85a0fe
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate.json
@@ -0,0 +1,36 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "customDomainName": "www-someDomain-net",
+    "customHttpsParameters": {
+      "certificateSource": "Cdn",
+      "protocolType": "ServerNameIndication",
+      "certificateSourceParameters": {
+        "OData.type": "#Microsoft.Azure.Cdn.Models.CdnCertificateSourceParameters",
+        "certificateType": "Shared"
+      }
+    }
+  },
+  "responses": {
+    "200": {},
+    "202": {
+      "body": {
+        "name": "www-someDomain-net",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "customHttpsProvisioningState": "Enabling",
+          "customHttpsProvisioningSubstate": "PendingDomainControlValidationREquestApproval",
+          "validationData": "validationdata"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CustomDomains_Get.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CustomDomains_Get.json
new file mode 100644
index 000000000000..14bd1123ab53
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CustomDomains_Get.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "customDomainName": "www-someDomain-net"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "www-someDomain-net",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "customHttpsProvisioningState": "Disabled",
+          "customHttpsProvisioningSubstate": "None",
+          "validationData": null
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CustomDomains_ListByEndpoint.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CustomDomains_ListByEndpoint.json
new file mode 100644
index 000000000000..93eab948f18d
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/CustomDomains_ListByEndpoint.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "www-someDomain-net",
+            "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
+            "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
+            "properties": {
+              "provisioningState": "Succeeded",
+              "resourceState": "Active",
+              "hostName": "www.someDomain.net",
+              "customHttpsProvisioningState": "Disabled",
+              "customHttpsProvisioningSubstate": "None",
+              "validationData": null
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/EdgeNodes_List.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/EdgeNodes_List.json
new file mode 100644
index 000000000000..6a6392c86c0d
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/EdgeNodes_List.json
@@ -0,0 +1,107 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "Standard_Verizon",
+            "id": "/providers/Microsoft.Cdn/edgenodes/Standard_Verizon",
+            "type": "Microsoft.Cdn/edgenodes",
+            "properties": {
+              "ipAddressGroups": [
+                {
+                  "deliveryRegion": "All",
+                  "ipv4Addresses": [
+                    {
+                      "baseIpAddress": "192.229.176.0",
+                      "prefixLength": 24
+                    },
+                    {
+                      "baseIpAddress": "180.240.184.128",
+                      "prefixLength": 25
+                    },
+                    {
+                      "baseIpAddress": "152.195.27.0",
+                      "prefixLength": 24
+                    }
+                  ],
+                  "ipv6Addresses": [
+                    {
+                      "baseIpAddress": "2606:2800:60f2::",
+                      "prefixLength": 48
+                    },
+                    {
+                      "baseIpAddress": "2606:2800:700c::",
+                      "prefixLength": 48
+                    }
+                  ]
+                }
+              ]
+            }
+          },
+          {
+            "name": "Premium_Verizon",
+            "id": "/providers/Microsoft.Cdn/edgenodes/Premium_Verizon",
+            "type": "Microsoft.Cdn/edgenodes",
+            "properties": {
+              "ipAddressGroups": [
+                {
+                  "deliveryRegion": "All",
+                  "ipv4Addresses": [
+                    {
+                      "baseIpAddress": "192.229.176.0",
+                      "prefixLength": 24
+                    },
+                    {
+                      "baseIpAddress": "152.195.27.0",
+                      "prefixLength": 24
+                    }
+                  ],
+                  "ipv6Addresses": [
+                    {
+                      "baseIpAddress": "2606:2800:60f2::",
+                      "prefixLength": 48
+                    },
+                    {
+                      "baseIpAddress": "2606:2800:700c::",
+                      "prefixLength": 48
+                    }
+                  ]
+                }
+              ]
+            }
+          },
+          {
+            "name": "Custom_Verizon",
+            "id": "/providers/Microsoft.Cdn/edgenodes/Custom_Verizon",
+            "type": "Microsoft.Cdn/edgenodes",
+            "properties": {
+              "ipAddressGroups": [
+                {
+                  "deliveryRegion": "All",
+                  "ipv4Addresses": [
+                    {
+                      "baseIpAddress": "192.229.176.0",
+                      "prefixLength": 24
+                    },
+                    {
+                      "baseIpAddress": "2606:2800:420b::",
+                      "prefixLength": 48
+                    },
+                    {
+                      "baseIpAddress": "2606:2800:700c::",
+                      "prefixLength": 48
+                    }
+                  ]
+                }
+              ]
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_Create.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_Create.json
new file mode 100644
index 000000000000..90abc4a43fa2
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_Create.json
@@ -0,0 +1,377 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "endpoint": {
+      "properties": {
+        "originHostHeader": "www.bing.com",
+        "originPath": "/photos",
+        "contentTypesToCompress": [
+          "text/html",
+          "application/octet-stream"
+        ],
+        "isCompressionEnabled": true,
+        "isHttpAllowed": true,
+        "isHttpsAllowed": true,
+        "queryStringCachingBehavior": "BypassCaching",
+        "deliveryPolicy": {
+          "description": "Test description for a policy.",
+          "rules": [
+            {
+              "name": "rule1",
+              "order": 1,
+              "conditions": [
+                {
+                  "name": "RemoteAddress",
+                  "parameters": {
+                    "operator": "IPMatch",
+                    "negateCondition": true,
+                    "matchValues": [
+                      "192.168.1.0/24",
+                      "10.0.0.0/24"
+                    ],
+                    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRemoteAddressConditionParameters"
+                  }
+                }
+              ],
+              "actions": [
+                {
+                  "name": "CacheExpiration",
+                  "parameters": {
+                    "cacheBehavior": "Override",
+                    "cacheDuration": "10:10:09",
+                    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleCacheExpirationActionParameters",
+                    "cacheType": "All"
+                  }
+                },
+                {
+                  "name": "ModifyResponseHeader",
+                  "parameters": {
+                    "headerAction": "Overwrite",
+                    "headerName": "Access-Control-Allow-Origin",
+                    "value": "*",
+                    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleHeaderActionParameters"
+                  }
+                },
+                {
+                  "name": "ModifyRequestHeader",
+                  "parameters": {
+                    "headerAction": "Overwrite",
+                    "headerName": "Accept-Encoding",
+                    "value": "gzip",
+                    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleHeaderActionParameters"
+                  }
+                }
+              ]
+            }
+          ]
+        },
+        "origins": [
+          {
+            "name": "origin1",
+            "properties": {
+              "hostName": "host1.hello.com"
+            }
+          }
+        ],
+        "webApplicationFirewallPolicyLink": {
+          "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/cdnWafPolicy1"
+        }
+      },
+      "location": "WestUs",
+      "tags": {
+        "kay1": "value1"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "endpoint4899",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+        "type": "Microsoft.Cdn/profiles/endpoints",
+        "tags": {
+          "kay1": "value1"
+        },
+        "location": "WestUs",
+        "properties": {
+          "hostName": "endpoint4899.azureedge-test.net",
+          "originHostHeader": "www.bing.com",
+          "provisioningState": "Creating",
+          "resourceState": "Creating",
+          "isHttpAllowed": true,
+          "isHttpsAllowed": true,
+          "queryStringCachingBehavior": "BypassCaching",
+          "originPath": "/photos",
+          "origins": [
+            {
+              "name": "origin1",
+              "properties": {
+                "hostName": "host1.hello.com",
+                "httpPort": null,
+                "httpsPort": null
+              }
+            }
+          ],
+          "contentTypesToCompress": [
+            "text/html",
+            "application/octet-stream"
+          ],
+          "isCompressionEnabled": true,
+          "optimizationType": null,
+          "probePath": null,
+          "geoFilters": [],
+          "deliveryPolicy": {
+            "description": "Test description for a policy.",
+            "rules": [
+              {
+                "name": "rule1",
+                "order": 1,
+                "conditions": [
+                  {
+                    "name": "RemoteAddress",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRemoteAddressConditionParameters",
+                      "operator": "IPMatch",
+                      "negateCondition": true,
+                      "matchValues": [
+                        "192.168.1.0/24",
+                        "10.0.0.0/24"
+                      ],
+                      "transforms": []
+                    }
+                  }
+                ],
+                "actions": [
+                  {
+                    "name": "CacheExpiration",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleCacheExpirationActionParameters",
+                      "cacheBehavior": "Override",
+                      "cacheDuration": "10:10:09",
+                      "cacheType": "All"
+                    }
+                  },
+                  {
+                    "name": "ModifyResponseHeader",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleHeaderActionParameters",
+                      "headerAction": "Overwrite",
+                      "headerName": "Access-Control-Allow-Origin",
+                      "value": "*"
+                    }
+                  },
+                  {
+                    "name": "ModifyRequestHeader",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleHeaderActionParameters",
+                      "headerAction": "Overwrite",
+                      "headerName": "Accept-Encoding",
+                      "value": "gzip"
+                    }
+                  }
+                ]
+              }
+            ]
+          },
+          "webApplicationFirewallPolicyLink": {
+            "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/cdnWafPolicy1"
+          }
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "name": "endpoint4899",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+        "type": "Microsoft.Cdn/profiles/endpoints",
+        "tags": {
+          "kay1": "value1"
+        },
+        "location": "WestUs",
+        "properties": {
+          "hostName": "endpoint4899.azureedge-test.net",
+          "originHostHeader": "www.bing.com",
+          "provisioningState": "Creating",
+          "resourceState": "Creating",
+          "isHttpAllowed": true,
+          "isHttpsAllowed": true,
+          "queryStringCachingBehavior": "BypassCaching",
+          "originPath": "/photos",
+          "origins": [
+            {
+              "name": "origin1",
+              "properties": {
+                "hostName": "host1.hello.com",
+                "httpPort": null,
+                "httpsPort": null
+              }
+            }
+          ],
+          "contentTypesToCompress": [
+            "text/html",
+            "application/octet-stream"
+          ],
+          "isCompressionEnabled": true,
+          "optimizationType": null,
+          "probePath": null,
+          "geoFilters": [],
+          "deliveryPolicy": {
+            "description": "Test description for a policy.",
+            "rules": [
+              {
+                "name": "rule1",
+                "order": 1,
+                "conditions": [
+                  {
+                    "name": "RemoteAddress",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRemoteAddressConditionParameters",
+                      "operator": "IPMatch",
+                      "negateCondition": true,
+                      "matchValues": [
+                        "192.168.1.0/24",
+                        "10.0.0.0/24"
+                      ],
+                      "transforms": []
+                    }
+                  }
+                ],
+                "actions": [
+                  {
+                    "name": "CacheExpiration",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleCacheExpirationActionParameters",
+                      "cacheBehavior": "Override",
+                      "cacheDuration": "10:10:09",
+                      "cacheType": "All"
+                    }
+                  },
+                  {
+                    "name": "ModifyResponseHeader",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleHeaderActionParameters",
+                      "headerAction": "Overwrite",
+                      "headerName": "Access-Control-Allow-Origin",
+                      "value": "*"
+                    }
+                  },
+                  {
+                    "name": "ModifyRequestHeader",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleHeaderActionParameters",
+                      "headerAction": "Overwrite",
+                      "headerName": "Accept-Encoding",
+                      "value": "gzip"
+                    }
+                  }
+                ]
+              }
+            ]
+          },
+          "webApplicationFirewallPolicyLink": {
+            "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/cdnWafPolicy1"
+          }
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "endpoint4899",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+        "type": "Microsoft.Cdn/profiles/endpoints",
+        "tags": {
+          "kay1": "value1"
+        },
+        "location": "WestUs",
+        "properties": {
+          "hostName": "endpoint4899.azureedge-test.net",
+          "originHostHeader": "www.bing.com",
+          "provisioningState": "Creating",
+          "resourceState": "Creating",
+          "isHttpAllowed": true,
+          "isHttpsAllowed": true,
+          "queryStringCachingBehavior": "BypassCaching",
+          "originPath": "/photos",
+          "origins": [
+            {
+              "name": "origin1",
+              "properties": {
+                "hostName": "host1.hello.com",
+                "httpPort": null,
+                "httpsPort": null
+              }
+            }
+          ],
+          "contentTypesToCompress": [
+            "text/html",
+            "application/octet-stream"
+          ],
+          "isCompressionEnabled": true,
+          "optimizationType": null,
+          "probePath": null,
+          "geoFilters": [],
+          "deliveryPolicy": {
+            "description": "Test description for a policy.",
+            "rules": [
+              {
+                "name": "rule1",
+                "order": 1,
+                "conditions": [
+                  {
+                    "name": "RemoteAddress",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRemoteAddressConditionParameters",
+                      "operator": "IPMatch",
+                      "negateCondition": true,
+                      "matchValues": [
+                        "192.168.1.0/24",
+                        "10.0.0.0/24"
+                      ],
+                      "transforms": []
+                    }
+                  }
+                ],
+                "actions": [
+                  {
+                    "name": "CacheExpiration",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleCacheExpirationActionParameters",
+                      "cacheBehavior": "Override",
+                      "cacheDuration": "10:10:09",
+                      "cacheType": "All"
+                    }
+                  },
+                  {
+                    "name": "ModifyResponseHeader",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleHeaderActionParameters",
+                      "headerAction": "Overwrite",
+                      "headerName": "Access-Control-Allow-Origin",
+                      "value": "*"
+                    }
+                  },
+                  {
+                    "name": "ModifyRequestHeader",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleHeaderActionParameters",
+                      "headerAction": "Overwrite",
+                      "headerName": "Accept-Encoding",
+                      "value": "gzip"
+                    }
+                  }
+                ]
+              }
+            ]
+          },
+          "webApplicationFirewallPolicyLink": {
+            "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/cdnWafPolicy1"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_Delete.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_Delete.json
new file mode 100644
index 000000000000..95f06c69a84c
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_Delete.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1"
+  },
+  "responses": {
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_Get.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_Get.json
new file mode 100644
index 000000000000..d526f887045f
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_Get.json
@@ -0,0 +1,48 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "endpoint1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+        "type": "Microsoft.Cdn/profiles/endpoints",
+        "tags": {},
+        "location": "CentralUs",
+        "properties": {
+          "hostName": "endpoint1.azureedge.net",
+          "originHostHeader": "www.bing.com",
+          "provisioningState": "Succeeded",
+          "resourceState": "Running",
+          "isHttpAllowed": true,
+          "isHttpsAllowed": true,
+          "queryStringCachingBehavior": "NotSet",
+          "originPath": null,
+          "origins": [
+            {
+              "name": "www-bing-com",
+              "properties": {
+                "hostName": "www.bing.com",
+                "httpPort": 80,
+                "httpsPort": 443
+              }
+            }
+          ],
+          "contentTypesToCompress": [],
+          "isCompressionEnabled": false,
+          "optimizationType": "DynamicSiteAcceleration",
+          "probePath": "/image",
+          "geoFilters": [],
+          "webApplicationFirewallPolicyLink": {
+            "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/cdnWafPolicy1"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_ListByProfile.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_ListByProfile.json
new file mode 100644
index 000000000000..9c8811f1a5a2
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_ListByProfile.json
@@ -0,0 +1,49 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "endpoint1",
+            "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+            "type": "Microsoft.Cdn/profiles/endpoints",
+            "tags": {},
+            "location": "CentralUs",
+            "properties": {
+              "hostName": "endpoint1.azureedge.net",
+              "originHostHeader": "www.bing.com",
+              "provisioningState": "Succeeded",
+              "resourceState": "Running",
+              "isHttpAllowed": true,
+              "isHttpsAllowed": true,
+              "queryStringCachingBehavior": "NotSet",
+              "originPath": null,
+              "origins": [
+                {
+                  "name": "www-bing-com",
+                  "properties": {
+                    "hostName": "www.bing.com",
+                    "httpPort": 80,
+                    "httpsPort": 443
+                  }
+                }
+              ],
+              "contentTypesToCompress": [],
+              "isCompressionEnabled": false,
+              "optimizationType": "DynamicSiteAcceleration",
+              "probePath": "/image",
+              "geoFilters": [],
+              "webApplicationFirewallPolicyLink": null
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_ListResourceUsage.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_ListResourceUsage.json
new file mode 100644
index 000000000000..896e73cbf94c
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_ListResourceUsage.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "resourceType": "customdomain",
+            "unit": "count",
+            "currentValue": 1,
+            "limit": 20
+          },
+          {
+            "resourceType": "geofilter",
+            "unit": "count",
+            "currentValue": 0,
+            "limit": 25
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_LoadContent.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_LoadContent.json
new file mode 100644
index 000000000000..ab4ce8b77ff4
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_LoadContent.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "contentFilePaths": {
+      "contentPaths": [
+        "/folder1"
+      ]
+    }
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_PurgeContent.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_PurgeContent.json
new file mode 100644
index 000000000000..ab4ce8b77ff4
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_PurgeContent.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "contentFilePaths": {
+      "contentPaths": [
+        "/folder1"
+      ]
+    }
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_Start.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_Start.json
new file mode 100644
index 000000000000..95393054d8aa
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_Start.json
@@ -0,0 +1,85 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "endpoint4899",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+        "type": "Microsoft.Cdn/profiles/endpoints",
+        "tags": {
+          "kay1": "value1"
+        },
+        "location": "WestUs",
+        "properties": {
+          "hostName": "endpoint1.azureedge.net",
+          "originHostHeader": "www.bing.com",
+          "provisioningState": "Succeeded",
+          "resourceState": "Starting",
+          "isHttpAllowed": true,
+          "isHttpsAllowed": true,
+          "queryStringCachingBehavior": "NotSet",
+          "originPath": null,
+          "origins": [
+            {
+              "name": "www-bing-com",
+              "properties": {
+                "hostName": "www.bing.com",
+                "httpPort": 80,
+                "httpsPort": 443
+              }
+            }
+          ],
+          "contentTypesToCompress": [],
+          "isCompressionEnabled": false,
+          "optimizationType": "DynamicSiteAcceleration",
+          "probePath": "/image",
+          "geoFilters": [],
+          "webApplicationFirewallPolicyLink": null
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "endpoint4899",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+        "type": "Microsoft.Cdn/profiles/endpoints",
+        "tags": {
+          "kay1": "value1"
+        },
+        "location": "WestUs",
+        "properties": {
+          "hostName": "endpoint1.azureedge.net",
+          "originHostHeader": "www.bing.com",
+          "provisioningState": "Succeeded",
+          "resourceState": "Starting",
+          "isHttpAllowed": true,
+          "isHttpsAllowed": true,
+          "queryStringCachingBehavior": "NotSet",
+          "originPath": null,
+          "origins": [
+            {
+              "name": "www-bing-com",
+              "properties": {
+                "hostName": "www.bing.com",
+                "httpPort": 80,
+                "httpsPort": 443
+              }
+            }
+          ],
+          "contentTypesToCompress": [],
+          "isCompressionEnabled": false,
+          "optimizationType": "DynamicSiteAcceleration",
+          "probePath": "/image",
+          "geoFilters": [],
+          "webApplicationFirewallPolicyLink": null
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_Stop.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_Stop.json
new file mode 100644
index 000000000000..64d81d581402
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_Stop.json
@@ -0,0 +1,85 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "endpoint4899",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+        "type": "Microsoft.Cdn/profiles/endpoints",
+        "tags": {
+          "kay1": "value1"
+        },
+        "location": "WestUs",
+        "properties": {
+          "hostName": "endpoint1.azureedge.net",
+          "originHostHeader": "www.bing.com",
+          "provisioningState": "Succeeded",
+          "resourceState": "Stopping",
+          "isHttpAllowed": true,
+          "isHttpsAllowed": true,
+          "queryStringCachingBehavior": "NotSet",
+          "originPath": null,
+          "origins": [
+            {
+              "name": "www-bing-com",
+              "properties": {
+                "hostName": "www.bing.com",
+                "httpPort": 80,
+                "httpsPort": 443
+              }
+            }
+          ],
+          "contentTypesToCompress": [],
+          "isCompressionEnabled": false,
+          "optimizationType": "DynamicSiteAcceleration",
+          "probePath": "/image",
+          "geoFilters": [],
+          "webApplicationFirewallPolicyLink": null
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "endpoint4899",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+        "type": "Microsoft.Cdn/profiles/endpoints",
+        "tags": {
+          "kay1": "value1"
+        },
+        "location": "WestUs",
+        "properties": {
+          "hostName": "endpoint1.azureedge.net",
+          "originHostHeader": "www.bing.com",
+          "provisioningState": "Succeeded",
+          "resourceState": "Stopping",
+          "isHttpAllowed": true,
+          "isHttpsAllowed": true,
+          "queryStringCachingBehavior": "NotSet",
+          "originPath": null,
+          "origins": [
+            {
+              "name": "www-bing-com",
+              "properties": {
+                "hostName": "www.bing.com",
+                "httpPort": 80,
+                "httpsPort": 443
+              }
+            }
+          ],
+          "contentTypesToCompress": [],
+          "isCompressionEnabled": false,
+          "optimizationType": "DynamicSiteAcceleration",
+          "probePath": "/image",
+          "geoFilters": [],
+          "webApplicationFirewallPolicyLink": null
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_Update.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_Update.json
new file mode 100644
index 000000000000..3050f09b2ba6
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_Update.json
@@ -0,0 +1,99 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "endpointUpdateProperties": {
+      "tags": {
+        "additionalProperties": "Tag1"
+      },
+      "properties": {
+        "webApplicationFirewallPolicyLink": {
+          "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/MicrosoftCdnWafPolicy2"
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "endpoint1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+        "type": "Microsoft.Cdn/profiles/endpoints",
+        "tags": {
+          "additionalProperties": "Tag1"
+        },
+        "location": "WestCentralUs",
+        "properties": {
+          "hostName": "endpoint1.azureedge.net",
+          "originHostHeader": null,
+          "provisioningState": "Creating",
+          "resourceState": "Creating",
+          "isHttpAllowed": true,
+          "isHttpsAllowed": true,
+          "queryStringCachingBehavior": "IgnoreQueryString",
+          "originPath": null,
+          "origins": [
+            {
+              "name": "www-bing-com",
+              "properties": {
+                "hostName": "www.bing.com",
+                "httpPort": 80,
+                "httpsPort": 443
+              }
+            }
+          ],
+          "contentTypesToCompress": [],
+          "isCompressionEnabled": false,
+          "optimizationType": null,
+          "probePath": null,
+          "geoFilters": [],
+          "webApplicationFirewallPolicyLink": {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/MicrosoftCdnWafPolicy2"
+          }
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "endpoint1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+        "type": "Microsoft.Cdn/profiles/endpoints",
+        "tags": {
+          "additionalProperties": "Tag1"
+        },
+        "location": "WestCentralUs",
+        "properties": {
+          "hostName": "endpoint1.azureedge.net",
+          "originHostHeader": null,
+          "provisioningState": "Creating",
+          "resourceState": "Creating",
+          "isHttpAllowed": true,
+          "isHttpsAllowed": true,
+          "queryStringCachingBehavior": "IgnoreQueryString",
+          "originPath": null,
+          "origins": [
+            {
+              "name": "www-bing-com",
+              "properties": {
+                "hostName": "www.bing.com",
+                "httpPort": 80,
+                "httpsPort": 443
+              }
+            }
+          ],
+          "contentTypesToCompress": [],
+          "isCompressionEnabled": false,
+          "optimizationType": null,
+          "probePath": null,
+          "geoFilters": [],
+          "webApplicationFirewallPolicyLink": {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/MicrosoftCdnWafPolicy2"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_ValidateCustomDomain.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_ValidateCustomDomain.json
new file mode 100644
index 000000000000..ff001cf6687a
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Endpoints_ValidateCustomDomain.json
@@ -0,0 +1,21 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "customDomainProperties": {
+      "hostName": "www.someDomain.com"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "customDomainValidated": true,
+        "message": null,
+        "reason": null
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Operations_List.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Operations_List.json
new file mode 100644
index 000000000000..081de51e65db
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Operations_List.json
@@ -0,0 +1,93 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "Microsoft.Cdn/register/action",
+            "display": {
+              "provider": "Microsoft.Cdn",
+              "resource": "Microsoft.Cdn Resource Provider",
+              "operation": "Registers the Microsoft.Cdn Resource Provider"
+            }
+          },
+          {
+            "name": "Microsoft.Cdn/edgenodes/read",
+            "display": {
+              "provider": "Microsoft.Cdn",
+              "resource": "EdgeNode",
+              "operation": "read"
+            }
+          },
+          {
+            "name": "Microsoft.Cdn/edgenodes/write",
+            "display": {
+              "provider": "Microsoft.Cdn",
+              "resource": "EdgeNode",
+              "operation": "write"
+            }
+          },
+          {
+            "name": "Microsoft.Cdn/edgenodes/delete",
+            "display": {
+              "provider": "Microsoft.Cdn",
+              "resource": "EdgeNode",
+              "operation": "delete"
+            }
+          },
+          {
+            "name": "Microsoft.Cdn/profiles/read",
+            "display": {
+              "provider": "Microsoft.Cdn",
+              "resource": "Profile",
+              "operation": "read"
+            }
+          },
+          {
+            "name": "Microsoft.Cdn/profiles/write",
+            "display": {
+              "provider": "Microsoft.Cdn",
+              "resource": "Profile",
+              "operation": "write"
+            }
+          },
+          {
+            "name": "Microsoft.Cdn/operationresults/profileresults/write",
+            "display": {
+              "provider": "Microsoft.Cdn",
+              "resource": "Profile",
+              "operation": "write"
+            }
+          },
+          {
+            "name": "Microsoft.Cdn/operationresults/profileresults/delete",
+            "display": {
+              "provider": "Microsoft.Cdn",
+              "resource": "Profile",
+              "operation": "delete"
+            }
+          },
+          {
+            "name": "Microsoft.Cdn/operationresults/profileresults/CheckResourceUsage/action",
+            "display": {
+              "provider": "Microsoft.Cdn",
+              "resource": "Profile",
+              "operation": "CheckResourceUsage"
+            }
+          },
+          {
+            "name": "Microsoft.Cdn/operationresults/profileresults/GenerateSsoUri/action",
+            "display": {
+              "provider": "Microsoft.Cdn",
+              "resource": "Profile",
+              "operation": "GenerateSsoUri"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Origins_Get.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Origins_Get.json
new file mode 100644
index 000000000000..fdd5dbb71875
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Origins_Get.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "originName": "www-someDomain-net"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "www-someDomain-net",
+        "location": "WestUs",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/origins",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "httpPort": null,
+          "httpsPort": null
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Origins_ListByEndpoint.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Origins_ListByEndpoint.json
new file mode 100644
index 000000000000..2a7d21ac4410
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Origins_ListByEndpoint.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "www-someDomain-net",
+            "location": "WestUs",
+            "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/www-someDomain-net",
+            "type": "Microsoft.Cdn/profiles/endpoints/origins",
+            "properties": {
+              "provisioningState": "Succeeded",
+              "resourceState": "Active",
+              "hostName": "www.someDomain.net",
+              "httpPort": null,
+              "httpsPort": null
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Origins_Update.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Origins_Update.json
new file mode 100644
index 000000000000..d44cd8cd16a3
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Origins_Update.json
@@ -0,0 +1,48 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "originName": "www-someDomain-net",
+    "originUpdateProperties": {
+      "properties": {
+        "httpPort": 42,
+        "httpsPort": 43
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "www-someDomain-net",
+        "location": "WestUs",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/origins",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "httpPort": 42,
+          "httpsPort": 43
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "www-someDomain-net",
+        "location": "WestUs",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/origins",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "httpPort": 42,
+          "httpsPort": 43
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_Create.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_Create.json
new file mode 100644
index 000000000000..d41d40645002
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_Create.json
@@ -0,0 +1,64 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "profile": {
+      "location": "WestCentralUs",
+      "sku": {
+        "name": "Standard_Verizon"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "profile1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1",
+        "type": "Microsoft.Cdn/profiles",
+        "tags": {},
+        "location": "WestCentralUs",
+        "sku": {
+          "name": "Standard_Verizon"
+        },
+        "properties": {
+          "provisioningState": "Creating",
+          "resourceState": "Creating"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "name": "profile1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1",
+        "type": "Microsoft.Cdn/profiles",
+        "tags": {},
+        "location": "WestCentralUs",
+        "sku": {
+          "name": "Standard_Verizon"
+        },
+        "properties": {
+          "provisioningState": "Creating",
+          "resourceState": "Creating"
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "profile1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1",
+        "type": "Microsoft.Cdn/profiles",
+        "tags": {},
+        "location": "WestCentralUs",
+        "sku": {
+          "name": "Standard_Verizon"
+        },
+        "properties": {
+          "provisioningState": "Creating",
+          "resourceState": "Creating"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_Delete.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_Delete.json
new file mode 100644
index 000000000000..5b4325394d1d
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_Delete.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1"
+  },
+  "responses": {
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_GenerateSsoUri.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_GenerateSsoUri.json
new file mode 100644
index 000000000000..4f22d15171d1
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_GenerateSsoUri.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "ssoUriValue": "https://someuri.com"
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_Get.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_Get.json
new file mode 100644
index 000000000000..c519c6c128c9
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_Get.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "profile1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1",
+        "type": "Microsoft.Cdn/profiles",
+        "tags": {},
+        "location": "WestCentralUs",
+        "sku": {
+          "name": "Standard_Akamai"
+        },
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_List.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_List.json
new file mode 100644
index 000000000000..51fa44ed1edc
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_List.json
@@ -0,0 +1,42 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "profile1",
+            "id": "/subscriptions/subid/resourcegroups/RG1/providers/Microsoft.Cdn/profiles/profile1",
+            "type": "Microsoft.Cdn/profiles",
+            "tags": {},
+            "location": "WestCentralUs",
+            "sku": {
+              "name": "Standard_Akamai"
+            },
+            "properties": {
+              "provisioningState": "Succeeded",
+              "resourceState": "Active"
+            }
+          },
+          {
+            "name": "profile2",
+            "id": "/subscriptions/subid/resourcegroups/RG1/providers/Microsoft.Cdn/profiles/profile2",
+            "type": "Microsoft.Cdn/profiles",
+            "tags": {},
+            "location": "WestCentralUs",
+            "sku": {
+              "name": "Standard_Akamai"
+            },
+            "properties": {
+              "provisioningState": "Succeeded",
+              "resourceState": "Active"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_ListByResourceGroup.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_ListByResourceGroup.json
new file mode 100644
index 000000000000..7158dca4b260
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_ListByResourceGroup.json
@@ -0,0 +1,43 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "profile1",
+            "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1",
+            "type": "Microsoft.Cdn/profiles",
+            "tags": {},
+            "location": "WestCentralUs",
+            "sku": {
+              "name": "Standard_Akamai"
+            },
+            "properties": {
+              "provisioningState": "Succeeded",
+              "resourceState": "Active"
+            }
+          },
+          {
+            "name": "profile2",
+            "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile2",
+            "type": "Microsoft.Cdn/profiles",
+            "tags": {},
+            "location": "WestCentralUs",
+            "sku": {
+              "name": "Standard_Akamai"
+            },
+            "properties": {
+              "provisioningState": "Succeeded",
+              "resourceState": "Active"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_ListResourceUsage.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_ListResourceUsage.json
new file mode 100644
index 000000000000..5c0e616e0663
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_ListResourceUsage.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "resourceType": "endpoint",
+            "unit": "count",
+            "currentValue": 0,
+            "limit": 25
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_ListSupportedOptimizationTypes.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_ListSupportedOptimizationTypes.json
new file mode 100644
index 000000000000..96c28271c160
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_ListSupportedOptimizationTypes.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "supportedOptimizationTypes": [
+          "GeneralWebDelivery",
+          "DynamicSiteAcceleration"
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_Update.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_Update.json
new file mode 100644
index 000000000000..7e01f44177a3
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/Profiles_Update.json
@@ -0,0 +1,51 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "profileUpdateParameters": {
+      "tags": {
+        "additionalProperties": "Tag1"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "profile1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1",
+        "type": "Microsoft.Cdn/profiles",
+        "tags": {
+          "additionalProperties": "Tag1"
+        },
+        "location": "WestCentralUs",
+        "sku": {
+          "name": "Standard_Verizon"
+        },
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active"
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "profile1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1",
+        "type": "Microsoft.Cdn/profiles",
+        "tags": {
+          "additionalProperties": "Tag1"
+        },
+        "location": "WestCentralUs",
+        "sku": {
+          "name": "Standard_Verizon"
+        },
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/ResourceUsage_List.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/ResourceUsage_List.json
new file mode 100644
index 000000000000..c0804515e562
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/ResourceUsage_List.json
@@ -0,0 +1,20 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "resourceType": "profile",
+            "unit": "count",
+            "currentValue": 31,
+            "limit": 200
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/ValidateProbe.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/ValidateProbe.json
new file mode 100644
index 000000000000..3ffb4c86b32b
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/ValidateProbe.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "validateProbeInput": {
+      "probeURL": "https://www.bing.com/image"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "isValid": true,
+        "errorCode": "None",
+        "message": null
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/WafListManagedRuleSets.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/WafListManagedRuleSets.json
new file mode 100644
index 000000000000..a4c343b3b81d
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/WafListManagedRuleSets.json
@@ -0,0 +1,53 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "DefaultRuleSet_1.0",
+            "id": "/subscriptions/subid/providers/Microsoft.Cdn/CdnWebApplicationFirewallManagedRuleSets",
+            "type": "Microsoft.Cdn/cdnwebapplicationfirewallmanagedrulesets",
+            "sku": {
+              "name": "Standard_Microsoft"
+            },
+            "properties": {
+              "provisioningState": "Succeeded",
+              "ruleSetType": "DefaultRuleSet",
+              "ruleSetVersion": "preview-1.0",
+              "ruleGroups": [
+                {
+                  "ruleGroupName": "Group1",
+                  "description": "Description for rule group 1.",
+                  "rules": [
+                    {
+                      "ruleId": "GROUP1-0001",
+                      "description": "Generic managed web application firewall rule."
+                    },
+                    {
+                      "ruleId": "GROUP1-0002",
+                      "description": "Generic managed web application firewall rule."
+                    }
+                  ]
+                },
+                {
+                  "ruleGroupName": "Group2",
+                  "description": "Description for rule group 2.",
+                  "rules": [
+                    {
+                      "ruleId": "GROUP2-0001",
+                      "description": "Generic managed web application firewall rule."
+                    }
+                  ]
+                }
+              ]
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/WafListPolicies.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/WafListPolicies.json
new file mode 100644
index 000000000000..fe06b030ca50
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/WafListPolicies.json
@@ -0,0 +1,265 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rg1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "MicrosoftCdnWafPolicy",
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/MicrosoftCdnWafPolicy",
+            "type": "Microsoft.Cdn/cdnwebapplicationfirewallpolicies",
+            "tags": {
+              "key1": "value1",
+              "key2": "value2"
+            },
+            "location": "WestUs",
+            "sku": {
+              "name": "Standard_Microsoft"
+            },
+            "properties": {
+              "resourceState": "Enabled",
+              "provisioningState": "Succeeded",
+              "policySettings": {
+                "enabledState": "Enabled",
+                "mode": "Prevention",
+                "defaultRedirectUrl": "http://www.bing.com",
+                "defaultCustomBlockResponseStatusCode": 429,
+                "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
+              },
+              "rateLimitRules": {
+                "rules": [
+                  {
+                    "name": "RateLimitRule1",
+                    "priority": 1,
+                    "enabledState": "Enabled",
+                    "rateLimitDurationInMinutes": 0,
+                    "rateLimitThreshold": 1000,
+                    "matchConditions": [
+                      {
+                        "matchVariable": "RemoteAddr",
+                        "selector": null,
+                        "operator": "IPMatch",
+                        "negateCondition": false,
+                        "transforms": [],
+                        "matchValue": [
+                          "192.168.1.0/24",
+                          "10.0.0.0/24"
+                        ]
+                      }
+                    ],
+                    "action": "Block"
+                  }
+                ]
+              },
+              "customRules": {
+                "rules": [
+                  {
+                    "name": "CustomRule1",
+                    "priority": 2,
+                    "enabledState": "Enabled",
+                    "matchConditions": [
+                      {
+                        "matchVariable": "RemoteAddr",
+                        "selector": null,
+                        "operator": "GeoMatch",
+                        "negateCondition": false,
+                        "transforms": [],
+                        "matchValue": [
+                          "CH"
+                        ]
+                      },
+                      {
+                        "matchVariable": "RequestHeader",
+                        "selector": "UserAgent",
+                        "operator": "Contains",
+                        "negateCondition": false,
+                        "transforms": [],
+                        "matchValue": [
+                          "windows"
+                        ]
+                      },
+                      {
+                        "matchVariable": "QueryString",
+                        "selector": "search",
+                        "operator": "Contains",
+                        "negateCondition": false,
+                        "transforms": [
+                          "UrlDecode",
+                          "Lowercase"
+                        ],
+                        "matchValue": [
+                          "<?php",
+                          "?>"
+                        ]
+                      }
+                    ],
+                    "action": "Block"
+                  }
+                ]
+              },
+              "managedRules": {
+                "managedRuleSets": [
+                  {
+                    "ruleSetType": "DefaultRuleSet",
+                    "ruleSetVersion": "preview-1.0",
+                    "ruleGroupOverrides": [
+                      {
+                        "ruleGroupName": "Group1",
+                        "rules": [
+                          {
+                            "ruleId": "GROUP1-0001",
+                            "enabledState": "Enabled",
+                            "action": "Redirect"
+                          },
+                          {
+                            "ruleId": "GROUP1-0002",
+                            "enabledState": "Disabled"
+                          }
+                        ]
+                      }
+                    ]
+                  }
+                ]
+              },
+              "endpointLinks": [
+                {
+                  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint1"
+                },
+                {
+                  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint2"
+                }
+              ]
+            }
+          },
+          {
+            "name": "VerizonStandardCdnWafPolicy",
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/VerizonStandardCdnWafPolicy",
+            "type": "Microsoft.Cdn/cdnwebapplicationfirewallpolicies",
+            "tags": {
+              "key1": "value1",
+              "key2": "value2"
+            },
+            "location": "WestUs",
+            "sku": {
+              "name": "Standard_Verizon"
+            },
+            "properties": {
+              "resourceState": "Enabled",
+              "provisioningState": "Succeeded",
+              "policySettings": {
+                "enabledState": "Enabled",
+                "mode": "Prevention",
+                "defaultRedirectUrl": "http://www.bing.com",
+                "defaultCustomBlockResponseStatusCode": 429,
+                "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
+              },
+              "rateLimitRules": {
+                "rules": [
+                  {
+                    "name": "RateLimitRule1",
+                    "priority": 1,
+                    "enabledState": "Enabled",
+                    "rateLimitDurationInMinutes": 0,
+                    "rateLimitThreshold": 1000,
+                    "matchConditions": [
+                      {
+                        "matchVariable": "RemoteAddr",
+                        "selector": null,
+                        "operator": "IPMatch",
+                        "negateCondition": false,
+                        "transforms": [],
+                        "matchValue": [
+                          "192.168.1.0/24",
+                          "10.0.0.0/24"
+                        ]
+                      }
+                    ],
+                    "action": "Block"
+                  }
+                ]
+              },
+              "customRules": {
+                "rules": [
+                  {
+                    "name": "CustomRule1",
+                    "priority": 2,
+                    "enabledState": "Enabled",
+                    "matchConditions": [
+                      {
+                        "matchVariable": "RemoteAddr",
+                        "selector": null,
+                        "operator": "GeoMatch",
+                        "negateCondition": false,
+                        "transforms": [],
+                        "matchValue": [
+                          "CH"
+                        ]
+                      },
+                      {
+                        "matchVariable": "RequestHeader",
+                        "selector": "UserAgent",
+                        "operator": "Contains",
+                        "negateCondition": false,
+                        "matchValue": [
+                          "windows"
+                        ]
+                      },
+                      {
+                        "matchVariable": "QueryString",
+                        "selector": "search",
+                        "operator": "Contains",
+                        "negateCondition": false,
+                        "transforms": [
+                          "UrlDecode",
+                          "Lowercase"
+                        ],
+                        "matchValue": [
+                          "<?php",
+                          "?>"
+                        ]
+                      }
+                    ],
+                    "action": "Block"
+                  }
+                ]
+              },
+              "managedRules": {
+                "managedRuleSets": [
+                  {
+                    "ruleSetType": "ECRS",
+                    "ruleSetVersion": "2018-11-2",
+                    "ruleGroupOverrides": [
+                      {
+                        "ruleGroupName": "XSS",
+                        "rules": [
+                          {
+                            "ruleId": "XSS-0001",
+                            "enabledState": "Enabled",
+                            "action": "Redirect"
+                          },
+                          {
+                            "ruleId": "XSS-0002",
+                            "enabledState": "Disabled"
+                          }
+                        ]
+                      }
+                    ]
+                  }
+                ]
+              },
+              "endpointLinks": [
+                {
+                  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint3"
+                }
+              ]
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/WafPatchPolicy.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/WafPatchPolicy.json
new file mode 100644
index 000000000000..097f3387a82b
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/WafPatchPolicy.json
@@ -0,0 +1,272 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rg1",
+    "policyName": "MicrosoftCdnWafPolicy",
+    "cdnWebApplicationFirewallPolicyPatchParameters": {
+      "tags": {
+        "foo": "bar"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "MicrosoftCdnWafPolicy",
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/MicrosoftCdnWafPolicy",
+        "type": "Microsoft.Cdn/cdnwebapplicationfirewallpolicies",
+        "tags": {
+          "foo": "bar"
+        },
+        "location": "WestUs",
+        "sku": {
+          "name": "Standard_Microsoft"
+        },
+        "properties": {
+          "resourceState": "Enabled",
+          "provisioningState": "Succeeded",
+          "policySettings": {
+            "enabledState": "Enabled",
+            "mode": "Prevention",
+            "defaultRedirectUrl": "http://www.bing.com",
+            "defaultCustomBlockResponseStatusCode": 403,
+            "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
+          },
+          "rateLimitRules": {
+            "rules": [
+              {
+                "name": "RateLimitRule1",
+                "priority": 1,
+                "enabledState": "Enabled",
+                "rateLimitDurationInMinutes": 0,
+                "rateLimitThreshold": 1000,
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "IPMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "192.168.1.0/24",
+                      "10.0.0.0/24"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "customRules": {
+            "rules": [
+              {
+                "name": "CustomRule1",
+                "priority": 2,
+                "enabledState": "Enabled",
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "GeoMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "CH"
+                    ]
+                  },
+                  {
+                    "matchVariable": "RequestHeader",
+                    "selector": "UserAgent",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "windows"
+                    ]
+                  },
+                  {
+                    "matchVariable": "QueryString",
+                    "selector": "search",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [
+                      "UrlDecode",
+                      "Lowercase"
+                    ],
+                    "matchValue": [
+                      "<?php",
+                      "?>"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "managedRules": {
+            "managedRuleSets": [
+              {
+                "ruleSetType": "DefaultRuleSet",
+                "ruleSetVersion": "preview-1.0",
+                "ruleGroupOverrides": [
+                  {
+                    "ruleGroupName": "Group1",
+                    "rules": [
+                      {
+                        "ruleId": "GROUP1-0001",
+                        "enabledState": "Enabled",
+                        "action": "Redirect"
+                      },
+                      {
+                        "ruleId": "GROUP1-0002",
+                        "enabledState": "Disabled"
+                      }
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
+          "endpointLinks": [
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint1"
+            },
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint2"
+            }
+          ]
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "MicrosoftCdnWafPolicy",
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/MicrosoftCdnWafPolicy",
+        "type": "Microsoft.Cdn/cdnwebapplicationfirewallpolicies",
+        "tags": {
+          "key1": "value1",
+          "key2": "value2"
+        },
+        "location": "WestUs",
+        "sku": {
+          "name": "Standard_Microsoft"
+        },
+        "properties": {
+          "resourceState": "Creating",
+          "provisioningState": "Succeeded",
+          "policySettings": {
+            "enabledState": "Enabled",
+            "mode": "Prevention",
+            "defaultRedirectUrl": "http://www.bing.com",
+            "defaultCustomBlockResponseStatusCode": 403,
+            "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
+          },
+          "rateLimitRules": {
+            "rules": [
+              {
+                "name": "RateLimitRule1",
+                "priority": 1,
+                "enabledState": "Enabled",
+                "rateLimitDurationInMinutes": 0,
+                "rateLimitThreshold": 1000,
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "IPMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "192.168.1.0/24",
+                      "10.0.0.0/24"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "customRules": {
+            "rules": [
+              {
+                "name": "CustomRule1",
+                "priority": 2,
+                "enabledState": "Enabled",
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "GeoMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "CH"
+                    ]
+                  },
+                  {
+                    "matchVariable": "RequestHeader",
+                    "selector": "UserAgent",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "windows"
+                    ]
+                  },
+                  {
+                    "matchVariable": "QueryString",
+                    "selector": "search",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [
+                      "UrlDecode",
+                      "Lowercase"
+                    ],
+                    "matchValue": [
+                      "<?php",
+                      "?>"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "managedRules": {
+            "managedRuleSets": [
+              {
+                "ruleSetType": "DefaultRuleSet",
+                "ruleSetVersion": "preview-1.0",
+                "ruleGroupOverrides": [
+                  {
+                    "ruleGroupName": "Group1",
+                    "rules": [
+                      {
+                        "ruleId": "GROUP1-0001",
+                        "enabledState": "Enabled",
+                        "action": "Redirect"
+                      },
+                      {
+                        "ruleId": "GROUP1-0002",
+                        "enabledState": "Disabled"
+                      }
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
+          "endpointLinks": [
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint1"
+            },
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint2"
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/WafPolicyCreateOrUpdate.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/WafPolicyCreateOrUpdate.json
new file mode 100644
index 000000000000..39cccc946483
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/WafPolicyCreateOrUpdate.json
@@ -0,0 +1,505 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rg1",
+    "policyName": "MicrosoftCdnWafPolicy",
+    "cdnWebApplicationFirewallPolicy": {
+      "location": "WestUs",
+      "sku": {
+        "name": "Standard_Microsoft"
+      },
+      "properties": {
+        "policySettings": {
+          "defaultRedirectUrl": "http://www.bing.com",
+          "defaultCustomBlockResponseStatusCode": 200,
+          "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
+        },
+        "rateLimitRules": {
+          "rules": [
+            {
+              "name": "RateLimitRule1",
+              "priority": 1,
+              "enabledState": "Enabled",
+              "rateLimitDurationInMinutes": 0,
+              "rateLimitThreshold": 1000,
+              "matchConditions": [
+                {
+                  "matchVariable": "RemoteAddr",
+                  "selector": null,
+                  "operator": "IPMatch",
+                  "negateCondition": false,
+                  "transforms": [],
+                  "matchValue": [
+                    "192.168.1.0/24",
+                    "10.0.0.0/24"
+                  ]
+                }
+              ],
+              "action": "Block"
+            }
+          ]
+        },
+        "customRules": {
+          "rules": [
+            {
+              "name": "CustomRule1",
+              "priority": 2,
+              "enabledState": "Enabled",
+              "matchConditions": [
+                {
+                  "matchVariable": "RemoteAddr",
+                  "selector": null,
+                  "operator": "GeoMatch",
+                  "negateCondition": false,
+                  "transforms": [],
+                  "matchValue": [
+                    "CH"
+                  ]
+                },
+                {
+                  "matchVariable": "RequestHeader",
+                  "selector": "UserAgent",
+                  "operator": "Contains",
+                  "negateCondition": false,
+                  "transforms": [],
+                  "matchValue": [
+                    "windows"
+                  ]
+                },
+                {
+                  "matchVariable": "QueryString",
+                  "selector": "search",
+                  "operator": "Contains",
+                  "negateCondition": false,
+                  "transforms": [
+                    "UrlDecode",
+                    "Lowercase"
+                  ],
+                  "matchValue": [
+                    "<?php",
+                    "?>"
+                  ]
+                }
+              ],
+              "action": "Block"
+            }
+          ]
+        },
+        "managedRules": {
+          "managedRuleSets": [
+            {
+              "ruleSetType": "DefaultRuleSet",
+              "ruleSetVersion": "preview-1.0",
+              "ruleGroupOverrides": [
+                {
+                  "ruleGroupName": "Group1",
+                  "rules": [
+                    {
+                      "ruleId": "GROUP1-0001",
+                      "enabledState": "Enabled",
+                      "action": "Redirect"
+                    },
+                    {
+                      "ruleId": "GROUP1-0002",
+                      "enabledState": "Disabled"
+                    }
+                  ]
+                }
+              ]
+            }
+          ]
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "MicrosoftCdnWafPolicy",
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/MicrosoftCdnWafPolicy",
+        "type": "Microsoft.Cdn/cdnwebapplicationfirewallpolicies",
+        "tags": {
+          "key1": "value1",
+          "key2": "value2"
+        },
+        "location": "WestUs",
+        "sku": {
+          "name": "Standard_Microsoft"
+        },
+        "properties": {
+          "resourceState": "Enabled",
+          "provisioningState": "Succeeded",
+          "policySettings": {
+            "enabledState": "Enabled",
+            "mode": "Prevention",
+            "defaultRedirectUrl": "http://www.bing.com",
+            "defaultCustomBlockResponseStatusCode": 200,
+            "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
+          },
+          "rateLimitRules": {
+            "rules": [
+              {
+                "name": "RateLimitRule1",
+                "priority": 1,
+                "enabledState": "Enabled",
+                "rateLimitDurationInMinutes": 0,
+                "rateLimitThreshold": 1000,
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "IPMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "192.168.1.0/24",
+                      "10.0.0.0/24"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "customRules": {
+            "rules": [
+              {
+                "name": "CustomRule1",
+                "priority": 2,
+                "enabledState": "Enabled",
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "GeoMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "CH"
+                    ]
+                  },
+                  {
+                    "matchVariable": "RequestHeader",
+                    "selector": "UserAgent",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "windows"
+                    ]
+                  },
+                  {
+                    "matchVariable": "QueryString",
+                    "selector": "search",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [
+                      "UrlDecode",
+                      "Lowercase"
+                    ],
+                    "matchValue": [
+                      "<?php",
+                      "?>"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "managedRules": {
+            "managedRuleSets": [
+              {
+                "ruleSetType": "DefaultRuleSet",
+                "ruleSetVersion": "preview-1.0",
+                "ruleGroupOverrides": [
+                  {
+                    "ruleGroupName": "Group1",
+                    "rules": [
+                      {
+                        "ruleId": "GROUP1-0001",
+                        "enabledState": "Enabled",
+                        "action": "Redirect"
+                      },
+                      {
+                        "ruleId": "GROUP1-0002",
+                        "enabledState": "Disabled"
+                      }
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
+          "endpointLinks": [
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint1"
+            },
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint2"
+            }
+          ]
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "name": "MicrosoftCdnWafPolicy",
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/MicrosoftCdnWafPolicy",
+        "type": "Microsoft.Cdn/cdnwebapplicationfirewallpolicies",
+        "tags": {
+          "key1": "value1",
+          "key2": "value2"
+        },
+        "location": "WestUs",
+        "sku": {
+          "name": "Standard_Microsoft"
+        },
+        "properties": {
+          "resourceState": "Enabled",
+          "provisioningState": "Succeeded",
+          "policySettings": {
+            "enabledState": "Enabled",
+            "mode": "Prevention",
+            "defaultRedirectUrl": "http://www.bing.com",
+            "defaultCustomBlockResponseStatusCode": 200,
+            "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
+          },
+          "rateLimitRules": {
+            "rules": [
+              {
+                "name": "RateLimitRule1",
+                "priority": 1,
+                "enabledState": "Enabled",
+                "rateLimitDurationInMinutes": 0,
+                "rateLimitThreshold": 1000,
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "IPMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "192.168.1.0/24",
+                      "10.0.0.0/24"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "customRules": {
+            "rules": [
+              {
+                "name": "CustomRule1",
+                "priority": 2,
+                "enabledState": "Enabled",
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "GeoMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "CH"
+                    ]
+                  },
+                  {
+                    "matchVariable": "RequestHeader",
+                    "selector": "UserAgent",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "windows"
+                    ]
+                  },
+                  {
+                    "matchVariable": "QueryString",
+                    "selector": "search",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [
+                      "UrlDecode",
+                      "Lowercase"
+                    ],
+                    "matchValue": [
+                      "<?php",
+                      "?>"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "managedRules": {
+            "managedRuleSets": [
+              {
+                "ruleSetType": "DefaultRuleSet",
+                "ruleSetVersion": "preview-1.0",
+                "ruleGroupOverrides": [
+                  {
+                    "ruleGroupName": "Group1",
+                    "rules": [
+                      {
+                        "ruleId": "GROUP1-0001",
+                        "enabledState": "Enabled",
+                        "action": "Redirect"
+                      },
+                      {
+                        "ruleId": "GROUP1-0002",
+                        "enabledState": "Disabled"
+                      }
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
+          "endpointLinks": [
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint1"
+            },
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint2"
+            }
+          ]
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "MicrosoftCdnWafPolicy",
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/MicrosoftCdnWafPolicy",
+        "type": "Microsoft.Cdn/cdnwebapplicationfirewallpolicies",
+        "tags": {
+          "key1": "value1",
+          "key2": "value2"
+        },
+        "location": "WestUs",
+        "sku": {
+          "name": "Standard_Microsoft"
+        },
+        "properties": {
+          "resourceState": "Creating",
+          "provisioningState": "Succeeded",
+          "policySettings": {
+            "enabledState": "Enabled",
+            "mode": "Prevention",
+            "defaultRedirectUrl": "http://www.bing.com",
+            "defaultCustomBlockResponseStatusCode": 200,
+            "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
+          },
+          "rateLimitRules": {
+            "rules": [
+              {
+                "name": "RateLimitRule1",
+                "priority": 1,
+                "enabledState": "Enabled",
+                "rateLimitDurationInMinutes": 0,
+                "rateLimitThreshold": 1000,
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "IPMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "192.168.1.0/24",
+                      "10.0.0.0/24"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "customRules": {
+            "rules": [
+              {
+                "name": "CustomRule1",
+                "priority": 3,
+                "enabledState": "Enabled",
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "GeoMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "CH"
+                    ]
+                  },
+                  {
+                    "matchVariable": "RequestHeader",
+                    "selector": "UserAgent",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "windows"
+                    ]
+                  },
+                  {
+                    "matchVariable": "QueryString",
+                    "selector": "search",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [
+                      "UrlDecode",
+                      "Lowercase"
+                    ],
+                    "matchValue": [
+                      "<?php",
+                      "?>"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "managedRules": {
+            "managedRuleSets": [
+              {
+                "ruleSetType": "DefaultRuleSet",
+                "ruleSetVersion": "preview-1.0",
+                "ruleGroupOverrides": [
+                  {
+                    "ruleGroupName": "Group1",
+                    "rules": [
+                      {
+                        "ruleId": "GROUP1-0001",
+                        "enabledState": "Enabled",
+                        "action": "Redirect"
+                      },
+                      {
+                        "ruleId": "GROUP1-0002",
+                        "enabledState": "Disabled"
+                      }
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
+          "endpointLinks": [
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint1"
+            },
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint2"
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/WafPolicyDelete.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/WafPolicyDelete.json
new file mode 100644
index 000000000000..d5dfe788d78f
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/WafPolicyDelete.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rg1",
+    "policyName": "Policy1"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/WafPolicyGet.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/WafPolicyGet.json
new file mode 100644
index 000000000000..2525da1d6fb4
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2019-06-15/examples/WafPolicyGet.json
@@ -0,0 +1,139 @@
+{
+  "parameters": {
+    "api-version": "2019-06-15",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rg1",
+    "policyName": "MicrosoftCdnWafPolicy"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "MicrosoftCdnWafPolicy",
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/MicrosoftCdnWafPolicy",
+        "type": "Microsoft.Cdn/cdnwebapplicationfirewallpolicies",
+        "tags": {
+          "key1": "value1",
+          "key2": "value2"
+        },
+        "location": "WestUs",
+        "sku": {
+          "name": "Standard_Microsoft"
+        },
+        "properties": {
+          "resourceState": "Enabled",
+          "provisioningState": "Succeeded",
+          "policySettings": {
+            "enabledState": "Enabled",
+            "mode": "Prevention",
+            "defaultRedirectUrl": "http://www.bing.com",
+            "defaultCustomBlockResponseStatusCode": 429,
+            "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
+          },
+          "rateLimitRules": {
+            "rules": [
+              {
+                "name": "RateLimitRule1",
+                "priority": 1,
+                "enabledState": "Enabled",
+                "rateLimitDurationInMinutes": 0,
+                "rateLimitThreshold": 1000,
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "IPMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "192.168.1.0/24",
+                      "10.0.0.0/24"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "customRules": {
+            "rules": [
+              {
+                "name": "CustomRule1",
+                "priority": 2,
+                "enabledState": "Enabled",
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "GeoMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "CH"
+                    ]
+                  },
+                  {
+                    "matchVariable": "RequestHeader",
+                    "selector": "UserAgent",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "windows"
+                    ]
+                  },
+                  {
+                    "matchVariable": "QueryString",
+                    "selector": "search",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [
+                      "UrlDecode",
+                      "Lowercase"
+                    ],
+                    "matchValue": [
+                      "<?php",
+                      "?>"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "managedRules": {
+            "managedRuleSets": [
+              {
+                "ruleSetType": "DefaultRuleSet",
+                "ruleSetVersion": "preview-1.0",
+                "ruleGroupOverrides": [
+                  {
+                    "ruleGroupName": "Group1",
+                    "rules": [
+                      {
+                        "ruleId": "GROUP1-0001",
+                        "enabledState": "Enabled",
+                        "action": "Redirect"
+                      },
+                      {
+                        "ruleId": "GROUP1-0002",
+                        "enabledState": "Disabled"
+                      }
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
+          "endpointLinks": [
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint1"
+            },
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint2"
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/cdn.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/cdn.json
new file mode 100644
index 000000000000..7b052709cb5f
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/cdn.json
@@ -0,0 +1,5486 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "version": "2020-03-31",
+    "title": "CdnManagementClient",
+    "description": "Use these APIs to manage Azure CDN resources through the Azure Resource Manager. You must make sure that requests made to these resources are secure."
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Cdn/profiles": {
+      "get": {
+        "tags": [
+          "Profiles"
+        ],
+        "description": "Lists all of the CDN profiles within an Azure subscription.",
+        "operationId": "Profiles_List",
+        "x-ms-examples": {
+          "Profiles_List": {
+            "$ref": "./examples/Profiles_List.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/ProfileListResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles": {
+      "get": {
+        "tags": [
+          "Profiles"
+        ],
+        "description": "Lists all of the CDN profiles within a resource group.",
+        "operationId": "Profiles_ListByResourceGroup",
+        "x-ms-examples": {
+          "Profiles_ListByResourceGroup": {
+            "$ref": "./examples/Profiles_ListByResourceGroup.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/ProfileListResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}": {
+      "get": {
+        "tags": [
+          "Profiles"
+        ],
+        "description": "Gets a CDN profile with the specified profile name under the specified subscription and resource group.",
+        "operationId": "Profiles_Get",
+        "x-ms-examples": {
+          "Profiles_Get": {
+            "$ref": "./examples/Profiles_Get.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/Profile"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Profiles"
+        ],
+        "description": "Creates a new CDN profile with a profile name under the specified subscription and resource group.",
+        "operationId": "Profiles_Create",
+        "x-ms-examples": {
+          "Profiles_Create": {
+            "$ref": "./examples/Profiles_Create.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "description": "Profile properties needed to create a new profile.",
+            "in": "body",
+            "name": "profile",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/Profile"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/Profile"
+            }
+          },
+          "201": {
+            "description": "Created. The request has been fulfilled and a new profile has been created.",
+            "schema": {
+              "$ref": "#/definitions/Profile"
+            }
+          },
+          "202": {
+            "description": "Accepted. The request has been accepted for processing and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/Profile"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "patch": {
+        "tags": [
+          "Profiles"
+        ],
+        "description": "Updates an existing CDN profile with the specified profile name under the specified subscription and resource group.",
+        "operationId": "Profiles_Update",
+        "x-ms-examples": {
+          "Profiles_Update": {
+            "$ref": "./examples/Profiles_Update.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "profileUpdateParameters",
+            "in": "body",
+            "description": "Profile properties needed to update an existing profile.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ProfileUpdateParameters"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/Profile"
+            }
+          },
+          "202": {
+            "description": "Accepted. The request has been accepted for processing and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/Profile"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "delete": {
+        "tags": [
+          "Profiles"
+        ],
+        "description": "Deletes an existing CDN profile with the specified parameters. Deleting a profile will result in the deletion of all of the sub-resources including endpoints, origins and custom domains.",
+        "operationId": "Profiles_Delete",
+        "x-ms-examples": {
+          "Profiles_Delete": {
+            "$ref": "./examples/Profiles_Delete.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Accepted. The request has been accepted for processing and the operation will complete asynchronously."
+          },
+          "204": {
+            "description": "No Content. The request has been accepted but the profile was not found."
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/generateSsoUri": {
+      "post": {
+        "tags": [
+          "Profiles"
+        ],
+        "description": "Generates a dynamic SSO URI used to sign in to the CDN supplemental portal. Supplemental portal is used to configure advanced feature capabilities that are not yet available in the Azure portal, such as core reports in a standard profile; rules engine, advanced HTTP reports, and real-time stats and alerts in a premium profile. The SSO URI changes approximately every 10 minutes.",
+        "operationId": "Profiles_GenerateSsoUri",
+        "x-ms-examples": {
+          "Profiles_GenerateSsoUri": {
+            "$ref": "./examples/Profiles_GenerateSsoUri.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/SsoUri"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/getSupportedOptimizationTypes": {
+      "post": {
+        "tags": [
+          "Profiles"
+        ],
+        "description": "Gets the supported optimization types for the current profile. A user can create an endpoint with an optimization type from the listed values.",
+        "operationId": "Profiles_ListSupportedOptimizationTypes",
+        "x-ms-examples": {
+          "Profiles_ListSupportedOptimizationTypes": {
+            "$ref": "./examples/Profiles_ListSupportedOptimizationTypes.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/SupportedOptimizationTypesListResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/checkResourceUsage": {
+      "post": {
+        "tags": [
+          "Profiles"
+        ],
+        "description": "Checks the quota and actual usage of endpoints under the given CDN profile.",
+        "operationId": "Profiles_ListResourceUsage",
+        "x-ms-examples": {
+          "Profiles_ListResourceUsage": {
+            "$ref": "./examples/Profiles_ListResourceUsage.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/ResourceUsageListResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints": {
+      "get": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Lists existing CDN endpoints.",
+        "operationId": "Endpoints_ListByProfile",
+        "x-ms-examples": {
+          "Endpoints_ListByProfile": {
+            "$ref": "./examples/Endpoints_ListByProfile.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/EndpointListResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}": {
+      "get": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Gets an existing CDN endpoint with the specified endpoint name under the specified subscription, resource group and profile.",
+        "operationId": "Endpoints_Get",
+        "x-ms-examples": {
+          "Endpoints_Get": {
+            "$ref": "./examples/Endpoints_Get.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Creates a new CDN endpoint with the specified endpoint name under the specified subscription, resource group and profile.",
+        "operationId": "Endpoints_Create",
+        "x-ms-examples": {
+          "Endpoints_Create": {
+            "$ref": "./examples/Endpoints_Create.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpoint",
+            "in": "body",
+            "description": "Endpoint properties",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          "201": {
+            "description": "Created. The request has been fulfilled and a new endpoint has been created.",
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "patch": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Updates an existing CDN endpoint with the specified endpoint name under the specified subscription, resource group and profile. Only tags can be updated after creating an endpoint. To update origins, use the Update Origin operation. To update origin groups, use the Update Origin group operation. To update custom domains, use the Update Custom Domain operation.",
+        "operationId": "Endpoints_Update",
+        "x-ms-examples": {
+          "Endpoints_Update": {
+            "$ref": "./examples/Endpoints_Update.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointUpdateProperties",
+            "in": "body",
+            "description": "Endpoint update properties",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/EndpointUpdateParameters"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously",
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "delete": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Deletes an existing CDN endpoint with the specified endpoint name under the specified subscription, resource group and profile.",
+        "operationId": "Endpoints_Delete",
+        "x-ms-examples": {
+          "Endpoints_Delete": {
+            "$ref": "./examples/Endpoints_Delete.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously."
+          },
+          "204": {
+            "description": "No Content. The request has been accepted but the endpoint was not found."
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/start": {
+      "post": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Starts an existing CDN endpoint that is on a stopped state.",
+        "operationId": "Endpoints_Start",
+        "x-ms-examples": {
+          "Endpoints_Start": {
+            "$ref": "./examples/Endpoints_Start.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/stop": {
+      "post": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Stops an existing running CDN endpoint.",
+        "operationId": "Endpoints_Stop",
+        "x-ms-examples": {
+          "Endpoints_Stop": {
+            "$ref": "./examples/Endpoints_Stop.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/Endpoint"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/purge": {
+      "post": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Removes a content from CDN.",
+        "operationId": "Endpoints_PurgeContent",
+        "x-ms-examples": {
+          "Endpoints_PurgeContent": {
+            "$ref": "./examples/Endpoints_PurgeContent.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "contentFilePaths",
+            "in": "body",
+            "description": "The path to the content to be purged. Path can be a full URL, e.g. '/pictures/city.png' which removes a single file, or a directory with a wildcard, e.g. '/pictures/*' which removes all folders and files in the directory.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/PurgeParameters"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded."
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously."
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/load": {
+      "post": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Pre-loads a content to CDN. Available for Verizon Profiles.",
+        "operationId": "Endpoints_LoadContent",
+        "x-ms-examples": {
+          "Endpoints_LoadContent": {
+            "$ref": "./examples/Endpoints_LoadContent.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "contentFilePaths",
+            "in": "body",
+            "description": "The path to the content to be loaded. Path should be a full URL, e.g. ‘/pictures/city.png' which loads a single file ",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/LoadParameters"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded."
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously."
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/validateCustomDomain": {
+      "post": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Validates the custom domain mapping to ensure it maps to the correct CDN endpoint in DNS.",
+        "operationId": "Endpoints_ValidateCustomDomain",
+        "x-ms-examples": {
+          "Endpoints_ValidateCustomDomain": {
+            "$ref": "./examples/Endpoints_ValidateCustomDomain.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "customDomainProperties",
+            "in": "body",
+            "description": "Custom domain to be validated.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ValidateCustomDomainInput"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/ValidateCustomDomainOutput"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/checkResourceUsage": {
+      "post": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Checks the quota and usage of geo filters and custom domains under the given endpoint.",
+        "operationId": "Endpoints_ListResourceUsage",
+        "x-ms-examples": {
+          "Endpoints_ListResourceUsage": {
+            "$ref": "./examples/Endpoints_ListResourceUsage.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/ResourceUsageListResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/origins": {
+      "get": {
+        "tags": [
+          "Origins"
+        ],
+        "description": "Lists all of the existing origins within an endpoint.",
+        "operationId": "Origins_ListByEndpoint",
+        "x-ms-examples": {
+          "Origins_ListByEndpoint": {
+            "$ref": "./examples/Origins_ListByEndpoint.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/OriginListResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/origins/{originName}": {
+      "get": {
+        "tags": [
+          "Origins"
+        ],
+        "description": "Gets an existing origin within an endpoint.",
+        "operationId": "Origins_Get",
+        "x-ms-examples": {
+          "Origins_Get": {
+            "$ref": "./examples/Origins_Get.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "originName",
+            "in": "path",
+            "description": "Name of the origin which is unique within the endpoint.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/Origin"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Origins"
+        ],
+        "description": "Creates a new origin within the specified endpoint.",
+        "operationId": "Origins_Create",
+        "x-ms-examples": {
+          "Origins_Create": {
+            "$ref": "./examples/Origins_Create.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "originName",
+            "in": "path",
+            "description": "Name of the origin that is unique within the endpoint.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "origin",
+            "in": "body",
+            "description": "Origin properties",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/Origin"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/Origin"
+            }
+          },
+          "201": {
+            "description": "Created. The request has been fulfilled and a new origin has been created.",
+            "schema": {
+              "$ref": "#/definitions/Origin"
+            }
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/Origin"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "patch": {
+        "tags": [
+          "Origins"
+        ],
+        "description": "Updates an existing origin within an endpoint.",
+        "operationId": "Origins_Update",
+        "x-ms-examples": {
+          "Origins_Update": {
+            "$ref": "./examples/Origins_Update.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "originName",
+            "in": "path",
+            "description": "Name of the origin which is unique within the endpoint.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "originUpdateProperties",
+            "in": "body",
+            "description": "Origin properties",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/OriginUpdateParameters"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/Origin"
+            }
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/Origin"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "delete": {
+        "tags": [
+          "Origins"
+        ],
+        "description": "Deletes an existing origin within an endpoint.",
+        "operationId": "Origins_Delete",
+        "x-ms-examples": {
+          "Origins_Delete": {
+            "$ref": "./examples/Origins_Delete.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "originName",
+            "in": "path",
+            "description": "Name of the origin which is unique within the endpoint.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously."
+          },
+          "204": {
+            "description": "No Content. The request has been accepted but the origin was not found."
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/originGroups": {
+      "get": {
+        "tags": [
+          "OriginGroups"
+        ],
+        "description": "Lists all of the existing origin groups within an endpoint.",
+        "operationId": "OriginGroups_ListByEndpoint",
+        "x-ms-examples": {
+          "OriginsGroups_ListByEndpoint": {
+            "$ref": "./examples/OriginGroups_ListByEndpoint.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/OriginGroupListResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/originGroups/{originGroupName}": {
+      "get": {
+        "tags": [
+          "OriginGroups"
+        ],
+        "description": "Gets an existing origin group within an endpoint.",
+        "operationId": "OriginGroups_Get",
+        "x-ms-examples": {
+          "OriginGroups_Get": {
+            "$ref": "./examples/OriginGroups_Get.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "originGroupName",
+            "in": "path",
+            "description": "Name of the origin group which is unique within the endpoint.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/OriginGroup"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "OriginGroups"
+        ],
+        "description": "Creates a new origin group within the specified endpoint.",
+        "operationId": "OriginGroups_Create",
+        "x-ms-examples": {
+          "OriginGroups_Create": {
+            "$ref": "./examples/OriginGroups_Create.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "originGroupName",
+            "in": "path",
+            "description": "Name of the origin group which is unique within the endpoint.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "originGroup",
+            "in": "body",
+            "description": "Origin group properties",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/OriginGroup"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/OriginGroup"
+            }
+          },
+          "201": {
+            "description": "Created. The request has been fulfilled and a new origin group has been created.",
+            "schema": {
+              "$ref": "#/definitions/OriginGroup"
+            }
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/OriginGroup"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "patch": {
+        "tags": [
+          "OriginGroups"
+        ],
+        "description": "Updates an existing origin group within an endpoint.",
+        "operationId": "OriginGroups_Update",
+        "x-ms-examples": {
+          "OriginGroups_Update": {
+            "$ref": "./examples/OriginGroups_Update.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "originGroupName",
+            "in": "path",
+            "description": "Name of the origin group which is unique within the endpoint.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "originGroupUpdateProperties",
+            "in": "body",
+            "description": "Origin group properties",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/OriginGroupUpdateParameters"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/OriginGroup"
+            }
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/OriginGroup"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "delete": {
+        "tags": [
+          "OriginGroups"
+        ],
+        "description": "Deletes an existing origin group within an endpoint.",
+        "operationId": "OriginGroups_Delete",
+        "x-ms-examples": {
+          "OriginGroups_Delete": {
+            "$ref": "./examples/OriginGroups_Delete.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "originGroupName",
+            "in": "path",
+            "description": "Name of the origin group which is unique within the endpoint.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously."
+          },
+          "204": {
+            "description": "No Content. The request has been accepted but the origin was not found."
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/customDomains": {
+      "get": {
+        "tags": [
+          "CustomDomains"
+        ],
+        "description": "Lists all of the existing custom domains within an endpoint.",
+        "operationId": "CustomDomains_ListByEndpoint",
+        "x-ms-examples": {
+          "CustomDomains_ListByEndpoint": {
+            "$ref": "./examples/CustomDomains_ListByEndpoint.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/CustomDomainListResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/customDomains/{customDomainName}": {
+      "get": {
+        "tags": [
+          "CustomDomains"
+        ],
+        "description": "Gets an existing custom domain within an endpoint.",
+        "operationId": "CustomDomains_Get",
+        "x-ms-examples": {
+          "CustomDomains_Get": {
+            "$ref": "./examples/CustomDomains_Get.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "customDomainName",
+            "in": "path",
+            "description": "Name of the custom domain within an endpoint.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/CustomDomain"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "CustomDomains"
+        ],
+        "description": "Creates a new custom domain within an endpoint.",
+        "operationId": "CustomDomains_Create",
+        "x-ms-examples": {
+          "CustomDomains_Create": {
+            "$ref": "./examples/CustomDomains_Create.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "customDomainName",
+            "in": "path",
+            "description": "Name of the custom domain within an endpoint.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "customDomainProperties",
+            "in": "body",
+            "description": "Properties required to create a new custom domain.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/CustomDomainParameters"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/CustomDomain"
+            }
+          },
+          "201": {
+            "description": "Created. The request has been fulfilled and a new custom domain has been created.",
+            "schema": {
+              "$ref": "#/definitions/CustomDomain"
+            }
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/CustomDomain"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "delete": {
+        "tags": [
+          "CustomDomains"
+        ],
+        "description": "Deletes an existing custom domain within an endpoint.",
+        "operationId": "CustomDomains_Delete",
+        "x-ms-examples": {
+          "CustomDomains_Delete": {
+            "$ref": "./examples/CustomDomains_Delete.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "customDomainName",
+            "in": "path",
+            "description": "Name of the custom domain within an endpoint.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded."
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/CustomDomain"
+            }
+          },
+          "204": {
+            "description": "No Content. The request has been accepted but the custom domain was not found"
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/customDomains/{customDomainName}/disableCustomHttps": {
+      "post": {
+        "tags": [
+          "CustomDomains"
+        ],
+        "description": "Disable https delivery of the custom domain.",
+        "operationId": "CustomDomains_DisableCustomHttps",
+        "x-ms-examples": {
+          "CustomDomains_DisableCustomHttps": {
+            "$ref": "./examples/CustomDomains_DisableCustomHttps.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "customDomainName",
+            "in": "path",
+            "description": "Name of the custom domain within an endpoint.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded."
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/CustomDomain"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/customDomains/{customDomainName}/enableCustomHttps": {
+      "post": {
+        "tags": [
+          "CustomDomains"
+        ],
+        "description": "Enable https delivery of the custom domain.",
+        "operationId": "CustomDomains_EnableCustomHttps",
+        "x-ms-examples": {
+          "CustomDomains_EnableCustomHttpsUsingYourOwnCertificate": {
+            "$ref": "./examples/CustomDomains_EnableCustomHttpsUsingBYOC.json"
+          },
+          "CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate": {
+            "$ref": "./examples/CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "name": "profileName",
+            "in": "path",
+            "description": "Name of the CDN profile which is unique within the resource group.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "endpointName",
+            "in": "path",
+            "description": "Name of the endpoint under the profile which is unique globally.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "customDomainName",
+            "in": "path",
+            "description": "Name of the custom domain within an endpoint.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "customDomainHttpsParameters",
+            "in": "body",
+            "description": "The configuration specifying how to enable HTTPS for the custom domain - using CDN managed certificate or user's own certificate. If not specified, enabling ssl uses CDN managed certificate by default.",
+            "required": false,
+            "schema": {
+              "$ref": "#/definitions/CustomDomainHttpsParameters"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded."
+          },
+          "202": {
+            "description": "Accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/CustomDomain"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/providers/Microsoft.Cdn/checkNameAvailability": {
+      "post": {
+        "tags": [
+          "CheckNameAvailability"
+        ],
+        "description": "Check the availability of a resource name. This is needed for resources where name is globally unique, such as a CDN endpoint.",
+        "operationId": "CheckNameAvailability",
+        "x-ms-examples": {
+          "CheckNameAvailability": {
+            "$ref": "./examples/CheckNameAvailability.json"
+          }
+        },
+        "parameters": [
+          {
+            "name": "checkNameAvailabilityInput",
+            "in": "body",
+            "description": "Input to check.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/CheckNameAvailabilityInput"
+            }
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/CheckNameAvailabilityOutput"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Cdn/checkNameAvailability": {
+      "post": {
+        "tags": [
+          "CheckNameAvailabilityWithSubscription"
+        ],
+        "description": "Check the availability of a resource name. This is needed for resources where name is globally unique, such as a CDN endpoint.",
+        "operationId": "CheckNameAvailabilityWithSubscription",
+        "x-ms-examples": {
+          "CheckNameAvailabilityWithSubscription": {
+            "$ref": "./examples/CheckNameAvailabilityWithSubscription.json"
+          }
+        },
+        "parameters": [
+          {
+            "name": "checkNameAvailabilityInput",
+            "in": "body",
+            "description": "Input to check.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/CheckNameAvailabilityInput"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/CheckNameAvailabilityOutput"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Cdn/validateProbe": {
+      "post": {
+        "tags": [
+          "ValidateProbe"
+        ],
+        "description": "Check if the probe path is a valid path and the file can be accessed. Probe path is the path to a file hosted on the origin server to help accelerate the delivery of dynamic content via the CDN endpoint. This path is relative to the origin path specified in the endpoint configuration.",
+        "operationId": "ValidateProbe",
+        "x-ms-examples": {
+          "ValidateProbe": {
+            "$ref": "./examples/ValidateProbe.json"
+          }
+        },
+        "parameters": [
+          {
+            "name": "validateProbeInput",
+            "in": "body",
+            "description": "Input to check.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ValidateProbeInput"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/ValidateProbeOutput"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Cdn/checkResourceUsage": {
+      "post": {
+        "tags": [
+          "CheckResourceUsage"
+        ],
+        "description": "Check the quota and actual usage of the CDN profiles under the given subscription.",
+        "operationId": "ResourceUsage_List",
+        "x-ms-examples": {
+          "ResourceUsage_List": {
+            "$ref": "./examples/ResourceUsage_List.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/ResourceUsageListResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/providers/Microsoft.Cdn/operations": {
+      "get": {
+        "tags": [
+          "Operations"
+        ],
+        "description": "Lists all of the available CDN REST API operations.",
+        "operationId": "Operations_List",
+        "x-ms-examples": {
+          "Operations_List": {
+            "$ref": "./examples/Operations_List.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/OperationsListResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/providers/Microsoft.Cdn/edgenodes": {
+      "get": {
+        "tags": [
+          "Edgenodes"
+        ],
+        "description": "Edgenodes are the global Point of Presence (POP) locations used to deliver CDN content to end users.",
+        "operationId": "EdgeNodes_List",
+        "x-ms-examples": {
+          "EdgeNodes_List": {
+            "$ref": "./examples/EdgeNodes_List.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/EdgenodeResult"
+            }
+          },
+          "default": {
+            "description": "CDN error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    }
+  },
+  "definitions": {
+    "Profile": {
+      "description": "CDN profile is a logical grouping of endpoints that share the same settings, such as CDN provider and pricing tier.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/TrackedResource"
+        }
+      ],
+      "properties": {
+        "sku": {
+          "description": "The pricing tier (defines a CDN provider, feature list and rate) of the CDN profile.",
+          "$ref": "#/definitions/Sku"
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ProfileProperties"
+        }
+      },
+      "required": [
+        "sku"
+      ]
+    },
+    "ProfileProperties": {
+      "description": "The JSON object that contains the properties required to create a profile.",
+      "properties": {
+        "resourceState": {
+          "description": "Resource status of the profile.",
+          "readOnly": true,
+          "enum": [
+            "Creating",
+            "Active",
+            "Deleting",
+            "Disabled"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "ProfileResourceState",
+            "modelAsString": true
+          }
+        },
+        "provisioningState": {
+          "readOnly": true,
+          "description": "Provisioning status of the profile.",
+          "type": "string"
+        }
+      }
+    },
+    "ProfileListResult": {
+      "description": "Result of the request to list profiles. It contains a list of profile objects and a URL link to get the next set of results.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/Profile"
+          },
+          "description": "List of CDN profiles within a resource group."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of profile objects if there are any."
+        }
+      }
+    },
+    "ProfileUpdateParameters": {
+      "type": "object",
+      "description": "Properties required to update a profile.",
+      "properties": {
+        "tags": {
+          "description": "Profile tags",
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "SsoUri": {
+      "description": "The URI required to login to the supplemental portal from the Azure portal.",
+      "type": "object",
+      "properties": {
+        "ssoUriValue": {
+          "description": "The URI used to login to the supplemental portal.",
+          "readOnly": true,
+          "type": "string"
+        }
+      }
+    },
+    "SupportedOptimizationTypesListResult": {
+      "description": "The result of the GetSupportedOptimizationTypes API",
+      "type": "object",
+      "properties": {
+        "supportedOptimizationTypes": {
+          "description": "Supported optimization types for a profile.",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/OptimizationType"
+          },
+          "type": "array"
+        }
+      }
+    },
+    "Endpoint": {
+      "description": "CDN endpoint is the entity within a CDN profile containing configuration information such as origin, protocol, content caching and delivery behavior. The CDN endpoint uses the URL format <endpointname>.azureedge.net.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/TrackedResource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/EndpointProperties"
+        }
+      }
+    },
+    "EndpointProperties": {
+      "description": "The JSON object that contains the properties required to create an endpoint.",
+      "required": [
+        "origins"
+      ],
+      "allOf": [
+        {
+          "$ref": "#/definitions/EndpointPropertiesUpdateParameters"
+        }
+      ],
+      "properties": {
+        "hostName": {
+          "description": "The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net",
+          "type": "string",
+          "readOnly": true
+        },
+        "origins": {
+          "description": "The source of the content being delivered via CDN.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DeepCreatedOrigin"
+          }
+        },
+        "originGroups": {
+          "description": "The origin groups comprising of origins that are used for load balancing the traffic based on availability.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DeepCreatedOriginGroup"
+          }
+        },
+        "resourceState": {
+          "description": "Resource status of the endpoint.",
+          "readOnly": true,
+          "enum": [
+            "Creating",
+            "Deleting",
+            "Running",
+            "Starting",
+            "Stopped",
+            "Stopping"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "EndpointResourceState",
+            "modelAsString": true
+          }
+        },
+        "provisioningState": {
+          "readOnly": true,
+          "description": "Provisioning status of the endpoint.",
+          "type": "string"
+        }
+      }
+    },
+    "EndpointListResult": {
+      "description": "Result of the request to list endpoints. It contains a list of endpoint objects and a URL link to get the next set of results.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/Endpoint"
+          },
+          "description": "List of CDN endpoints within a profile"
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of endpoint objects if there is any."
+        }
+      }
+    },
+    "EndpointUpdateParameters": {
+      "type": "object",
+      "description": "Properties required to create or update an endpoint.",
+      "properties": {
+        "tags": {
+          "description": "Endpoint tags.",
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/EndpointPropertiesUpdateParameters"
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "EndpointPropertiesUpdateParameters": {
+      "description": "The JSON object containing endpoint update parameters.",
+      "properties": {
+        "originPath": {
+          "description": "A directory path on the origin that CDN can use to retrieve content from, e.g. contoso.cloudapp.net/originpath.",
+          "type": "string"
+        },
+        "contentTypesToCompress": {
+          "description": "List of content types on which compression applies. The value should be a valid MIME type.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "originHostHeader": {
+          "description": "The host header value sent to the origin with each request. This property at Endpoint is only allowed when endpoint uses single origin and can be overridden by the same property specified at origin.If you leave this blank, the request hostname determines this value. Azure CDN origins, such as Web Apps, Blob Storage, and Cloud Services require this host header value to match the origin hostname by default.",
+          "type": "string"
+        },
+        "isCompressionEnabled": {
+          "description": "Indicates whether content compression is enabled on CDN. Default value is false. If compression is enabled, content will be served as compressed if user requests for a compressed version. Content won't be compressed on CDN when requested content is smaller than 1 byte or larger than 1 MB.",
+          "type": "boolean"
+        },
+        "isHttpAllowed": {
+          "description": "Indicates whether HTTP traffic is allowed on the endpoint. Default value is true. At least one protocol (HTTP or HTTPS) must be allowed.",
+          "type": "boolean"
+        },
+        "isHttpsAllowed": {
+          "description": "Indicates whether HTTPS traffic is allowed on the endpoint. Default value is true. At least one protocol (HTTP or HTTPS) must be allowed.",
+          "type": "boolean"
+        },
+        "queryStringCachingBehavior": {
+          "description": "Defines how CDN caches requests that include query strings. You can ignore any query strings when caching, bypass caching to prevent requests that contain query strings from being cached, or cache every request with a unique URL.",
+          "$ref": "#/definitions/QueryStringCachingBehavior"
+        },
+        "optimizationType": {
+          "description": "Specifies what scenario the customer wants this CDN endpoint to optimize for, e.g. Download, Media services. With this information, CDN can apply scenario driven optimization.",
+          "$ref": "#/definitions/OptimizationType"
+        },
+        "probePath": {
+          "description": "Path to a file hosted on the origin which helps accelerate delivery of the dynamic content and calculate the most optimal routes for the CDN. This is relative to the origin path. This property is only relevant when using a single origin.",
+          "type": "string"
+        },
+        "geoFilters": {
+          "description": "List of rules defining the user's geo access within a CDN endpoint. Each geo filter defines an access rule to a specified path or content, e.g. block APAC for path /pictures/",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/GeoFilter"
+          }
+        },
+        "defaultOriginGroup": {
+          "description": "A reference to the origin group.",
+          "type": "object",
+          "$ref": "#/definitions/ResourceReference"
+        },
+        "urlSigningKeys": {
+          "description": "List of keys used to validate the signed URL hashes.",
+          "type": "array",
+          "$ref": "#/definitions/UrlSigningKey"
+        },
+        "deliveryPolicy": {
+          "description": "A policy that specifies the delivery rules to be used for an endpoint.",
+          "type": "object",
+          "required": [
+            "rules"
+          ],
+          "properties": {
+            "description": {
+              "description": "User-friendly description of the policy.",
+              "type": "string"
+            },
+            "rules": {
+              "description": "A list of the delivery rules.",
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/DeliveryRule"
+              }
+            }
+          }
+        },
+        "webApplicationFirewallPolicyLink": {
+          "description": "Defines the Web Application Firewall policy for the endpoint (if applicable)",
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string",
+              "description": "Resource ID."
+            }
+          }
+        }
+      }
+    },
+    "DeliveryRule": {
+      "description": "A rule that specifies a set of actions and conditions",
+      "type": "object",
+      "required": [
+        "order",
+        "actions"
+      ],
+      "properties": {
+        "name": {
+          "description": "Name of the rule",
+          "type": "string"
+        },
+        "order": {
+          "description": "The order in which the rules are applied for the endpoint. Possible values {0,1,2,3,………}. A rule with a lesser order will be applied before a rule with a greater order. Rule with order 0 is a special rule. It does not require any condition and actions listed in it will always be applied.",
+          "type": "integer"
+        },
+        "conditions": {
+          "description": "A list of conditions that must be matched for the actions to be executed",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DeliveryRuleCondition"
+          }
+        },
+        "actions": {
+          "description": "A list of actions that are executed when all the conditions of a rule are satisfied.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DeliveryRuleAction"
+          }
+        }
+      }
+    },
+    "DeliveryRuleCondition": {
+      "description": "A condition for the delivery rule.",
+      "discriminator": "name",
+      "required": [
+        "name"
+      ],
+      "properties": {
+        "name": {
+          "description": "The name of the condition for the delivery rule.",
+          "type": "string",
+          "enum": [
+            "RemoteAddress",
+            "RequestMethod",
+            "QueryString",
+            "PostArgs",
+            "RequestUri",
+            "RequestHeader",
+            "RequestBody",
+            "RequestScheme",
+            "UrlPath",
+            "UrlFileExtension",
+            "UrlFileName",
+            "HttpVersion",
+            "Cookies",
+            "IsDevice"
+          ],
+          "x-ms-enum": {
+            "name": "MatchVariable",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "DeliveryRuleRemoteAddressCondition": {
+      "description": "Defines the RemoteAddress condition for the delivery rule.",
+      "x-ms-discriminator-value": "RemoteAddress",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/RemoteAddressMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleRequestMethodCondition": {
+      "description": "Defines the RequestMethod condition for the delivery rule.",
+      "x-ms-discriminator-value": "RequestMethod",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/RequestMethodMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleQueryStringCondition": {
+      "description": "Defines the QueryString condition for the delivery rule.",
+      "x-ms-discriminator-value": "QueryString",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/QueryStringMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRulePostArgsCondition": {
+      "description": "Defines the PostArgs condition for the delivery rule.",
+      "x-ms-discriminator-value": "PostArgs",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/PostArgsMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleRequestUriCondition": {
+      "description": "Defines the RequestUri condition for the delivery rule.",
+      "x-ms-discriminator-value": "RequestUri",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/RequestUriMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleRequestHeaderCondition": {
+      "description": "Defines the RequestHeader condition for the delivery rule.",
+      "x-ms-discriminator-value": "RequestHeader",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/RequestHeaderMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleRequestBodyCondition": {
+      "description": "Defines the RequestBody condition for the delivery rule.",
+      "x-ms-discriminator-value": "RequestBody",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/RequestBodyMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleRequestSchemeCondition": {
+      "description": "Defines the RequestScheme condition for the delivery rule.",
+      "x-ms-discriminator-value": "RequestScheme",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/RequestSchemeMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleUrlPathCondition": {
+      "description": "Defines the UrlPath condition for the delivery rule.",
+      "x-ms-discriminator-value": "UrlPath",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/UrlPathMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleUrlFileExtensionCondition": {
+      "description": "Defines the UrlFileExtension condition for the delivery rule.",
+      "x-ms-discriminator-value": "UrlFileExtension",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/UrlFileExtensionMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleUrlFileNameCondition": {
+      "description": "Defines the UrlFileName condition for the delivery rule.",
+      "x-ms-discriminator-value": "UrlFileName",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/UrlFileNameMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleHttpVersionCondition": {
+      "description": "Defines the HttpVersion condition for the delivery rule.",
+      "x-ms-discriminator-value": "HttpVersion",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/HttpVersionMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleCookiesCondition": {
+      "description": "Defines the Cookies condition for the delivery rule.",
+      "x-ms-discriminator-value": "Cookies",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/CookiesMatchConditionParameters"
+        }
+      }
+    },
+    "DeliveryRuleIsDeviceCondition": {
+      "description": "Defines the IsDevice condition for the delivery rule.",
+      "x-ms-discriminator-value": "IsDevice",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleCondition"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the condition.",
+          "$ref": "#/definitions/IsDeviceMatchConditionParameters"
+        }
+      }
+    },
+    "RemoteAddressMatchConditionParameters": {
+      "description": "Defines the parameters for RemoteAddress match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleRemoteAddressConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "IPMatch",
+            "GeoMatch"
+          ],
+          "x-ms-enum": {
+            "name": "RemoteAddressOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "Match values to match against. The operator will apply to each value in here with OR semantics. If any of them match the variable with the given operator this match condition is considered a match.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "RequestMethodMatchConditionParameters": {
+      "description": "Defines the parameters for RequestMethod match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestMethodConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Equal"
+          ],
+          "x-ms-enum": {
+            "name": "RequestMethodOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "GET",
+              "HEAD",
+              "POST",
+              "PUT",
+              "DELETE",
+              "OPTIONS",
+              "TRACE"
+            ]
+          }
+        }
+      }
+    },
+    "QueryStringMatchConditionParameters": {
+      "description": "Defines the parameters for QueryString match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleQueryStringConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "Equal",
+            "Contains",
+            "BeginsWith",
+            "EndsWith",
+            "LessThan",
+            "LessThanOrEqual",
+            "GreaterThan",
+            "GreaterThanOrEqual"
+          ],
+          "x-ms-enum": {
+            "name": "QueryStringOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "PostArgsMatchConditionParameters": {
+      "description": "Defines the parameters for PostArgs match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "selector",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRulePostArgsConditionParameters"
+          ]
+        },
+        "selector": {
+          "description": "Name of PostArg to be matched",
+          "type": "string"
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "Equal",
+            "Contains",
+            "BeginsWith",
+            "EndsWith",
+            "LessThan",
+            "LessThanOrEqual",
+            "GreaterThan",
+            "GreaterThanOrEqual"
+          ],
+          "x-ms-enum": {
+            "name": "PostArgsOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "RequestUriMatchConditionParameters": {
+      "description": "Defines the parameters for RequestUri match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestUriConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "Equal",
+            "Contains",
+            "BeginsWith",
+            "EndsWith",
+            "LessThan",
+            "LessThanOrEqual",
+            "GreaterThan",
+            "GreaterThanOrEqual"
+          ],
+          "x-ms-enum": {
+            "name": "RequestUriOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "RequestHeaderMatchConditionParameters": {
+      "description": "Defines the parameters for RequestHeader match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "selector",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestHeaderConditionParameters"
+          ]
+        },
+        "selector": {
+          "description": "Name of Header to be matched",
+          "type": "string"
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "Equal",
+            "Contains",
+            "BeginsWith",
+            "EndsWith",
+            "LessThan",
+            "LessThanOrEqual",
+            "GreaterThan",
+            "GreaterThanOrEqual"
+          ],
+          "x-ms-enum": {
+            "name": "RequestHeaderOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "RequestBodyMatchConditionParameters": {
+      "description": "Defines the parameters for RequestBody match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestBodyConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "Equal",
+            "Contains",
+            "BeginsWith",
+            "EndsWith",
+            "LessThan",
+            "LessThanOrEqual",
+            "GreaterThan",
+            "GreaterThanOrEqual"
+          ],
+          "x-ms-enum": {
+            "name": "RequestBodyOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "RequestSchemeMatchConditionParameters": {
+      "description": "Defines the parameters for RequestScheme match conditions ",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestSchemeConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Equal"
+          ]
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "HTTP",
+              "HTTPS"
+            ]
+          }
+        }
+      }
+    },
+    "UrlPathMatchConditionParameters": {
+      "description": "Defines the parameters for UrlPath match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlPathMatchConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "Equal",
+            "Contains",
+            "BeginsWith",
+            "EndsWith",
+            "LessThan",
+            "LessThanOrEqual",
+            "GreaterThan",
+            "GreaterThanOrEqual",
+            "Wildcard"
+          ],
+          "x-ms-enum": {
+            "name": "UrlPathOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "UrlFileExtensionMatchConditionParameters": {
+      "description": "Defines the parameters for UrlFileExtension match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlFileExtensionMatchConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "Equal",
+            "Contains",
+            "BeginsWith",
+            "EndsWith",
+            "LessThan",
+            "LessThanOrEqual",
+            "GreaterThan",
+            "GreaterThanOrEqual"
+          ],
+          "x-ms-enum": {
+            "name": "UrlFileExtensionOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "UrlFileNameMatchConditionParameters": {
+      "description": "Defines the parameters for UrlFilename match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlFilenameConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "Equal",
+            "Contains",
+            "BeginsWith",
+            "EndsWith",
+            "LessThan",
+            "LessThanOrEqual",
+            "GreaterThan",
+            "GreaterThanOrEqual"
+          ],
+          "x-ms-enum": {
+            "name": "UrlFileNameOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "HttpVersionMatchConditionParameters": {
+      "description": "Defines the parameters for HttpVersion match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleHttpVersionConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Equal"
+          ],
+          "x-ms-enum": {
+            "name": "HttpVersionOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "CookiesMatchConditionParameters": {
+      "description": "Defines the parameters for Cookies match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "selector",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleCookiesConditionParameters"
+          ]
+        },
+        "selector": {
+          "description": "Name of Cookies to be matched",
+          "type": "string"
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "Equal",
+            "Contains",
+            "BeginsWith",
+            "EndsWith",
+            "LessThan",
+            "LessThanOrEqual",
+            "GreaterThan",
+            "GreaterThanOrEqual"
+          ],
+          "x-ms-enum": {
+            "name": "CookiesOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "IsDeviceMatchConditionParameters": {
+      "description": "Defines the parameters for IsDevice match conditions",
+      "required": [
+        "operator",
+        "matchValues",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleIsDeviceConditionParameters"
+          ]
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Equal"
+          ],
+          "x-ms-enum": {
+            "name": "IsDeviceOperator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if this is negate condition or not",
+          "type": "boolean"
+        },
+        "matchValues": {
+          "description": "The match value for the condition of the delivery rule",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "Mobile",
+              "Desktop"
+            ]
+          }
+        },
+        "transforms": {
+          "description": "List of transforms",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/transform"
+          }
+        }
+      }
+    },
+    "DeliveryRuleAction": {
+      "description": "An action for the delivery rule.",
+      "discriminator": "name",
+      "required": [
+        "name"
+      ],
+      "properties": {
+        "name": {
+          "description": "The name of the action for the delivery rule.",
+          "type": "string",
+          "enum": [
+            "CacheExpiration",
+            "CacheKeyQueryString",
+            "ModifyRequestHeader",
+            "ModifyResponseHeader",
+            "UrlRedirect",
+            "UrlRewrite",
+            "UrlSigning"
+          ],
+          "x-ms-enum": {
+            "name": "DeliveryRuleAction",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "UrlRedirectAction": {
+      "description": "Defines the url redirect action for the delivery rule.",
+      "x-ms-discriminator-value": "UrlRedirect",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleAction"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the action.",
+          "$ref": "#/definitions/UrlRedirectActionParameters"
+        }
+      }
+    },
+    "UrlRedirectActionParameters": {
+      "description": "Defines the parameters for the url redirect action.",
+      "required": [
+        "redirectType",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlRedirectActionParameters"
+          ]
+        },
+        "redirectType": {
+          "description": "The redirect type the rule will use when redirecting traffic.",
+          "type": "string",
+          "enum": [
+            "Moved",
+            "Found",
+            "TemporaryRedirect",
+            "PermanentRedirect"
+          ],
+          "x-ms-enum": {
+            "name": "RedirectType",
+            "modelAsString": true
+          }
+        },
+        "destinationProtocol": {
+          "description": "Protocol to use for the redirect. The default value is MatchRequest",
+          "type": "string",
+          "enum": [
+            "MatchRequest",
+            "Http",
+            "Https"
+          ],
+          "x-ms-enum": {
+            "name": "DestinationProtocol",
+            "modelAsString": true
+          }
+        },
+        "customPath": {
+          "description": "The full path to redirect. Path cannot be empty and must start with /. Leave empty to use the incoming path as destination path.",
+          "type": "string"
+        },
+        "customHostname": {
+          "description": "Host to redirect. Leave empty to use the incoming host as the destination host.",
+          "type": "string"
+        },
+        "customQueryString": {
+          "description": "The set of query strings to be placed in the redirect URL. Setting this value would replace any existing query string; leave empty to preserve the incoming query string. Query string must be in <key>=<value> format. ? and & will be added automatically so do not include them.",
+          "type": "string"
+        },
+        "customFragment": {
+          "type": "string",
+          "description": "Fragment to add to the redirect URL. Fragment is the part of the URL that comes after #. Do not include the #."
+        }
+      }
+    },
+    "UrlSigningActionParameters": {
+      "description": "Defines the parameters for the Url Signing action.",
+      "required": [
+        "keyId"
+      ],
+      "properties": {
+        "keyId": {
+          "description": "Id reference of the key to be used to verify the hash and should be defined in UrlSigningKeys",
+          "type": "string"
+        },
+        "algorithm": {
+          "description": "Algorithm to use for URL signing",
+          "type": "string",
+          "enum": [
+            "SHA256"
+          ]
+        },
+        "parameterNameOverride": {
+          "description": "Defines which query string parameters in the url to be considered for expires, key id etc. ",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/UrlSigningParamIdentifier"
+          }
+        },
+        "ipSubnets": {
+          "description": "Match values to match against. Supports CIDR ranges (both IPv4 and IPv6).",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "UrlSigningParamIdentifier": {
+      "description": "Defines how to identify a parameter for a specific purpose e.g. expires",
+      "required": [
+        "paramIndicator",
+        "paramName"
+      ],
+      "properties": {
+        "paramIndicator": {
+          "description": "Indicates the purpose of the parameter",
+          "type": "string",
+          "enum": [
+            "expires",
+            "keyId",
+            "signature"
+          ]
+        },
+        "paramName": {
+          "description": "Parameter name",
+          "type": "string"
+        }
+      }
+    },
+    "UrlRewriteAction": {
+      "description": "Defines the url rewrite action for the delivery rule.",
+      "x-ms-discriminator-value": "UrlRewrite",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleAction"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the action.",
+          "$ref": "#/definitions/UrlRewriteActionParameters"
+        }
+      }
+    },
+    "UrlRewriteActionParameters": {
+      "description": "Defines the parameters for the url rewrite action.",
+      "required": [
+        "sourcePattern",
+        "destination",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlRewriteActionParameters"
+          ]
+        },
+        "sourcePattern": {
+          "description": "define a request URI pattern that identifies the type of requests that may be rewritten. If value is blank, all strings are matched.",
+          "type": "string"
+        },
+        "destination": {
+          "description": "Define the relative URL to which the above requests will be rewritten by.",
+          "type": "string"
+        },
+        "preserveUnmatchedPath": {
+          "description": "Whether to preserve unmatched path. Default value is true.",
+          "type": "boolean"
+        }
+      }
+    },
+    "DeliveryRuleRequestHeaderAction": {
+      "description": "Defines the request header action for the delivery rule.",
+      "x-ms-discriminator-value": "ModifyRequestHeader",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleAction"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the action.",
+          "$ref": "#/definitions/HeaderActionParameters"
+        }
+      }
+    },
+    "DeliveryRuleResponseHeaderAction": {
+      "description": "Defines the response header action for the delivery rule.",
+      "x-ms-discriminator-value": "ModifyResponseHeader",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleAction"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the action.",
+          "$ref": "#/definitions/HeaderActionParameters"
+        }
+      }
+    },
+    "HeaderActionParameters": {
+      "description": "Defines the parameters for the request header action.",
+      "required": [
+        "headerAction",
+        "headerName",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleHeaderActionParameters"
+          ]
+        },
+        "headerAction": {
+          "description": "Action to perform",
+          "type": "string",
+          "enum": [
+            "Append",
+            "Overwrite",
+            "Delete"
+          ],
+          "x-ms-enum": {
+            "name": "HeaderAction",
+            "modelAsString": true
+          }
+        },
+        "headerName": {
+          "description": "Name of the header to modify",
+          "type": "string"
+        },
+        "value": {
+          "description": "Value for the specified action",
+          "type": "string"
+        }
+      }
+    },
+    "DeliveryRuleCacheExpirationAction": {
+      "description": "Defines the cache expiration action for the delivery rule.",
+      "x-ms-discriminator-value": "CacheExpiration",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleAction"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the action.",
+          "$ref": "#/definitions/CacheExpirationActionParameters"
+        }
+      }
+    },
+    "CacheExpirationActionParameters": {
+      "description": "Defines the parameters for the cache expiration action.",
+      "required": [
+        "cacheBehavior",
+        "cacheType",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleCacheExpirationActionParameters"
+          ]
+        },
+        "cacheBehavior": {
+          "description": "Caching behavior for the requests",
+          "type": "string",
+          "enum": [
+            "BypassCache",
+            "Override",
+            "SetIfMissing"
+          ],
+          "x-ms-enum": {
+            "name": "cacheBehavior",
+            "modelAsString": true
+          }
+        },
+        "cacheType": {
+          "description": "The level at which the content needs to be cached.",
+          "type": "string",
+          "enum": [
+            "All"
+          ],
+          "x-ms-enum": {
+            "name": "CacheType",
+            "modelAsString": true
+          }
+        },
+        "cacheDuration": {
+          "description": "The duration for which the content needs to be cached. Allowed format is [d.]hh:mm:ss",
+          "type": "string",
+          "x-nullable": true
+        }
+      }
+    },
+    "DeliveryRuleCacheKeyQueryStringAction": {
+      "description": "Defines the cache-key query string action for the delivery rule.",
+      "x-ms-discriminator-value": "CacheKeyQueryString",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeliveryRuleAction"
+        }
+      ],
+      "required": [
+        "parameters"
+      ],
+      "properties": {
+        "parameters": {
+          "description": "Defines the parameters for the action.",
+          "$ref": "#/definitions/CacheKeyQueryStringActionParameters"
+        }
+      }
+    },
+    "CacheKeyQueryStringActionParameters": {
+      "description": "Defines the parameters for the cache-key query string action.",
+      "required": [
+        "queryStringBehavior",
+        "@odata.type"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.DeliveryRuleCacheKeyQueryStringBehaviorActionParameters"
+          ]
+        },
+        "queryStringBehavior": {
+          "description": "Caching behavior for the requests",
+          "type": "string",
+          "enum": [
+            "Include",
+            "IncludeAll",
+            "Exclude",
+            "ExcludeAll"
+          ],
+          "x-ms-enum": {
+            "name": "queryStringBehavior",
+            "modelAsString": true
+          }
+        },
+        "queryParameters": {
+          "description": "query parameters to include or exclude (comma separated).",
+          "type": "string",
+          "x-nullable": true
+        }
+      }
+    },
+    "transform": {
+      "description": "Describes what transforms are applied before matching",
+      "type": "string",
+      "enum": [
+        "Lowercase",
+        "Uppercase"
+      ],
+      "x-ms-enum": {
+        "name": "transform",
+        "modelAsString": true
+      }
+    },
+    "DeepCreatedOrigin": {
+      "description": "The main origin of CDN content which is added when creating a CDN endpoint.",
+      "type": "object",
+      "required": [
+        "name"
+      ],
+      "properties": {
+        "name": {
+          "description": "Origin name which must be unique within the endpoint. ",
+          "type": "string"
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/DeepCreatedOriginProperties"
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "DeepCreatedOriginProperties": {
+      "description": "Properties of the origin created on the CDN endpoint.",
+      "type": "object",
+      "required": [
+        "hostName"
+      ],
+      "properties": {
+        "hostName": {
+          "description": "The address of the origin. It can be a domain name, IPv4 address, or IPv6 address. This should be unique across all origins in an endpoint.",
+          "type": "string"
+        },
+        "httpPort": {
+          "description": "The value of the HTTP port. Must be between 1 and 65535.",
+          "type": "integer",
+          "maximum": 65535,
+          "exclusiveMaximum": false,
+          "minimum": 1,
+          "exclusiveMinimum": false
+        },
+        "httpsPort": {
+          "description": "The value of the HTTPS port. Must be between 1 and 65535.",
+          "type": "integer",
+          "maximum": 65535,
+          "exclusiveMaximum": false,
+          "minimum": 1,
+          "exclusiveMinimum": false
+        },
+        "originHostHeader": {
+          "description": "The host header value sent to the origin with each request. If you leave this blank, the request hostname determines this value. Azure CDN origins, such as Web Apps, Blob Storage, and Cloud Services require this host header value to match the origin hostname by default.",
+          "type": "string"
+        },
+        "priority": {
+          "description": "Priority of origin in given origin group for load balancing. Higher priorities will not be used for load balancing if any lower priority origin is healthy.Must be between 1 and 5.",
+          "type": "integer",
+          "maximum": 5,
+          "minimum": 1
+        },
+        "weight": {
+          "description": "Weight of the origin in given origin group for load balancing. Must be between 1 and 1000",
+          "type": "integer",
+          "maximum": 1000,
+          "minimum": 1
+        },
+        "enabled": {
+          "description": "Origin is enabled for load balancing or not. By default, origin is always enabled.",
+          "type": "boolean"
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "DeepCreatedOriginGroup": {
+      "description": "The origin group for CDN content which is added when creating a CDN endpoint. Traffic is sent to the origins within the origin group based on origin health.",
+      "type": "object",
+      "required": [
+        "name"
+      ],
+      "properties": {
+        "name": {
+          "description": "Origin group name which must be unique within the endpoint.",
+          "type": "string"
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/DeepCreatedOriginGroupProperties"
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "DeepCreatedOriginGroupProperties": {
+      "description": "Properties of the origin group created on the CDN endpoint.",
+      "type": "object",
+      "required": [
+        "origins"
+      ],
+      "properties": {
+        "healthProbeSettings": {
+          "description": "Health probe settings to the origin that is used to determine the health of the origin.",
+          "type": "object",
+          "$ref": "#/definitions/HealthProbeParameters"
+        },
+        "origins": {
+          "description": "The source of the content being delivered via CDN within given origin group.",
+          "type": "array",
+          "items": {
+            "description": "A reference to a origin.",
+            "$ref": "#/definitions/ResourceReference"
+          }
+        },
+        "trafficRestorationTimeToHealedOrNewEndpointsInMinutes": {
+          "description": "Time in minutes to shift the traffic to the endpoint gradually when an unhealthy endpoint comes healthy or a new endpoint is added. Default is 10 mins. This property is currently not supported.",
+          "type": "integer",
+          "maximum": 50,
+          "minimum": 0
+        },
+        "responseBasedOriginErrorDetectionSettings": {
+          "description": "The JSON object that contains the properties to determine origin health using real requests/responses.This property is currently not supported.",
+          "type": "object",
+          "$ref": "#/definitions/ResponseBasedOriginErrorDetectionParameters"
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "ResourceReference": {
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Resource ID."
+        }
+      },
+      "description": "Reference to another resource.",
+      "x-ms-azure-resource": true
+    },
+    "GeoFilter": {
+      "description": "Rules defining user's geo access within a CDN endpoint.",
+      "type": "object",
+      "required": [
+        "relativePath",
+        "action",
+        "countryCodes"
+      ],
+      "properties": {
+        "relativePath": {
+          "description": "Relative path applicable to geo filter. (e.g. '/mypictures', '/mypicture/kitty.jpg', and etc.)",
+          "type": "string"
+        },
+        "action": {
+          "description": "Action of the geo filter, i.e. allow or block access.",
+          "enum": [
+            "Block",
+            "Allow"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "GeoFilterActions",
+            "modelAsString": false
+          }
+        },
+        "countryCodes": {
+          "description": "Two letter country codes defining user country access in a geo filter, e.g. AU, MX, US.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "PurgeParameters": {
+      "type": "object",
+      "description": "Parameters required for content purge.",
+      "required": [
+        "contentPaths"
+      ],
+      "properties": {
+        "contentPaths": {
+          "description": "The path to the content to be purged. Can describe a file path or a wild card directory.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "UrlSigningKey": {
+      "description": "Url signing key",
+      "required": [
+        "keyId",
+        "keySourceParameters"
+      ],
+      "properties": {
+        "keyId": {
+          "description": "Defines the customer defined key Id. This id will exist in the incoming request to indicate the key used to form the hash.",
+          "type": "string"
+        },
+        "keySourceParameters": {
+          "description": "Defines the parameters for using customer key vault for Url Signing Key.",
+          "$ref": "#/definitions/KeyVaultSigningKeyParameters"
+        }
+      }
+    },
+    "KeyVaultSigningKeyParameters": {
+      "description": "Describes the parameters for using a user's KeyVault for URL Signing Key.",
+      "required": [
+        "@odata.type",
+        "subscriptionId",
+        "resourceGroupName",
+        "vaultName",
+        "secretName",
+        "secretVersion"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.KeyVaultSigningKeyParameters"
+          ]
+        },
+        "subscriptionId": {
+          "description": "Subscription Id of the user's Key Vault containing the secret",
+          "type": "string"
+        },
+        "resourceGroupName": {
+          "description": "Resource group of the user's Key Vault containing the secret",
+          "type": "string"
+        },
+        "vaultName": {
+          "description": "The name of the user's Key Vault containing the secret",
+          "type": "string"
+        },
+        "secretName": {
+          "description": "The name of secret in Key Vault.",
+          "type": "string"
+        },
+        "secretVersion": {
+          "description": "The version(GUID) of secret in Key Vault.",
+          "type": "string"
+        }
+      }
+    },
+    "LoadParameters": {
+      "type": "object",
+      "description": "Parameters required for content load.",
+      "required": [
+        "contentPaths"
+      ],
+      "properties": {
+        "contentPaths": {
+          "description": "The path to the content to be loaded. Path should be a relative file URL of the origin.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "Origin": {
+      "description": "CDN origin is the source of the content being delivered via CDN. When the edge nodes represented by an endpoint do not have the requested content cached, they attempt to fetch it from one or more of the configured origins.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/TrackedResource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/OriginProperties"
+        }
+      }
+    },
+    "OriginProperties": {
+      "description": "The JSON object that contains the properties of the origin.",
+      "required": [
+        "hostName"
+      ],
+      "allOf": [
+        {
+          "$ref": "#/definitions/OriginUpdatePropertiesParameters"
+        }
+      ],
+      "properties": {
+        "resourceState": {
+          "description": "Resource status of the origin.",
+          "readOnly": true,
+          "enum": [
+            "Creating",
+            "Active",
+            "Deleting"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "OriginResourceState",
+            "modelAsString": true
+          }
+        },
+        "provisioningState": {
+          "readOnly": true,
+          "description": "Provisioning status of the origin.",
+          "type": "string"
+        }
+      }
+    },
+    "OriginUpdateParameters": {
+      "type": "object",
+      "description": "Origin properties needed for origin update.",
+      "properties": {
+        "tags": {
+          "description": "Origin tags.",
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/OriginUpdatePropertiesParameters"
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "OriginUpdatePropertiesParameters": {
+      "description": "The JSON object that contains the properties of the origin.",
+      "properties": {
+        "hostName": {
+          "description": "The address of the origin. Domain names, IPv4 addresses, and IPv6 addresses are supported.This should be unique across all origins in an endpoint.",
+          "type": "string"
+        },
+        "httpPort": {
+          "description": "The value of the HTTP port. Must be between 1 and 65535.",
+          "type": "integer",
+          "maximum": 65535,
+          "exclusiveMaximum": false,
+          "minimum": 1,
+          "exclusiveMinimum": false
+        },
+        "httpsPort": {
+          "description": "The value of the HTTPS port. Must be between 1 and 65535.",
+          "type": "integer",
+          "maximum": 65535,
+          "exclusiveMaximum": false,
+          "minimum": 1,
+          "exclusiveMinimum": false
+        },
+        "originHostHeader": {
+          "description": "The host header value sent to the origin with each request. If you leave this blank, the request hostname determines this value. Azure CDN origins, such as Web Apps, Blob Storage, and Cloud Services require this host header value to match the origin hostname by default. This overrides the host header defined at Endpoint",
+          "type": "string"
+        },
+        "priority": {
+          "description": "Priority of origin in given origin group for load balancing. Higher priorities will not be used for load balancing if any lower priority origin is healthy.Must be between 1 and 5",
+          "type": "integer",
+          "maximum": 5,
+          "minimum": 1
+        },
+        "weight": {
+          "description": "Weight of the origin in given origin group for load balancing. Must be between 1 and 1000",
+          "type": "integer",
+          "maximum": 1000,
+          "minimum": 1
+        },
+        "enabled": {
+          "description": "Origin is enabled for load balancing or not",
+          "type": "boolean"
+        }
+      }
+    },
+    "OriginListResult": {
+      "description": "Result of the request to list origins. It contains a list of origin objects and a URL link to get the next set of results.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/Origin"
+          },
+          "description": "List of CDN origins within an endpoint"
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of origin objects if there are any."
+        }
+      }
+    },
+    "OriginGroup": {
+      "description": "Origin group comprising of origins is used for load balancing to origins when the content cannot be served from CDN.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ProxyResource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/OriginGroupProperties"
+        }
+      }
+    },
+    "OriginGroupProperties": {
+      "description": "The JSON object that contains the properties of the origin group.",
+      "type": "object",
+      "required": [
+        "origins"
+      ],
+      "allOf": [
+        {
+          "$ref": "#/definitions/OriginGroupUpdatePropertiesParameters"
+        }
+      ],
+      "properties": {
+        "resourceState": {
+          "description": "Resource status of the origin group.",
+          "readOnly": true,
+          "enum": [
+            "Creating",
+            "Active",
+            "Deleting"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "OriginGroupResourceState",
+            "modelAsString": true
+          }
+        },
+        "provisioningState": {
+          "readOnly": true,
+          "description": "Provisioning status of the origin group.",
+          "type": "string"
+        }
+      }
+    },
+    "OriginGroupUpdateParameters": {
+      "type": "object",
+      "description": "Origin group properties needed for origin group creation or update.",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/OriginGroupUpdatePropertiesParameters"
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "OriginGroupUpdatePropertiesParameters": {
+      "description": "The JSON object that contains the properties of the origin group.",
+      "properties": {
+        "healthProbeSettings": {
+          "description": "Health probe settings to the origin that is used to determine the health of the origin.",
+          "type": "object",
+          "$ref": "#/definitions/HealthProbeParameters"
+        },
+        "origins": {
+          "description": "The source of the content being delivered via CDN within given origin group.",
+          "type": "array",
+          "items": {
+            "description": "A reference to a origin.",
+            "$ref": "#/definitions/ResourceReference"
+          }
+        },
+        "trafficRestorationTimeToHealedOrNewEndpointsInMinutes": {
+          "description": "Time in minutes to shift the traffic to the endpoint gradually when an unhealthy endpoint comes healthy or a new endpoint is added. Default is 10 mins. This property is currently not supported.",
+          "type": "integer",
+          "maximum": 50,
+          "minimum": 0
+        },
+        "responseBasedOriginErrorDetectionSettings": {
+          "description": "The JSON object that contains the properties to determine origin health using real requests/responses. This property is currently not supported.",
+          "type": "object",
+          "$ref": "#/definitions/ResponseBasedOriginErrorDetectionParameters"
+        }
+      }
+    },
+    "HealthProbeParameters": {
+      "description": "The JSON object that contains the properties to send health probes to origin.",
+      "properties": {
+        "probePath": {
+          "description": "The path relative to the origin that is used to determine the health of the origin.",
+          "type": "string"
+        },
+        "probeRequestType": {
+          "description": "The type of health probe request that is made.",
+          "enum": [
+            "NotSet",
+            "GET",
+            "HEAD"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "HealthProbeRequestType",
+            "modelAsString": false
+          }
+        },
+        "probeProtocol": {
+          "description": "Protocol to use for health probe.",
+          "type": "string",
+          "enum": [
+            "NotSet",
+            "Http",
+            "Https"
+          ],
+          "x-ms-enum": {
+            "name": "ProbeProtocol",
+            "modelAsString": false
+          }
+        },
+        "probeIntervalInSeconds": {
+          "description": "The number of seconds between health probes.Default is 240sec.",
+          "type": "integer",
+          "maximum": 255,
+          "minimum": 1
+        }
+      }
+    },
+    "ResponseBasedOriginErrorDetectionParameters": {
+      "description": "The JSON object that contains the properties to determine origin health using real requests/responses.",
+      "properties": {
+        "responseBasedDetectedErrorTypes": {
+          "description": "Type of response errors for real user requests for which origin will be deemed unhealthy",
+          "type": "string",
+          "enum": [
+            "None",
+            "TcpErrorsOnly",
+            "TcpAndHttpErrors"
+          ],
+          "x-ms-enum": {
+            "name": "ResponseBasedDetectedErrorTypes",
+            "modelAsString": false
+          }
+        },
+        "responseBasedFailoverThresholdPercentage": {
+          "description": "The percentage of failed requests in the sample where failover should trigger.",
+          "type": "integer",
+          "maximum": 100,
+          "minimum": 0
+        },
+        "httpErrorRanges": {
+          "description": "The list of Http status code ranges that are considered as server errors for origin and it is marked as unhealthy.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/HttpErrorRangeParameters"
+          }
+        }
+      }
+    },
+    "HttpErrorRangeParameters": {
+      "description": "The JSON object that represents the range for http status codes",
+      "properties": {
+        "begin": {
+          "description": "The inclusive start of the http status code range.",
+          "type": "integer",
+          "maximum": 999,
+          "minimum": 100
+        },
+        "end": {
+          "description": "The inclusive end of the http status code range.",
+          "type": "integer",
+          "maximum": 999,
+          "minimum": 100
+        }
+      }
+    },
+    "OriginGroupListResult": {
+      "description": "Result of the request to list origin groups. It contains a list of origin groups objects and a URL link to get the next set of results.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/OriginGroup"
+          },
+          "description": "List of CDN origin groups within an endpoint"
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of origin objects if there are any."
+        }
+      }
+    },
+    "CustomDomain": {
+      "description": "Friendly domain name mapping to the endpoint hostname that the customer provides for branding purposes, e.g. www.contoso.com.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ProxyResource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/CustomDomainProperties"
+        }
+      }
+    },
+    "CustomDomainProperties": {
+      "description": "The JSON object that contains the properties of the custom domain to create.",
+      "required": [
+        "hostName"
+      ],
+      "properties": {
+        "hostName": {
+          "description": "The host name of the custom domain. Must be a domain name.",
+          "type": "string"
+        },
+        "resourceState": {
+          "description": "Resource status of the custom domain.",
+          "readOnly": true,
+          "enum": [
+            "Creating",
+            "Active",
+            "Deleting"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "CustomDomainResourceState",
+            "modelAsString": true
+          }
+        },
+        "customHttpsProvisioningState": {
+          "description": "Provisioning status of Custom Https of the custom domain.",
+          "readOnly": true,
+          "enum": [
+            "Enabling",
+            "Enabled",
+            "Disabling",
+            "Disabled",
+            "Failed"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "CustomHttpsProvisioningState",
+            "modelAsString": true
+          }
+        },
+        "customHttpsProvisioningSubstate": {
+          "description": "Provisioning substate shows the progress of custom HTTPS enabling/disabling process step by step.",
+          "readOnly": true,
+          "enum": [
+            "SubmittingDomainControlValidationRequest",
+            "PendingDomainControlValidationREquestApproval",
+            "DomainControlValidationRequestApproved",
+            "DomainControlValidationRequestRejected",
+            "DomainControlValidationRequestTimedOut",
+            "IssuingCertificate",
+            "DeployingCertificate",
+            "CertificateDeployed",
+            "DeletingCertificate",
+            "CertificateDeleted"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "CustomHttpsProvisioningSubstate",
+            "modelAsString": true
+          }
+        },
+        "validationData": {
+          "description": "Special validation or data may be required when delivering CDN to some regions due to local compliance reasons. E.g. ICP license number of a custom domain is required to deliver content in China.",
+          "type": "string"
+        },
+        "provisioningState": {
+          "readOnly": true,
+          "description": "Provisioning status of the custom domain.",
+          "type": "string"
+        }
+      }
+    },
+    "CustomDomainParameters": {
+      "description": "The customDomain JSON object required for custom domain creation or update.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/CustomDomainPropertiesParameters"
+        }
+      }
+    },
+    "CustomDomainPropertiesParameters": {
+      "description": "The JSON object that contains the properties of the custom domain to create.",
+      "required": [
+        "hostName"
+      ],
+      "properties": {
+        "hostName": {
+          "description": "The host name of the custom domain. Must be a domain name.",
+          "type": "string"
+        }
+      }
+    },
+    "CustomDomainHttpsParameters": {
+      "description": "The JSON object that contains the properties to secure a custom domain.",
+      "discriminator": "certificateSource",
+      "required": [
+        "certificateSource",
+        "protocolType"
+      ],
+      "properties": {
+        "certificateSource": {
+          "description": "Defines the source of the SSL certificate.",
+          "enum": [
+            "AzureKeyVault",
+            "Cdn"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "CertificateSource",
+            "modelAsString": true
+          }
+        },
+        "protocolType": {
+          "description": "Defines the TLS extension protocol that is used for secure delivery.",
+          "enum": [
+            "ServerNameIndication",
+            "IPBased"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "ProtocolType",
+            "modelAsString": true
+          }
+        },
+        "minimumTlsVersion": {
+          "description": "TLS protocol version that will be used for Https",
+          "enum": [
+            "None",
+            "TLS10",
+            "TLS12"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "MinimumTlsVersion",
+            "modelAsString": false
+          }
+        }
+      }
+    },
+    "CdnManagedHttpsParameters": {
+      "description": "Defines the certificate source parameters using CDN managed certificate for enabling SSL.",
+      "x-ms-discriminator-value": "Cdn",
+      "allOf": [
+        {
+          "$ref": "#/definitions/CustomDomainHttpsParameters"
+        }
+      ],
+      "required": [
+        "certificateSourceParameters"
+      ],
+      "properties": {
+        "certificateSourceParameters": {
+          "description": "Defines the certificate source parameters using CDN managed certificate for enabling SSL.",
+          "$ref": "#/definitions/CdnCertificateSourceParameters"
+        }
+      }
+    },
+    "CdnCertificateSourceParameters": {
+      "description": "Defines the parameters for using CDN managed certificate for securing custom domain.",
+      "required": [
+        "@odata.type",
+        "certificateType"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.CdnCertificateSourceParameters"
+          ]
+        },
+        "certificateType": {
+          "description": "Type of certificate used",
+          "enum": [
+            "Shared",
+            "Dedicated"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "CertificateType",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "UserManagedHttpsParameters": {
+      "description": "Defines the certificate source parameters using user's keyvault certificate for enabling SSL.",
+      "x-ms-discriminator-value": "AzureKeyVault",
+      "allOf": [
+        {
+          "$ref": "#/definitions/CustomDomainHttpsParameters"
+        }
+      ],
+      "required": [
+        "certificateSourceParameters"
+      ],
+      "properties": {
+        "certificateSourceParameters": {
+          "description": "Defines the certificate source parameters using user's keyvault certificate for enabling SSL.",
+          "$ref": "#/definitions/KeyVaultCertificateSourceParameters"
+        }
+      }
+    },
+    "KeyVaultCertificateSourceParameters": {
+      "description": "Describes the parameters for using a user's KeyVault certificate for securing custom domain.",
+      "required": [
+        "@odata.type",
+        "subscriptionId",
+        "resourceGroupName",
+        "vaultName",
+        "secretName",
+        "secretVersion",
+        "updateRule",
+        "deleteRule"
+      ],
+      "properties": {
+        "@odata.type": {
+          "type": "string",
+          "enum": [
+            "#Microsoft.Azure.Cdn.Models.KeyVaultCertificateSourceParameters"
+          ]
+        },
+        "subscriptionId": {
+          "description": "Subscription Id of the user's Key Vault containing the SSL certificate",
+          "type": "string"
+        },
+        "resourceGroupName": {
+          "description": "Resource group of the user's Key Vault containing the SSL certificate",
+          "type": "string"
+        },
+        "vaultName": {
+          "description": "The name of the user's Key Vault containing the SSL certificate",
+          "type": "string"
+        },
+        "secretName": {
+          "description": "The name of Key Vault Secret (representing the full certificate PFX) in Key Vault.",
+          "type": "string"
+        },
+        "secretVersion": {
+          "description": "The version(GUID) of Key Vault Secret in Key Vault.",
+          "type": "string"
+        },
+        "updateRule": {
+          "description": "Describes the action that shall be taken when the certificate is updated in Key Vault.",
+          "type": "string",
+          "enum": [
+            "NoAction"
+          ],
+          "x-ms-enum": {
+            "name": "UpdateRule",
+            "modelAsString": true
+          }
+        },
+        "deleteRule": {
+          "description": "Describes the action that shall be taken when the certificate is removed from Key Vault.",
+          "type": "string",
+          "enum": [
+            "NoAction"
+          ],
+          "x-ms-enum": {
+            "name": "DeleteRule",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "CustomDomainListResult": {
+      "description": "Result of the request to list custom domains. It contains a list of custom domain objects and a URL link to get the next set of results.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/CustomDomain"
+          },
+          "description": "List of CDN CustomDomains within an endpoint."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of custom domain objects if there are any."
+        }
+      }
+    },
+    "ValidateCustomDomainInput": {
+      "description": "Input of the custom domain to be validated for DNS mapping.",
+      "type": "object",
+      "required": [
+        "hostName"
+      ],
+      "properties": {
+        "hostName": {
+          "description": "The host name of the custom domain. Must be a domain name.",
+          "type": "string"
+        }
+      }
+    },
+    "ValidateCustomDomainOutput": {
+      "description": "Output of custom domain validation.",
+      "type": "object",
+      "properties": {
+        "customDomainValidated": {
+          "description": "Indicates whether the custom domain is valid or not.",
+          "readOnly": true,
+          "type": "boolean"
+        },
+        "reason": {
+          "description": "The reason why the custom domain is not valid.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "message": {
+          "description": "Error message describing why the custom domain is not valid.",
+          "readOnly": true,
+          "type": "string"
+        }
+      }
+    },
+    "CheckNameAvailabilityInput": {
+      "description": "Input of CheckNameAvailability API.",
+      "type": "object",
+      "required": [
+        "name",
+        "type"
+      ],
+      "properties": {
+        "name": {
+          "description": "The resource name to validate.",
+          "type": "string"
+        },
+        "type": {
+          "description": "The type of the resource whose name is to be validated.",
+          "$ref": "#/definitions/ResourceType"
+        }
+      }
+    },
+    "CheckNameAvailabilityOutput": {
+      "description": "Output of check name availability API.",
+      "type": "object",
+      "properties": {
+        "nameAvailable": {
+          "description": "Indicates whether the name is available.",
+          "readOnly": true,
+          "type": "boolean"
+        },
+        "reason": {
+          "description": "The reason why the name is not available.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "message": {
+          "description": "The detailed error message describing why the name is not available.",
+          "readOnly": true,
+          "type": "string"
+        }
+      }
+    },
+    "ValidateProbeInput": {
+      "description": "Input of the validate probe API.",
+      "properties": {
+        "probeURL": {
+          "description": "The probe URL to validate.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "probeURL"
+      ],
+      "type": "object"
+    },
+    "ValidateProbeOutput": {
+      "description": "Output of the validate probe API.",
+      "properties": {
+        "isValid": {
+          "description": "Indicates whether the probe URL is accepted or not.",
+          "readOnly": true,
+          "type": "boolean"
+        },
+        "errorCode": {
+          "description": "Specifies the error code when the probe url is not accepted.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "message": {
+          "description": "The detailed error message describing why the probe URL is not accepted.",
+          "readOnly": true,
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "ResourceUsageListResult": {
+      "description": "Output of check resource usage API.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/ResourceUsage"
+          },
+          "description": "List of resource usages."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of custom domain objects if there are any."
+        }
+      }
+    },
+    "ResourceUsage": {
+      "description": "Output of check resource usage API.",
+      "type": "object",
+      "properties": {
+        "resourceType": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource type for which the usage is provided."
+        },
+        "unit": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Unit of the usage. e.g. Count."
+        },
+        "currentValue": {
+          "type": "integer",
+          "readOnly": true,
+          "description": "Actual value of usage on the specified resource type."
+        },
+        "limit": {
+          "type": "integer",
+          "readOnly": true,
+          "description": "Quota of the specified resource type."
+        }
+      }
+    },
+    "ResourceType": {
+      "description": "Type of CDN resource used in CheckNameAvailability.",
+      "enum": [
+        "Microsoft.Cdn/Profiles/Endpoints"
+      ],
+      "type": "string",
+      "x-ms-enum": {
+        "name": "ResourceType",
+        "modelAsString": false
+      }
+    },
+    "Operation": {
+      "description": "CDN REST API operation",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "Operation name: {provider}/{resource}/{operation}",
+          "readOnly": true,
+          "type": "string"
+        },
+        "display": {
+          "description": "The object that represents the operation.",
+          "properties": {
+            "provider": {
+              "description": "Service provider: Microsoft.Cdn",
+              "readOnly": true,
+              "type": "string"
+            },
+            "resource": {
+              "description": "Resource on which the operation is performed: Profile, endpoint, etc.",
+              "readOnly": true,
+              "type": "string"
+            },
+            "operation": {
+              "description": "Operation type: Read, write, delete, etc.",
+              "readOnly": true,
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "OperationsListResult": {
+      "description": "Result of the request to list CDN operations. It contains a list of operations and a URL link to get the next set of results.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/Operation"
+          },
+          "description": "List of CDN operations supported by the CDN resource provider."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of operation list results if there are any."
+        }
+      }
+    },
+    "EdgenodeResult": {
+      "description": "Result of the request to list CDN edgenodes. It contains a list of ip address group and a URL link to get the next set of results.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/EdgeNode"
+          },
+          "description": "Edge node of CDN service."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of edgenode list results if there are any."
+        }
+      }
+    },
+    "EdgeNode": {
+      "description": "Edgenode is a global Point of Presence (POP) location used to deliver CDN content to end users.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ProxyResource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/EdgeNodeProperties"
+        }
+      }
+    },
+    "EdgeNodeProperties": {
+      "description": "The JSON object that contains the properties required to create an edgenode.",
+      "required": [
+        "ipAddressGroups"
+      ],
+      "properties": {
+        "ipAddressGroups": {
+          "description": "List of ip address groups.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/IpAddressGroup"
+          }
+        }
+      }
+    },
+    "IpAddressGroup": {
+      "description": "CDN Ip address group",
+      "type": "object",
+      "properties": {
+        "deliveryRegion": {
+          "description": "The delivery region of the ip address group",
+          "type": "string"
+        },
+        "ipv4Addresses": {
+          "description": "The list of ip v4 addresses.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/cidrIpAddress"
+          }
+        },
+        "ipv6Addresses": {
+          "description": "The list of ip v6 addresses.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/cidrIpAddress"
+          }
+        }
+      }
+    },
+    "cidrIpAddress": {
+      "description": "CIDR Ip address",
+      "type": "object",
+      "properties": {
+        "baseIpAddress": {
+          "description": "Ip address itself.",
+          "type": "string"
+        },
+        "prefixLength": {
+          "description": "The length of the prefix of the ip address.",
+          "type": "integer"
+        }
+      }
+    },
+    "Resource": {
+      "description": "The core properties of ARM resources",
+      "properties": {
+        "id": {
+          "description": "Resource ID.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "name": {
+          "description": "Resource name.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "type": {
+          "description": "Resource type.",
+          "readOnly": true,
+          "type": "string"
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "TrackedResource": {
+      "description": "The resource model definition for a ARM tracked top level resource.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/Resource"
+        }
+      ],
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "Resource location."
+        },
+        "tags": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "x-ms-mutability": [
+            "read",
+            "create",
+            "update"
+          ],
+          "description": "Resource tags."
+        }
+      },
+      "required": [
+        "location"
+      ]
+    },
+    "ProxyResource": {
+      "description": "The resource model definition for a ARM proxy resource. It will have everything other than required location and tags",
+      "allOf": [
+        {
+          "$ref": "#/definitions/Resource"
+        }
+      ]
+    },
+    "QueryStringCachingBehavior": {
+      "description": "Defines how CDN caches requests that include query strings. You can ignore any query strings when caching, bypass caching to prevent requests that contain query strings from being cached, or cache every request with a unique URL.",
+      "enum": [
+        "IgnoreQueryString",
+        "BypassCaching",
+        "UseQueryString",
+        "NotSet"
+      ],
+      "type": "string",
+      "x-ms-enum": {
+        "name": "QueryStringCachingBehavior",
+        "modelAsString": false
+      }
+    },
+    "Sku": {
+      "description": "The pricing tier (defines a CDN provider, feature list and rate) of the CDN profile.",
+      "properties": {
+        "name": {
+          "description": "Name of the pricing tier.",
+          "enum": [
+            "Standard_Verizon",
+            "Premium_Verizon",
+            "Custom_Verizon",
+            "Standard_Akamai",
+            "Standard_ChinaCdn",
+            "Standard_Microsoft",
+            "Premium_ChinaCdn"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "SkuName",
+            "modelAsString": true
+          }
+        }
+      },
+      "type": "object"
+    },
+    "OptimizationType": {
+      "description": "Specifies what scenario the customer wants this CDN endpoint to optimize, e.g. Download, Media services. With this information we can apply scenario driven optimization.",
+      "enum": [
+        "GeneralWebDelivery",
+        "GeneralMediaStreaming",
+        "VideoOnDemandMediaStreaming",
+        "LargeFileDownload",
+        "DynamicSiteAcceleration"
+      ],
+      "type": "string",
+      "x-ms-enum": {
+        "name": "OptimizationType",
+        "modelAsString": true
+      }
+    },
+    "ErrorResponse": {
+      "description": "Error response indicates CDN service is not able to process the incoming request. The reason is provided in the error message.",
+      "type": "object",
+      "properties": {
+        "code": {
+          "description": "Error code.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "message": {
+          "description": "Error message indicating why the operation failed.",
+          "readOnly": true,
+          "type": "string"
+        }
+      }
+    }
+  },
+  "parameters": {
+    "subscriptionIdParameter": {
+      "name": "subscriptionId",
+      "in": "path",
+      "description": "Azure Subscription ID.",
+      "required": true,
+      "type": "string"
+    },
+    "apiVersionParameter": {
+      "name": "api-version",
+      "in": "query",
+      "required": true,
+      "type": "string",
+      "description": "Version of the API to be used with the client request. Current version is 2017-04-02."
+    },
+    "resourceGroupNameParameter": {
+      "name": "resourceGroupName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "pattern": "^[-\\w\\._\\(\\)]+$",
+      "minLength": 1,
+      "maxLength": 90,
+      "x-ms-parameter-location": "method",
+      "description": "Name of the Resource group within the Azure subscription."
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/cdnwebapplicationfirewall.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/cdnwebapplicationfirewall.json
new file mode 100644
index 000000000000..8c308c75542c
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/cdnwebapplicationfirewall.json
@@ -0,0 +1,923 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "version": "2019-06-15-preview",
+    "title": "Azure CDN WebApplicationFirewallManagement",
+    "description": "APIs to manage web application firewall rules for Azure CDN"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies": {
+      "get": {
+        "tags": [
+          "WebApplicationFirewallPolicies"
+        ],
+        "description": "Lists all of the protection policies within a resource group.",
+        "operationId": "Policies_List",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/CdnWebApplicationFirewallPolicyList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./cdn.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-examples": {
+          "List Policies in a Resource Group": {
+            "$ref": "./examples/WafListPolicies.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/{policyName}": {
+      "get": {
+        "tags": [
+          "WebApplicationFirewallPolicies"
+        ],
+        "description": "Retrieve protection policy with specified name within a resource group.",
+        "operationId": "Policies_Get",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/PolicyNameParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/CdnWebApplicationFirewallPolicy"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./cdn.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Get Policy": {
+            "$ref": "./examples/WafPolicyGet.json"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "WebApplicationFirewallPolicies"
+        ],
+        "description": "Create or update policy with specified rule set name within a resource group.",
+        "operationId": "Policies_CreateOrUpdate",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/PolicyNameParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "description": "Policy to be created.",
+            "in": "body",
+            "name": "cdnWebApplicationFirewallPolicy",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/CdnWebApplicationFirewallPolicy"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/CdnWebApplicationFirewallPolicy"
+            }
+          },
+          "201": {
+            "description": "Created. The request has been fulfilled and a new protection policy has been created.",
+            "schema": {
+              "$ref": "#/definitions/CdnWebApplicationFirewallPolicy"
+            }
+          },
+          "202": {
+            "description": "Accepted. The request has been accepted for processing and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/CdnWebApplicationFirewallPolicy"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./cdn.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Creates specific policy": {
+            "$ref": "./examples/WafPolicyCreateOrUpdate.json"
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "patch": {
+        "tags": [
+          "WebApplicationFirewallPolicies"
+        ],
+        "description": "Update an existing CdnWebApplicationFirewallPolicy with the specified policy name under the specified subscription and resource group",
+        "operationId": "Policies_Update",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/PolicyNameParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "description": "CdnWebApplicationFirewallPolicy parameters to be patched.",
+            "in": "body",
+            "name": "cdnWebApplicationFirewallPolicyPatchParameters",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/CdnWebApplicationFirewallPolicyPatchParameters"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/CdnWebApplicationFirewallPolicy"
+            }
+          },
+          "202": {
+            "description": "Accepted. The request has been accepted for processing and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/CdnWebApplicationFirewallPolicy"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./cdn.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Creates specific policy": {
+            "$ref": "./examples/WafPatchPolicy.json"
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "delete": {
+        "tags": [
+          "WebApplicationFirewallPolicies"
+        ],
+        "description": "Deletes Policy",
+        "operationId": "Policies_Delete",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/PolicyNameParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Delete successful."
+          },
+          "204": {
+            "description": "No Content. The request has been accepted but the policy was not found."
+          }
+        },
+        "x-ms-examples": {
+          "Delete protection policy": {
+            "$ref": "./examples/WafPolicyDelete.json"
+          }
+        },
+        "x-ms-long-running-operation": false
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Cdn/CdnWebApplicationFirewallManagedRuleSets": {
+      "get": {
+        "tags": [
+          "WebApplicationFirewallManagedRuleSets"
+        ],
+        "description": "Lists all available managed rule sets.",
+        "operationId": "ManagedRuleSets_List",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success. The operation returns a list of all available web application firewall managed rule sets.",
+            "schema": {
+              "$ref": "#/definitions/ManagedRuleSetDefinitionList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./cdn.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-examples": {
+          "List Policies in a Resource Group": {
+            "$ref": "./examples/WafListManagedRuleSets.json"
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "CdnWebApplicationFirewallPolicyList": {
+      "description": "Defines a list of WebApplicationFirewallPolicies for Azure CDN. It contains a list of WebApplicationFirewallPolicy objects and a URL link to get the next set of results.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/CdnWebApplicationFirewallPolicy"
+          },
+          "description": "List of Azure CDN WebApplicationFirewallPolicies within a resource group."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of WebApplicationFirewallPolicy objects if there are any."
+        }
+      }
+    },
+    "CdnWebApplicationFirewallPolicy": {
+      "description": "Defines web application firewall policy for Azure CDN.",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "Properties of the web application firewall policy.",
+          "$ref": "#/definitions/CdnWebApplicationFirewallPolicyProperties"
+        },
+        "etag": {
+          "type": "string",
+          "description": "Gets a unique read-only string that changes whenever the resource is updated."
+        },
+        "sku": {
+          "description": "The pricing tier (defines a CDN provider, feature list and rate) of the CdnWebApplicationFirewallPolicy.",
+          "$ref": "./cdn.json#/definitions/Sku"
+        }
+      },
+      "required": [
+        "sku"
+      ],
+      "allOf": [
+        {
+          "$ref": "./cdn.json#/definitions/TrackedResource"
+        }
+      ]
+    },
+    "CdnWebApplicationFirewallPolicyPatchParameters": {
+      "type": "object",
+      "description": "Properties required to update a CdnWebApplicationFirewallPolicy.",
+      "properties": {
+        "tags": {
+          "description": "CdnWebApplicationFirewallPolicy tags",
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "CdnWebApplicationFirewallPolicyProperties": {
+      "description": "Defines CDN web application firewall policy properties.",
+      "properties": {
+        "policySettings": {
+          "description": "Describes  policySettings for policy",
+          "$ref": "#/definitions/policySettings"
+        },
+        "rateLimitRules": {
+          "description": "Describes rate limit rules inside the policy.",
+          "$ref": "#/definitions/RateLimitRuleList"
+        },
+        "customRules": {
+          "description": "Describes custom rules inside the policy.",
+          "$ref": "#/definitions/CustomRuleList"
+        },
+        "managedRules": {
+          "description": "Describes managed rules inside the policy.",
+          "$ref": "#/definitions/ManagedRuleSetList"
+        },
+        "endpointLinks": {
+          "description": "Describes Azure CDN endpoints associated with this Web Application Firewall policy.",
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/CdnEndpoint"
+          }
+        },
+        "provisioningState": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Provisioning state of the WebApplicationFirewallPolicy.",
+          "enum": [
+            "Creating",
+            "Succeeded",
+            "Failed"
+          ],
+          "x-ms-enum": {
+            "name": "ProvisioningState",
+            "modelAsString": true
+          }
+        },
+        "resourceState": {
+          "title": "Resource status of the policy.",
+          "readOnly": true,
+          "enum": [
+            "Creating",
+            "Enabling",
+            "Enabled",
+            "Disabling",
+            "Disabled",
+            "Deleting"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "PolicyResourceState",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "policySettings": {
+      "description": "Defines contents of a web application firewall global configuration",
+      "properties": {
+        "enabledState": {
+          "description": "describes if the policy is in enabled state or disabled state",
+          "type": "string",
+          "enum": [
+            "Disabled",
+            "Enabled"
+          ],
+          "x-ms-enum": {
+            "name": "PolicyEnabledState",
+            "modelAsString": true
+          }
+        },
+        "mode": {
+          "description": "Describes if it is in detection mode or prevention mode at policy level.",
+          "type": "string",
+          "enum": [
+            "Prevention",
+            "Detection"
+          ],
+          "x-ms-enum": {
+            "name": "PolicyMode",
+            "modelAsString": true
+          }
+        },
+        "defaultRedirectUrl": {
+          "description": "If action type is redirect, this field represents the default redirect URL for the client.",
+          "type": "string"
+        },
+        "defaultCustomBlockResponseStatusCode": {
+          "description": "If the action type is block, this field defines the default customer overridable http response status code.",
+          "type": "integer",
+          "maximum": 599,
+          "exclusiveMaximum": false,
+          "minimum": 200,
+          "exclusiveMinimum": false
+        },
+        "defaultCustomBlockResponseBody": {
+          "description": "If the action type is block, customer can override the response body. The body must be specified in base64 encoding.",
+          "type": "string",
+          "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{4})$"
+        }
+      }
+    },
+    "CdnEndpoint": {
+      "description": "Defines the ARM Resource ID for the linked endpoints",
+      "type": "object",
+      "readOnly": true,
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "ARM Resource ID string."
+        }
+      }
+    },
+    "CustomRuleList": {
+      "description": "Defines contents of custom rules",
+      "properties": {
+        "rules": {
+          "description": "List of rules",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/CustomRule"
+          }
+        }
+      }
+    },
+    "CustomRule": {
+      "description": "Defines the common attributes for a custom rule that can be included in a waf policy",
+      "type": "object",
+      "required": [
+        "name",
+        "priority",
+        "matchConditions",
+        "action"
+      ],
+      "properties": {
+        "name": {
+          "description": "Defines the name of the custom rule",
+          "type": "string"
+        },
+        "enabledState": {
+          "description": "Describes if the custom rule is in enabled or disabled state. Defaults to Enabled if not specified.",
+          "type": "string",
+          "enum": [
+            "Disabled",
+            "Enabled"
+          ],
+          "x-ms-enum": {
+            "name": "CustomRuleEnabledState",
+            "modelAsString": true
+          }
+        },
+        "priority": {
+          "description": "Defines in what order this rule be evaluated in the overall list of custom rules",
+          "type": "integer",
+          "maximum": 1000,
+          "exclusiveMaximum": false,
+          "minimum": 0,
+          "exclusiveMinimum": false
+        },
+        "matchConditions": {
+          "description": "List of match conditions.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/MatchCondition"
+          }
+        },
+        "action": {
+          "description": "Describes what action to be applied when rule matches",
+          "$ref": "#/definitions/ActionType"
+        }
+      }
+    },
+    "RateLimitRuleList": {
+      "description": "Defines contents of rate limit rules",
+      "properties": {
+        "rules": {
+          "description": "List of rules",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/RateLimitRule"
+          }
+        }
+      }
+    },
+    "RateLimitRule": {
+      "description": "Defines a rate limiting rule that can be included in a waf policy",
+      "type": "object",
+      "required": [
+        "rateLimitThreshold",
+        "rateLimitDurationInMinutes"
+      ],
+      "properties": {
+        "rateLimitThreshold": {
+          "description": "Defines rate limit threshold.",
+          "type": "integer",
+          "minimum": 0,
+          "exclusiveMinimum": false
+        },
+        "rateLimitDurationInMinutes": {
+          "description": "Defines rate limit duration. Default is 1 minute.",
+          "type": "integer",
+          "maximum": 60,
+          "exclusiveMaximum": false,
+          "minimum": 0,
+          "exclusiveMinimum": false
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/CustomRule"
+        }
+      ]
+    },
+    "MatchCondition": {
+      "description": "Define match conditions",
+      "required": [
+        "matchVariable",
+        "operator",
+        "matchValue"
+      ],
+      "properties": {
+        "matchVariable": {
+          "description": "Match variable to compare against.",
+          "type": "string",
+          "enum": [
+            "RemoteAddr",
+            "SocketAddr",
+            "RequestMethod",
+            "RequestHeader",
+            "RequestUri",
+            "QueryString",
+            "RequestBody",
+            "Cookies",
+            "PostArgs"
+          ],
+          "x-ms-enum": {
+            "name": "MatchVariable",
+            "modelAsString": true
+          }
+        },
+        "selector": {
+          "description": "Selector can used to match a specific key for QueryString, RequestUri, RequestHeaders or RequestBody.",
+          "type": "string"
+        },
+        "operator": {
+          "description": "Describes operator to be matched",
+          "type": "string",
+          "enum": [
+            "Any",
+            "IPMatch",
+            "GeoMatch",
+            "Equal",
+            "Contains",
+            "LessThan",
+            "GreaterThan",
+            "LessThanOrEqual",
+            "GreaterThanOrEqual",
+            "BeginsWith",
+            "EndsWith",
+            "RegEx"
+          ],
+          "x-ms-enum": {
+            "name": "operator",
+            "modelAsString": true
+          }
+        },
+        "negateCondition": {
+          "description": "Describes if the result of this condition should be negated.",
+          "type": "boolean"
+        },
+        "matchValue": {
+          "description": "List of possible match values.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transforms": {
+          "description": "List of transforms.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/TransformType"
+          }
+        }
+      }
+    },
+    "TransformType": {
+      "description": "Describes what transforms were applied before matching.",
+      "type": "string",
+      "enum": [
+        "Lowercase",
+        "Uppercase",
+        "Trim",
+        "UrlDecode",
+        "UrlEncode",
+        "RemoveNulls"
+      ],
+      "x-ms-enum": {
+        "name": "TransformType",
+        "modelAsString": true
+      }
+    },
+    "ManagedRuleSetList": {
+      "description": "Defines the list of managed rule sets for the policy.",
+      "properties": {
+        "managedRuleSets": {
+          "description": "List of rule sets.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ManagedRuleSet"
+          }
+        }
+      }
+    },
+    "ManagedRuleSet": {
+      "type": "object",
+      "description": "Defines a managed rule set.",
+      "required": [
+        "ruleSetType",
+        "ruleSetVersion"
+      ],
+      "properties": {
+        "ruleSetType": {
+          "description": "Defines the rule set type to use.",
+          "type": "string"
+        },
+        "ruleSetVersion": {
+          "description": "Defines the version of the rule set to use.",
+          "type": "string"
+        },
+        "anomalyScore": {
+          "description": "Verizon only : If the rule set supports anomaly detection mode, this describes the threshold for blocking requests.",
+          "type": "integer",
+          "maximum": 20,
+          "exclusiveMaximum": false,
+          "minimum": 0,
+          "exclusiveMinimum": false
+        },
+        "ruleGroupOverrides": {
+          "description": "Defines the rule overrides to apply to the rule set.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ManagedRuleGroupOverride"
+          }
+        }
+      }
+    },
+    "ManagedRuleGroupOverride": {
+      "description": "Defines a managed rule group override setting.",
+      "required": [
+        "ruleGroupName"
+      ],
+      "properties": {
+        "ruleGroupName": {
+          "description": "Describes the managed rule group within the rule set to override",
+          "type": "string"
+        },
+        "rules": {
+          "description": "List of rules that will be disabled. If none specified, all rules in the group will be disabled.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ManagedRuleOverride"
+          }
+        }
+      }
+    },
+    "ManagedRuleOverride": {
+      "description": "Defines a managed rule group override setting.",
+      "required": [
+        "ruleId"
+      ],
+      "properties": {
+        "ruleId": {
+          "description": "Identifier for the managed rule.",
+          "type": "string"
+        },
+        "enabledState": {
+          "description": "Describes if the managed rule is in enabled or disabled state. Defaults to Disabled if not specified.",
+          "type": "string",
+          "enum": [
+            "Disabled",
+            "Enabled"
+          ],
+          "x-ms-enum": {
+            "name": "ManagedRuleEnabledState",
+            "modelAsString": true
+          }
+        },
+        "action": {
+          "description": "Describes the override action to be applied when rule matches.",
+          "$ref": "#/definitions/ActionType"
+        }
+      }
+    },
+    "ManagedRuleSetDefinitionList": {
+      "description": "List of managed rule set definitions available for use in a policy.",
+      "properties": {
+        "value": {
+          "description": "List of managed rule set definitions.",
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ManagedRuleSetDefinition"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to retrieve next set of managed rule set definitions."
+        }
+      }
+    },
+    "ManagedRuleSetDefinition": {
+      "description": "Describes a managed rule set definition.",
+      "properties": {
+        "properties": {
+          "description": "Describes managed rule set definition properties.",
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ManagedRuleSetDefinitionProperties"
+        },
+        "sku": {
+          "description": "The pricing tier (defines a CDN provider, feature list and rate) of the CdnWebApplicationFirewallPolicy.",
+          "$ref": "./cdn.json#/definitions/Sku"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./cdn.json#/definitions/Resource"
+        }
+      ]
+    },
+    "ManagedRuleSetDefinitionProperties": {
+      "description": "Properties for a managed rule set definition.",
+      "properties": {
+        "provisioningState": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Provisioning state of the managed rule set."
+        },
+        "ruleSetType": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Type of the managed rule set."
+        },
+        "ruleSetVersion": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Version of the managed rule set type."
+        },
+        "ruleGroups": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/ManagedRuleGroupDefinition"
+          },
+          "description": "Rule groups of the managed rule set."
+        }
+      }
+    },
+    "ManagedRuleGroupDefinition": {
+      "description": "Describes a managed rule group.",
+      "properties": {
+        "ruleGroupName": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Name of the managed rule group."
+        },
+        "description": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Description of the managed rule group."
+        },
+        "rules": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/ManagedRuleDefinition"
+          },
+          "description": "List of rules within the managed rule group."
+        }
+      }
+    },
+    "ManagedRuleDefinition": {
+      "description": "Describes a managed rule definition.",
+      "properties": {
+        "ruleId": {
+          "description": "Identifier for the managed rule.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "description": {
+          "description": "Describes the functionality of the managed rule.",
+          "readOnly": true,
+          "type": "string"
+        }
+      }
+    },
+    "ActionType": {
+      "description": "Defines the action to take on rule match.",
+      "type": "string",
+      "enum": [
+        "Allow",
+        "Block",
+        "Log",
+        "Redirect"
+      ],
+      "x-ms-enum": {
+        "name": "ActionType",
+        "modelAsString": true
+      }
+    }
+  },
+  "parameters": {
+    "SubscriptionIdParameter": {
+      "name": "subscriptionId",
+      "in": "path",
+      "description": "Azure Subscription ID.",
+      "required": true,
+      "type": "string"
+    },
+    "ApiVersionParameter": {
+      "name": "api-version",
+      "in": "query",
+      "required": true,
+      "type": "string",
+      "description": "Version of the API to be used with the client request. Current version is 2017-04-02."
+    },
+    "PolicyNameParameter": {
+      "name": "policyName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "maxLength": 128,
+      "x-ms-parameter-location": "method",
+      "description": "The name of the CdnWebApplicationFirewallPolicy."
+    },
+    "ResourceGroupNameParameter": {
+      "name": "resourceGroupName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "pattern": "^[a-zA-Z0-9_\\-\\(\\)\\.]*[^\\.]$",
+      "minLength": 1,
+      "maxLength": 80,
+      "x-ms-parameter-location": "method",
+      "description": "Name of the Resource group within the Azure subscription."
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CheckNameAvailability.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CheckNameAvailability.json
new file mode 100644
index 000000000000..a20fc0ace07c
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CheckNameAvailability.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "checkNameAvailabilityInput": {
+      "name": "sampleName",
+      "type": "Microsoft.Cdn/Profiles/Endpoints"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "nameAvailable": false,
+        "reason": "Name is already in use",
+        "message": "Name not available"
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CheckNameAvailabilityWithSubscription.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CheckNameAvailabilityWithSubscription.json
new file mode 100644
index 000000000000..935a838c7924
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CheckNameAvailabilityWithSubscription.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "checkNameAvailabilityInput": {
+      "name": "sampleName",
+      "type": "Microsoft.Cdn/Profiles/Endpoints"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "nameAvailable": false,
+        "reason": "Name is already in use",
+        "message": "Name not available"
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CustomDomains_Create.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CustomDomains_Create.json
new file mode 100644
index 000000000000..c368ab84efcc
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CustomDomains_Create.json
@@ -0,0 +1,62 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "customDomainName": "www-someDomain-net",
+    "customDomainProperties": {
+      "properties": {
+        "hostName": "www.someDomain.net"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "www-someDomain-net",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "customHttpsProvisioningState": "Enabling",
+          "customHttpsProvisioningSubstate": "PendingDomainControlValidationREquestApproval",
+          "validationData": null
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "name": "www-someDomain-net",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "customHttpsProvisioningState": "Enabling",
+          "customHttpsProvisioningSubstate": "PendingDomainControlValidationREquestApproval",
+          "validationData": null
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "www-someDomain-net",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "customHttpsProvisioningState": "Enabling",
+          "customHttpsProvisioningSubstate": "PendingDomainControlValidationREquestApproval",
+          "validationData": null
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CustomDomains_Delete.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CustomDomains_Delete.json
new file mode 100644
index 000000000000..502c74bac3f3
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CustomDomains_Delete.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "customDomainName": "www-someDomain-net"
+  },
+  "responses": {
+    "200": {},
+    "202": {
+      "body": {
+        "name": "www-someDomain-net",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "customHttpsProvisioningState": "Enabling",
+          "customHttpsProvisioningSubstate": "PendingDomainControlValidationREquestApproval",
+          "validationData": null
+        }
+      }
+    },
+    "204": {}
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CustomDomains_DisableCustomHttps.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CustomDomains_DisableCustomHttps.json
new file mode 100644
index 000000000000..8a0b974b22b9
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CustomDomains_DisableCustomHttps.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "customDomainName": "www-someDomain-net"
+  },
+  "responses": {
+    "200": {},
+    "202": {
+      "body": {
+        "name": "www-someDomain-net",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "customHttpsProvisioningState": "Enabling",
+          "customHttpsProvisioningSubstate": "PendingDomainControlValidationREquestApproval",
+          "validationData": null
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CustomDomains_EnableCustomHttpsUsingBYOC.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CustomDomains_EnableCustomHttpsUsingBYOC.json
new file mode 100644
index 000000000000..1bb98872ff7e
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CustomDomains_EnableCustomHttpsUsingBYOC.json
@@ -0,0 +1,43 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "customDomainName": "www-someDomain-net",
+    "customHttpsParameters": {
+      "MinimumTLSVersion": "TLS12",
+      "certificateSource": "AzureKeyVault",
+      "protocolType": "ServerNameIndication",
+      "certificateSourceParameters": {
+        "OData.type": "#Microsoft.Azure.Cdn.Models.KeyVaultCertificateSourceParameters",
+        "subscriptionId": "subid",
+        "resourceGroupName": "RG",
+        "vaultName": "kv",
+        "secretName": "secret1",
+        "secretVersion": "00000000-0000-0000-0000-000000000000",
+        "updateRule": "NoAction",
+        "deleteRule": "NoAction"
+      }
+    }
+  },
+  "responses": {
+    "200": {},
+    "202": {
+      "body": {
+        "name": "www-someDomain-net",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "customHttpsProvisioningState": "Enabling",
+          "customHttpsProvisioningSubstate": "PendingDomainControlValidationREquestApproval",
+          "validationData": "validationdata"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate.json
new file mode 100644
index 000000000000..ed42e2512b06
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate.json
@@ -0,0 +1,37 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "customDomainName": "www-someDomain-net",
+    "customHttpsParameters": {
+      "MinimumTLSVersion": "TLS12",
+      "certificateSource": "Cdn",
+      "protocolType": "ServerNameIndication",
+      "certificateSourceParameters": {
+        "OData.type": "#Microsoft.Azure.Cdn.Models.CdnCertificateSourceParameters",
+        "certificateType": "Shared"
+      }
+    }
+  },
+  "responses": {
+    "200": {},
+    "202": {
+      "body": {
+        "name": "www-someDomain-net",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "customHttpsProvisioningState": "Enabling",
+          "customHttpsProvisioningSubstate": "PendingDomainControlValidationREquestApproval",
+          "validationData": "validationdata"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CustomDomains_Get.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CustomDomains_Get.json
new file mode 100644
index 000000000000..a6a7cfcd9bd9
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CustomDomains_Get.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "customDomainName": "www-someDomain-net"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "www-someDomain-net",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "customHttpsProvisioningState": "Disabled",
+          "customHttpsProvisioningSubstate": "None",
+          "validationData": null
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CustomDomains_ListByEndpoint.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CustomDomains_ListByEndpoint.json
new file mode 100644
index 000000000000..9b7329618e99
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/CustomDomains_ListByEndpoint.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "www-someDomain-net",
+            "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
+            "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
+            "properties": {
+              "provisioningState": "Succeeded",
+              "resourceState": "Active",
+              "hostName": "www.someDomain.net",
+              "customHttpsProvisioningState": "Disabled",
+              "customHttpsProvisioningSubstate": "None",
+              "validationData": null
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/EdgeNodes_List.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/EdgeNodes_List.json
new file mode 100644
index 000000000000..6583b23e0f8f
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/EdgeNodes_List.json
@@ -0,0 +1,107 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "Standard_Verizon",
+            "id": "/providers/Microsoft.Cdn/edgenodes/Standard_Verizon",
+            "type": "Microsoft.Cdn/edgenodes",
+            "properties": {
+              "ipAddressGroups": [
+                {
+                  "deliveryRegion": "All",
+                  "ipv4Addresses": [
+                    {
+                      "baseIpAddress": "192.229.176.0",
+                      "prefixLength": 24
+                    },
+                    {
+                      "baseIpAddress": "180.240.184.128",
+                      "prefixLength": 25
+                    },
+                    {
+                      "baseIpAddress": "152.195.27.0",
+                      "prefixLength": 24
+                    }
+                  ],
+                  "ipv6Addresses": [
+                    {
+                      "baseIpAddress": "2606:2800:60f2::",
+                      "prefixLength": 48
+                    },
+                    {
+                      "baseIpAddress": "2606:2800:700c::",
+                      "prefixLength": 48
+                    }
+                  ]
+                }
+              ]
+            }
+          },
+          {
+            "name": "Premium_Verizon",
+            "id": "/providers/Microsoft.Cdn/edgenodes/Premium_Verizon",
+            "type": "Microsoft.Cdn/edgenodes",
+            "properties": {
+              "ipAddressGroups": [
+                {
+                  "deliveryRegion": "All",
+                  "ipv4Addresses": [
+                    {
+                      "baseIpAddress": "192.229.176.0",
+                      "prefixLength": 24
+                    },
+                    {
+                      "baseIpAddress": "152.195.27.0",
+                      "prefixLength": 24
+                    }
+                  ],
+                  "ipv6Addresses": [
+                    {
+                      "baseIpAddress": "2606:2800:60f2::",
+                      "prefixLength": 48
+                    },
+                    {
+                      "baseIpAddress": "2606:2800:700c::",
+                      "prefixLength": 48
+                    }
+                  ]
+                }
+              ]
+            }
+          },
+          {
+            "name": "Custom_Verizon",
+            "id": "/providers/Microsoft.Cdn/edgenodes/Custom_Verizon",
+            "type": "Microsoft.Cdn/edgenodes",
+            "properties": {
+              "ipAddressGroups": [
+                {
+                  "deliveryRegion": "All",
+                  "ipv4Addresses": [
+                    {
+                      "baseIpAddress": "192.229.176.0",
+                      "prefixLength": 24
+                    },
+                    {
+                      "baseIpAddress": "2606:2800:420b::",
+                      "prefixLength": 48
+                    },
+                    {
+                      "baseIpAddress": "2606:2800:700c::",
+                      "prefixLength": 48
+                    }
+                  ]
+                }
+              ]
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_Create.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_Create.json
new file mode 100644
index 000000000000..58d5489139d0
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_Create.json
@@ -0,0 +1,543 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "endpoint": {
+      "location": "WestUs",
+      "tags": {
+        "key1": "value1"
+      },
+      "properties": {
+        "originHostHeader": "www.bing.com",
+        "originPath": "/photos",
+        "contentTypesToCompress": [
+          "text/html",
+          "application/octet-stream"
+        ],
+        "isCompressionEnabled": true,
+        "isHttpAllowed": true,
+        "isHttpsAllowed": true,
+        "queryStringCachingBehavior": "BypassCaching",
+        "defaultOriginGroup": {
+          "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1"
+        },
+        "deliveryPolicy": {
+          "description": "Test description for a policy.",
+          "rules": [
+            {
+              "name": "rule1",
+              "order": 1,
+              "conditions": [
+                {
+                  "name": "RemoteAddress",
+                  "parameters": {
+                    "operator": "IPMatch",
+                    "negateCondition": true,
+                    "matchValues": [
+                      "192.168.1.0/24",
+                      "10.0.0.0/24"
+                    ],
+                    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRemoteAddressConditionParameters"
+                  }
+                }
+              ],
+              "actions": [
+                {
+                  "name": "CacheExpiration",
+                  "parameters": {
+                    "cacheBehavior": "Override",
+                    "cacheDuration": "10:10:09",
+                    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleCacheExpirationActionParameters",
+                    "cacheType": "All"
+                  }
+                },
+                {
+                  "name": "ModifyResponseHeader",
+                  "parameters": {
+                    "headerAction": "Overwrite",
+                    "headerName": "Access-Control-Allow-Origin",
+                    "value": "*",
+                    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleHeaderActionParameters"
+                  }
+                },
+                {
+                  "name": "ModifyRequestHeader",
+                  "parameters": {
+                    "headerAction": "Overwrite",
+                    "headerName": "Accept-Encoding",
+                    "value": "gzip",
+                    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleHeaderActionParameters"
+                  }
+                }
+              ]
+            }
+          ]
+        },
+        "origins": [
+          {
+            "name": "origin1",
+            "properties": {
+              "hostName": "www.someDomain1.net",
+              "httpPort": 80,
+              "httpsPort": 443,
+              "originHostHeader": "www.someDomain1.net",
+              "priority": 1,
+              "weight": 50,
+              "enabled": true
+            }
+          },
+          {
+            "name": "origin2",
+            "properties": {
+              "hostName": "www.someDomain2.net",
+              "httpPort": 80,
+              "httpsPort": 443,
+              "originHostHeader": "www.someDomain2.net",
+              "priority": 2,
+              "weight": 50,
+              "enabled": true
+            }
+          }
+        ],
+        "originGroups": [
+          {
+            "name": "originGroup1",
+            "properties": {
+              "healthProbeSettings": {
+                "probePath": "/health.aspx",
+                "probeRequestType": "GET",
+                "probeProtocol": "Http",
+                "probeIntervalInSeconds": 120
+              },
+              "origins": [
+                {
+                  "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
+                },
+                {
+                  "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin2"
+                }
+              ],
+              "responseBasedOriginErrorDetectionSettings": {
+                "responseBasedDetectedErrorTypes": "TcpErrorsOnly",
+                "responseBasedFailoverThresholdPercentage": 10
+              }
+            }
+          }
+        ]
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "endpoint4899",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+        "type": "Microsoft.Cdn/profiles/endpoints",
+        "tags": {
+          "kay1": "value1"
+        },
+        "location": "WestUs",
+        "properties": {
+          "hostName": "endpoint4899.azureedge-test.net",
+          "originHostHeader": "www.bing.com",
+          "provisioningState": "Creating",
+          "resourceState": "Creating",
+          "isHttpAllowed": true,
+          "isHttpsAllowed": true,
+          "queryStringCachingBehavior": "BypassCaching",
+          "originPath": "/photos",
+          "defaultOriginGroup": {
+            "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1"
+          },
+          "origins": [
+            {
+              "name": "origin1",
+              "properties": {
+                "hostName": "www.someDomain1.net",
+                "httpPort": 80,
+                "httpsPort": 443,
+                "originHostHeader": "www.someDomain1.net",
+                "priority": 1,
+                "weight": 50,
+                "enabled": true
+              }
+            },
+            {
+              "name": "origin2",
+              "properties": {
+                "hostName": "www.someDomain2.net",
+                "httpPort": 80,
+                "httpsPort": 443,
+                "originHostHeader": "www.someDomain2.net",
+                "priority": 2,
+                "weight": 50,
+                "enabled": true
+              }
+            }
+          ],
+          "originGroups": [
+            {
+              "name": "originGroup1",
+              "properties": {
+                "healthProbeSettings": {
+                  "probePath": "/health.aspx",
+                  "probeRequestType": "GET",
+                  "probeProtocol": "Http",
+                  "probeIntervalInSeconds": 120
+                },
+                "origins": [
+                  {
+                    "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
+                  },
+                  {
+                    "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin2"
+                  }
+                ],
+                "responseBasedOriginErrorDetectionSettings": {
+                  "responseBasedDetectedErrorTypes": "TcpErrorsOnly",
+                  "responseBasedFailoverThresholdPercentage": 10
+                }
+              }
+            }
+          ],
+          "contentTypesToCompress": [
+            "text/html",
+            "application/octet-stream"
+          ],
+          "isCompressionEnabled": true,
+          "optimizationType": null,
+          "probePath": null,
+          "geoFilters": [],
+          "deliveryPolicy": {
+            "description": "Test description for a policy.",
+            "rules": [
+              {
+                "name": "rule1",
+                "order": 1,
+                "conditions": [
+                  {
+                    "name": "RemoteAddress",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRemoteAddressConditionParameters",
+                      "operator": "IPMatch",
+                      "negateCondition": true,
+                      "matchValues": [
+                        "192.168.1.0/24",
+                        "10.0.0.0/24"
+                      ],
+                      "transforms": []
+                    }
+                  }
+                ],
+                "actions": [
+                  {
+                    "name": "CacheExpiration",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleCacheExpirationActionParameters",
+                      "cacheBehavior": "Override",
+                      "cacheDuration": "10:10:09",
+                      "cacheType": "All"
+                    }
+                  },
+                  {
+                    "name": "ModifyResponseHeader",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleHeaderActionParameters",
+                      "headerAction": "Overwrite",
+                      "headerName": "Access-Control-Allow-Origin",
+                      "value": "*"
+                    }
+                  },
+                  {
+                    "name": "ModifyRequestHeader",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleHeaderActionParameters",
+                      "headerAction": "Overwrite",
+                      "headerName": "Accept-Encoding",
+                      "value": "gzip"
+                    }
+                  }
+                ]
+              }
+            ]
+          }
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "name": "endpoint4899",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+        "type": "Microsoft.Cdn/profiles/endpoints",
+        "tags": {
+          "kay1": "value1"
+        },
+        "location": "WestUs",
+        "properties": {
+          "hostName": "endpoint4899.azureedge-test.net",
+          "originHostHeader": "www.bing.com",
+          "provisioningState": "Creating",
+          "resourceState": "Creating",
+          "isHttpAllowed": true,
+          "isHttpsAllowed": true,
+          "queryStringCachingBehavior": "BypassCaching",
+          "originPath": "/photos",
+          "defaultOriginGroup": {
+            "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1"
+          },
+          "origins": [
+            {
+              "name": "origin1",
+              "properties": {
+                "hostName": "www.someDomain1.net",
+                "httpPort": 80,
+                "httpsPort": 443,
+                "originHostHeader": "www.someDomain1.net",
+                "priority": 1,
+                "weight": 50,
+                "enabled": true
+              }
+            },
+            {
+              "name": "origin2",
+              "properties": {
+                "hostName": "www.someDomain2.net",
+                "httpPort": 80,
+                "httpsPort": 443,
+                "originHostHeader": "www.someDomain2.net",
+                "priority": 2,
+                "weight": 50,
+                "enabled": true
+              }
+            }
+          ],
+          "originGroups": [
+            {
+              "name": "originGroup1",
+              "properties": {
+                "healthProbeSettings": {
+                  "probePath": "/health.aspx",
+                  "probeRequestType": "GET",
+                  "probeProtocol": "Http",
+                  "probeIntervalInSeconds": 120
+                },
+                "origins": [
+                  {
+                    "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
+                  },
+                  {
+                    "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin2"
+                  }
+                ],
+                "responseBasedOriginErrorDetectionSettings": {
+                  "responseBasedDetectedErrorTypes": "TcpErrorsOnly",
+                  "responseBasedFailoverThresholdPercentage": 10
+                }
+              }
+            }
+          ],
+          "contentTypesToCompress": [
+            "text/html",
+            "application/octet-stream"
+          ],
+          "isCompressionEnabled": true,
+          "optimizationType": null,
+          "probePath": null,
+          "geoFilters": [],
+          "deliveryPolicy": {
+            "description": "Test description for a policy.",
+            "rules": [
+              {
+                "name": "rule1",
+                "order": 1,
+                "conditions": [
+                  {
+                    "name": "RemoteAddress",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRemoteAddressConditionParameters",
+                      "operator": "IPMatch",
+                      "negateCondition": true,
+                      "matchValues": [
+                        "192.168.1.0/24",
+                        "10.0.0.0/24"
+                      ],
+                      "transforms": []
+                    }
+                  }
+                ],
+                "actions": [
+                  {
+                    "name": "CacheExpiration",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleCacheExpirationActionParameters",
+                      "cacheBehavior": "Override",
+                      "cacheDuration": "10:10:09",
+                      "cacheType": "All"
+                    }
+                  },
+                  {
+                    "name": "ModifyResponseHeader",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleHeaderActionParameters",
+                      "headerAction": "Overwrite",
+                      "headerName": "Access-Control-Allow-Origin",
+                      "value": "*"
+                    }
+                  },
+                  {
+                    "name": "ModifyRequestHeader",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleHeaderActionParameters",
+                      "headerAction": "Overwrite",
+                      "headerName": "Accept-Encoding",
+                      "value": "gzip"
+                    }
+                  }
+                ]
+              }
+            ]
+          }
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "endpoint4899",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+        "type": "Microsoft.Cdn/profiles/endpoints",
+        "tags": {
+          "kay1": "value1"
+        },
+        "location": "WestUs",
+        "properties": {
+          "hostName": "endpoint4899.azureedge-test.net",
+          "originHostHeader": "www.bing.com",
+          "provisioningState": "Creating",
+          "resourceState": "Creating",
+          "isHttpAllowed": true,
+          "isHttpsAllowed": true,
+          "queryStringCachingBehavior": "BypassCaching",
+          "originPath": "/photos",
+          "defaultOriginGroup": {
+            "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1"
+          },
+          "origins": [
+            {
+              "name": "origin1",
+              "properties": {
+                "hostName": "www.someDomain1.net",
+                "httpPort": 80,
+                "httpsPort": 443,
+                "originHostHeader": "www.someDomain1.net",
+                "priority": 1,
+                "weight": 50,
+                "enabled": true
+              }
+            },
+            {
+              "name": "origin2",
+              "properties": {
+                "hostName": "www.someDomain2.net",
+                "httpPort": 80,
+                "httpsPort": 443,
+                "originHostHeader": "www.someDomain2.net",
+                "priority": 2,
+                "weight": 50,
+                "enabled": true
+              }
+            }
+          ],
+          "originGroups": [
+            {
+              "name": "originGroup1",
+              "properties": {
+                "healthProbeSettings": {
+                  "probePath": "/health.aspx",
+                  "probeRequestType": "GET",
+                  "probeProtocol": "Http",
+                  "probeIntervalInSeconds": 120
+                },
+                "origins": [
+                  {
+                    "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
+                  },
+                  {
+                    "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin2"
+                  }
+                ],
+                "responseBasedOriginErrorDetectionSettings": {
+                  "responseBasedDetectedErrorTypes": "TcpErrorsOnly",
+                  "responseBasedFailoverThresholdPercentage": 10
+                }
+              }
+            }
+          ],
+          "contentTypesToCompress": [
+            "text/html",
+            "application/octet-stream"
+          ],
+          "isCompressionEnabled": true,
+          "optimizationType": null,
+          "probePath": null,
+          "geoFilters": [],
+          "deliveryPolicy": {
+            "description": "Test description for a policy.",
+            "rules": [
+              {
+                "name": "rule1",
+                "order": 1,
+                "conditions": [
+                  {
+                    "name": "RemoteAddress",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRemoteAddressConditionParameters",
+                      "operator": "IPMatch",
+                      "negateCondition": true,
+                      "matchValues": [
+                        "192.168.1.0/24",
+                        "10.0.0.0/24"
+                      ],
+                      "transforms": []
+                    }
+                  }
+                ],
+                "actions": [
+                  {
+                    "name": "CacheExpiration",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleCacheExpirationActionParameters",
+                      "cacheBehavior": "Override",
+                      "cacheDuration": "10:10:09",
+                      "cacheType": "All"
+                    }
+                  },
+                  {
+                    "name": "ModifyResponseHeader",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleHeaderActionParameters",
+                      "headerAction": "Overwrite",
+                      "headerName": "Access-Control-Allow-Origin",
+                      "value": "*"
+                    }
+                  },
+                  {
+                    "name": "ModifyRequestHeader",
+                    "parameters": {
+                      "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleHeaderActionParameters",
+                      "headerAction": "Overwrite",
+                      "headerName": "Accept-Encoding",
+                      "value": "gzip"
+                    }
+                  }
+                ]
+              }
+            ]
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_Delete.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_Delete.json
new file mode 100644
index 000000000000..3f86f09f9aa6
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_Delete.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1"
+  },
+  "responses": {
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_Get.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_Get.json
new file mode 100644
index 000000000000..52d7141aacb9
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_Get.json
@@ -0,0 +1,70 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "endpoint1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+        "type": "Microsoft.Cdn/profiles/endpoints",
+        "tags": {},
+        "location": "CentralUs",
+        "properties": {
+          "hostName": "endpoint1.azureedge.net",
+          "originHostHeader": "www.bing.com",
+          "provisioningState": "Succeeded",
+          "resourceState": "Running",
+          "isHttpAllowed": true,
+          "isHttpsAllowed": true,
+          "queryStringCachingBehavior": "NotSet",
+          "originPath": null,
+          "origins": [
+            {
+              "name": "www-bing-com",
+              "properties": {
+                "hostName": "www.bing.com",
+                "httpPort": 80,
+                "httpsPort": 443,
+                "originHostHeader": "www.someDomain2.net",
+                "priority": 2,
+                "weight": 50,
+                "enabled": true
+              }
+            }
+          ],
+          "originGroups": [
+            {
+              "name": "originGroup1",
+              "properties": {
+                "healthProbeSettings": {
+                  "probePath": "/health.aspx",
+                  "probeRequestType": "GET",
+                  "probeProtocol": "Http",
+                  "probeIntervalInSeconds": 120
+                },
+                "origins": [
+                  {
+                    "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/www-bing-com"
+                  }
+                ]
+              }
+            }
+          ],
+          "contentTypesToCompress": [],
+          "isCompressionEnabled": false,
+          "optimizationType": "DynamicSiteAcceleration",
+          "probePath": "/image",
+          "geoFilters": [],
+          "defaultOriginGroup": {
+            "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_ListByProfile.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_ListByProfile.json
new file mode 100644
index 000000000000..b152f3bbd6de
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_ListByProfile.json
@@ -0,0 +1,77 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "endpoint1",
+            "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+            "type": "Microsoft.Cdn/profiles/endpoints",
+            "tags": {},
+            "location": "CentralUs",
+            "properties": {
+              "hostName": "endpoint1.azureedge.net",
+              "originHostHeader": "www.bing.com",
+              "provisioningState": "Succeeded",
+              "resourceState": "Running",
+              "isHttpAllowed": true,
+              "isHttpsAllowed": true,
+              "queryStringCachingBehavior": "NotSet",
+              "originPath": null,
+              "origins": [
+                {
+                  "name": "www-bing-com",
+                  "properties": {
+                    "hostName": "www.bing.com",
+                    "httpPort": 80,
+                    "httpsPort": 443,
+                    "originHostHeader": "www.someDomain2.net",
+                    "priority": 2,
+                    "weight": 50,
+                    "enabled": true
+                  }
+                }
+              ],
+              "originGroups": [
+                {
+                  "name": "originGroup1",
+                  "properties": {
+                    "healthProbeSettings": {
+                      "probePath": "/health.aspx",
+                      "probeRequestType": "GET",
+                      "probeProtocol": "Http",
+                      "probeIntervalInSeconds": 120
+                    },
+                    "origins": [
+                      {
+                        "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/www-bing-com"
+                      }
+                    ],
+                    "responseBasedOriginErrorDetectionSettings": {
+                      "responseBasedDetectedErrorTypes": "TcpErrorsOnly",
+                      "responseBasedFailoverThresholdPercentage": 10
+                    }
+                  }
+                }
+              ],
+              "contentTypesToCompress": [],
+              "isCompressionEnabled": false,
+              "optimizationType": "DynamicSiteAcceleration",
+              "probePath": "/image",
+              "geoFilters": [],
+              "defaultOriginGroup": {
+                "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1"
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_ListResourceUsage.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_ListResourceUsage.json
new file mode 100644
index 000000000000..97622a7d7d91
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_ListResourceUsage.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "resourceType": "customdomain",
+            "unit": "count",
+            "currentValue": 1,
+            "limit": 20
+          },
+          {
+            "resourceType": "geofilter",
+            "unit": "count",
+            "currentValue": 0,
+            "limit": 25
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_LoadContent.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_LoadContent.json
new file mode 100644
index 000000000000..8ec0a0e2a181
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_LoadContent.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "contentFilePaths": {
+      "contentPaths": [
+        "/folder1"
+      ]
+    }
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_PurgeContent.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_PurgeContent.json
new file mode 100644
index 000000000000..8ec0a0e2a181
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_PurgeContent.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "contentFilePaths": {
+      "contentPaths": [
+        "/folder1"
+      ]
+    }
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_Start.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_Start.json
new file mode 100644
index 000000000000..911d81318e44
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_Start.json
@@ -0,0 +1,83 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "endpoint4899",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+        "type": "Microsoft.Cdn/profiles/endpoints",
+        "tags": {
+          "kay1": "value1"
+        },
+        "location": "WestUs",
+        "properties": {
+          "hostName": "endpoint1.azureedge.net",
+          "originHostHeader": "www.bing.com",
+          "provisioningState": "Succeeded",
+          "resourceState": "Starting",
+          "isHttpAllowed": true,
+          "isHttpsAllowed": true,
+          "queryStringCachingBehavior": "NotSet",
+          "originPath": null,
+          "origins": [
+            {
+              "name": "www-bing-com",
+              "properties": {
+                "hostName": "www.bing.com",
+                "httpPort": 80,
+                "httpsPort": 443
+              }
+            }
+          ],
+          "contentTypesToCompress": [],
+          "isCompressionEnabled": false,
+          "optimizationType": "DynamicSiteAcceleration",
+          "probePath": "/image",
+          "geoFilters": []
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "endpoint4899",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+        "type": "Microsoft.Cdn/profiles/endpoints",
+        "tags": {
+          "kay1": "value1"
+        },
+        "location": "WestUs",
+        "properties": {
+          "hostName": "endpoint1.azureedge.net",
+          "originHostHeader": "www.bing.com",
+          "provisioningState": "Succeeded",
+          "resourceState": "Starting",
+          "isHttpAllowed": true,
+          "isHttpsAllowed": true,
+          "queryStringCachingBehavior": "NotSet",
+          "originPath": null,
+          "origins": [
+            {
+              "name": "www-bing-com",
+              "properties": {
+                "hostName": "www.bing.com",
+                "httpPort": 80,
+                "httpsPort": 443
+              }
+            }
+          ],
+          "contentTypesToCompress": [],
+          "isCompressionEnabled": false,
+          "optimizationType": "DynamicSiteAcceleration",
+          "probePath": "/image",
+          "geoFilters": []
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_Stop.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_Stop.json
new file mode 100644
index 000000000000..8d670c159f4a
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_Stop.json
@@ -0,0 +1,83 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "endpoint4899",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+        "type": "Microsoft.Cdn/profiles/endpoints",
+        "tags": {
+          "kay1": "value1"
+        },
+        "location": "WestUs",
+        "properties": {
+          "hostName": "endpoint1.azureedge.net",
+          "originHostHeader": "www.bing.com",
+          "provisioningState": "Succeeded",
+          "resourceState": "Stopping",
+          "isHttpAllowed": true,
+          "isHttpsAllowed": true,
+          "queryStringCachingBehavior": "NotSet",
+          "originPath": null,
+          "origins": [
+            {
+              "name": "www-bing-com",
+              "properties": {
+                "hostName": "www.bing.com",
+                "httpPort": 80,
+                "httpsPort": 443
+              }
+            }
+          ],
+          "contentTypesToCompress": [],
+          "isCompressionEnabled": false,
+          "optimizationType": "DynamicSiteAcceleration",
+          "probePath": "/image",
+          "geoFilters": []
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "endpoint4899",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+        "type": "Microsoft.Cdn/profiles/endpoints",
+        "tags": {
+          "kay1": "value1"
+        },
+        "location": "WestUs",
+        "properties": {
+          "hostName": "endpoint1.azureedge.net",
+          "originHostHeader": "www.bing.com",
+          "provisioningState": "Succeeded",
+          "resourceState": "Stopping",
+          "isHttpAllowed": true,
+          "isHttpsAllowed": true,
+          "queryStringCachingBehavior": "NotSet",
+          "originPath": null,
+          "origins": [
+            {
+              "name": "www-bing-com",
+              "properties": {
+                "hostName": "www.bing.com",
+                "httpPort": 80,
+                "httpsPort": 443
+              }
+            }
+          ],
+          "contentTypesToCompress": [],
+          "isCompressionEnabled": false,
+          "optimizationType": "DynamicSiteAcceleration",
+          "probePath": "/image",
+          "geoFilters": []
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_Update.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_Update.json
new file mode 100644
index 000000000000..8f8b4f876ccd
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_Update.json
@@ -0,0 +1,138 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "endpointUpdateProperties": {
+      "tags": {
+        "additionalProperties": "Tag1"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "endpoint1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+        "type": "Microsoft.Cdn/profiles/endpoints",
+        "tags": {
+          "additionalProperties": "Tag1"
+        },
+        "location": "WestCentralUs",
+        "properties": {
+          "hostName": "endpoint1.azureedge.net",
+          "originHostHeader": null,
+          "provisioningState": "Creating",
+          "resourceState": "Creating",
+          "isHttpAllowed": true,
+          "isHttpsAllowed": true,
+          "queryStringCachingBehavior": "IgnoreQueryString",
+          "originPath": null,
+          "origins": [
+            {
+              "name": "www-bing-com",
+              "properties": {
+                "hostName": "www.bing.com",
+                "httpPort": 80,
+                "httpsPort": 443,
+                "originHostHeader": "www.someDomain2.net",
+                "priority": 2,
+                "weight": 50,
+                "enabled": true
+              }
+            }
+          ],
+          "originGroups": [
+            {
+              "name": "originGroup1",
+              "properties": {
+                "healthProbeSettings": {
+                  "probePath": "/health.aspx",
+                  "probeRequestType": "GET",
+                  "probeProtocol": "Http",
+                  "probeIntervalInSeconds": 120
+                },
+                "origins": [
+                  {
+                    "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/www-bing-com"
+                  }
+                ]
+              }
+            }
+          ],
+          "defaultOriginGroup": {
+            "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1"
+          },
+          "contentTypesToCompress": [],
+          "isCompressionEnabled": false,
+          "optimizationType": null,
+          "probePath": null,
+          "geoFilters": []
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "endpoint1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
+        "type": "Microsoft.Cdn/profiles/endpoints",
+        "tags": {
+          "additionalProperties": "Tag1"
+        },
+        "location": "WestCentralUs",
+        "properties": {
+          "hostName": "endpoint1.azureedge.net",
+          "originHostHeader": null,
+          "provisioningState": "Creating",
+          "resourceState": "Creating",
+          "isHttpAllowed": true,
+          "isHttpsAllowed": true,
+          "queryStringCachingBehavior": "IgnoreQueryString",
+          "originPath": null,
+          "origins": [
+            {
+              "name": "www-bing-com",
+              "properties": {
+                "hostName": "www.bing.com",
+                "httpPort": 80,
+                "httpsPort": 443,
+                "originHostHeader": "www.someDomain2.net",
+                "priority": 2,
+                "weight": 50,
+                "enabled": true
+              }
+            }
+          ],
+          "originGroups": [
+            {
+              "name": "originGroup1",
+              "properties": {
+                "healthProbeSettings": {
+                  "probePath": "/health.aspx",
+                  "probeRequestType": "GET",
+                  "probeProtocol": "Http",
+                  "probeIntervalInSeconds": 120
+                },
+                "origins": [
+                  {
+                    "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/www-bing-com"
+                  }
+                ]
+              }
+            }
+          ],
+          "contentTypesToCompress": [],
+          "isCompressionEnabled": false,
+          "optimizationType": null,
+          "probePath": null,
+          "geoFilters": [],
+          "defaultOriginGroup": {
+            "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_ValidateCustomDomain.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_ValidateCustomDomain.json
new file mode 100644
index 000000000000..63777e355ac3
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Endpoints_ValidateCustomDomain.json
@@ -0,0 +1,21 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "customDomainProperties": {
+      "hostName": "www.someDomain.com"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "customDomainValidated": true,
+        "message": null,
+        "reason": null
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Operations_List.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Operations_List.json
new file mode 100644
index 000000000000..0c9d7e28bdaf
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Operations_List.json
@@ -0,0 +1,93 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "Microsoft.Cdn/register/action",
+            "display": {
+              "provider": "Microsoft.Cdn",
+              "resource": "Microsoft.Cdn Resource Provider",
+              "operation": "Registers the Microsoft.Cdn Resource Provider"
+            }
+          },
+          {
+            "name": "Microsoft.Cdn/edgenodes/read",
+            "display": {
+              "provider": "Microsoft.Cdn",
+              "resource": "EdgeNode",
+              "operation": "read"
+            }
+          },
+          {
+            "name": "Microsoft.Cdn/edgenodes/write",
+            "display": {
+              "provider": "Microsoft.Cdn",
+              "resource": "EdgeNode",
+              "operation": "write"
+            }
+          },
+          {
+            "name": "Microsoft.Cdn/edgenodes/delete",
+            "display": {
+              "provider": "Microsoft.Cdn",
+              "resource": "EdgeNode",
+              "operation": "delete"
+            }
+          },
+          {
+            "name": "Microsoft.Cdn/profiles/read",
+            "display": {
+              "provider": "Microsoft.Cdn",
+              "resource": "Profile",
+              "operation": "read"
+            }
+          },
+          {
+            "name": "Microsoft.Cdn/profiles/write",
+            "display": {
+              "provider": "Microsoft.Cdn",
+              "resource": "Profile",
+              "operation": "write"
+            }
+          },
+          {
+            "name": "Microsoft.Cdn/operationresults/profileresults/write",
+            "display": {
+              "provider": "Microsoft.Cdn",
+              "resource": "Profile",
+              "operation": "write"
+            }
+          },
+          {
+            "name": "Microsoft.Cdn/operationresults/profileresults/delete",
+            "display": {
+              "provider": "Microsoft.Cdn",
+              "resource": "Profile",
+              "operation": "delete"
+            }
+          },
+          {
+            "name": "Microsoft.Cdn/operationresults/profileresults/CheckResourceUsage/action",
+            "display": {
+              "provider": "Microsoft.Cdn",
+              "resource": "Profile",
+              "operation": "CheckResourceUsage"
+            }
+          },
+          {
+            "name": "Microsoft.Cdn/operationresults/profileresults/GenerateSsoUri/action",
+            "display": {
+              "provider": "Microsoft.Cdn",
+              "resource": "Profile",
+              "operation": "GenerateSsoUri"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/OriginGroups_Create.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/OriginGroups_Create.json
new file mode 100644
index 000000000000..d9011eeb0e0b
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/OriginGroups_Create.json
@@ -0,0 +1,109 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "originGroupName": "origingroup1",
+    "originGroup": {
+      "properties": {
+        "healthProbeSettings": {
+          "probePath": "/health.aspx",
+          "probeRequestType": "GET",
+          "probeProtocol": "Http",
+          "probeIntervalInSeconds": 120
+        },
+        "origins": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
+          }
+        ],
+        "responseBasedOriginErrorDetectionSettings": {
+          "responseBasedDetectedErrorTypes": "TcpErrorsOnly",
+          "responseBasedFailoverThresholdPercentage": 10
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "origingroup1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1",
+        "type": "Microsoft.Cdn/profiles/endpoints/origingroups",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "healthProbeSettings": {
+            "probePath": "/health.aspx",
+            "probeRequestType": "GET",
+            "probeProtocol": "Http",
+            "probeIntervalInSeconds": 120
+          },
+          "origins": [
+            {
+              "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
+            }
+          ],
+          "responseBasedOriginErrorDetectionSettings": {
+            "responseBasedDetectedErrorTypes": "TcpErrorsOnly",
+            "responseBasedFailoverThresholdPercentage": 10
+          }
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "name": "origingroup1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1",
+        "type": "Microsoft.Cdn/profiles/endpoints/origingroups",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "healthProbeSettings": {
+            "probePath": "/health.aspx",
+            "probeRequestType": "GET",
+            "probeProtocol": "Http",
+            "probeIntervalInSeconds": 120
+          },
+          "origins": [
+            {
+              "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
+            }
+          ],
+          "responseBasedOriginErrorDetectionSettings": {
+            "responseBasedDetectedErrorTypes": "TcpErrorsOnly",
+            "responseBasedFailoverThresholdPercentage": 10
+          }
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "originGroup1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1",
+        "type": "Microsoft.Cdn/profiles/endpoints/origingroups",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "healthProbeSettings": {
+            "probePath": "/health.aspx",
+            "probeRequestType": "GET",
+            "probeProtocol": "Http",
+            "probeIntervalInSeconds": 120
+          },
+          "origins": [
+            {
+              "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
+            }
+          ],
+          "responseBasedOriginErrorDetectionSettings": {
+            "responseBasedDetectedErrorTypes": "TcpErrorsOnly",
+            "responseBasedFailoverThresholdPercentage": 10
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/OriginGroups_Delete.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/OriginGroups_Delete.json
new file mode 100644
index 000000000000..579693751a64
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/OriginGroups_Delete.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "originGroupName": "originGroup1"
+  },
+  "responses": {
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/OriginGroups_Get.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/OriginGroups_Get.json
new file mode 100644
index 000000000000..d07d328840f6
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/OriginGroups_Get.json
@@ -0,0 +1,44 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "originGroupName": "originGroup1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "origingroup1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1",
+        "type": "Microsoft.Cdn/profiles/endpoints/origingroups",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "healthProbeSettings": {
+            "probePath": "/health.aspx",
+            "probeRequestType": "GET",
+            "probeProtocol": "Http",
+            "probeIntervalInSeconds": 120
+          },
+          "origins": [
+            {
+              "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
+            }
+          ],
+          "responseBasedOriginErrorDetectionSettings": {
+            "responseBasedDetectedErrorTypes": "TcpAndHttpErrors",
+            "responseBasedFailoverThresholdPercentage": 10,
+            "httpErrorRanges": [
+              {
+                "begin": 500,
+                "end": 505
+              }
+            ]
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/OriginGroups_ListByEndpoint.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/OriginGroups_ListByEndpoint.json
new file mode 100644
index 000000000000..9d537a147041
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/OriginGroups_ListByEndpoint.json
@@ -0,0 +1,41 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "origingroup1",
+            "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1",
+            "type": "Microsoft.Cdn/profiles/endpoints/origingroups",
+            "properties": {
+              "provisioningState": "Succeeded",
+              "resourceState": "Active",
+              "healthProbeSettings": {
+                "probePath": "/health.aspx",
+                "probeRequestType": "GET",
+                "probeProtocol": "Http",
+                "probeIntervalInSeconds": 120
+              },
+              "origins": [
+                {
+                  "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
+                }
+              ],
+              "responseBasedOriginErrorDetectionSettings": {
+                "responseBasedDetectedErrorTypes": "TcpErrorsOnly",
+                "responseBasedFailoverThresholdPercentage": 10
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/OriginGroups_Update.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/OriginGroups_Update.json
new file mode 100644
index 000000000000..5308383c35c0
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/OriginGroups_Update.json
@@ -0,0 +1,71 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "originGroupName": "originGroup1",
+    "originGroupUpdateProperties": {
+      "properties": {
+        "healthProbeSettings": {
+          "probePath": "/health.aspx",
+          "probeRequestType": "GET",
+          "probeProtocol": "Http",
+          "probeIntervalInSeconds": 120
+        },
+        "origins": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin2"
+          }
+        ]
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "www-someDomain-net",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/origins",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "healthProbeSettings": {
+            "probePath": "/health.aspx",
+            "probeRequestType": "GET",
+            "probeProtocol": "Http",
+            "probeIntervalInSeconds": 120
+          },
+          "origins": [
+            {
+              "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin2"
+            }
+          ]
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "www-someDomain-net",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/origins",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "healthProbeSettings": {
+            "probePath": "/health.aspx",
+            "probeRequestType": "GET",
+            "probeProtocol": "Http",
+            "probeIntervalInSeconds": 120
+          },
+          "origins": [
+            {
+              "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin2"
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Origins_Create.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Origins_Create.json
new file mode 100644
index 000000000000..ba59911b81e7
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Origins_Create.json
@@ -0,0 +1,93 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "originName": "www-someDomain-net",
+    "origin": {
+      "location": "WestUs",
+      "tags": {
+        "key1": "value1"
+      },
+      "properties": {
+        "hostName": "www.someDomain.net",
+        "httpPort": 80,
+        "httpsPort": 443,
+        "originHostHeader": "www.someDomain.net",
+        "priority": 1,
+        "weight": 50,
+        "enabled": true
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "www-someDomain-net",
+        "location": "WestUs",
+        "tags": {
+          "key1": "value1"
+        },
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/origins",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "httpPort": 80,
+          "httpsPort": 443,
+          "originHostHeader": "www.someDomain.net",
+          "priority": 1,
+          "weight": 50,
+          "enabled": true
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "name": "www-someDomain-net",
+        "location": "WestUs",
+        "tags": {
+          "key1": "value1"
+        },
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/origins",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "httpPort": 80,
+          "httpsPort": 443,
+          "originHostHeader": "www.someDomain.net",
+          "priority": 1,
+          "weight": 50,
+          "enabled": true
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "www-someDomain-net",
+        "location": "WestUs",
+        "tags": {
+          "key1": "value1"
+        },
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/origins",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "httpPort": 80,
+          "httpsPort": 443,
+          "originHostHeader": "www.someDomain.net",
+          "priority": 1,
+          "weight": 50,
+          "enabled": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Origins_Delete.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Origins_Delete.json
new file mode 100644
index 000000000000..497e0f8f3c37
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Origins_Delete.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "originName": "origin1"
+  },
+  "responses": {
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Origins_Get.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Origins_Get.json
new file mode 100644
index 000000000000..56444627eff0
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Origins_Get.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "originName": "www-someDomain-net"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "www-someDomain-net",
+        "location": "WestUs",
+        "tags": {
+          "key1": "value1"
+        },
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/origins",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "httpPort": null,
+          "httpsPort": null,
+          "originHostHeader": "www.someDomain.net",
+          "priority": 1,
+          "weight": 50,
+          "enabled": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Origins_ListByEndpoint.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Origins_ListByEndpoint.json
new file mode 100644
index 000000000000..1e81714e36a8
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Origins_ListByEndpoint.json
@@ -0,0 +1,37 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "www-someDomain-net",
+            "location": "WestUs",
+            "tags": {
+              "key1": "value1"
+            },
+            "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/www-someDomain-net",
+            "type": "Microsoft.Cdn/profiles/endpoints/origins",
+            "properties": {
+              "provisioningState": "Succeeded",
+              "resourceState": "Active",
+              "hostName": "www.someDomain.net",
+              "httpPort": null,
+              "httpsPort": null,
+              "originHostHeader": "www.someDomain.net",
+              "priority": 1,
+              "weight": 50,
+              "enabled": true
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Origins_Update.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Origins_Update.json
new file mode 100644
index 000000000000..c47e493a4b2a
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Origins_Update.json
@@ -0,0 +1,69 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "endpointName": "endpoint1",
+    "originName": "www-someDomain-net",
+    "originUpdateProperties": {
+      "tags": {
+        "key1": "value1"
+      },
+      "properties": {
+        "httpPort": 42,
+        "httpsPort": 43,
+        "originHostHeader": "www.someDomain2.net",
+        "priority": 1,
+        "weight": 50,
+        "enabled": true
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "www-someDomain-net",
+        "location": "WestUs",
+        "tags": {
+          "key1": "value1"
+        },
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/www-someDomain-net",
+        "type": "Microsoft.Cdn/profiles/endpoints/origins",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "httpPort": 42,
+          "httpsPort": 43,
+          "originHostHeader": "www.someDomain2.net",
+          "priority": 1,
+          "weight": 50,
+          "enabled": true
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "www-someDomain-net",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/www-someDomain-net",
+        "location": "WestUs",
+        "tags": {
+          "key1": "value1"
+        },
+        "type": "Microsoft.Cdn/profiles/endpoints/origins",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active",
+          "hostName": "www.someDomain.net",
+          "httpPort": 42,
+          "httpsPort": 43,
+          "originHostHeader": "www.someDomain2.net",
+          "priority": 1,
+          "weight": 50,
+          "enabled": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_Create.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_Create.json
new file mode 100644
index 000000000000..83c7264d1aa9
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_Create.json
@@ -0,0 +1,64 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "profile": {
+      "location": "WestCentralUs",
+      "sku": {
+        "name": "Standard_Verizon"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "profile1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1",
+        "type": "Microsoft.Cdn/profiles",
+        "tags": {},
+        "location": "WestCentralUs",
+        "sku": {
+          "name": "Standard_Verizon"
+        },
+        "properties": {
+          "provisioningState": "Creating",
+          "resourceState": "Creating"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "name": "profile1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1",
+        "type": "Microsoft.Cdn/profiles",
+        "tags": {},
+        "location": "WestCentralUs",
+        "sku": {
+          "name": "Standard_Verizon"
+        },
+        "properties": {
+          "provisioningState": "Creating",
+          "resourceState": "Creating"
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "profile1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1",
+        "type": "Microsoft.Cdn/profiles",
+        "tags": {},
+        "location": "WestCentralUs",
+        "sku": {
+          "name": "Standard_Verizon"
+        },
+        "properties": {
+          "provisioningState": "Creating",
+          "resourceState": "Creating"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_Delete.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_Delete.json
new file mode 100644
index 000000000000..8dc5b312a313
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_Delete.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1"
+  },
+  "responses": {
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_GenerateSsoUri.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_GenerateSsoUri.json
new file mode 100644
index 000000000000..8860f9753469
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_GenerateSsoUri.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "ssoUriValue": "https://someuri.com"
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_Get.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_Get.json
new file mode 100644
index 000000000000..9d75fbdcbafe
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_Get.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "profile1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1",
+        "type": "Microsoft.Cdn/profiles",
+        "tags": {},
+        "location": "WestCentralUs",
+        "sku": {
+          "name": "Standard_Akamai"
+        },
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_List.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_List.json
new file mode 100644
index 000000000000..57b729d7ec4f
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_List.json
@@ -0,0 +1,42 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "profile1",
+            "id": "/subscriptions/subid/resourcegroups/RG1/providers/Microsoft.Cdn/profiles/profile1",
+            "type": "Microsoft.Cdn/profiles",
+            "tags": {},
+            "location": "WestCentralUs",
+            "sku": {
+              "name": "Standard_Akamai"
+            },
+            "properties": {
+              "provisioningState": "Succeeded",
+              "resourceState": "Active"
+            }
+          },
+          {
+            "name": "profile2",
+            "id": "/subscriptions/subid/resourcegroups/RG1/providers/Microsoft.Cdn/profiles/profile2",
+            "type": "Microsoft.Cdn/profiles",
+            "tags": {},
+            "location": "WestCentralUs",
+            "sku": {
+              "name": "Standard_Akamai"
+            },
+            "properties": {
+              "provisioningState": "Succeeded",
+              "resourceState": "Active"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_ListByResourceGroup.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_ListByResourceGroup.json
new file mode 100644
index 000000000000..f8ac7df9d109
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_ListByResourceGroup.json
@@ -0,0 +1,43 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "profile1",
+            "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1",
+            "type": "Microsoft.Cdn/profiles",
+            "tags": {},
+            "location": "WestCentralUs",
+            "sku": {
+              "name": "Standard_Akamai"
+            },
+            "properties": {
+              "provisioningState": "Succeeded",
+              "resourceState": "Active"
+            }
+          },
+          {
+            "name": "profile2",
+            "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile2",
+            "type": "Microsoft.Cdn/profiles",
+            "tags": {},
+            "location": "WestCentralUs",
+            "sku": {
+              "name": "Standard_Akamai"
+            },
+            "properties": {
+              "provisioningState": "Succeeded",
+              "resourceState": "Active"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_ListResourceUsage.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_ListResourceUsage.json
new file mode 100644
index 000000000000..817007a24c82
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_ListResourceUsage.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "resourceType": "endpoint",
+            "unit": "count",
+            "currentValue": 0,
+            "limit": 25
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_ListSupportedOptimizationTypes.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_ListSupportedOptimizationTypes.json
new file mode 100644
index 000000000000..eb48c6e3eb83
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_ListSupportedOptimizationTypes.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "supportedOptimizationTypes": [
+          "GeneralWebDelivery",
+          "DynamicSiteAcceleration"
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_Update.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_Update.json
new file mode 100644
index 000000000000..05e1324d08db
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/Profiles_Update.json
@@ -0,0 +1,51 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "RG",
+    "profileName": "profile1",
+    "profileUpdateParameters": {
+      "tags": {
+        "additionalProperties": "Tag1"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "profile1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1",
+        "type": "Microsoft.Cdn/profiles",
+        "tags": {
+          "additionalProperties": "Tag1"
+        },
+        "location": "WestCentralUs",
+        "sku": {
+          "name": "Standard_Verizon"
+        },
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active"
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "profile1",
+        "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1",
+        "type": "Microsoft.Cdn/profiles",
+        "tags": {
+          "additionalProperties": "Tag1"
+        },
+        "location": "WestCentralUs",
+        "sku": {
+          "name": "Standard_Verizon"
+        },
+        "properties": {
+          "provisioningState": "Succeeded",
+          "resourceState": "Active"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/ResourceUsage_List.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/ResourceUsage_List.json
new file mode 100644
index 000000000000..04dd17cacaca
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/ResourceUsage_List.json
@@ -0,0 +1,20 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "resourceType": "profile",
+            "unit": "count",
+            "currentValue": 31,
+            "limit": 200
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/ValidateProbe.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/ValidateProbe.json
new file mode 100644
index 000000000000..0fbcc807ca79
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/ValidateProbe.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "validateProbeInput": {
+      "probeURL": "https://www.bing.com/image"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "isValid": true,
+        "errorCode": "None",
+        "message": null
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/WafListManagedRuleSets.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/WafListManagedRuleSets.json
new file mode 100644
index 000000000000..35a6f617f967
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/WafListManagedRuleSets.json
@@ -0,0 +1,53 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "DefaultRuleSet_1.0",
+            "id": "/subscriptions/subid/providers/Microsoft.Cdn/CdnWebApplicationFirewallManagedRuleSets",
+            "type": "Microsoft.Cdn/cdnwebapplicationfirewallmanagedrulesets",
+            "sku": {
+              "name": "Standard_Microsoft"
+            },
+            "properties": {
+              "provisioningState": "Succeeded",
+              "ruleSetType": "DefaultRuleSet",
+              "ruleSetVersion": "preview-1.0",
+              "ruleGroups": [
+                {
+                  "ruleGroupName": "Group1",
+                  "description": "Description for rule group 1.",
+                  "rules": [
+                    {
+                      "ruleId": "GROUP1-0001",
+                      "description": "Generic managed web application firewall rule."
+                    },
+                    {
+                      "ruleId": "GROUP1-0002",
+                      "description": "Generic managed web application firewall rule."
+                    }
+                  ]
+                },
+                {
+                  "ruleGroupName": "Group2",
+                  "description": "Description for rule group 2.",
+                  "rules": [
+                    {
+                      "ruleId": "GROUP2-0001",
+                      "description": "Generic managed web application firewall rule."
+                    }
+                  ]
+                }
+              ]
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/WafListPolicies.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/WafListPolicies.json
new file mode 100644
index 000000000000..f768c71a1cef
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/WafListPolicies.json
@@ -0,0 +1,265 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rg1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "MicrosoftCdnWafPolicy",
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/MicrosoftCdnWafPolicy",
+            "type": "Microsoft.Cdn/cdnwebapplicationfirewallpolicies",
+            "tags": {
+              "key1": "value1",
+              "key2": "value2"
+            },
+            "location": "WestUs",
+            "sku": {
+              "name": "Standard_Microsoft"
+            },
+            "properties": {
+              "resourceState": "Enabled",
+              "provisioningState": "Succeeded",
+              "policySettings": {
+                "enabledState": "Enabled",
+                "mode": "Prevention",
+                "defaultRedirectUrl": "http://www.bing.com",
+                "defaultCustomBlockResponseStatusCode": 429,
+                "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
+              },
+              "rateLimitRules": {
+                "rules": [
+                  {
+                    "name": "RateLimitRule1",
+                    "priority": 1,
+                    "enabledState": "Enabled",
+                    "rateLimitDurationInMinutes": 0,
+                    "rateLimitThreshold": 1000,
+                    "matchConditions": [
+                      {
+                        "matchVariable": "RemoteAddr",
+                        "selector": null,
+                        "operator": "IPMatch",
+                        "negateCondition": false,
+                        "transforms": [],
+                        "matchValue": [
+                          "192.168.1.0/24",
+                          "10.0.0.0/24"
+                        ]
+                      }
+                    ],
+                    "action": "Block"
+                  }
+                ]
+              },
+              "customRules": {
+                "rules": [
+                  {
+                    "name": "CustomRule1",
+                    "priority": 2,
+                    "enabledState": "Enabled",
+                    "matchConditions": [
+                      {
+                        "matchVariable": "RemoteAddr",
+                        "selector": null,
+                        "operator": "GeoMatch",
+                        "negateCondition": false,
+                        "transforms": [],
+                        "matchValue": [
+                          "CH"
+                        ]
+                      },
+                      {
+                        "matchVariable": "RequestHeader",
+                        "selector": "UserAgent",
+                        "operator": "Contains",
+                        "negateCondition": false,
+                        "transforms": [],
+                        "matchValue": [
+                          "windows"
+                        ]
+                      },
+                      {
+                        "matchVariable": "QueryString",
+                        "selector": "search",
+                        "operator": "Contains",
+                        "negateCondition": false,
+                        "transforms": [
+                          "UrlDecode",
+                          "Lowercase"
+                        ],
+                        "matchValue": [
+                          "<?php",
+                          "?>"
+                        ]
+                      }
+                    ],
+                    "action": "Block"
+                  }
+                ]
+              },
+              "managedRules": {
+                "managedRuleSets": [
+                  {
+                    "ruleSetType": "DefaultRuleSet",
+                    "ruleSetVersion": "preview-1.0",
+                    "ruleGroupOverrides": [
+                      {
+                        "ruleGroupName": "Group1",
+                        "rules": [
+                          {
+                            "ruleId": "GROUP1-0001",
+                            "enabledState": "Enabled",
+                            "action": "Redirect"
+                          },
+                          {
+                            "ruleId": "GROUP1-0002",
+                            "enabledState": "Disabled"
+                          }
+                        ]
+                      }
+                    ]
+                  }
+                ]
+              },
+              "endpointLinks": [
+                {
+                  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint1"
+                },
+                {
+                  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint2"
+                }
+              ]
+            }
+          },
+          {
+            "name": "VerizonStandardCdnWafPolicy",
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/VerizonStandardCdnWafPolicy",
+            "type": "Microsoft.Cdn/cdnwebapplicationfirewallpolicies",
+            "tags": {
+              "key1": "value1",
+              "key2": "value2"
+            },
+            "location": "WestUs",
+            "sku": {
+              "name": "Standard_Verizon"
+            },
+            "properties": {
+              "resourceState": "Enabled",
+              "provisioningState": "Succeeded",
+              "policySettings": {
+                "enabledState": "Enabled",
+                "mode": "Prevention",
+                "defaultRedirectUrl": "http://www.bing.com",
+                "defaultCustomBlockResponseStatusCode": 429,
+                "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
+              },
+              "rateLimitRules": {
+                "rules": [
+                  {
+                    "name": "RateLimitRule1",
+                    "priority": 1,
+                    "enabledState": "Enabled",
+                    "rateLimitDurationInMinutes": 0,
+                    "rateLimitThreshold": 1000,
+                    "matchConditions": [
+                      {
+                        "matchVariable": "RemoteAddr",
+                        "selector": null,
+                        "operator": "IPMatch",
+                        "negateCondition": false,
+                        "transforms": [],
+                        "matchValue": [
+                          "192.168.1.0/24",
+                          "10.0.0.0/24"
+                        ]
+                      }
+                    ],
+                    "action": "Block"
+                  }
+                ]
+              },
+              "customRules": {
+                "rules": [
+                  {
+                    "name": "CustomRule1",
+                    "priority": 2,
+                    "enabledState": "Enabled",
+                    "matchConditions": [
+                      {
+                        "matchVariable": "RemoteAddr",
+                        "selector": null,
+                        "operator": "GeoMatch",
+                        "negateCondition": false,
+                        "transforms": [],
+                        "matchValue": [
+                          "CH"
+                        ]
+                      },
+                      {
+                        "matchVariable": "RequestHeader",
+                        "selector": "UserAgent",
+                        "operator": "Contains",
+                        "negateCondition": false,
+                        "matchValue": [
+                          "windows"
+                        ]
+                      },
+                      {
+                        "matchVariable": "QueryString",
+                        "selector": "search",
+                        "operator": "Contains",
+                        "negateCondition": false,
+                        "transforms": [
+                          "UrlDecode",
+                          "Lowercase"
+                        ],
+                        "matchValue": [
+                          "<?php",
+                          "?>"
+                        ]
+                      }
+                    ],
+                    "action": "Block"
+                  }
+                ]
+              },
+              "managedRules": {
+                "managedRuleSets": [
+                  {
+                    "ruleSetType": "ECRS",
+                    "ruleSetVersion": "2018-11-2",
+                    "ruleGroupOverrides": [
+                      {
+                        "ruleGroupName": "XSS",
+                        "rules": [
+                          {
+                            "ruleId": "XSS-0001",
+                            "enabledState": "Enabled",
+                            "action": "Redirect"
+                          },
+                          {
+                            "ruleId": "XSS-0002",
+                            "enabledState": "Disabled"
+                          }
+                        ]
+                      }
+                    ]
+                  }
+                ]
+              },
+              "endpointLinks": [
+                {
+                  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint3"
+                }
+              ]
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/WafPatchPolicy.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/WafPatchPolicy.json
new file mode 100644
index 000000000000..f25f8d61b5a9
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/WafPatchPolicy.json
@@ -0,0 +1,272 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rg1",
+    "policyName": "MicrosoftCdnWafPolicy",
+    "cdnWebApplicationFirewallPolicyPatchParameters": {
+      "tags": {
+        "foo": "bar"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "MicrosoftCdnWafPolicy",
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/MicrosoftCdnWafPolicy",
+        "type": "Microsoft.Cdn/cdnwebapplicationfirewallpolicies",
+        "tags": {
+          "foo": "bar"
+        },
+        "location": "WestUs",
+        "sku": {
+          "name": "Standard_Microsoft"
+        },
+        "properties": {
+          "resourceState": "Enabled",
+          "provisioningState": "Succeeded",
+          "policySettings": {
+            "enabledState": "Enabled",
+            "mode": "Prevention",
+            "defaultRedirectUrl": "http://www.bing.com",
+            "defaultCustomBlockResponseStatusCode": 403,
+            "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
+          },
+          "rateLimitRules": {
+            "rules": [
+              {
+                "name": "RateLimitRule1",
+                "priority": 1,
+                "enabledState": "Enabled",
+                "rateLimitDurationInMinutes": 0,
+                "rateLimitThreshold": 1000,
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "IPMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "192.168.1.0/24",
+                      "10.0.0.0/24"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "customRules": {
+            "rules": [
+              {
+                "name": "CustomRule1",
+                "priority": 2,
+                "enabledState": "Enabled",
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "GeoMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "CH"
+                    ]
+                  },
+                  {
+                    "matchVariable": "RequestHeader",
+                    "selector": "UserAgent",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "windows"
+                    ]
+                  },
+                  {
+                    "matchVariable": "QueryString",
+                    "selector": "search",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [
+                      "UrlDecode",
+                      "Lowercase"
+                    ],
+                    "matchValue": [
+                      "<?php",
+                      "?>"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "managedRules": {
+            "managedRuleSets": [
+              {
+                "ruleSetType": "DefaultRuleSet",
+                "ruleSetVersion": "preview-1.0",
+                "ruleGroupOverrides": [
+                  {
+                    "ruleGroupName": "Group1",
+                    "rules": [
+                      {
+                        "ruleId": "GROUP1-0001",
+                        "enabledState": "Enabled",
+                        "action": "Redirect"
+                      },
+                      {
+                        "ruleId": "GROUP1-0002",
+                        "enabledState": "Disabled"
+                      }
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
+          "endpointLinks": [
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint1"
+            },
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint2"
+            }
+          ]
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "MicrosoftCdnWafPolicy",
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/MicrosoftCdnWafPolicy",
+        "type": "Microsoft.Cdn/cdnwebapplicationfirewallpolicies",
+        "tags": {
+          "key1": "value1",
+          "key2": "value2"
+        },
+        "location": "WestUs",
+        "sku": {
+          "name": "Standard_Microsoft"
+        },
+        "properties": {
+          "resourceState": "Creating",
+          "provisioningState": "Succeeded",
+          "policySettings": {
+            "enabledState": "Enabled",
+            "mode": "Prevention",
+            "defaultRedirectUrl": "http://www.bing.com",
+            "defaultCustomBlockResponseStatusCode": 403,
+            "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
+          },
+          "rateLimitRules": {
+            "rules": [
+              {
+                "name": "RateLimitRule1",
+                "priority": 1,
+                "enabledState": "Enabled",
+                "rateLimitDurationInMinutes": 0,
+                "rateLimitThreshold": 1000,
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "IPMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "192.168.1.0/24",
+                      "10.0.0.0/24"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "customRules": {
+            "rules": [
+              {
+                "name": "CustomRule1",
+                "priority": 2,
+                "enabledState": "Enabled",
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "GeoMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "CH"
+                    ]
+                  },
+                  {
+                    "matchVariable": "RequestHeader",
+                    "selector": "UserAgent",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "windows"
+                    ]
+                  },
+                  {
+                    "matchVariable": "QueryString",
+                    "selector": "search",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [
+                      "UrlDecode",
+                      "Lowercase"
+                    ],
+                    "matchValue": [
+                      "<?php",
+                      "?>"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "managedRules": {
+            "managedRuleSets": [
+              {
+                "ruleSetType": "DefaultRuleSet",
+                "ruleSetVersion": "preview-1.0",
+                "ruleGroupOverrides": [
+                  {
+                    "ruleGroupName": "Group1",
+                    "rules": [
+                      {
+                        "ruleId": "GROUP1-0001",
+                        "enabledState": "Enabled",
+                        "action": "Redirect"
+                      },
+                      {
+                        "ruleId": "GROUP1-0002",
+                        "enabledState": "Disabled"
+                      }
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
+          "endpointLinks": [
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint1"
+            },
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint2"
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/WafPolicyCreateOrUpdate.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/WafPolicyCreateOrUpdate.json
new file mode 100644
index 000000000000..b5fdc100e22a
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/WafPolicyCreateOrUpdate.json
@@ -0,0 +1,505 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rg1",
+    "policyName": "MicrosoftCdnWafPolicy",
+    "cdnWebApplicationFirewallPolicy": {
+      "location": "WestUs",
+      "sku": {
+        "name": "Standard_Microsoft"
+      },
+      "properties": {
+        "policySettings": {
+          "defaultRedirectUrl": "http://www.bing.com",
+          "defaultCustomBlockResponseStatusCode": 200,
+          "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
+        },
+        "rateLimitRules": {
+          "rules": [
+            {
+              "name": "RateLimitRule1",
+              "priority": 1,
+              "enabledState": "Enabled",
+              "rateLimitDurationInMinutes": 0,
+              "rateLimitThreshold": 1000,
+              "matchConditions": [
+                {
+                  "matchVariable": "RemoteAddr",
+                  "selector": null,
+                  "operator": "IPMatch",
+                  "negateCondition": false,
+                  "transforms": [],
+                  "matchValue": [
+                    "192.168.1.0/24",
+                    "10.0.0.0/24"
+                  ]
+                }
+              ],
+              "action": "Block"
+            }
+          ]
+        },
+        "customRules": {
+          "rules": [
+            {
+              "name": "CustomRule1",
+              "priority": 2,
+              "enabledState": "Enabled",
+              "matchConditions": [
+                {
+                  "matchVariable": "RemoteAddr",
+                  "selector": null,
+                  "operator": "GeoMatch",
+                  "negateCondition": false,
+                  "transforms": [],
+                  "matchValue": [
+                    "CH"
+                  ]
+                },
+                {
+                  "matchVariable": "RequestHeader",
+                  "selector": "UserAgent",
+                  "operator": "Contains",
+                  "negateCondition": false,
+                  "transforms": [],
+                  "matchValue": [
+                    "windows"
+                  ]
+                },
+                {
+                  "matchVariable": "QueryString",
+                  "selector": "search",
+                  "operator": "Contains",
+                  "negateCondition": false,
+                  "transforms": [
+                    "UrlDecode",
+                    "Lowercase"
+                  ],
+                  "matchValue": [
+                    "<?php",
+                    "?>"
+                  ]
+                }
+              ],
+              "action": "Block"
+            }
+          ]
+        },
+        "managedRules": {
+          "managedRuleSets": [
+            {
+              "ruleSetType": "DefaultRuleSet",
+              "ruleSetVersion": "preview-1.0",
+              "ruleGroupOverrides": [
+                {
+                  "ruleGroupName": "Group1",
+                  "rules": [
+                    {
+                      "ruleId": "GROUP1-0001",
+                      "enabledState": "Enabled",
+                      "action": "Redirect"
+                    },
+                    {
+                      "ruleId": "GROUP1-0002",
+                      "enabledState": "Disabled"
+                    }
+                  ]
+                }
+              ]
+            }
+          ]
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "MicrosoftCdnWafPolicy",
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/MicrosoftCdnWafPolicy",
+        "type": "Microsoft.Cdn/cdnwebapplicationfirewallpolicies",
+        "tags": {
+          "key1": "value1",
+          "key2": "value2"
+        },
+        "location": "WestUs",
+        "sku": {
+          "name": "Standard_Microsoft"
+        },
+        "properties": {
+          "resourceState": "Enabled",
+          "provisioningState": "Succeeded",
+          "policySettings": {
+            "enabledState": "Enabled",
+            "mode": "Prevention",
+            "defaultRedirectUrl": "http://www.bing.com",
+            "defaultCustomBlockResponseStatusCode": 200,
+            "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
+          },
+          "rateLimitRules": {
+            "rules": [
+              {
+                "name": "RateLimitRule1",
+                "priority": 1,
+                "enabledState": "Enabled",
+                "rateLimitDurationInMinutes": 0,
+                "rateLimitThreshold": 1000,
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "IPMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "192.168.1.0/24",
+                      "10.0.0.0/24"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "customRules": {
+            "rules": [
+              {
+                "name": "CustomRule1",
+                "priority": 2,
+                "enabledState": "Enabled",
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "GeoMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "CH"
+                    ]
+                  },
+                  {
+                    "matchVariable": "RequestHeader",
+                    "selector": "UserAgent",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "windows"
+                    ]
+                  },
+                  {
+                    "matchVariable": "QueryString",
+                    "selector": "search",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [
+                      "UrlDecode",
+                      "Lowercase"
+                    ],
+                    "matchValue": [
+                      "<?php",
+                      "?>"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "managedRules": {
+            "managedRuleSets": [
+              {
+                "ruleSetType": "DefaultRuleSet",
+                "ruleSetVersion": "preview-1.0",
+                "ruleGroupOverrides": [
+                  {
+                    "ruleGroupName": "Group1",
+                    "rules": [
+                      {
+                        "ruleId": "GROUP1-0001",
+                        "enabledState": "Enabled",
+                        "action": "Redirect"
+                      },
+                      {
+                        "ruleId": "GROUP1-0002",
+                        "enabledState": "Disabled"
+                      }
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
+          "endpointLinks": [
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint1"
+            },
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint2"
+            }
+          ]
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "name": "MicrosoftCdnWafPolicy",
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/MicrosoftCdnWafPolicy",
+        "type": "Microsoft.Cdn/cdnwebapplicationfirewallpolicies",
+        "tags": {
+          "key1": "value1",
+          "key2": "value2"
+        },
+        "location": "WestUs",
+        "sku": {
+          "name": "Standard_Microsoft"
+        },
+        "properties": {
+          "resourceState": "Enabled",
+          "provisioningState": "Succeeded",
+          "policySettings": {
+            "enabledState": "Enabled",
+            "mode": "Prevention",
+            "defaultRedirectUrl": "http://www.bing.com",
+            "defaultCustomBlockResponseStatusCode": 200,
+            "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
+          },
+          "rateLimitRules": {
+            "rules": [
+              {
+                "name": "RateLimitRule1",
+                "priority": 1,
+                "enabledState": "Enabled",
+                "rateLimitDurationInMinutes": 0,
+                "rateLimitThreshold": 1000,
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "IPMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "192.168.1.0/24",
+                      "10.0.0.0/24"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "customRules": {
+            "rules": [
+              {
+                "name": "CustomRule1",
+                "priority": 2,
+                "enabledState": "Enabled",
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "GeoMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "CH"
+                    ]
+                  },
+                  {
+                    "matchVariable": "RequestHeader",
+                    "selector": "UserAgent",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "windows"
+                    ]
+                  },
+                  {
+                    "matchVariable": "QueryString",
+                    "selector": "search",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [
+                      "UrlDecode",
+                      "Lowercase"
+                    ],
+                    "matchValue": [
+                      "<?php",
+                      "?>"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "managedRules": {
+            "managedRuleSets": [
+              {
+                "ruleSetType": "DefaultRuleSet",
+                "ruleSetVersion": "preview-1.0",
+                "ruleGroupOverrides": [
+                  {
+                    "ruleGroupName": "Group1",
+                    "rules": [
+                      {
+                        "ruleId": "GROUP1-0001",
+                        "enabledState": "Enabled",
+                        "action": "Redirect"
+                      },
+                      {
+                        "ruleId": "GROUP1-0002",
+                        "enabledState": "Disabled"
+                      }
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
+          "endpointLinks": [
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint1"
+            },
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint2"
+            }
+          ]
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "name": "MicrosoftCdnWafPolicy",
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/MicrosoftCdnWafPolicy",
+        "type": "Microsoft.Cdn/cdnwebapplicationfirewallpolicies",
+        "tags": {
+          "key1": "value1",
+          "key2": "value2"
+        },
+        "location": "WestUs",
+        "sku": {
+          "name": "Standard_Microsoft"
+        },
+        "properties": {
+          "resourceState": "Creating",
+          "provisioningState": "Succeeded",
+          "policySettings": {
+            "enabledState": "Enabled",
+            "mode": "Prevention",
+            "defaultRedirectUrl": "http://www.bing.com",
+            "defaultCustomBlockResponseStatusCode": 200,
+            "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
+          },
+          "rateLimitRules": {
+            "rules": [
+              {
+                "name": "RateLimitRule1",
+                "priority": 1,
+                "enabledState": "Enabled",
+                "rateLimitDurationInMinutes": 0,
+                "rateLimitThreshold": 1000,
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "IPMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "192.168.1.0/24",
+                      "10.0.0.0/24"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "customRules": {
+            "rules": [
+              {
+                "name": "CustomRule1",
+                "priority": 3,
+                "enabledState": "Enabled",
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "GeoMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "CH"
+                    ]
+                  },
+                  {
+                    "matchVariable": "RequestHeader",
+                    "selector": "UserAgent",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "windows"
+                    ]
+                  },
+                  {
+                    "matchVariable": "QueryString",
+                    "selector": "search",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [
+                      "UrlDecode",
+                      "Lowercase"
+                    ],
+                    "matchValue": [
+                      "<?php",
+                      "?>"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "managedRules": {
+            "managedRuleSets": [
+              {
+                "ruleSetType": "DefaultRuleSet",
+                "ruleSetVersion": "preview-1.0",
+                "ruleGroupOverrides": [
+                  {
+                    "ruleGroupName": "Group1",
+                    "rules": [
+                      {
+                        "ruleId": "GROUP1-0001",
+                        "enabledState": "Enabled",
+                        "action": "Redirect"
+                      },
+                      {
+                        "ruleId": "GROUP1-0002",
+                        "enabledState": "Disabled"
+                      }
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
+          "endpointLinks": [
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint1"
+            },
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint2"
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/WafPolicyDelete.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/WafPolicyDelete.json
new file mode 100644
index 000000000000..7de315080401
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/WafPolicyDelete.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rg1",
+    "policyName": "Policy1"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/WafPolicyGet.json b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/WafPolicyGet.json
new file mode 100644
index 000000000000..cec9f3b447a3
--- /dev/null
+++ b/specification/cdn/resource-manager/Microsoft.Cdn/stable/2020-03-31/examples/WafPolicyGet.json
@@ -0,0 +1,139 @@
+{
+  "parameters": {
+    "api-version": "2020-03-31",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rg1",
+    "policyName": "MicrosoftCdnWafPolicy"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "MicrosoftCdnWafPolicy",
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/CdnWebApplicationFirewallPolicies/MicrosoftCdnWafPolicy",
+        "type": "Microsoft.Cdn/cdnwebapplicationfirewallpolicies",
+        "tags": {
+          "key1": "value1",
+          "key2": "value2"
+        },
+        "location": "WestUs",
+        "sku": {
+          "name": "Standard_Microsoft"
+        },
+        "properties": {
+          "resourceState": "Enabled",
+          "provisioningState": "Succeeded",
+          "policySettings": {
+            "enabledState": "Enabled",
+            "mode": "Prevention",
+            "defaultRedirectUrl": "http://www.bing.com",
+            "defaultCustomBlockResponseStatusCode": 429,
+            "defaultCustomBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
+          },
+          "rateLimitRules": {
+            "rules": [
+              {
+                "name": "RateLimitRule1",
+                "priority": 1,
+                "enabledState": "Enabled",
+                "rateLimitDurationInMinutes": 0,
+                "rateLimitThreshold": 1000,
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "IPMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "192.168.1.0/24",
+                      "10.0.0.0/24"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "customRules": {
+            "rules": [
+              {
+                "name": "CustomRule1",
+                "priority": 2,
+                "enabledState": "Enabled",
+                "matchConditions": [
+                  {
+                    "matchVariable": "RemoteAddr",
+                    "selector": null,
+                    "operator": "GeoMatch",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "CH"
+                    ]
+                  },
+                  {
+                    "matchVariable": "RequestHeader",
+                    "selector": "UserAgent",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [],
+                    "matchValue": [
+                      "windows"
+                    ]
+                  },
+                  {
+                    "matchVariable": "QueryString",
+                    "selector": "search",
+                    "operator": "Contains",
+                    "negateCondition": false,
+                    "transforms": [
+                      "UrlDecode",
+                      "Lowercase"
+                    ],
+                    "matchValue": [
+                      "<?php",
+                      "?>"
+                    ]
+                  }
+                ],
+                "action": "Block"
+              }
+            ]
+          },
+          "managedRules": {
+            "managedRuleSets": [
+              {
+                "ruleSetType": "DefaultRuleSet",
+                "ruleSetVersion": "preview-1.0",
+                "ruleGroupOverrides": [
+                  {
+                    "ruleGroupName": "Group1",
+                    "rules": [
+                      {
+                        "ruleId": "GROUP1-0001",
+                        "enabledState": "Enabled",
+                        "action": "Redirect"
+                      },
+                      {
+                        "ruleId": "GROUP1-0002",
+                        "enabledState": "Disabled"
+                      }
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
+          "endpointLinks": [
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint1"
+            },
+            {
+              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cdn/profiles/profile1/endpoints/testEndpoint2"
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cdn/resource-manager/readme.md b/specification/cdn/resource-manager/readme.md
index ac6e2f874a2f..6e48071bcdf2 100644
--- a/specification/cdn/resource-manager/readme.md
+++ b/specification/cdn/resource-manager/readme.md
@@ -28,7 +28,7 @@ These are the global settings for the Cdn API.
 title: CdnManagementClient
 description: Cdn Management Client
 openapi-type: arm
-tag: package-2019-04
+tag: package-2019-06
 ```
 
 ### Tag: package-2019-12
@@ -46,6 +46,16 @@ These settings apply only when `--tag=package-2019-06` is specified on the comma
 
 ``` yaml $(tag) == 'package-2019-06'
 input-file:
+- Microsoft.Cdn/stable/2019-06-15/cdn.json
+- Microsoft.Cdn/stable/2019-06-15/cdnwebapplicationfirewall.json
+```
+
+### Tag: package-2019-06-preview
+
+These settings apply only when `--tag=package-2019-06-preview` is specified on the command line.
+
+``` yaml $(tag) == 'package-2019-06-preview'
+input-file:
 - Microsoft.Cdn/preview/2019-06-15-preview/cdn.json
 - Microsoft.Cdn/preview/2019-06-15-preview/cdnwebapplicationfirewall.json
 directive:
@@ -168,6 +178,8 @@ require: $(this-folder)/../../../profiles/readme.md
 # all the input files across all versions
 input-file:
   - $(this-folder)/Microsoft.Cdn/stable/2019-12-31/cdn.json
+  - $(this-folder)/Microsoft.Cdn/stable/2019-06-15/cdn.json
+  - $(this-folder)/Microsoft.Cdn/stable/2019-06-15/cdnwebapplicationfirewall.json
   - $(this-folder)/Microsoft.Cdn/preview/2019-06-15-preview/cdn.json
   - $(this-folder)/Microsoft.Cdn/preview/2019-06-15-preview/cdnwebapplicationfirewall.json
   - $(this-folder)/Microsoft.Cdn/stable/2019-04-15/cdn.json
diff --git a/specification/cdn/resource-manager/readme.ruby.md b/specification/cdn/resource-manager/readme.ruby.md
index e120956e650c..7d3f03852d62 100644
--- a/specification/cdn/resource-manager/readme.ruby.md
+++ b/specification/cdn/resource-manager/readme.ruby.md
@@ -4,7 +4,7 @@ These settings apply only when `--ruby` is specified on the command line.
 
 ``` yaml
 package-name: azure_mgmt_cdn
-package-version: "0.16.0"
+package-version: "0.17.0"
 azure-arm: true
 ```
 
@@ -12,6 +12,8 @@ azure-arm: true
 
 ``` yaml $(ruby) && $(multiapi)
 batch:
+  - tag: package-2019-06
+  - tag: package-2019-04
   - tag: package-2017-10
   - tag: package-2017-04
   - tag: package-2016-10
@@ -19,6 +21,26 @@ batch:
   - tag: package-2015-06
 ```
 
+### Tag: package-2019-06 and ruby
+
+These settings apply only when `--tag=package-2019-06 --ruby` is specified on the command line.
+Please also specify `--ruby-sdks-folder=<path to the root directory of your azure-sdk-for-ruby clone>`.
+
+``` yaml $(tag) == 'package-2019-06' && $(ruby)
+namespace: "Azure::CDN::Mgmt::V2019_06_15"
+output-folder: $(ruby-sdks-folder)/management/azure_mgmt_cdn/lib
+```
+
+### Tag: package-2019-04 and ruby
+
+These settings apply only when `--tag=package-2019-04 --ruby` is specified on the command line.
+Please also specify `--ruby-sdks-folder=<path to the root directory of your azure-sdk-for-ruby clone>`.
+
+``` yaml $(tag) == 'package-2019-04' && $(ruby)
+namespace: "Azure::CDN::Mgmt::V2019_04_15"
+output-folder: $(ruby-sdks-folder)/management/azure_mgmt_cdn/lib
+```
+
 ### Tag: package-2017-10 and ruby
 
 These settings apply only when `--tag=package-2017-10 --ruby` is specified on the command line.
diff --git a/specification/cognitiveservices/data-plane/FormRecognizer/preview/v2.0/FormRecognizer.json b/specification/cognitiveservices/data-plane/FormRecognizer/preview/v2.0/FormRecognizer.json
index 44eaef160894..2db307f4d4b9 100644
--- a/specification/cognitiveservices/data-plane/FormRecognizer/preview/v2.0/FormRecognizer.json
+++ b/specification/cognitiveservices/data-plane/FormRecognizer/preview/v2.0/FormRecognizer.json
@@ -261,7 +261,8 @@
           "Analyze form with custom model": {
             "$ref": "./examples/AnalyzeBatch.json"
           }
-        }
+        },
+        "x-ms-long-running-operation": true
       }
     },
     "/custom/models/{modelId}/analyzeResults/{resultId}": {
@@ -362,7 +363,8 @@
           "Analyze receipt": {
             "$ref": "./examples/ReceiptsBatch.json"
           }
-        }
+        },
+        "x-ms-long-running-operation": true
       }
     },
     "/prebuilt/receipt/analyzeResults/{resultId}": {
@@ -446,7 +448,8 @@
           "Analyze layout": {
             "$ref": "./examples/LayoutBatch.json"
           }
-        }
+        },
+        "x-ms-long-running-operation": true
       }
     },
     "/layout/analyzeResults/{resultId}": {
diff --git a/specification/compute/resource-manager/Microsoft.Compute/stable/2019-07-01/compute.json b/specification/compute/resource-manager/Microsoft.Compute/stable/2019-07-01/compute.json
index 84387c9e29f6..658fcc12c0c0 100644
--- a/specification/compute/resource-manager/Microsoft.Compute/stable/2019-07-01/compute.json
+++ b/specification/compute/resource-manager/Microsoft.Compute/stable/2019-07-01/compute.json
@@ -7486,7 +7486,7 @@
         },
         "customData": {
           "type": "string",
-          "description": "Specifies a base-64 encoded string of custom data. The base-64 encoded string is decoded to a binary array that is saved as a file on the Virtual Machine. The maximum length of the binary array is 65535 bytes. <br><br> **Note: Do not pass any secrets or passwords in customData property** <br><br> This property cannot be updated after the VM is created. <br><br> customData is passed to the VM to be saved as a file, for more information see [Custom Data on Azure VMs](https://azure.microsoft.com/en-us/blog/custom-data-and-cloud-init-on-windows-azure/) <br><br> For using cloud-init for your Linux VM, see [Using cloud-init to customize a Linux VM during creation](https://docs.microsoft.com/azure/virtual-machines/virtual-machines-linux-using-cloud-init?toc=%2fazure%2fvirtual-machines%2flinux%2ftoc.json)"
+          "description": "Specifies a base-64 encoded string of custom data. The base-64 encoded string is decoded to a binary array that is saved as a file on the Virtual Machine. The maximum length of the binary array is 65535 bytes. <br><br> **Note: Do not pass any secrets or passwords in customData property** <br><br> This property cannot be updated after the VM is created. <br><br> customData is passed to the VM to be saved as a file, for more information see [Custom Data on Azure VMs](https://docs.microsoft.com/azure/virtual-machines/custom-data) <br><br> For using cloud-init for your Linux VM, see [Using cloud-init to customize a Linux VM during creation](https://docs.microsoft.com/azure/virtual-machines/virtual-machines-linux-using-cloud-init?toc=%2fazure%2fvirtual-machines%2flinux%2ftoc.json)"
         },
         "windowsConfiguration": {
           "$ref": "#/definitions/WindowsConfiguration",
diff --git a/specification/consumption/resource-manager/Microsoft.Consumption/stable/2019-06-01/consumption.json b/specification/consumption/resource-manager/Microsoft.Consumption/stable/2019-06-01/consumption.json
index 78c4194a23fe..8126edf921b9 100644
--- a/specification/consumption/resource-manager/Microsoft.Consumption/stable/2019-06-01/consumption.json
+++ b/specification/consumption/resource-manager/Microsoft.Consumption/stable/2019-06-01/consumption.json
@@ -104,7 +104,7 @@
           },
           {
             "name": "$filter",
-            "description": "May be used to filter usageDetails by properties/resourceGroup, properties/resourceName, properties/resourceId, properties/chargeType, properties/reservationId, properties/publisherType or tags. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value is separated by a colon (:). PublisherType Filter accepts two values azure and marketplace and it is currently supported for Web Direct Offer Type",
+            "description": "May be used to filter usageDetails by properties/resourceGroup, properties/resourceName, properties/instanceId, properties/chargeType, properties/reservationId, properties/publisherType or tags. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value is separated by a colon (:). PublisherType Filter accepts two values azure and marketplace and it is currently supported for Web Direct Offer Type",
             "in": "query",
             "required": false,
             "type": "string"
diff --git a/specification/containerregistry/resource-manager/Microsoft.ContainerRegistry/preview/2019-06-01-preview/containerregistry_build.json b/specification/containerregistry/resource-manager/Microsoft.ContainerRegistry/preview/2019-06-01-preview/containerregistry_build.json
index 7d459ea58817..a4689a1792a2 100644
--- a/specification/containerregistry/resource-manager/Microsoft.ContainerRegistry/preview/2019-06-01-preview/containerregistry_build.json
+++ b/specification/containerregistry/resource-manager/Microsoft.ContainerRegistry/preview/2019-06-01-preview/containerregistry_build.json
@@ -50,7 +50,7 @@
           "default": {
             "description": "Error response describing why the operation failed. If the registry/agentpool doesn't exist, 404 (Not found) is returned.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -108,7 +108,7 @@
           "default": {
             "description": "Error response describing why the operation failed. If the registry doesn't exist, 404 (Not found) is returned. If any of the input parameters is wrong, 400(Bad Request) is returned.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -155,7 +155,7 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -214,7 +214,7 @@
           "default": {
             "description": "Error response describing why the operation failed. If the registry doesn't exist, 404 (Not found) is returned. If any of the input parameters is wrong, 400(Bad Request) is returned.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -257,7 +257,7 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -305,7 +305,7 @@
           "default": {
             "description": "Error response describing why the operation failed. If the registry/agentpool doesn't exist, 404 (Not found) is returned.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -359,7 +359,7 @@
           "default": {
             "description": "Error response describing why the operation failed. If the registry/run doesn't exist, 404 (Not found) is returned. If any of the input parameters is wrong, 400(Bad Request) is returned.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -417,7 +417,7 @@
           "default": {
             "description": "Error response describing why the operation failed. If the registry doesn't exist, 404 (Not found) is returned.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -474,7 +474,7 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -527,7 +527,7 @@
           "default": {
             "description": "Error response describing why the operation failed. If the registry/run doesn't exist, 404 (Not found) is returned.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -589,7 +589,7 @@
           "default": {
             "description": "Error response describing why the operation failed. If the registry/build doesn't exist, 404 (Not found) is returned. If any of the input parameters is wrong, 400(Bad Request) is returned.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -639,7 +639,7 @@
           "default": {
             "description": "Error response describing why the operation failed. If the registry/run doesn't exist, 404 (Not found) is returned.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -688,7 +688,7 @@
           "default": {
             "description": "Error response describing why the operation failed. If the registry/run doesn't exist, 404 (Not found) is returned.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -738,7 +738,7 @@
           "default": {
             "description": "Error response describing why the operation failed. If the registry/run doesn't exist, 404 (Not found) is returned.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -800,7 +800,7 @@
           "default": {
             "description": "Error response describing why the operation failed. If the registry doesn't exist, 404 (Not found) is returned. If any of the input parameters is wrong, 400(Bad Request) is returned.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -851,7 +851,7 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -914,7 +914,7 @@
           "default": {
             "description": "Error response describing why the operation failed. If the registry doesn't exist, 404 (Not found) is returned. If any of the input parameters is wrong, 400(Bad Request) is returned.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -964,7 +964,7 @@
           "default": {
             "description": "Error response describing why the operation failed. If the registry/run doesn't exist, 404 (Not found) is returned.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -1006,7 +1006,7 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -1051,7 +1051,7 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -1099,7 +1099,7 @@
           "default": {
             "description": "Error response describing why the operation failed. If the registry doesn't exist, 404 (Not found) is returned.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -1157,7 +1157,7 @@
           "default": {
             "description": "Error response describing why the operation failed. If the registry doesn't exist, 404 (Not found) is returned. If any of the input parameters is wrong, 400(Bad Request) is returned.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -1213,7 +1213,7 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -1272,7 +1272,7 @@
           "default": {
             "description": "Error response describing why the operation failed. If the registry doesn't exist, 404 (Not found) is returned. If any of the input parameters is wrong, 400(Bad Request) is returned.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -1327,7 +1327,7 @@
           "default": {
             "description": "Error response describing why the operation failed. If the registry doesn't exist, 404 (Not found) is returned.",
             "schema": {
-              "$ref": "#/definitions/ErrorSchema"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -2980,7 +2980,7 @@
       },
       "x-ms-azure-resource": true
     },
-    "Error": {
+    "ErrorResponseBody": {
       "description": "An error response from the Azure Container Registry service.",
       "required": [
         "code",
@@ -2997,11 +2997,11 @@
         }
       }
     },
-    "ErrorSchema": {
+    "ErrorResponse": {
       "description": "An error response from the Azure Container Registry service.",
       "properties": {
         "error": {
-          "$ref": "#/definitions/Error",
+          "$ref": "#/definitions/ErrorResponseBody",
           "description": "Azure container registry build API error body."
         }
       }
diff --git a/specification/containerregistry/resource-manager/Microsoft.ContainerRegistry/preview/2019-12-01-preview/containerregistry.json b/specification/containerregistry/resource-manager/Microsoft.ContainerRegistry/preview/2019-12-01-preview/containerregistry.json
index fee5e737d941..f880a5744ac7 100644
--- a/specification/containerregistry/resource-manager/Microsoft.ContainerRegistry/preview/2019-12-01-preview/containerregistry.json
+++ b/specification/containerregistry/resource-manager/Microsoft.ContainerRegistry/preview/2019-12-01-preview/containerregistry.json
@@ -1520,20 +1520,12 @@
     "PrivateEndpointConnection": {
       "description": "An object that represents a private endpoint connection for a container registry.",
       "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ProxyResource"
+        }
+      ],
       "properties": {
-        "type": {
-          "description": "The resource type is private endpoint connection.",
-          "type": "string",
-          "readOnly": true
-        },
-        "id": {
-          "description": "The resource ID.",
-          "type": "string"
-        },
-        "name": {
-          "description": "The name of the resource.",
-          "type": "string"
-        },
         "properties": {
           "$ref": "#/definitions/PrivateEndpointConnectionProperties",
           "description": "The properties of a private endpoint connection.",
@@ -1596,7 +1588,7 @@
           ],
           "type": "string",
           "x-ms-enum": {
-            "name": "Status",
+            "name": "ConnectionStatus",
             "modelAsString": true
           }
         },
@@ -2897,6 +2889,27 @@
         }
       }
     },
+    "ProxyResource": {
+      "description": "The resource model definition for a ARM proxy resource. It will have everything other than required location and tags.",
+      "properties": {
+        "id": {
+          "description": "The resource ID.",
+          "type": "string",
+          "readOnly": true
+        },
+        "name": {
+          "description": "The name of the resource.",
+          "type": "string",
+          "readOnly": true
+        },
+        "type": {
+          "description": "The type of the resource.",
+          "type": "string",
+          "readOnly": true
+        }
+      },
+      "x-ms-azure-resource": true
+    },
     "Resource": {
       "description": "An Azure resource.",
       "required": [
diff --git a/specification/containerregistry/resource-manager/readme.java.md b/specification/containerregistry/resource-manager/readme.java.md
index 87034cad98c9..7e591a145f73 100644
--- a/specification/containerregistry/resource-manager/readme.java.md
+++ b/specification/containerregistry/resource-manager/readme.java.md
@@ -12,6 +12,15 @@ payload-flattening-threshold: 1
 output-folder: $(azure-libraries-for-java-folder)/azure-mgmt-containerregistry
 ```
 
+These settings apply only when `--multiapi` is not specified on the command line.
+
+``` yaml $(java) && !$(multiapi)
+directive:
+  - rename-model:
+      from: DockerBuildStep
+      to: DockerTaskStep
+```
+
 ### Java multi-api
 
 ``` yaml $(java) && $(multiapi)
diff --git a/specification/containerregistry/resource-manager/readme.md b/specification/containerregistry/resource-manager/readme.md
index d4d66a50652f..dc042e35dca0 100644
--- a/specification/containerregistry/resource-manager/readme.md
+++ b/specification/containerregistry/resource-manager/readme.md
@@ -26,7 +26,7 @@ These are the global settings for the ContainerRegistry API.
 
 ``` yaml
 openapi-type: arm
-tag: package-2019-06-preview
+tag: package-2019-12-preview
 ```
 
 
diff --git a/specification/containerregistry/resource-manager/readme.typescript.md b/specification/containerregistry/resource-manager/readme.typescript.md
index 8fc2768ada95..db34cc240a6d 100644
--- a/specification/containerregistry/resource-manager/readme.typescript.md
+++ b/specification/containerregistry/resource-manager/readme.typescript.md
@@ -5,7 +5,7 @@ Please also specify `--typescript-sdks-folder=<path to root folder of your azure
 
 ``` yaml $(typescript)
 input-file:
-  - Microsoft.ContainerRegistry/stable/2019-05-01/containerregistry.json
+  - Microsoft.ContainerRegistry/preview/2019-12-01-preview/containerregistry.json
   - Microsoft.ContainerRegistry/preview/2019-06-01-preview/containerregistry_build.json
   - Microsoft.ContainerRegistry/preview/2019-05-01-preview/containerregistry_scopemap.json
 typescript:
diff --git a/specification/cost-management/resource-manager/Microsoft.CostManagement/preview/2019-03-01-preview/costmanagement.json b/specification/cost-management/resource-manager/Microsoft.CostManagement/preview/2019-03-01-preview/costmanagement.json
index 699141844f71..2193dca44ff3 100644
--- a/specification/cost-management/resource-manager/Microsoft.CostManagement/preview/2019-03-01-preview/costmanagement.json
+++ b/specification/cost-management/resource-manager/Microsoft.CostManagement/preview/2019-03-01-preview/costmanagement.json
@@ -1417,6 +1417,51 @@
         }
       }
     },
+    "/providers/Microsoft.CostManagement/checkConnectorEligibility": {
+      "post": {
+        "tags": [
+          "CheckConnectorEligibility"
+        ],
+        "operationId": "Connector_CheckEligibility",
+        "description": "Check if a connector already exists and return it's definition",
+        "externalDocs": {
+          "url": "https://docs.microsoft.com/en-us/rest/api/costmanagement/"
+        },
+        "x-ms-examples": {
+          "CheckEligibility_Post": {
+            "$ref": "./examples/CheckEligibilityPost.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          },
+          {
+            "name": "connectorCredentials",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/CheckEligibilityDefinition"
+            },
+            "description": "Connector credentials"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/ConnectorDefinition"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
     "/providers/Microsoft.CostManagement/externalBillingAccounts": {
       "get": {
         "tags": [
@@ -2618,6 +2663,42 @@
         }
       }
     },
+    "CheckEligibilityDefinition": {
+      "type": "object",
+      "description": "The check eligibility Connector credentials definition",
+      "properties": {
+        "kind": {
+          "type": "string",
+          "description": "Connector kind (eg aws)"
+        },
+        "credentialsKey": {
+          "type": "string",
+          "x-ms-mutability": [
+            "read",
+            "create",
+            "update"
+          ],
+          "description": "Credentials authentication key (eg AWS ARN)"
+        },
+        "credentialsSecret": {
+          "type": "string",
+          "x-ms-mutability": [
+            "create",
+            "update"
+          ],
+          "description": "Credentials secret (eg AWS ExternalId)"
+        },
+        "reportId": {
+          "type": "string",
+          "x-ms-mutability": [
+            "read",
+            "create",
+            "update"
+          ],
+          "description": "Identifying source report. (For AWS this is a CUR report name, defined with Daily and with Resources)"
+        }
+      }
+    },
     "ExternalBillingAccountDefinitionListResult": {
       "description": "Result of listing ExternalBillingAccount definitions. It contains a list of available ExternalBillingAccount definitions in the scope provided.",
       "properties": {
diff --git a/specification/cost-management/resource-manager/Microsoft.CostManagement/preview/2019-03-01-preview/examples/CheckEligibilityPost.json b/specification/cost-management/resource-manager/Microsoft.CostManagement/preview/2019-03-01-preview/examples/CheckEligibilityPost.json
new file mode 100644
index 000000000000..fabd1d2eddcf
--- /dev/null
+++ b/specification/cost-management/resource-manager/Microsoft.CostManagement/preview/2019-03-01-preview/examples/CheckEligibilityPost.json
@@ -0,0 +1,35 @@
+{
+  "parameters": {
+    "api-version": "2019-03-01-preview",
+    "connectorCredentials": {
+      "kind": "aws",
+      "credentialsKey": "arn:aws:iam::123456789012:role/AzureCostManagementRole",
+      "credentialsSecret": "external-id",
+      "reportId": "HourlyWithResources"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "kind": "aws",
+        "id": "/providers/Microsoft.CostManagement/cloudConnectors/aws-123456789012",
+        "name": "aws-123456789012",
+        "type": "Microsoft.CostManagement/cloudConnectors",
+        "properties": {
+          "displayName": "AWS-Consolidated-1",
+          "providerBillingAccountId": "123456789012",
+          "credentialsKey": "arn:aws:iam::123456789012:role/AzureCostManagementRole",
+          "reportId": "HourlyWithResources",
+          "createdOn": "2018-05-15T13:25:48Z",
+          "modifiedOn": "2018-05-23T09:21:11Z",
+          "status": "active",
+          "externalBillingAccountId": "/providers/Microsoft.CostManagement/externalBillingAccounts/aws-123456789012",
+          "defaultManagementGroupId": "/providers/Microsoft.Management/managementGroups/XYZ",
+          "subscriptionId": "22222222-3333-4444-1111-777777777777",
+          "billingModel": "autoUpgrade",
+          "daysTrialRemaining": 62
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cost-management/resource-manager/Microsoft.CostManagement/preview/2019-03-01-preview/examples/ShowbackRulePut.json b/specification/cost-management/resource-manager/Microsoft.CostManagement/preview/2019-03-01-preview/examples/ShowbackRulePut.json
index 010f490e8cea..b5cb7c3b4555 100644
--- a/specification/cost-management/resource-manager/Microsoft.CostManagement/preview/2019-03-01-preview/examples/ShowbackRulePut.json
+++ b/specification/cost-management/resource-manager/Microsoft.CostManagement/preview/2019-03-01-preview/examples/ShowbackRulePut.json
@@ -4,7 +4,6 @@
     "billingAccountId": "100",
     "ruleName": "testRule",
     "showbackRule": {
-      "name": "demo",
       "properties": {
         "description": "Welcome to Showback demo",
         "status": "Active",
diff --git a/specification/cost-management/resource-manager/readme.md b/specification/cost-management/resource-manager/readme.md
index 4f67bba4f0e2..205a74666b50 100644
--- a/specification/cost-management/resource-manager/readme.md
+++ b/specification/cost-management/resource-manager/readme.md
@@ -262,6 +262,7 @@ batch:
   - tag: package-2018-08-preview
   - tag: package-2019-01
   - tag: package-2019-09
+  - tag: package-2019-11
 ```
 
 ### Tag: package-2018-05 and java
@@ -329,6 +330,19 @@ regenerate-manager: true
 generate-interface: true
 ```
 
+### Tag: package-2019-11 and java
+
+These settings apply only when `--tag=package-2019-11 --java` is specified on the command line.
+Please also specify `--azure-libraries-for-java=<path to the root directory of your azure-sdk-for-java clone>`.
+
+``` yaml $(tag) == 'package-2019-11' && $(java) && $(multiapi)
+java:
+  namespace: com.microsoft.azure.management.costmanagement.v2019_11_01
+  output-folder: $(azure-libraries-for-java-folder)/sdk/costmanagement/mgmt-v2019_11_01
+regenerate-manager: true
+generate-interface: true
+```
+
 ## Multi-API/Profile support for AutoRest v3 generators
 
 AutoRest V3 generators require the use of `--tag=all-api-versions` to select api files.
diff --git a/specification/customproviders/resource-manager/readme.md b/specification/customproviders/resource-manager/readme.md
index 43b3beaac239..e2a284ceebef 100644
--- a/specification/customproviders/resource-manager/readme.md
+++ b/specification/customproviders/resource-manager/readme.md
@@ -85,6 +85,10 @@ See configuration in [readme.csharp.md](./readme.csharp.md)
 
 See configuration in [readme.nodejs.md](./readme.nodejs.md)
 
+## Trenton
+
+See configuration in [readme.trenton.md](./readme.trenton.md)
+
 ## Multi-API/Profile support for AutoRest v3 generators 
 
 AutoRest V3 generators require the use of `--tag=all-api-versions` to select api files.
diff --git a/specification/customproviders/resource-manager/readme.trenton.md b/specification/customproviders/resource-manager/readme.trenton.md
new file mode 100644
index 000000000000..9e3698eb29ab
--- /dev/null
+++ b/specification/customproviders/resource-manager/readme.trenton.md
@@ -0,0 +1,19 @@
+## Trenton
+
+These settings apply only when `--trenton` is specified on the command line.
+
+``` yaml $(trenton)
+trenton:
+  cli_name: customproviders
+  azure_arm: true
+  license_header: MICROSOFT_MIT_NO_VERSION
+  payload_flattening_threshold: 2
+  namespace: azure.mgmt.customproviders
+  package_name: azure-mgmt-customproviders
+  clear_output_folder: false
+overrides:
+  - where:
+      property: resourceProviderName
+    set:
+    - IdPortion: "resourceproviders"
+```
diff --git a/specification/datafactory/resource-manager/Microsoft.DataFactory/stable/2018-06-01/entityTypes/Dataset.json b/specification/datafactory/resource-manager/Microsoft.DataFactory/stable/2018-06-01/entityTypes/Dataset.json
index 8a4bb5225c35..8e1e0fcb1665 100644
--- a/specification/datafactory/resource-manager/Microsoft.DataFactory/stable/2018-06-01/entityTypes/Dataset.json
+++ b/specification/datafactory/resource-manager/Microsoft.DataFactory/stable/2018-06-01/entityTypes/Dataset.json
@@ -3103,6 +3103,32 @@
           "description": "The table name of the Snowflake database. Type: string (or Expression with resultType string)."
         }
       }
+    },
+    "SharePointOnlineListResourceDataset": {
+      "x-ms-discriminator-value": "SharePointOnlineListResource",
+      "description": "The sharepoint online list resource dataset.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/Dataset"
+        }
+      ],
+      "properties": {
+        "typeProperties": {
+          "description": "Sharepoint online list dataset properties.",
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/SharePointOnlineListDatasetTypeProperties"
+        }
+      }
+    },
+    "SharePointOnlineListDatasetTypeProperties": {
+      "description": "Sharepoint online list dataset properties.",
+      "properties": {
+        "listName": {
+          "type": "object",
+          "description": "The name of the SharePoint Online list. Type: string (or Expression with resultType string)."
+        }
+      }
     }
   }
 }
diff --git a/specification/datafactory/resource-manager/Microsoft.DataFactory/stable/2018-06-01/entityTypes/LinkedService.json b/specification/datafactory/resource-manager/Microsoft.DataFactory/stable/2018-06-01/entityTypes/LinkedService.json
index 993816e34b28..fb66ce6759a2 100644
--- a/specification/datafactory/resource-manager/Microsoft.DataFactory/stable/2018-06-01/entityTypes/LinkedService.json
+++ b/specification/datafactory/resource-manager/Microsoft.DataFactory/stable/2018-06-01/entityTypes/LinkedService.json
@@ -5729,6 +5729,57 @@
       "required": [
         "connectionString"
       ]
+    },
+    "SharePointOnlineListLinkedService": {
+      "x-ms-discriminator-value": "SharePointOnlineList",
+      "description": "SharePoint Online List linked service.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/LinkedService"
+        }
+      ],
+      "properties": {
+        "typeProperties": {
+          "description": "SharePoint Online List linked service properties.",
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/SharePointOnlineListLinkedServiceTypeProperties"
+        }
+      },
+      "required": [
+        "typeProperties"
+      ]
+    },
+    "SharePointOnlineListLinkedServiceTypeProperties": {
+      "description": "SharePoint Online List linked service properties.",
+      "properties": {
+        "siteUrl": {
+          "type": "object",
+          "description": "The URL of the SharePoint Online site. For example, https://contoso.sharepoint.com/sites/siteName. Type: string (or Expression with resultType string)."
+        },
+        "tenantId": {
+          "type": "object",
+          "description": "The tenant ID under which your application resides. You can find it from Azure portal Active Directory overview page. Type: string (or Expression with resultType string)."
+        },
+        "servicePrincipalId": {
+          "type": "object",
+          "description": "The application (client) ID of your application registered in Azure Active Directory. Make sure to grant SharePoint site permission to this application. Type: string (or Expression with resultType string)."
+        },
+        "servicePrincipalKey": {
+          "description": "The client secret of your application registered in Azure Active Directory. Type: string (or Expression with resultType string).",
+          "$ref": "../datafactory.json#/definitions/SecretBase"
+        },
+        "encryptedCredential": {
+          "type": "object",
+          "description": "The encrypted credential used for authentication. Credentials are encrypted using the integration runtime credential manager. Type: string (or Expression with resultType string)."
+        }
+      },
+      "required": [
+        "siteUrl",
+        "tenantId",
+        "servicePrincipalId",
+        "servicePrincipalKey"
+      ]
     }
   }
 }
diff --git a/specification/datafactory/resource-manager/Microsoft.DataFactory/stable/2018-06-01/entityTypes/Pipeline.json b/specification/datafactory/resource-manager/Microsoft.DataFactory/stable/2018-06-01/entityTypes/Pipeline.json
index ffe0dca60ba8..5e8e94b490bd 100644
--- a/specification/datafactory/resource-manager/Microsoft.DataFactory/stable/2018-06-01/entityTypes/Pipeline.json
+++ b/specification/datafactory/resource-manager/Microsoft.DataFactory/stable/2018-06-01/entityTypes/Pipeline.json
@@ -770,6 +770,38 @@
         "type"
       ]
     },
+    "CompressionReadSettings": {
+      "description": "Compression read settings.",
+      "discriminator": "type",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "description": "The Compression setting type."
+        }
+      },
+      "additionalProperties": {
+        "type": "object"
+      },
+      "required": [
+        "type"
+      ]
+    },
+    "ZipDeflateReadSettings": {
+      "description": "The ZipDeflate compression read settings.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/CompressionReadSettings"
+        }
+      ],
+      "properties": {
+        "preserveZipFileNameAsFolder": {
+          "description": "Preserve the zip file name as folder path. Type: boolean (or Expression with resultType boolean).",
+          "type": "object"
+        }
+      }
+    },
     "DelimitedTextReadSettings": {
       "description": "Delimited text read settings.",
       "type": "object",
@@ -782,6 +814,40 @@
         "skipLineCount": {
           "type": "object",
           "description": "Indicates the number of non-empty rows to skip when reading data from input files. Type: integer (or Expression with resultType integer)."
+        },
+        "compressionProperties": {
+          "$ref": "#/definitions/CompressionReadSettings",
+          "description": "Compression settings."
+        }
+      }
+    },
+    "JsonReadSettings": {
+      "description": "Json read settings.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/FormatReadSettings"
+        }
+      ],
+      "properties": {
+        "compressionProperties": {
+          "$ref": "#/definitions/CompressionReadSettings",
+          "description": "Compression settings."
+        }
+      }
+    },
+    "BinaryReadSettings": {
+      "description": "Binary read settings.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/FormatReadSettings"
+        }
+      ],
+      "properties": {
+        "compressionProperties": {
+          "$ref": "#/definitions/CompressionReadSettings",
+          "description": "Compression settings."
         }
       }
     },
@@ -949,6 +1015,10 @@
           "$ref": "#/definitions/StoreReadSettings",
           "description": "Json store settings."
         },
+        "formatSettings": {
+          "$ref": "#/definitions/JsonReadSettings",
+          "description": "Json format settings."
+        },
         "additionalColumns": {
           "type": "array",
           "description": "Specifies the additional columns to be added to source data. Type: array of objects (or Expression with resultType array of objects).",
@@ -1180,6 +1250,10 @@
         "storeSettings": {
           "$ref": "#/definitions/StoreReadSettings",
           "description": "Binary store settings."
+        },
+        "formatSettings": {
+          "$ref": "#/definitions/BinaryReadSettings",
+          "description": "Binary format settings."
         }
       }
     },
@@ -1535,6 +1609,10 @@
           "type": "object",
           "description": "OData query. For example, \"$top=1\". Type: string (or Expression with resultType string)."
         },
+        "httpRequestTimeout": {
+          "type": "object",
+          "description": "The timeout (TimeSpan) to get an HTTP response. It is the timeout to get a response, not the timeout to read response data. Default value: 00:05:00. Type: string (or Expression with resultType string), pattern: ((\\d+)\\.)?(\\d\\d):(60|([0-5][0-9])):(60|([0-5][0-9]))."
+        },
         "additionalColumns": {
           "type": "array",
           "description": "Specifies the additional columns to be added to source data. Type: array of objects (or Expression with resultType array of objects).",
@@ -1617,6 +1695,10 @@
         "query": {
           "type": "object",
           "description": "SAP Cloud for Customer OData query. For example, \"$top=1\". Type: string (or Expression with resultType string)."
+        },
+        "httpRequestTimeout": {
+          "type": "object",
+          "description": "The timeout (TimeSpan) to get an HTTP response. It is the timeout to get a response, not the timeout to read response data. Default value: 00:05:00. Type: string (or Expression with resultType string), pattern: ((\\d+)\\.)?(\\d\\d):(60|([0-5][0-9])):(60|([0-5][0-9]))."
         }
       }
     },
@@ -1632,6 +1714,10 @@
         "query": {
           "type": "object",
           "description": "SAP ECC OData query. For example, \"$top=1\". Type: string (or Expression with resultType string)."
+        },
+        "httpRequestTimeout": {
+          "type": "object",
+          "description": "The timeout (TimeSpan) to get an HTTP response. It is the timeout to get a response, not the timeout to read response data. Default value: 00:05:00. Type: string (or Expression with resultType string), pattern: ((\\d+)\\.)?(\\d\\d):(60|([0-5][0-9])):(60|([0-5][0-9]))."
         }
       }
     },
@@ -2990,6 +3076,10 @@
         "query": {
           "type": "object",
           "description": "A query to retrieve data from source. Type: string (or Expression with resultType string)."
+        },
+        "httpRequestTimeout": {
+          "type": "object",
+          "description": "The timeout (TimeSpan) to get an HTTP response. It is the timeout to get a response, not the timeout to read response data. Default value: 00:05:00. Type: string (or Expression with resultType string), pattern: ((\\d+)\\.)?(\\d\\d):(60|([0-5][0-9])):(60|([0-5][0-9]))."
         }
       }
     },
@@ -3209,6 +3299,10 @@
             "name": "SapCloudForCustomerSinkWriteBehavior",
             "modelAsString": true
           }
+        },
+        "httpRequestTimeout": {
+          "type": "object",
+          "description": "The timeout (TimeSpan) to get an HTTP response. It is the timeout to get a response, not the timeout to read response data. Default value: 00:05:00. Type: string (or Expression with resultType string), pattern: ((\\d+)\\.)?(\\d\\d):(60|([0-5][0-9])):(60|([0-5][0-9]))."
         }
       }
     },
@@ -6214,6 +6308,25 @@
       "required": [
         "dataFlow"
       ]
+    },
+    "SharePointOnlineListSource": {
+      "description": "A copy activity source for sharePoint online list source.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/CopySource"
+        }
+      ],
+      "properties": {
+        "query": {
+          "type": "object",
+          "description": "The OData query to filter the data in SharePoint Online list. For example, \"$top=1\". Type: string (or Expression with resultType string)."
+        },
+        "httpRequestTimeout": {
+          "type": "object",
+          "description": "The wait time to get a response from SharePoint Online. Default value is 5 minutes (00:05:00). Type: string (or Expression with resultType string), pattern: ((\\d+)\\.)?(\\d\\d):(60|([0-5][0-9])):(60|([0-5][0-9]))."
+        }
+      }
     }
   }
 }
diff --git a/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSCertificateCreateOrUpdate.json b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSCertificateCreateOrUpdate.json
new file mode 100644
index 000000000000..bad1dd6fb8c4
--- /dev/null
+++ b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSCertificateCreateOrUpdate.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "provisioningServiceName": "myFirstProvisioningService",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2020-01-01",
+    "subscriptionId": "91d12660-3dec-467a-be2a-213b5544ddc0",
+    "certificateName": "cert",
+    "certificateDescription": {
+      "certificate": "############################################"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "subject": "CN=testdevice1",
+          "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
+          "thumbprint": "97388663832D0393C9246CAB4FBA2C8677185A25",
+          "isVerified": false,
+          "created": "Thu, 12 Oct 2017 19:23:50 GMT",
+          "updated": "Thu, 12 Oct 2017 19:23:50 GMT"
+        },
+        "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServives/myFirstProvisioningService/certificates/cert",
+        "name": "cert",
+        "type": "Microsoft.Devices/ProvisioningServices/Certificates",
+        "etag": "AAAAAAExpNs="
+      }
+    }
+  }
+}
diff --git a/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSCheckNameAvailability.json b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSCheckNameAvailability.json
new file mode 100644
index 000000000000..e32b22fe2bf3
--- /dev/null
+++ b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSCheckNameAvailability.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01",
+    "subscriptionId": "91d12660-3dec-467a-be2a-213b5544ddc0",
+    "arguments": {
+      "name": "test213123"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "nameAvailable": true,
+        "reason": "Invalid",
+        "message": "name is valid"
+      }
+    }
+  }
+}
diff --git a/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSCreate.json b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSCreate.json
new file mode 100644
index 000000000000..985e43062210
--- /dev/null
+++ b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSCreate.json
@@ -0,0 +1,65 @@
+{
+  "parameters": {
+    "provisioningServiceName": "myFirstProvisioningService",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2020-01-01",
+    "subscriptionId": "91d12660-3dec-467a-be2a-213b5544ddc0",
+    "iotDpsDescription": {
+      "location": "East US",
+      "properties": {},
+      "sku": {
+        "name": "S1",
+        "capacity": 1
+      },
+      "tags": {}
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "etag": "AAAAAAAADGk=",
+        "name": "myFirstProvisioningService",
+        "location": "eastus",
+        "properties": {
+          "state": "Active",
+          "allocationPolicy": "Hashed",
+          "serviceOperationsHostName": "myFirstProvisioningService.azure-devices-provisioning.net",
+          "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
+          "idScope": "0ne00000012",
+          "authorizationPolicies": []
+        },
+        "type": "Microsoft.Devices/ProvisioningServices",
+        "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups//providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService",
+        "tags": {},
+        "sku": {
+          "name": "S1",
+          "tier": "Standard",
+          "capacity": 1
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "etag": "AAAAAAAADGk=",
+        "name": "myFirstProvisioningService",
+        "location": "eastus",
+        "properties": {
+          "state": "Active",
+          "allocationPolicy": "Hashed",
+          "serviceOperationsHostName": "myFirstProvisioningService.azure-devices-provisioning.net",
+          "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
+          "idScope": "0ne00000012",
+          "authorizationPolicies": []
+        },
+        "type": "Microsoft.Devices/ProvisioningServices",
+        "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups//providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService",
+        "tags": {},
+        "sku": {
+          "name": "S1",
+          "tier": "Standard",
+          "capacity": 1
+        }
+      }
+    }
+  }
+}
diff --git a/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSDelete.json b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSDelete.json
new file mode 100644
index 000000000000..6268ef59e80e
--- /dev/null
+++ b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSDelete.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "provisioningServiceName": "myFirstProvisioningService",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2020-01-01",
+    "subscriptionId": "91d12660-3dec-467a-be2a-213b5544ddc0"
+  },
+  "responses": {
+    "200": {},
+    "204": {},
+    "202": {},
+    "404": {}
+  }
+}
diff --git a/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSDeleteCertificate.json b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSDeleteCertificate.json
new file mode 100644
index 000000000000..a75650efd323
--- /dev/null
+++ b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSDeleteCertificate.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "provisioningServiceName": "myFirstProvisioningService",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2020-01-01",
+    "subscriptionId": "91d12660-3dec-467a-be2a-213b5544ddc0",
+    "certificateName": "cert",
+    "If-Match": "AAAAAAAADGk="
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSGenerateVerificationCode.json b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSGenerateVerificationCode.json
new file mode 100644
index 000000000000..e28a4c4bf1f3
--- /dev/null
+++ b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSGenerateVerificationCode.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "provisioningServiceName": "myFirstProvisioningService",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2020-01-01",
+    "subscriptionId": "91d12660-3dec-467a-be2a-213b5544ddc0",
+    "certificateName": "cert",
+    "If-Match": "AAAAAAAADGk="
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "cert",
+        "properties": {
+          "verificationCode": "##################################",
+          "subject": "CN=andbucdevice1",
+          "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
+          "thumbprint": "##############################",
+          "isVerified": false,
+          "created": "Thu, 12 Oct 2017 19:23:50 GMT",
+          "updated": "Thu, 12 Oct 2017 19:26:56 GMT"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSGet.json b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSGet.json
new file mode 100644
index 000000000000..b44b366b80b5
--- /dev/null
+++ b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSGet.json
@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "provisioningServiceName": "myFirstProvisioningService",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2020-01-01",
+    "subscriptionId": "91d12660-3dec-467a-be2a-213b5544ddc0"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "etag": "AAAAAAAADGk=",
+        "name": "myFirstProvisioningService",
+        "location": "eastus",
+        "properties": {
+          "state": "Active",
+          "allocationPolicy": "Hashed",
+          "serviceOperationsHostName": "myFirstProvisioningService.azure-devices-provisioning.net",
+          "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
+          "idScope": "0ne00000012",
+          "authorizationPolicies": []
+        },
+        "type": "Microsoft.Devices/ProvisioningServices",
+        "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService",
+        "tags": {},
+        "sku": {
+          "name": "S1",
+          "tier": "Standard",
+          "capacity": 1
+        }
+      }
+    }
+  }
+}
diff --git a/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSGetCertificate.json b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSGetCertificate.json
new file mode 100644
index 000000000000..c477bfea1fa6
--- /dev/null
+++ b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSGetCertificate.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "provisioningServiceName": "myFirstProvisioningService",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2020-01-01",
+    "subscriptionId": "91d12660-3dec-467a-be2a-213b5544ddc0",
+    "certificateName": "cert"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "subject": "CN=testdevice1",
+          "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
+          "thumbprint": "97388663832D0393C9246CAB4FBA2C8677185A25",
+          "isVerified": false,
+          "created": "Thu, 12 Oct 2017 19:23:50 GMT",
+          "updated": "Thu, 12 Oct 2017 19:23:50 GMT"
+        },
+        "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/andbuc-hub/certificates/cert",
+        "name": "cert",
+        "type": "Microsoft.Devices/ProvisioningServices/Certificates",
+        "etag": "AAAAAAExpNs="
+      }
+    }
+  }
+}
diff --git a/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSGetCertificates.json b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSGetCertificates.json
new file mode 100644
index 000000000000..9f307d6e87a9
--- /dev/null
+++ b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSGetCertificates.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "provisioningServiceName": "myFirstProvisioningService",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2020-01-01",
+    "subscriptionId": "91d12660-3dec-467a-be2a-213b5544ddc0"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "properties": {
+              "subject": "CN=testdevice1",
+              "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
+              "thumbprint": "97388663832D0393C9246CAB4FBA2C8677185A25",
+              "isVerified": false,
+              "created": "Thu, 12 Oct 2017 19:23:50 GMT",
+              "updated": "Thu, 12 Oct 2017 19:23:50 GMT"
+            },
+            "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/andbuc-hub/certificates/cert",
+            "name": "cert",
+            "type": "Microsoft.Devices/ProvisioningServices/Certificates",
+            "etag": "AAAAAAExpNs="
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSGetKey.json b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSGetKey.json
new file mode 100644
index 000000000000..d4ee8aa65833
--- /dev/null
+++ b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSGetKey.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "provisioningServiceName": "myFirstProvisioningService",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2020-01-01",
+    "subscriptionId": "91d12660-3dec-467a-be2a-213b5544ddc0",
+    "keyName": "testKey"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "keyName": "testKey",
+        "primaryKey": "##################################",
+        "secondaryKey": "################################",
+        "rights": "RegistrationStatusWrite"
+      }
+    }
+  }
+}
diff --git a/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSGetOperationResult.json b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSGetOperationResult.json
new file mode 100644
index 000000000000..38169a6a6832
--- /dev/null
+++ b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSGetOperationResult.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "provisioningServiceName": "myFirstProvisioningService",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2020-01-01",
+    "subscriptionId": "91d12660-3dec-467a-be2a-213b5544ddc0",
+    "operationId": "MTY5OTNmZDctODI5Yy00N2E2LTkxNDQtMDU1NGIyYzY1ZjRl",
+    "asyncinfo": "1508265712453"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "status": "Succeeded"
+      }
+    }
+  }
+}
diff --git a/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSGetValidSku.json b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSGetValidSku.json
new file mode 100644
index 000000000000..bd010bd38ccf
--- /dev/null
+++ b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSGetValidSku.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "provisioningServiceName": "myFirstProvisioningService",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2020-01-01",
+    "subscriptionId": "91d12660-3dec-467a-be2a-213b5544ddc0"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "S1"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSListByResourceGroup.json b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSListByResourceGroup.json
new file mode 100644
index 000000000000..5606e0a06bb4
--- /dev/null
+++ b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSListByResourceGroup.json
@@ -0,0 +1,55 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01",
+    "subscriptionId": "91d12660-3dec-467a-be2a-213b5544ddc0",
+    "resourceGroupName": "myResourceGroup"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "etag": "AAAAAAAADGk=",
+            "name": "myFirstProvisioningService",
+            "location": "eastus",
+            "properties": {
+              "state": "Active",
+              "allocationPolicy": "Hashed",
+              "serviceOperationsHostName": "myFirstProvisioningService.azure-devices-provisioning.net",
+              "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
+              "idScope": "0ne00000012"
+            },
+            "type": "Microsoft.Devices/ProvisioningServices",
+            "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService",
+            "tags": {},
+            "sku": {
+              "name": "S1",
+              "tier": "Standard",
+              "capacity": 1
+            }
+          },
+          {
+            "etag": "AAAAAAAADGk=",
+            "name": "mySecondProvisioningService",
+            "location": "eastus",
+            "properties": {
+              "state": "Active",
+              "allocationPolicy": "Hashed",
+              "serviceOperationsHostName": "mySecondProvisioningService.azure-devices-provisioning.net",
+              "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
+              "idScope": "0ne00000012"
+            },
+            "type": "Microsoft.Devices/ProvisioningServices",
+            "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServices/mySecondProvisioningService",
+            "tags": {},
+            "sku": {
+              "name": "S1",
+              "tier": "Standard",
+              "capacity": 1
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSListBySubscription.json b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSListBySubscription.json
new file mode 100644
index 000000000000..ae139fc87d88
--- /dev/null
+++ b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSListBySubscription.json
@@ -0,0 +1,54 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01",
+    "subscriptionId": "91d12660-3dec-467a-be2a-213b5544ddc0"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "etag": "AAAAAAAADGk=",
+            "name": "myFirstProvisioningService",
+            "location": "eastus",
+            "properties": {
+              "state": "Active",
+              "allocationPolicy": "Hashed",
+              "serviceOperationsHostName": "myFirstProvisioningService.azure-devices-provisioning.net",
+              "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
+              "idScope": "0ne00000012"
+            },
+            "type": "Microsoft.Devices/ProvisioningServices",
+            "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService",
+            "tags": {},
+            "sku": {
+              "name": "S1",
+              "tier": "Standard",
+              "capacity": 1
+            }
+          },
+          {
+            "etag": "AAAAAAAADGk=",
+            "name": "mySecondProvisioningService",
+            "location": "eastus",
+            "properties": {
+              "state": "Active",
+              "allocationPolicy": "Hashed",
+              "serviceOperationsHostName": "myFirstProvisioningService.azure-devices-provisioning.net",
+              "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
+              "idScope": "0ne00000012"
+            },
+            "type": "Microsoft.Devices/ProvisioningServices",
+            "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServices/mySecondProvisioningService",
+            "tags": {},
+            "sku": {
+              "name": "S1",
+              "tier": "Standard",
+              "capacity": 1
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSListKeys.json b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSListKeys.json
new file mode 100644
index 000000000000..aca0af4ab6b7
--- /dev/null
+++ b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSListKeys.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "provisioningServiceName": "myFirstProvisioningService",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2020-01-01",
+    "subscriptionId": "91d12660-3dec-467a-be2a-213b5544ddc0"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "keyName": "key1",
+            "primaryKey": "#####################################",
+            "secondaryKey": "###################################",
+            "rights": "ServiceConfig"
+          },
+          {
+            "keyName": "key2",
+            "primaryKey": "#######################################",
+            "secondaryKey": "####################################=",
+            "rights": "ServiceConfig"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSOperations.json b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSOperations.json
new file mode 100644
index 000000000000..63fccdb5acfe
--- /dev/null
+++ b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSOperations.json
@@ -0,0 +1,293 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "Microsoft.Devices/register/action",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Register Resource Provider"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/IotHubs/diagnosticSettings/read",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Get Diagnostic Setting"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/IotHubs/diagnosticSettings/write",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Set Diagnostic Setting"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/IotHubs/metricDefinitions/read",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Read IotHub service metric definitions"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/IotHubs/logDefinitions/read",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Read IotHub service log definitions"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/operations/Read",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Get All ResourceProvider Operations"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/checkNameAvailability/Action",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Check If IotHub name is available"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/usages/Read",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Get Subscription Usages"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/iotHubs/Read",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Get IotHub(s)"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/iotHubs/Write",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Create or update IotHub Resource"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/iotHubs/Delete",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Delete IotHub Resource"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/iotHubs/iotHubStats/Read",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Get IotHub Statistics"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/iotHubs/skus/Read",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Get valid IotHub Skus"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/iotHubs/listkeys/Action",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Get all IotHub Keys"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/iotHubs/iotHubKeys/listkeys/Action",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Get IotHub Key for the given name"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/iotHubs/eventHubEndpoints/consumerGroups/Write",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Create EventHub Consumer Group"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/iotHubs/eventHubEndpoints/consumerGroups/Read",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Get EventHub Consumer Group(s)"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/iotHubs/eventHubEndpoints/consumerGroups/Delete",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Delete EventHub Consumer Group"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/iotHubs/exportDevices/Action",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Export Devices"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/iotHubs/importDevices/Action",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Import Devices"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/iotHubs/jobs/Read",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Get the Job(s) on IotHub"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/iotHubs/quotaMetrics/Read",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Get Quota Metrics"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/iotHubs/routing/routes/$testall/Action",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Routing Rule Test All"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/iotHubs/routing/routes/$testnew/Action",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Routing Rule Test Route"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/iotHubs/routingEndpointsHealth/Read",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Get Endpoint Health"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/ProvisioningServices/diagnosticSettings/read",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Get Diagnostic Setting"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/ProvisioningServices/diagnosticSettings/write",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Set Diagnostic Setting"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/ProvisioningServices/metricDefinitions/read",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Read DPS service metric definitions"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/ProvisioningServices/logDefinitions/read",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "IotHubs",
+              "operation": "Read DPS service log definitions"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/checkProvisioningServiceNameAvailability/Action",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "ProvisioningServives",
+              "operation": "Check If Provisioning Service name is available"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/provisioningServices/Read",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "ProvisioningServices",
+              "operation": "Get Provisioning Service resource"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/provisioningServices/Write",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "ProvisioningServices",
+              "operation": "Create Provisioning Service resource"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/provisioningServices/Delete",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "ProvisioningServices",
+              "operation": "Delete Provisioning Service resource"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/provisioningServices/skus/Read",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "ProvisioningServices",
+              "operation": "Delete Provisioning Service resource"
+            }
+          },
+          {
+            "name": "Microsoft.Devices/provisioningServices/listkeys/Action",
+            "display": {
+              "provider": "Microsoft Devices",
+              "resource": "ProvisioningServices",
+              "operation": "get security related metadata"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSPatch.json b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSPatch.json
new file mode 100644
index 000000000000..631bd5151555
--- /dev/null
+++ b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSPatch.json
@@ -0,0 +1,41 @@
+{
+  "parameters": {
+    "provisioningServiceName": "myFirstProvisioningService",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2020-01-01",
+    "subscriptionId": "91d12660-3dec-467a-be2a-213b5544ddc0",
+    "location": "East US",
+    "type": "Microsoft.Devices/ProvisioningServices",
+    "ProvisioningServiceTags": {
+      "tags": {
+        "foo": "bar"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "etag": "AAAAAAAADGk=",
+        "name": "myFirstProvisioningService",
+        "location": "eastus",
+        "properties": {
+          "state": "Active",
+          "allocationPolicy": "Hashed",
+          "serviceOperationsHostName": "myFirstProvisioningService.azure-devices-provisioning.net",
+          "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
+          "idScope": "0ne00000012"
+        },
+        "type": "Microsoft.Devices/ProvisioningServices",
+        "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService",
+        "tags": {
+          "foo": "bar"
+        },
+        "sku": {
+          "name": "S1",
+          "tier": "Standard",
+          "capacity": 1
+        }
+      }
+    }
+  }
+}
diff --git a/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSVerifyCertificate.json b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSVerifyCertificate.json
new file mode 100644
index 000000000000..92fd1b91fbf6
--- /dev/null
+++ b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/examples/DPSVerifyCertificate.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "provisioningServiceName": "myFirstProvisioningService",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2020-01-01",
+    "subscriptionId": "91d12660-3dec-467a-be2a-213b5544ddc0",
+    "certificateName": "cert",
+    "If-Match": "AAAAAAAADGk=",
+    "request": {
+      "certificate": "#####################################"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "subject": "CN=andbucdevice1",
+          "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
+          "thumbprint": "97388663832D0393C9246CAB4FBA2C8677185A25",
+          "isVerified": true,
+          "created": "Thu, 12 Oct 2017 19:23:50 GMT",
+          "updated": "Thu, 12 Oct 2017 19:26:56 GMT"
+        },
+        "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService/certificates/cert",
+        "name": "cert",
+        "type": "Microsoft.Devices/ProvisioningServices/Certificates",
+        "etag": "AAAAAAExpTQ="
+      }
+    }
+  }
+}
diff --git a/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/iotdps.json b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/iotdps.json
new file mode 100644
index 000000000000..70ea10d42a16
--- /dev/null
+++ b/specification/deviceprovisioningservices/resource-manager/Microsoft.Devices/stable/2020-01-01/iotdps.json
@@ -0,0 +1,2003 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "version": "2020-01-01",
+    "x-ms-code-generation-settings": {
+      "host": "management.azure.com"
+    },
+    "title": "iotDpsClient",
+    "description": "API for using the Azure IoT Hub Device Provisioning Service features."
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/providers/Microsoft.Devices/operations": {
+      "get": {
+        "tags": [
+          "Operations"
+        ],
+        "operationId": "Operations_List",
+        "x-ms-examples": {
+          "DPSOperations": {
+            "$ref": "./examples/DPSOperations.json"
+          }
+        },
+        "description": "Lists all of the available Microsoft.Devices REST API operations.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/OperationListResult"
+            }
+          },
+          "default": {
+            "description": "Default error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorDetails"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/certificates/{certificateName}": {
+      "get": {
+        "tags": [
+          "GET"
+        ],
+        "operationId": "DpsCertificate_Get",
+        "description": "Get the certificate from the provisioning service.",
+        "x-ms-examples": {
+          "DPSGetCertificate": {
+            "$ref": "./examples/DPSGetCertificate.json"
+          }
+        },
+        "consumes": [],
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "name": "certificateName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of the certificate to retrieve."
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "name": "resourceGroupName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Resource group identifier."
+          },
+          {
+            "name": "provisioningServiceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of the provisioning service the certificate is associated with."
+          },
+          {
+            "name": "If-Match",
+            "in": "header",
+            "required": false,
+            "type": "string",
+            "description": "ETag of the certificate."
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Metadata for the specified certificate.",
+            "schema": {
+              "$ref": "#/definitions/CertificateResponse"
+            }
+          },
+          "default": {
+            "description": "Default error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorDetails"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "PUT"
+        ],
+        "summary": "Upload the certificate to the provisioning service.",
+        "description": "Add new certificate or update an existing certificate.",
+        "operationId": "DpsCertificate_CreateOrUpdate",
+        "x-ms-examples": {
+          "DPSCreateOrUpdateCertificate": {
+            "$ref": "./examples/DPSCertificateCreateOrUpdate.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "name": "resourceGroupName",
+            "in": "path",
+            "description": "Resource group identifier.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "provisioningServiceName",
+            "in": "path",
+            "description": "The name of the provisioning service.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "certificateName",
+            "in": "path",
+            "description": "The name of the certificate create or update.",
+            "required": true,
+            "type": "string",
+            "maxLength": 256
+          },
+          {
+            "name": "certificateDescription",
+            "in": "body",
+            "description": "The certificate body.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/CertificateBodyDescription"
+            }
+          },
+          {
+            "name": "If-Match",
+            "in": "header",
+            "required": false,
+            "type": "string",
+            "description": "ETag of the certificate. This is required to update an existing certificate, and ignored while creating a brand new certificate."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "If certificate already exist and update was successful, the operation returns HTTP status code of 201 (OK).",
+            "schema": {
+              "$ref": "#/definitions/CertificateResponse"
+            }
+          },
+          "default": {
+            "description": "Default error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorDetails"
+            }
+          }
+        },
+        "deprecated": false,
+        "produces": [
+          "application/json"
+        ],
+        "consumes": [
+          "application/json"
+        ]
+      },
+      "delete": {
+        "tags": [
+          "DELETE"
+        ],
+        "operationId": "DpsCertificate_Delete",
+        "summary": "Delete the Provisioning Service Certificate.",
+        "description": "Deletes the specified certificate associated with the Provisioning Service",
+        "x-ms-examples": {
+          "DPSDeleteCertificate": {
+            "$ref": "./examples/DPSDeleteCertificate.json"
+          }
+        },
+        "consumes": [],
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "name": "resourceGroupName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Resource group identifier."
+          },
+          {
+            "name": "If-Match",
+            "in": "header",
+            "required": true,
+            "type": "string",
+            "description": "ETag of the certificate"
+          },
+          {
+            "name": "provisioningServiceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The name of the provisioning service."
+          },
+          {
+            "name": "certificateName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "This is a mandatory field, and is the logical name of the certificate that the provisioning service will access by."
+          },
+          {
+            "name": "certificate.name",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "This is optional, and it is the Common Name of the certificate."
+          },
+          {
+            "name": "certificate.rawBytes",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "format": "byte",
+            "description": "Raw data within the certificate."
+          },
+          {
+            "name": "certificate.isVerified",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "description": "Indicates if certificate has been verified by owner of the private key."
+          },
+          {
+            "name": "certificate.purpose",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "A description that mentions the purpose of the certificate.",
+            "enum": [
+              "clientAuthentication",
+              "serverAuthentication"
+            ],
+            "x-ms-enum": {
+              "name": "CertificatePurpose",
+              "modelAsString": true
+            }
+          },
+          {
+            "name": "certificate.created",
+            "in": "query",
+            "description": "Time the certificate is created.",
+            "required": false,
+            "type": "string",
+            "format": "date-time"
+          },
+          {
+            "name": "certificate.lastUpdated",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "Time the certificate is last updated.",
+            "format": "date-time"
+          },
+          {
+            "name": "certificate.hasPrivateKey",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "description": "Indicates if the certificate contains a private key."
+          },
+          {
+            "name": "certificate.nonce",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "Random number generated to indicate Proof of Possession."
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK."
+          },
+          "204": {
+            "description": "No content."
+          },
+          "default": {
+            "description": "Default error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorDetails"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}": {
+      "get": {
+        "tags": [
+          "GET"
+        ],
+        "summary": "Get the non-security related metadata of the provisioning service.",
+        "description": "Get the metadata of the provisioning service without SAS keys.",
+        "operationId": "IotDpsResource_Get",
+        "x-ms-examples": {
+          "DPSGet": {
+            "$ref": "./examples/DPSGet.json"
+          }
+        },
+        "parameters": [
+          {
+            "name": "provisioningServiceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of the provisioning service to retrieve."
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "name": "resourceGroupName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Resource group name."
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Provisioning service description with no keys is included in the response.",
+            "schema": {
+              "$ref": "#/definitions/ProvisioningServiceDescription"
+            }
+          },
+          "default": {
+            "description": "Default error response",
+            "schema": {
+              "$ref": "#/definitions/ErrorDetails"
+            }
+          }
+        },
+        "produces": [
+          "application/json"
+        ],
+        "consumes": [
+          "application/json"
+        ]
+      },
+      "put": {
+        "tags": [
+          "PUT"
+        ],
+        "summary": "Create or update the metadata of the provisioning service.",
+        "description": "Create or update the metadata of the provisioning service. The usual pattern to modify a property is to retrieve the provisioning service metadata and security metadata, and then combine them with the modified values in a new body to update the provisioning service.",
+        "x-ms-long-running-operation": true,
+        "operationId": "IotDpsResource_CreateOrUpdate",
+        "x-ms-examples": {
+          "DPSCreate": {
+            "$ref": "./examples/DPSCreate.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "name": "resourceGroupName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Resource group identifier."
+          },
+          {
+            "name": "provisioningServiceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of provisioning service to create or update."
+          },
+          {
+            "name": "iotDpsDescription",
+            "in": "body",
+            "required": true,
+            "description": "Description of the provisioning service to create or update.",
+            "schema": {
+              "$ref": "#/definitions/ProvisioningServiceDescription"
+            }
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The body contains all the non-security properties of the provisioning service. Security-related properties are set to null.",
+            "schema": {
+              "$ref": "#/definitions/ProvisioningServiceDescription"
+            }
+          },
+          "201": {
+            "description": "This is a long running operation. The operation returns a 201 if the validation is complete. The response includes an Azure-AsyncOperation header that contains a status URL. Clients are expected to poll the status URL for the status of the operation. If successful, the operation returns HTTP status code of 201 (OK).",
+            "schema": {
+              "$ref": "#/definitions/ProvisioningServiceDescription"
+            }
+          },
+          "default": {
+            "description": "Default error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorDetails"
+            }
+          }
+        },
+        "produces": [
+          "application/json"
+        ],
+        "consumes": [
+          "application/json"
+        ]
+      },
+      "patch": {
+        "tags": [
+          "PATCH"
+        ],
+        "summary": "Update an existing provisioning service's tags.",
+        "description": "Update an existing provisioning service's tags. to update other fields use the CreateOrUpdate method",
+        "x-ms-long-running-operation": true,
+        "operationId": "IotDpsResource_Update",
+        "x-ms-examples": {
+          "DPSPatch": {
+            "$ref": "./examples/DPSPatch.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "name": "resourceGroupName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Resource group identifier."
+          },
+          {
+            "name": "provisioningServiceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of provisioning service to create or update."
+          },
+          {
+            "name": "ProvisioningServiceTags",
+            "in": "body",
+            "required": true,
+            "description": "Updated tag information to set into the provisioning service instance.",
+            "schema": {
+              "$ref": "#/definitions/TagsResource"
+            }
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Provisioning Service was successfully updated",
+            "schema": {
+              "$ref": "#/definitions/ProvisioningServiceDescription"
+            }
+          }
+        },
+        "produces": [
+          "application/json"
+        ],
+        "consumes": [
+          "application/json"
+        ]
+      },
+      "delete": {
+        "tags": [
+          "DELETE"
+        ],
+        "summary": "Delete the Provisioning Service",
+        "description": "Deletes the Provisioning Service.",
+        "x-ms-long-running-operation": true,
+        "operationId": "IotDpsResource_Delete",
+        "x-ms-examples": {
+          "DPSDelete": {
+            "$ref": "./examples/DPSDelete.json"
+          }
+        },
+        "consumes": [],
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "name": "provisioningServiceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of provisioning service to delete."
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "name": "resourceGroupName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Resource group identifier."
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The provisioning service resource provider always returns a 202 Accepted status code with valid Location and Retry-After headers. The resource provider also sets the Azure-AsyncOperation header with a URL that points to the operation resource for this operation. Subsequent GET attempts on the resource after a DELETE operation return a resource representation that indicates a transitional provisioning state (such as Terminating). To retrieve the status of the operation, a client can either poll the URL returned in the Location header after the Retry-After interval, get the provisioning service status directly, or query the operation resource."
+          },
+          "200": {
+            "description": "This is returned as a response to the status polling request for the delete operation. The body contains the resource representation that indicates a transitional provisioning state."
+          },
+          "204": {
+            "description": "Once the long running delete operation completes successfully, a 204 No Content status code is returned when the status polling request finds the provisioning service metadata in the service and the status of the delete operation is set to a completed state."
+          },
+          "404": {
+            "description": "After the long running delete operation completes successfully, a 404 Not Found is returned when the status polling request no longer finds the provisioning service metadata in the service."
+          },
+          "default": {
+            "description": "Default error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorDetails"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/certificates": {
+      "get": {
+        "tags": [
+          "GET"
+        ],
+        "operationId": "DpsCertificate_List",
+        "description": "Get all the certificates tied to the provisioning service.",
+        "x-ms-examples": {
+          "DPSGetCertificates": {
+            "$ref": "./examples/DPSGetCertificates.json"
+          }
+        },
+        "consumes": [],
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "name": "resourceGroupName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of resource group."
+          },
+          {
+            "name": "provisioningServiceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of provisioning service to retrieve certificates for."
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "List of certificate descriptions in a JSON-serialized array.",
+            "schema": {
+              "$ref": "#/definitions/CertificateListDescription"
+            }
+          },
+          "default": {
+            "description": "Default error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorDetails"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Devices/provisioningServices": {
+      "get": {
+        "tags": [
+          "GET"
+        ],
+        "summary": "Get all the provisioning services in a subscription.",
+        "description": "List all the provisioning services for a given subscription id.",
+        "operationId": "IotDpsResource_ListBySubscription",
+        "x-ms-examples": {
+          "DPSListBySubscription": {
+            "$ref": "./examples/DPSListBySubscription.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "This is a synchronous operation. The body contains a JSON-serialized array of the metadata from all the provisioning services in the subscription.",
+            "schema": {
+              "$ref": "#/definitions/ProvisioningServiceDescriptionListResult"
+            }
+          },
+          "default": {
+            "description": "Default error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorDetails"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices": {
+      "get": {
+        "tags": [
+          "GET"
+        ],
+        "operationId": "IotDpsResource_ListByResourceGroup",
+        "description": "Get a list of all provisioning services in the given resource group.",
+        "x-ms-examples": {
+          "DPSListByResourceGroup": {
+            "$ref": "./examples/DPSListByResourceGroup.json"
+          }
+        },
+        "consumes": [],
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "name": "resourceGroupName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Resource group identifier."
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "List of provisioning services in the resource group.",
+            "schema": {
+              "$ref": "#/definitions/ProvisioningServiceDescriptionListResult"
+            }
+          },
+          "default": {
+            "description": "Default error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorDetails"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/operationresults/{operationId}": {
+      "get": {
+        "tags": [
+          "GET"
+        ],
+        "operationId": "IotDpsResource_GetOperationResult",
+        "description": "Gets the status of a long running operation, such as create, update or delete a provisioning service.",
+        "x-ms-examples": {
+          "DPSGetOperationResult": {
+            "$ref": "./examples/DPSGetOperationResult.json"
+          }
+        },
+        "consumes": [],
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "name": "operationId",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Operation id corresponding to long running operation. Use this to poll for the status."
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "name": "resourceGroupName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Resource group identifier."
+          },
+          {
+            "name": "provisioningServiceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of provisioning service that the operation is running on."
+          },
+          {
+            "name": "asyncinfo",
+            "in": "query",
+            "description": "Async header used to poll on the status of the operation, obtained while creating the long running operation.",
+            "required": true,
+            "type": "string",
+            "default": "true"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The status of the long running operation.",
+            "schema": {
+              "$ref": "#/definitions/AsyncOperationResult"
+            }
+          },
+          "default": {
+            "description": "Default error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorDetails"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/skus": {
+      "get": {
+        "tags": [
+          "GET"
+        ],
+        "summary": "Get the list of valid SKUs for a provisioning service.",
+        "description": "Gets the list of valid SKUs and tiers for a provisioning service.",
+        "operationId": "IotDpsResource_listValidSkus",
+        "x-ms-examples": {
+          "DPSGetValidSku": {
+            "$ref": "./examples/DPSGetValidSku.json"
+          }
+        },
+        "parameters": [
+          {
+            "name": "provisioningServiceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of provisioning service."
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "name": "resourceGroupName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of resource group."
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "This is a synchronous operation. The body contains a JSON-serialized array of the valid SKUs for this provisioning service.",
+            "schema": {
+              "$ref": "#/definitions/IotDpsSkuDefinitionListResult"
+            }
+          },
+          "default": {
+            "description": "Default error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorDetails"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/certificates/{certificateName}/generateVerificationCode": {
+      "post": {
+        "tags": [
+          "POST"
+        ],
+        "operationId": "DpsCertificate_GenerateVerificationCode",
+        "description": "Generate verification code for Proof of Possession.",
+        "x-ms-examples": {
+          "DPSGenerateVerificationCode": {
+            "$ref": "./examples/DPSGenerateVerificationCode.json"
+          }
+        },
+        "parameters": [
+          {
+            "name": "certificateName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The mandatory logical name of the certificate, that the provisioning service uses to access."
+          },
+          {
+            "name": "If-Match",
+            "in": "header",
+            "required": true,
+            "type": "string",
+            "description": "ETag of the certificate. This is required to update an existing certificate, and ignored while creating a brand new certificate."
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "name": "resourceGroupName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "name of resource group."
+          },
+          {
+            "name": "provisioningServiceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of provisioning service."
+          },
+          {
+            "name": "certificate.name",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "Common Name for the certificate."
+          },
+          {
+            "name": "certificate.rawBytes",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "format": "byte",
+            "description": "Raw data of certificate."
+          },
+          {
+            "name": "certificate.isVerified",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "description": "Indicates if the certificate has been verified by owner of the private key."
+          },
+          {
+            "name": "certificate.purpose",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "Description mentioning the purpose of the certificate.",
+            "enum": [
+              "clientAuthentication",
+              "serverAuthentication"
+            ],
+            "x-ms-enum": {
+              "name": "CertificatePurpose",
+              "modelAsString": true
+            }
+          },
+          {
+            "name": "certificate.created",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "format": "date-time",
+            "description": "Certificate creation time."
+          },
+          {
+            "name": "certificate.lastUpdated",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "format": "date-time",
+            "description": "Certificate last updated time."
+          },
+          {
+            "name": "certificate.hasPrivateKey",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "description": "Indicates if the certificate contains private key."
+          },
+          {
+            "name": "certificate.nonce",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "Random number generated to indicate Proof of Possession."
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Generated verification code for that certificate is returned.",
+            "schema": {
+              "$ref": "#/definitions/VerificationCodeResponse"
+            }
+          },
+          "default": {
+            "description": "Default error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorDetails"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/certificates/{certificateName}/verify": {
+      "post": {
+        "tags": [
+          "POST"
+        ],
+        "operationId": "DpsCertificate_VerifyCertificate",
+        "summary": "Verify certificate's private key possession.",
+        "description": "Verifies the certificate's private key possession by providing the leaf cert issued by the verifying pre uploaded certificate.",
+        "x-ms-examples": {
+          "DPSVerifyCertificate": {
+            "$ref": "./examples/DPSVerifyCertificate.json"
+          }
+        },
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "name": "certificateName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The mandatory logical name of the certificate, that the provisioning service uses to access."
+          },
+          {
+            "name": "If-Match",
+            "in": "header",
+            "required": true,
+            "type": "string",
+            "description": "ETag of the certificate."
+          },
+          {
+            "name": "request",
+            "in": "body",
+            "required": true,
+            "description": "The name of the certificate",
+            "schema": {
+              "$ref": "#/definitions/VerificationCodeRequest"
+            }
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "name": "resourceGroupName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Resource group name."
+          },
+          {
+            "name": "provisioningServiceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Provisioning service name."
+          },
+          {
+            "name": "certificate.name",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "Common Name for the certificate."
+          },
+          {
+            "name": "certificate.rawBytes",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "format": "byte",
+            "description": "Raw data of certificate."
+          },
+          {
+            "name": "certificate.isVerified",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "description": "Indicates if the certificate has been verified by owner of the private key."
+          },
+          {
+            "name": "certificate.purpose",
+            "in": "query",
+            "required": false,
+            "description": "Describe the purpose of the certificate.",
+            "type": "string",
+            "enum": [
+              "clientAuthentication",
+              "serverAuthentication"
+            ],
+            "x-ms-enum": {
+              "name": "CertificatePurpose",
+              "modelAsString": true
+            }
+          },
+          {
+            "name": "certificate.created",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "format": "date-time",
+            "description": "Certificate creation time."
+          },
+          {
+            "name": "certificate.lastUpdated",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "format": "date-time",
+            "description": "Certificate last updated time."
+          },
+          {
+            "name": "certificate.hasPrivateKey",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "description": "Indicates if the certificate contains private key."
+          },
+          {
+            "name": "certificate.nonce",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "Random number generated to indicate Proof of Possession."
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/CertificateResponse"
+            }
+          },
+          "default": {
+            "description": "Default error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorDetails"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Devices/checkProvisioningServiceNameAvailability": {
+      "post": {
+        "tags": [
+          "POST"
+        ],
+        "operationId": "IotDpsResource_CheckProvisioningServiceNameAvailability",
+        "x-ms-examples": {
+          "DPSCheckName": {
+            "$ref": "./examples/DPSCheckNameAvailability.json"
+          }
+        },
+        "summary": "Check if a provisioning service name is available.",
+        "description": "Check if a provisioning service name is available. This will validate if the name is syntactically valid and if the name is usable",
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "name": "arguments",
+            "in": "body",
+            "required": true,
+            "description": "Set the name parameter in the OperationInputs structure to the name of the provisioning service to check.",
+            "schema": {
+              "$ref": "#/definitions/OperationInputs"
+            }
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "This is a synchronous operation. The body contains a JSON-serialized response that specifies whether the provisioning service name is available. If the name is not available, the body contains the reason.",
+            "schema": {
+              "$ref": "#/definitions/NameAvailabilityInfo"
+            }
+          },
+          "default": {
+            "description": "Default error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorDetails"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/listkeys": {
+      "post": {
+        "tags": [
+          "POST"
+        ],
+        "operationId": "IotDpsResource_ListKeys",
+        "x-ms-examples": {
+          "DPSListKeys": {
+            "$ref": "./examples/DPSListKeys.json"
+          }
+        },
+        "summary": "Get the security metadata for a provisioning service.",
+        "description": "List the primary and secondary keys for a provisioning service.",
+        "parameters": [
+          {
+            "name": "provisioningServiceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The provisioning service name to get the shared access keys for."
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "name": "resourceGroupName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "resource group name"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "This is a synchronous operation. The body contains a JSON-serialized array of shared access policies, including keys, that you can use to access the provisioning service endpoints.",
+            "schema": {
+              "$ref": "#/definitions/SharedAccessSignatureAuthorizationRuleListResult"
+            }
+          },
+          "default": {
+            "description": "Default error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorDetails"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/keys/{keyName}/listkeys": {
+      "post": {
+        "tags": [
+          "POST"
+        ],
+        "operationId": "IotDpsResource_ListKeysForKeyName",
+        "x-ms-examples": {
+          "DPSGetKey": {
+            "$ref": "./examples/DPSGetKey.json"
+          }
+        },
+        "summary": "Get a shared access policy by name from a provisioning service.",
+        "description": "List primary and secondary keys for a specific key name",
+        "parameters": [
+          {
+            "name": "provisioningServiceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of the provisioning service."
+          },
+          {
+            "name": "keyName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Logical key name to get key-values for."
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "name": "resourceGroupName",
+            "description": "The name of the resource group that contains the provisioning service.",
+            "in": "path",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "This is a synchronous operation. The body contains a JSON-serialized shared access policy, including keys, that you can use to access one or more provisioning service endpoints.",
+            "schema": {
+              "$ref": "#/definitions/SharedAccessSignatureAuthorizationRule[AccessRightsDescription]"
+            }
+          },
+          "default": {
+            "description": "Default error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorDetails"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "AsyncOperationResult": {
+      "type": "object",
+      "description": "Result of a long running operation.",
+      "properties": {
+        "status": {
+          "description": "current status of a long running operation.",
+          "type": "string"
+        },
+        "error": {
+          "description": "Error message containing code, description and details",
+          "$ref": "#/definitions/ErrorMesssage"
+        }
+      }
+    },
+    "ErrorMesssage": {
+      "description": "Error response containing message and code.",
+      "type": "object",
+      "properties": {
+        "code": {
+          "description": "standard error code",
+          "type": "string"
+        },
+        "message": {
+          "description": "standard error description",
+          "type": "string"
+        },
+        "details": {
+          "description": "detailed summary of error",
+          "type": "string"
+        }
+      }
+    },
+    "CertificateListDescription": {
+      "description": "The JSON-serialized array of Certificate objects.",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "The array of Certificate objects.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/CertificateResponse"
+          }
+        }
+      }
+    },
+    "CertificateBodyDescription": {
+      "description": "The JSON-serialized X509 Certificate.",
+      "type": "object",
+      "properties": {
+        "certificate": {
+          "description": "Base-64 representation of the X509 leaf certificate .cer file or just .pem file content.",
+          "type": "string"
+        }
+      }
+    },
+    "CertificateResponse": {
+      "description": "The X509 Certificate.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "description": "properties of a certificate",
+          "$ref": "#/definitions/CertificateProperties"
+        },
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The resource identifier."
+        },
+        "name": {
+          "description": "The name of the certificate.",
+          "type": "string",
+          "readOnly": true
+        },
+        "etag": {
+          "description": "The entity tag.",
+          "type": "string",
+          "readOnly": true
+        },
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The resource type."
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "CertificateProperties": {
+      "description": "The description of an X509 CA Certificate.",
+      "type": "object",
+      "properties": {
+        "subject": {
+          "description": "The certificate's subject name.",
+          "type": "string",
+          "readOnly": true
+        },
+        "expiry": {
+          "description": "The certificate's expiration date and time.",
+          "type": "string",
+          "format": "date-time-rfc1123",
+          "readOnly": true
+        },
+        "thumbprint": {
+          "description": "The certificate's thumbprint.",
+          "type": "string",
+          "readOnly": true
+        },
+        "isVerified": {
+          "description": "Determines whether certificate has been verified.",
+          "type": "boolean",
+          "readOnly": true
+        },
+        "created": {
+          "description": "The certificate's creation date and time.",
+          "type": "string",
+          "format": "date-time-rfc1123",
+          "readOnly": true
+        },
+        "updated": {
+          "description": "The certificate's last update date and time.",
+          "type": "string",
+          "format": "date-time-rfc1123",
+          "readOnly": true
+        }
+      }
+    },
+    "IotDpsSkuInfo": {
+      "type": "object",
+      "description": "List of possible provisioning service SKUs.",
+      "properties": {
+        "name": {
+          "description": "Sku name.",
+          "enum": [
+            "S1"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "IotDpsSku",
+            "modelAsString": true
+          }
+        },
+        "tier": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Pricing tier name of the provisioning service."
+        },
+        "capacity": {
+          "format": "int64",
+          "type": "integer",
+          "description": "The number of units to provision"
+        }
+      }
+    },
+    "ProvisioningServiceDescription": {
+      "description": "The description of the provisioning service.",
+      "type": "object",
+      "properties": {
+        "etag": {
+          "description": "The Etag field is *not* required. If it is provided in the response body, it must also be provided as a header per the normal ETag convention.",
+          "type": "string"
+        },
+        "properties": {
+          "description": "Service specific properties for a provisioning service",
+          "$ref": "#/definitions/IotDpsPropertiesDescription"
+        },
+        "sku": {
+          "description": "Sku info for a provisioning Service.",
+          "$ref": "#/definitions/IotDpsSkuInfo"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/Resource"
+        }
+      ],
+      "required": [
+        "sku",
+        "properties"
+      ]
+    },
+    "IotDpsPropertiesDescription": {
+      "description": "the service specific properties of a provisioning service, including keys, linked iot hubs, current state, and system generated properties such as hostname and idScope",
+      "type": "object",
+      "properties": {
+        "state": {
+          "description": "Current state of the provisioning service.",
+          "enum": [
+            "Activating",
+            "Active",
+            "Deleting",
+            "Deleted",
+            "ActivationFailed",
+            "DeletionFailed",
+            "Transitioning",
+            "Suspending",
+            "Suspended",
+            "Resuming",
+            "FailingOver",
+            "FailoverFailed"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "state",
+            "modelAsString": true
+          }
+        },
+        "ipFilterRules": {
+          "description": "The IP filter rules.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/IpFilterRule"
+          }
+        },
+        "provisioningState": {
+          "description": "The ARM provisioning state of the provisioning service.",
+          "type": "string"
+        },
+        "iotHubs": {
+          "type": "array",
+          "description": "List of IoT hubs associated with this provisioning service.",
+          "items": {
+            "$ref": "#/definitions/IotHubDefinitionDescription"
+          }
+        },
+        "allocationPolicy": {
+          "enum": [
+            "Hashed",
+            "GeoLatency",
+            "Static"
+          ],
+          "type": "string",
+          "description": "Allocation policy to be used by this provisioning service.",
+          "x-ms-enum": {
+            "name": "AllocationPolicy",
+            "modelAsString": true
+          }
+        },
+        "serviceOperationsHostName": {
+          "description": "Service endpoint for provisioning service.",
+          "type": "string",
+          "readOnly": true
+        },
+        "deviceProvisioningHostName": {
+          "type": "string",
+          "description": "Device endpoint for this provisioning service.",
+          "readOnly": true
+        },
+        "idScope": {
+          "type": "string",
+          "description": "Unique identifier of this provisioning service.",
+          "readOnly": true
+        },
+        "authorizationPolicies": {
+          "description": "List of authorization keys for a provisioning service.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SharedAccessSignatureAuthorizationRule[AccessRightsDescription]"
+          }
+        }
+      }
+    },
+    "IotHubDefinitionDescription": {
+      "type": "object",
+      "description": "Description of the IoT hub.",
+      "properties": {
+        "applyAllocationPolicy": {
+          "description": "flag for applying allocationPolicy or not for a given iot hub.",
+          "type": "boolean"
+        },
+        "allocationWeight": {
+          "description": "weight to apply for a given iot h.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Host name of the IoT hub."
+        },
+        "connectionString": {
+          "type": "string",
+          "description": "Connection string og the IoT hub."
+        },
+        "location": {
+          "type": "string",
+          "description": "ARM region of the IoT hub."
+        }
+      },
+      "required": [
+        "connectionString",
+        "location"
+      ]
+    },
+    "IpFilterRule": {
+      "description": "The IP filter rules for the IoT dps.",
+      "type": "object",
+      "properties": {
+        "filterName": {
+          "description": "The name of the IP filter rule.",
+          "type": "string"
+        },
+        "action": {
+          "description": "The desired action for requests captured by this rule.",
+          "enum": [
+            "Accept",
+            "Reject"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "IpFilterActionType",
+            "modelAsString": false
+          }
+        },
+        "ipMask": {
+          "description": "A string that contains the IP address range in CIDR notation for the rule.",
+          "type": "string"
+        },
+        "target": {
+          "description": "Target for requests captured by this rule.",
+          "enum": [
+            "all",
+            "serviceApi",
+            "deviceApi"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "IpFilterTargetType",
+            "modelAsString": false
+          }
+        }
+      },
+      "required": [
+        "filterName",
+        "action",
+        "ipMask"
+      ]
+    },
+    "SharedAccessSignatureAuthorizationRule[AccessRightsDescription]": {
+      "type": "object",
+      "description": "Description of the shared access key.",
+      "properties": {
+        "keyName": {
+          "type": "string",
+          "description": "Name of the key."
+        },
+        "primaryKey": {
+          "type": "string",
+          "description": "Primary SAS key value."
+        },
+        "secondaryKey": {
+          "type": "string",
+          "description": "Secondary SAS key value."
+        },
+        "rights": {
+          "description": "Rights that this key has.",
+          "enum": [
+            "ServiceConfig",
+            "EnrollmentRead",
+            "EnrollmentWrite",
+            "DeviceConnect",
+            "RegistrationStatusRead",
+            "RegistrationStatusWrite"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "AccessRightsDescription",
+            "modelAsString": true
+          }
+        }
+      },
+      "required": [
+        "keyName",
+        "rights"
+      ]
+    },
+    "Resource": {
+      "description": "The common properties of an Azure resource.",
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The resource identifier."
+        },
+        "name": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The resource name.",
+          "pattern": "^(?![0-9]+$)(?!-)[a-zA-Z0-9-]{2,49}[a-zA-Z0-9]$"
+        },
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The resource type."
+        },
+        "location": {
+          "type": "string",
+          "description": "The resource location."
+        },
+        "tags": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "The resource tags."
+        }
+      },
+      "x-ms-azure-resource": true,
+      "required": [
+        "location"
+      ]
+    },
+    "OperationListResult": {
+      "description": "Result of the request to list IoT Hub operations. It contains a list of operations and a URL link to get the next set of results.",
+      "properties": {
+        "value": {
+          "description": "List of IoT Hub operations supported by the Microsoft.Devices resource provider.",
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/Operation"
+          }
+        },
+        "nextLink": {
+          "readOnly": true,
+          "type": "string",
+          "description": "URL to get the next set of operation list results if there are any."
+        }
+      }
+    },
+    "Operation": {
+      "description": "IoT Hub REST API operation.",
+      "type": "object",
+      "properties": {
+        "name": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Operation name: {provider}/{resource}/{read | write | action | delete}"
+        },
+        "display": {
+          "description": "The object that represents the operation.",
+          "properties": {
+            "provider": {
+              "readOnly": true,
+              "type": "string",
+              "description": "Service provider: Microsoft Devices."
+            },
+            "resource": {
+              "readOnly": true,
+              "type": "string",
+              "description": "Resource Type: ProvisioningServices."
+            },
+            "operation": {
+              "readOnly": true,
+              "type": "string",
+              "description": "Name of the operation."
+            }
+          }
+        }
+      }
+    },
+    "ErrorDetails": {
+      "description": "Error details.",
+      "type": "object",
+      "properties": {
+        "code": {
+          "description": "The error code.",
+          "type": "string",
+          "readOnly": true
+        },
+        "httpStatusCode": {
+          "description": "The HTTP status code.",
+          "type": "string",
+          "readOnly": true
+        },
+        "message": {
+          "description": "The error message.",
+          "type": "string",
+          "readOnly": true
+        },
+        "details": {
+          "description": "The error details.",
+          "type": "string",
+          "readOnly": true
+        }
+      }
+    },
+    "SharedAccessSignatureAuthorizationRuleListResult": {
+      "type": "object",
+      "description": "List of shared access keys.",
+      "properties": {
+        "value": {
+          "description": "The list of shared access policies.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SharedAccessSignatureAuthorizationRule[AccessRightsDescription]"
+          }
+        },
+        "nextLink": {
+          "description": "The next link.",
+          "type": "string",
+          "readOnly": true
+        }
+      }
+    },
+    "IotDpsSkuDefinitionListResult": {
+      "type": "object",
+      "description": "List of available SKUs.",
+      "properties": {
+        "value": {
+          "description": "The list of SKUs",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/IotDpsSkuDefinition"
+          }
+        },
+        "nextLink": {
+          "description": "The next link.",
+          "type": "string",
+          "readOnly": true
+        }
+      }
+    },
+    "IotDpsSkuDefinition": {
+      "type": "object",
+      "description": "Available SKUs of tier and units.",
+      "properties": {
+        "name": {
+          "description": "Sku name.",
+          "enum": [
+            "S1"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "IotDpsSku",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "OperationInputs": {
+      "description": "Input values for operation results call.",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "The name of the Provisioning Service to check.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "name"
+      ]
+    },
+    "NameAvailabilityInfo": {
+      "type": "object",
+      "description": "Description of name availability.",
+      "properties": {
+        "nameAvailable": {
+          "description": "specifies if a name is available or not",
+          "type": "boolean"
+        },
+        "reason": {
+          "description": "specifies the reason a name is unavailable",
+          "enum": [
+            "Invalid",
+            "AlreadyExists"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "NameUnavailabilityReason",
+            "modelAsString": true
+          }
+        },
+        "message": {
+          "description": "message containing a detailed reason name is unavailable",
+          "type": "string"
+        }
+      }
+    },
+    "TagsResource": {
+      "properties": {
+        "tags": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Resource tags"
+        }
+      },
+      "description": "A container holding only the Tags for a resource, allowing the user to update the tags on a Provisioning Service instance."
+    },
+    "ProvisioningServiceDescriptionListResult": {
+      "type": "object",
+      "description": "List of provisioning service descriptions.",
+      "properties": {
+        "value": {
+          "description": "List of provisioning service descriptions.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ProvisioningServiceDescription"
+          }
+        },
+        "nextLink": {
+          "description": "the next link",
+          "type": "string",
+          "readOnly": true
+        }
+      }
+    },
+    "VerificationCodeResponse": {
+      "type": "object",
+      "description": "Description of the response of the verification code.",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Name of certificate.",
+          "readOnly": true
+        },
+        "etag": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Request etag."
+        },
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The resource identifier."
+        },
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The resource type."
+        },
+        "properties": {
+          "type": "object",
+          "properties": {
+            "verificationCode": {
+              "type": "string",
+              "description": "Verification code."
+            },
+            "subject": {
+              "type": "string",
+              "description": "Certificate subject."
+            },
+            "expiry": {
+              "type": "string",
+              "description": "Code expiry."
+            },
+            "thumbprint": {
+              "type": "string",
+              "description": "Certificate thumbprint."
+            },
+            "isVerified": {
+              "type": "boolean",
+              "description": "Indicate if the certificate is verified by owner of private key."
+            },
+            "created": {
+              "type": "string",
+              "description": "Certificate created time."
+            },
+            "updated": {
+              "type": "string",
+              "description": "Certificate updated time."
+            }
+          }
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "VerificationCodeRequest": {
+      "type": "object",
+      "description": "The JSON-serialized leaf certificate",
+      "properties": {
+        "certificate": {
+          "description": "base-64 representation of X509 certificate .cer file or just .pem file content.",
+          "type": "string"
+        }
+      }
+    }
+  },
+  "parameters": {
+    "subscriptionId": {
+      "name": "subscriptionId",
+      "in": "path",
+      "description": "The subscription identifier.",
+      "required": true,
+      "type": "string"
+    },
+    "api-version": {
+      "name": "api-version",
+      "in": "query",
+      "description": "The version of the API.",
+      "required": true,
+      "type": "string"
+    }
+  }
+}
diff --git a/specification/deviceprovisioningservices/resource-manager/readme.md b/specification/deviceprovisioningservices/resource-manager/readme.md
index 12b9dedbbe9a..9d6a860f4177 100644
--- a/specification/deviceprovisioningservices/resource-manager/readme.md
+++ b/specification/deviceprovisioningservices/resource-manager/readme.md
@@ -54,6 +54,15 @@ input-file:
 - Microsoft.Devices/stable/2018-01-22/iotdps.json
 ```
 
+### Tag: package-2020-01
+
+These settings apply only when `--tag=package-2020-01` is specified on the command line.
+
+``` yaml $(tag) == 'package-2020-01'
+input-file:
+- Microsoft.Devices/stable/2020-01-01/iotdps.json
+```
+
 ---
 # Code Generation
 
@@ -198,6 +207,7 @@ input-file:
   - $(this-folder)/Microsoft.Devices/preview/2017-08-21-preview/iotdps.json
   - $(this-folder)/Microsoft.Devices/stable/2017-11-15/iotdps.json
   - $(this-folder)/Microsoft.Devices/stable/2018-01-22/iotdps.json
+  - $(this-folder)/Microsoft.Devices/stable/2020-01-01/iotdps.json
 
 ```
 
diff --git a/specification/eventgrid/resource-manager/Microsoft.EventGrid/preview/2020-04-01-preview/EventGrid.json b/specification/eventgrid/resource-manager/Microsoft.EventGrid/preview/2020-04-01-preview/EventGrid.json
index 77ee12851d56..4c189d18d19f 100644
--- a/specification/eventgrid/resource-manager/Microsoft.EventGrid/preview/2020-04-01-preview/EventGrid.json
+++ b/specification/eventgrid/resource-manager/Microsoft.EventGrid/preview/2020-04-01-preview/EventGrid.json
@@ -882,7 +882,8 @@
           "EventChannels_Delete": {
             "$ref": "./examples/EventChannels_Delete.json"
           }
-        }
+        },
+        "x-ms-long-running-operation": true
       }
     },
     "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/partnerNamespaces/{partnerNamespaceName}/eventChannels": {
@@ -1618,6 +1619,12 @@
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/FilterParameter"
+          },
+          {
+            "$ref": "#/parameters/TopParameter"
           }
         ],
         "responses": {
@@ -1637,7 +1644,7 @@
           }
         },
         "x-ms-pageable": {
-          "nextLinkName": null
+          "nextLinkName": "nextLink"
         }
       }
     },
@@ -1987,6 +1994,12 @@
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/FilterParameter"
+          },
+          {
+            "$ref": "#/parameters/TopParameter"
           }
         ],
         "responses": {
@@ -2006,7 +2019,7 @@
           }
         },
         "x-ms-pageable": {
-          "nextLinkName": null
+          "nextLinkName": "nextLink"
         }
       }
     },
@@ -3466,7 +3479,7 @@
           "nextLinkName": null
         },
         "x-ms-examples": {
-          "PartnerTopics_Get": {
+          "PartnerRegistrations_List": {
             "$ref": "./examples/PartnerRegistrations_List.json"
           }
         }
@@ -3919,7 +3932,9 @@
         "summary": "Update a specific private endpoint connection.",
         "description": "Update a specific private endpoint connection under a topic or domain.",
         "operationId": "PrivateEndpointConnections_Update",
-        "consumes": [],
+        "consumes": [
+          "application/json"
+        ],
         "produces": [
           "application/json"
         ],
@@ -3955,6 +3970,15 @@
             "required": true,
             "type": "string"
           },
+          {
+            "name": "privateEndpointConnection",
+            "in": "body",
+            "description": "The private endpoint connection object to update.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/PrivateEndpointConnection"
+            }
+          },
           {
             "$ref": "#/parameters/ApiVersionParameter"
           }
@@ -3977,7 +4001,7 @@
           }
         },
         "x-ms-examples": {
-          "PartnerTopics_Delete": {
+          "PrivateEndpointConnections_Update": {
             "$ref": "./examples/PrivateEndpointConnections_Update.json"
           }
         },
@@ -5404,7 +5428,6 @@
     },
     "PrivateEndpointConnection": {
       "type": "object",
-      "description": "PrivateEndpointConnection resource information.",
       "allOf": [
         {
           "$ref": "#/definitions/Resource"
@@ -5475,7 +5498,7 @@
       "x-ms-azure-resource": true
     },
     "PrivateEndpointConnectionProperties": {
-      "description": "Properties of the private endpoint connection resource",
+      "description": "Properties of the private endpoint connection resource.",
       "type": "object",
       "properties": {
         "privateEndpoint": {
@@ -5522,7 +5545,7 @@
       }
     },
     "ConnectionState": {
-      "description": "ConnectionState Information.",
+      "description": "ConnectionState information.",
       "type": "object",
       "properties": {
         "status": {
@@ -5721,8 +5744,8 @@
       }
     },
     "DomainUpdateParameterProperties": {
-      "type": "object",
       "description": "Information of domain update parameter properties.",
+      "type": "object",
       "properties": {
         "publicNetworkAccess": {
           "description": "This determines if traffic is allowed over public network. By default it is enabled. \r\nYou can further restrict to specific IPs by configuring <seealso cref=\"P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.DomainUpdateParameterProperties.InboundIpRules\" />",
@@ -5872,6 +5895,10 @@
             "name": "EventChannelProvisioningState",
             "modelAsString": true
           }
+        },
+        "filter": {
+          "$ref": "#/definitions/EventChannelFilter",
+          "description": "Information about the filter for the event channel."
         }
       }
     },
@@ -5903,145 +5930,20 @@
         }
       }
     },
-    "EventChannel": {
-      "description": "Event Channel.",
-      "type": "object",
-      "allOf": [
-        {
-          "$ref": "#/definitions/Resource"
-        }
-      ],
-      "properties": {
-        "properties": {
-          "$ref": "#/definitions/EventChannelProperties",
-          "description": "Properties of the EventChannel.",
-          "x-ms-client-flatten": true
-        }
-      }
-    },
-    "EventChannelsListResult": {
-      "description": "Result of the List Event Channels operation",
-      "type": "object",
-      "properties": {
-        "value": {
-          "description": "A collection of Event Channels",
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/EventChannel"
-          }
-        },
-        "nextLink": {
-          "description": "A link for the next page of event channels",
-          "type": "string"
-        }
-      }
-    },
-    "EventSubscriptionProperties": {
-      "description": "Properties of the Event Subscription.",
-      "type": "object",
-      "properties": {
-        "topic": {
-          "description": "Name of the topic of the event subscription.",
-          "type": "string",
-          "readOnly": true
-        },
-        "provisioningState": {
-          "description": "Provisioning state of the event subscription.",
-          "enum": [
-            "Creating",
-            "Updating",
-            "Deleting",
-            "Succeeded",
-            "Canceled",
-            "Failed",
-            "AwaitingManualAction"
-          ],
-          "type": "string",
-          "readOnly": true,
-          "x-ms-enum": {
-            "name": "EventSubscriptionProvisioningState",
-            "modelAsString": true
-          }
-        },
-        "destination": {
-          "$ref": "#/definitions/EventSubscriptionDestination",
-          "description": "Information about the destination where events have to be delivered for the event subscription.\r\nUses Azure Event Grid's identity to acquire the authentication tokens being used during delivery / dead-lettering."
-        },
-        "deliveryWithResourceIdentity": {
-          "$ref": "#/definitions/DeliveryWithResourceIdentity",
-          "description": "Information about the destination where events have to be delivered for the event subscription.\r\nUses the managed identity setup on the parent resource (namely, topic or domain) to acquire the authentication tokens being used during delivery / dead-lettering."
-        },
-        "filter": {
-          "$ref": "#/definitions/EventSubscriptionFilter",
-          "description": "Information about the filter for the event subscription."
-        },
-        "labels": {
-          "description": "List of user defined labels.",
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
-        },
-        "expirationTimeUtc": {
-          "format": "date-time",
-          "description": "Expiration time of the event subscription.",
-          "type": "string"
-        },
-        "eventDeliverySchema": {
-          "description": "The event delivery schema for the event subscription.",
-          "enum": [
-            "EventGridSchema",
-            "CustomInputSchema",
-            "CloudEventSchemaV1_0"
-          ],
-          "type": "string",
-          "x-ms-enum": {
-            "name": "EventDeliverySchema",
-            "modelAsString": true
-          }
-        },
-        "retryPolicy": {
-          "$ref": "#/definitions/RetryPolicy",
-          "description": "The retry policy for events. This can be used to configure maximum number of delivery attempts and time to live for events."
-        },
-        "deadLetterDestination": {
-          "$ref": "#/definitions/DeadLetterDestination",
-          "description": "The dead letter destination of the event subscription. Any event that cannot be delivered to its' destination is sent to the dead letter destination.\r\nUses Azure Event Grid's identity to acquire the authentication tokens being used during delivery / dead-lettering."
-        },
-        "deadLetterWithResourceIdentity": {
-          "$ref": "#/definitions/DeadLetterWithResourceIdentity",
-          "description": "The dead letter destination of the event subscription. Any event that cannot be delivered to its' destination is sent to the dead letter destination.\r\nUses the managed identity setup on the parent resource (namely, topic or domain) to acquire the authentication tokens being used during delivery / dead-lettering."
-        }
-      }
-    },
-    "DeliveryWithResourceIdentity": {
-      "description": "Information about the delivery for an event subscription with resource identity.",
-      "type": "object",
-      "properties": {
-        "identity": {
-          "$ref": "#/definitions/EventSubscriptionIdentity",
-          "description": "The identity to use when delivering events."
-        },
-        "destination": {
-          "$ref": "#/definitions/EventSubscriptionDestination",
-          "description": "Information about the destination where events have to be delivered for the event subscription.\r\nUses Azure Event Grid's identity to acquire the authentication tokens being used during delivery / dead-lettering."
-        }
-      }
-    },
-    "EventSubscriptionFilter": {
-      "description": "Filter for the Event Subscription.",
+    "EventChannelFilter": {
+      "description": "Filter for the Event Channel.",
       "type": "object",
       "properties": {
         "subjectBeginsWith": {
-          "description": "An optional string to filter events for an event subscription based on a resource path prefix.\r\nThe format of this depends on the publisher of the events.\r\nWildcard characters are not supported in this path.",
+          "description": "An optional string to filter events for an event channel based on a resource path prefix.\r\nThe format of this depends on the publisher of the events. Wildcard characters are not supported in this path.",
           "type": "string"
         },
         "subjectEndsWith": {
-          "description": "An optional string to filter events for an event subscription based on a resource path suffix.\r\nWildcard characters are not supported in this path.",
+          "description": "An optional string to filter events for an event channel based on a resource path suffix.\r\nWildcard characters are not supported in this path.",
           "type": "string"
         },
         "includedEventTypes": {
-          "description": "A list of applicable event types that need to be part of the event subscription. If it is desired to subscribe to all default event types, set the IncludedEventTypes to null.",
+          "description": "A list of applicable event types that need to be part of the event channel. If it is desired to subscribe to all default event types, set the IncludedEventTypes to null.",
           "type": "array",
           "items": {
             "type": "string"
@@ -6049,11 +5951,10 @@
         },
         "isSubjectCaseSensitive": {
           "description": "Specifies if the SubjectBeginsWith and SubjectEndsWith properties of the filter\r\nshould be compared in a case sensitive manner.",
-          "default": false,
           "type": "boolean"
         },
         "advancedFilters": {
-          "description": "An array of advanced filters that are used for filtering event subscriptions.",
+          "description": "An array of advanced filters that are used for filtering event channels.",
           "type": "array",
           "items": {
             "$ref": "#/definitions/AdvancedFilter"
@@ -6061,170 +5962,54 @@
         }
       }
     },
-    "RetryPolicy": {
-      "description": "Information about the retry policy for an event subscription.",
+    "NumberInAdvancedFilter": {
+      "description": "NumberIn Advanced Filter.",
       "type": "object",
-      "properties": {
-        "maxDeliveryAttempts": {
-          "format": "int32",
-          "description": "Maximum number of delivery retry attempts for events.",
-          "type": "integer"
-        },
-        "eventTimeToLiveInMinutes": {
-          "format": "int32",
-          "description": "Time To Live (in minutes) for events.",
-          "type": "integer"
+      "allOf": [
+        {
+          "$ref": "#/definitions/AdvancedFilter"
         }
-      }
-    },
-    "DeadLetterWithResourceIdentity": {
-      "description": "Information about the deadletter destination with resource identity.",
-      "type": "object",
+      ],
       "properties": {
-        "identity": {
-          "$ref": "#/definitions/EventSubscriptionIdentity",
-          "description": "The identity to use when dead-lettering events."
-        },
-        "deadLetterDestination": {
-          "$ref": "#/definitions/DeadLetterDestination",
-          "description": "Information about the destination where events have to be delivered for the event subscription.\r\nUses the managed identity setup on the parent resource (namely, topic or domain) to acquire the authentication tokens being used during delivery / dead-lettering."
+        "values": {
+          "description": "The set of filter values.",
+          "type": "array",
+          "items": {
+            "format": "double",
+            "type": "number"
+          }
         }
-      }
+      },
+      "x-ms-discriminator-value": "NumberIn"
     },
-    "EventSubscriptionIdentity": {
-      "description": "The identity information with the event subscription.",
+    "NumberNotInAdvancedFilter": {
+      "description": "NumberNotIn Advanced Filter.",
       "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/AdvancedFilter"
+        }
+      ],
       "properties": {
-        "type": {
-          "description": "The type of managed identity used. The type 'SystemAssigned, UserAssigned' includes both an implicitly created identity and a set of user-assigned identities. The type 'None' will remove any identity.",
-          "enum": [
-            "SystemAssigned",
-            "UserAssigned"
-          ],
-          "type": "string",
-          "x-ms-enum": {
-            "name": "EventSubscriptionIdentityType",
-            "modelAsString": true
+        "values": {
+          "description": "The set of filter values.",
+          "type": "array",
+          "items": {
+            "format": "double",
+            "type": "number"
           }
-        },
-        "userAssignedIdentity": {
-          "description": "The user identity associated with the resource.",
-          "type": "string"
         }
-      }
+      },
+      "x-ms-discriminator-value": "NumberNotIn"
     },
-    "WebHookEventSubscriptionDestinationProperties": {
-      "description": "Information about the webhook destination properties for an event subscription.",
+    "NumberLessThanAdvancedFilter": {
+      "description": "NumberLessThan Advanced Filter.",
       "type": "object",
-      "properties": {
-        "endpointUrl": {
-          "description": "The URL that represents the endpoint of the destination of an event subscription.",
-          "type": "string"
-        },
-        "endpointBaseUrl": {
-          "description": "The base URL that represents the endpoint of the destination of an event subscription.",
-          "type": "string",
-          "readOnly": true
-        },
-        "maxEventsPerBatch": {
-          "format": "int32",
-          "description": "Maximum number of events per batch.",
-          "type": "integer"
-        },
-        "preferredBatchSizeInKilobytes": {
-          "format": "int32",
-          "description": "Preferred batch size in Kilobytes.",
-          "type": "integer"
-        },
-        "azureActiveDirectoryTenantId": {
-          "description": "The Azure Active Directory Tenant ID to get the access token that will be included as the bearer token in delivery requests.",
-          "type": "string"
-        },
-        "azureActiveDirectoryApplicationIdOrUri": {
-          "description": "The Azure Active Directory Application ID or URI to get the access token that will be included as the bearer token in delivery requests.",
-          "type": "string"
-        }
-      }
-    },
-    "StorageBlobDeadLetterDestinationProperties": {
-      "description": "Properties of the storage blob based dead letter destination.",
-      "type": "object",
-      "properties": {
-        "resourceId": {
-          "description": "The Azure Resource ID of the storage account that is the destination of the deadletter events",
-          "type": "string"
-        },
-        "blobContainerName": {
-          "description": "The name of the Storage blob container that is the destination of the deadletter events",
-          "type": "string"
-        }
-      }
-    },
-    "NumberInAdvancedFilter": {
-      "description": "NumberIn Advanced Filter.",
-      "type": "object",
-      "allOf": [
-        {
-          "$ref": "#/definitions/AdvancedFilter"
-        }
-      ],
-      "properties": {
-        "values": {
-          "description": "The set of filter values.",
-          "type": "array",
-          "items": {
-            "format": "double",
-            "type": "number"
-          }
-        }
-      },
-      "x-ms-discriminator-value": "NumberIn"
-    },
-    "StorageBlobDeadLetterDestination": {
-      "description": "Information about the storage blob based dead letter destination.",
-      "type": "object",
-      "allOf": [
-        {
-          "$ref": "#/definitions/DeadLetterDestination"
-        }
-      ],
-      "properties": {
-        "properties": {
-          "$ref": "#/definitions/StorageBlobDeadLetterDestinationProperties",
-          "description": "The properties of the Storage Blob based deadletter destination",
-          "x-ms-client-flatten": true
-        }
-      },
-      "x-ms-discriminator-value": "StorageBlob"
-    },
-    "NumberNotInAdvancedFilter": {
-      "description": "NumberNotIn Advanced Filter.",
-      "type": "object",
-      "allOf": [
-        {
-          "$ref": "#/definitions/AdvancedFilter"
-        }
-      ],
-      "properties": {
-        "values": {
-          "description": "The set of filter values.",
-          "type": "array",
-          "items": {
-            "format": "double",
-            "type": "number"
-          }
-        }
-      },
-      "x-ms-discriminator-value": "NumberNotIn"
-    },
-    "NumberLessThanAdvancedFilter": {
-      "description": "NumberLessThan Advanced Filter.",
-      "type": "object",
-      "allOf": [
-        {
-          "$ref": "#/definitions/AdvancedFilter"
-        }
-      ],
+      "allOf": [
+        {
+          "$ref": "#/definitions/AdvancedFilter"
+        }
+      ],
       "properties": {
         "value": {
           "format": "double",
@@ -6432,6 +6217,280 @@
       },
       "discriminator": "operatorType"
     },
+    "EventChannel": {
+      "description": "Event Channel.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/Resource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/EventChannelProperties",
+          "description": "Properties of the EventChannel.",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "EventChannelsListResult": {
+      "description": "Result of the List Event Channels operation",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "A collection of Event Channels",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/EventChannel"
+          }
+        },
+        "nextLink": {
+          "description": "A link for the next page of event channels",
+          "type": "string"
+        }
+      }
+    },
+    "EventSubscriptionProperties": {
+      "description": "Properties of the Event Subscription.",
+      "type": "object",
+      "properties": {
+        "topic": {
+          "description": "Name of the topic of the event subscription.",
+          "type": "string",
+          "readOnly": true
+        },
+        "provisioningState": {
+          "description": "Provisioning state of the event subscription.",
+          "enum": [
+            "Creating",
+            "Updating",
+            "Deleting",
+            "Succeeded",
+            "Canceled",
+            "Failed",
+            "AwaitingManualAction"
+          ],
+          "type": "string",
+          "readOnly": true,
+          "x-ms-enum": {
+            "name": "EventSubscriptionProvisioningState",
+            "modelAsString": true
+          }
+        },
+        "destination": {
+          "$ref": "#/definitions/EventSubscriptionDestination",
+          "description": "Information about the destination where events have to be delivered for the event subscription.\r\nUses Azure Event Grid's identity to acquire the authentication tokens being used during delivery / dead-lettering."
+        },
+        "deliveryWithResourceIdentity": {
+          "$ref": "#/definitions/DeliveryWithResourceIdentity",
+          "description": "Information about the destination where events have to be delivered for the event subscription.\r\nUses the managed identity setup on the parent resource (namely, topic or domain) to acquire the authentication tokens being used during delivery / dead-lettering."
+        },
+        "filter": {
+          "$ref": "#/definitions/EventSubscriptionFilter",
+          "description": "Information about the filter for the event subscription."
+        },
+        "labels": {
+          "description": "List of user defined labels.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "expirationTimeUtc": {
+          "format": "date-time",
+          "description": "Expiration time of the event subscription.",
+          "type": "string"
+        },
+        "eventDeliverySchema": {
+          "description": "The event delivery schema for the event subscription.",
+          "enum": [
+            "EventGridSchema",
+            "CustomInputSchema",
+            "CloudEventSchemaV1_0"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "EventDeliverySchema",
+            "modelAsString": true
+          }
+        },
+        "retryPolicy": {
+          "$ref": "#/definitions/RetryPolicy",
+          "description": "The retry policy for events. This can be used to configure maximum number of delivery attempts and time to live for events."
+        },
+        "deadLetterDestination": {
+          "$ref": "#/definitions/DeadLetterDestination",
+          "description": "The dead letter destination of the event subscription. Any event that cannot be delivered to its' destination is sent to the dead letter destination.\r\nUses Azure Event Grid's identity to acquire the authentication tokens being used during delivery / dead-lettering."
+        },
+        "deadLetterWithResourceIdentity": {
+          "$ref": "#/definitions/DeadLetterWithResourceIdentity",
+          "description": "The dead letter destination of the event subscription. Any event that cannot be delivered to its' destination is sent to the dead letter destination.\r\nUses the managed identity setup on the parent resource (namely, topic or domain) to acquire the authentication tokens being used during delivery / dead-lettering."
+        }
+      }
+    },
+    "DeliveryWithResourceIdentity": {
+      "description": "Information about the delivery for an event subscription with resource identity.",
+      "type": "object",
+      "properties": {
+        "identity": {
+          "$ref": "#/definitions/EventSubscriptionIdentity",
+          "description": "The identity to use when delivering events."
+        },
+        "destination": {
+          "$ref": "#/definitions/EventSubscriptionDestination",
+          "description": "Information about the destination where events have to be delivered for the event subscription.\r\nUses Azure Event Grid's identity to acquire the authentication tokens being used during delivery / dead-lettering."
+        }
+      }
+    },
+    "EventSubscriptionFilter": {
+      "description": "Filter for the Event Subscription.",
+      "type": "object",
+      "properties": {
+        "subjectBeginsWith": {
+          "description": "An optional string to filter events for an event subscription based on a resource path prefix.\r\nThe format of this depends on the publisher of the events.\r\nWildcard characters are not supported in this path.",
+          "type": "string"
+        },
+        "subjectEndsWith": {
+          "description": "An optional string to filter events for an event subscription based on a resource path suffix.\r\nWildcard characters are not supported in this path.",
+          "type": "string"
+        },
+        "includedEventTypes": {
+          "description": "A list of applicable event types that need to be part of the event subscription. If it is desired to subscribe to all default event types, set the IncludedEventTypes to null.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "isSubjectCaseSensitive": {
+          "description": "Specifies if the SubjectBeginsWith and SubjectEndsWith properties of the filter\r\nshould be compared in a case sensitive manner.",
+          "default": false,
+          "type": "boolean"
+        },
+        "advancedFilters": {
+          "description": "An array of advanced filters that are used for filtering event subscriptions.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/AdvancedFilter"
+          }
+        }
+      }
+    },
+    "RetryPolicy": {
+      "description": "Information about the retry policy for an event subscription.",
+      "type": "object",
+      "properties": {
+        "maxDeliveryAttempts": {
+          "format": "int32",
+          "description": "Maximum number of delivery retry attempts for events.",
+          "type": "integer"
+        },
+        "eventTimeToLiveInMinutes": {
+          "format": "int32",
+          "description": "Time To Live (in minutes) for events.",
+          "type": "integer"
+        }
+      }
+    },
+    "DeadLetterWithResourceIdentity": {
+      "description": "Information about the deadletter destination with resource identity.",
+      "type": "object",
+      "properties": {
+        "identity": {
+          "$ref": "#/definitions/EventSubscriptionIdentity",
+          "description": "The identity to use when dead-lettering events."
+        },
+        "deadLetterDestination": {
+          "$ref": "#/definitions/DeadLetterDestination",
+          "description": "Information about the destination where events have to be delivered for the event subscription.\r\nUses the managed identity setup on the parent resource (namely, topic or domain) to acquire the authentication tokens being used during delivery / dead-lettering."
+        }
+      }
+    },
+    "EventSubscriptionIdentity": {
+      "description": "The identity information with the event subscription.",
+      "type": "object",
+      "properties": {
+        "type": {
+          "description": "The type of managed identity used. The type 'SystemAssigned, UserAssigned' includes both an implicitly created identity and a set of user-assigned identities. The type 'None' will remove any identity.",
+          "enum": [
+            "SystemAssigned",
+            "UserAssigned"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "EventSubscriptionIdentityType",
+            "modelAsString": true
+          }
+        },
+        "userAssignedIdentity": {
+          "description": "The user identity associated with the resource.",
+          "type": "string"
+        }
+      }
+    },
+    "WebHookEventSubscriptionDestinationProperties": {
+      "description": "Information about the webhook destination properties for an event subscription.",
+      "type": "object",
+      "properties": {
+        "endpointUrl": {
+          "description": "The URL that represents the endpoint of the destination of an event subscription.",
+          "type": "string"
+        },
+        "endpointBaseUrl": {
+          "description": "The base URL that represents the endpoint of the destination of an event subscription.",
+          "type": "string",
+          "readOnly": true
+        },
+        "maxEventsPerBatch": {
+          "format": "int32",
+          "description": "Maximum number of events per batch.",
+          "type": "integer"
+        },
+        "preferredBatchSizeInKilobytes": {
+          "format": "int32",
+          "description": "Preferred batch size in Kilobytes.",
+          "type": "integer"
+        },
+        "azureActiveDirectoryTenantId": {
+          "description": "The Azure Active Directory Tenant ID to get the access token that will be included as the bearer token in delivery requests.",
+          "type": "string"
+        },
+        "azureActiveDirectoryApplicationIdOrUri": {
+          "description": "The Azure Active Directory Application ID or URI to get the access token that will be included as the bearer token in delivery requests.",
+          "type": "string"
+        }
+      }
+    },
+    "StorageBlobDeadLetterDestinationProperties": {
+      "description": "Properties of the storage blob based dead letter destination.",
+      "type": "object",
+      "properties": {
+        "resourceId": {
+          "description": "The Azure Resource ID of the storage account that is the destination of the deadletter events",
+          "type": "string"
+        },
+        "blobContainerName": {
+          "description": "The name of the Storage blob container that is the destination of the deadletter events",
+          "type": "string"
+        }
+      }
+    },
+    "StorageBlobDeadLetterDestination": {
+      "description": "Information about the storage blob based dead letter destination.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeadLetterDestination"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/StorageBlobDeadLetterDestinationProperties",
+          "description": "The properties of the Storage Blob based deadletter destination",
+          "x-ms-client-flatten": true
+        }
+      },
+      "x-ms-discriminator-value": "StorageBlob"
+    },
     "WebHookEventSubscriptionDestination": {
       "description": "Information about the webhook destination for an event subscription.",
       "type": "object",
@@ -7021,6 +7080,13 @@
       "description": "Properties of the Partner Registration update.",
       "type": "object",
       "properties": {
+        "tags": {
+          "description": "Tags of the partner registration resource.",
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
         "partnerTopicTypeName": {
           "description": "Name of the partner topic type.",
           "type": "string"
@@ -7122,6 +7188,19 @@
         }
       }
     },
+    "PartnerTopicUpdateParameters": {
+      "description": "Properties of the Partner Topic update.",
+      "type": "object",
+      "properties": {
+        "tags": {
+          "description": "Tags of the partner topic.",
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      }
+    },
     "PartnerTopicProperties": {
       "description": "Properties of the Partner Topic.",
       "type": "object",
@@ -7178,19 +7257,6 @@
         }
       }
     },
-    "PartnerTopicUpdateParameters": {
-      "description": "Properties of the Partner Topic update.",
-      "type": "object",
-      "properties": {
-        "tags": {
-          "description": "Tags of the partner topic.",
-          "type": "object",
-          "additionalProperties": {
-            "type": "string"
-          }
-        }
-      }
-    },
     "PartnerTopicsListResult": {
       "description": "Result of the List Partner Topics operation.",
       "type": "object",
@@ -7307,8 +7373,8 @@
       }
     },
     "PrivateLinkResource": {
-      "type": "object",
       "description": "Information of the private link resource.",
+      "type": "object",
       "properties": {
         "properties": {
           "$ref": "#/definitions/PrivateLinkResourceProperties",
@@ -7369,40 +7435,6 @@
         }
       }
     },
-    "SkuDefinitionsForResourceTypeListResult": {
-      "description": "List collection of Sku Definitions for each Resource Type.",
-      "type": "object",
-      "properties": {
-        "value": {
-          "description": "A collection of Sku Definitions for each Resource Type.",
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/SkuDefinitionsForResourceType"
-          }
-        },
-        "nextLink": {
-          "description": "A link for the next page of Sku Definitions.",
-          "type": "string"
-        }
-      }
-    },
-    "SkuDefinitionsForResourceType": {
-      "description": "Describes an EventGrid Resource Sku Definition.",
-      "type": "object",
-      "properties": {
-        "resourceType": {
-          "description": "The Resource Type applicable for the Sku.",
-          "type": "string"
-        },
-        "skus": {
-          "description": "The Sku pricing tiers for the resource type.",
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/ResourceSku"
-          }
-        }
-      }
-    },
     "SystemTopicProperties": {
       "description": "Properties of the System Topic.",
       "type": "object",
@@ -7490,7 +7522,6 @@
       "type": "object",
       "properties": {
         "privateEndpointConnections": {
-          "description": "List of private endpoint connections.",
           "type": "array",
           "items": {
             "$ref": "#/definitions/PrivateEndpointConnection"
@@ -7598,8 +7629,8 @@
           }
         },
         "identity": {
-          "description": "Resource identity information.",
-          "$ref": "#/definitions/IdentityInfo"
+          "$ref": "#/definitions/IdentityInfo",
+          "description": "Resource identity information."
         },
         "properties": {
           "$ref": "#/definitions/TopicUpdateParameterProperties",
diff --git a/specification/eventgrid/resource-manager/Microsoft.EventGrid/preview/2020-04-01-preview/examples/PrivateEndpointConnections_Update.json b/specification/eventgrid/resource-manager/Microsoft.EventGrid/preview/2020-04-01-preview/examples/PrivateEndpointConnections_Update.json
index 532a2e9b343d..05dbe5771842 100644
--- a/specification/eventgrid/resource-manager/Microsoft.EventGrid/preview/2020-04-01-preview/examples/PrivateEndpointConnections_Update.json
+++ b/specification/eventgrid/resource-manager/Microsoft.EventGrid/preview/2020-04-01-preview/examples/PrivateEndpointConnections_Update.json
@@ -5,7 +5,16 @@
     "parentType": "topics",
     "parentName": "exampletopic1",
     "privateEndpointConnectionName": "BMTPE5.8A30D251-4C61-489D-A1AA-B37C4A329B8B",
-    "api-version": "2020-04-01-preview"
+    "api-version": "2020-04-01-preview",
+    "privateEndpointConnection": {
+      "properties": {
+        "privateLinkServiceConnectionState": {
+          "status": "Approved",
+          "description": "approving connection",
+          "actionsRequired": "None"
+        }
+      }
+    }
   },
   "responses": {
     "200": {
@@ -18,8 +27,8 @@
             "topic"
           ],
           "privateLinkServiceConnectionState": {
-            "status": "Pending",
-            "description": "Test",
+            "status": "Approved",
+            "description": "approving connection",
             "actionsRequired": "None"
           },
           "provisioningState": "Succeeded"
@@ -39,8 +48,8 @@
             "topic"
           ],
           "privateLinkServiceConnectionState": {
-            "status": "Pending",
-            "description": "Test",
+            "status": "Approved",
+            "description": "approving connection",
             "actionsRequired": "None"
           },
           "provisioningState": "Succeeded"
diff --git a/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/ProviderInstances_Create.json b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/ProviderInstances_Create.json
new file mode 100644
index 000000000000..3df0e7631d11
--- /dev/null
+++ b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/ProviderInstances_Create.json
@@ -0,0 +1,40 @@
+{
+  "parameters": {
+    "api-version": "2020-02-07-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "myResourceGroup",
+    "sapMonitorName": "mySapMonitor",
+    "providerInstanceName": "myProviderInstance",
+    "providerInstanceParameter": {
+      "name": "myProviderInstance",
+      "properties": {
+        "type": "hana",
+        "properties": "{\"hostname\":\"10.0.0.10\",\"dbName\":\"SYSTEMDB\",\"sqlPort\":30015,\"dbUsername\":\"SYSTEM\",\"dbPassword\":\"PASSWORD\"}"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.HanaOnAzure/sapMonitors/mySapMonitor/providerInstances/myProviderInstance",
+        "name": "myProviderInstance",
+        "type": "Microsoft.HanaOnAzure/sapMonitors/providerInstances",
+        "properties": {
+          "type": "hana",
+          "properties": "{\"hostname\":\"10.0.0.10\",\"dbName\":\"SYSTEMDB\",\"sqlPort\":30015,\"dbUsername\":\"SYSTEM\"}"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.HanaOnAzure/sapMonitors/mySapMonitor/providerInstances/myProviderInstance",
+        "name": "myProviderInstance",
+        "type": "Microsoft.HanaOnAzure/sapMonitors/providerInstances",
+        "properties": {
+          "type": "hana",
+          "properties": "{\"hostname\":\"10.0.0.10\",\"dbName\":\"SYSTEMDB\",\"sqlPort\":30015,\"dbUsername\":\"SYSTEM\"}"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/ProviderInstances_Delete.json b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/ProviderInstances_Delete.json
new file mode 100644
index 000000000000..1e0a487fc052
--- /dev/null
+++ b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/ProviderInstances_Delete.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "api-version": "2020-02-07-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "myResourceGroup",
+    "sapMonitorName": "mySapMonitor",
+    "providerInstanceName": "myProviderInstance"
+  },
+  "responses": {
+    "200": {},
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/ProviderInstances_Get.json b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/ProviderInstances_Get.json
new file mode 100644
index 000000000000..e149fb1ae2cc
--- /dev/null
+++ b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/ProviderInstances_Get.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "api-version": "2020-02-07-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "myResourceGroup",
+    "sapMonitorName": "mySapMonitor",
+    "providerInstanceName": "myProviderInstance"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.HanaOnAzure/sapMonitors/mySapMonitor/providerInstances/myProviderInstance",
+        "name": "myProviderInstance",
+        "type": "Microsoft.HanaOnAzure/sapMonitors/providerInstances",
+        "properties": {
+          "type": "hana",
+          "properties": "{\"hostname\":\"10.0.0.10\",\"dbName\":\"SYSTEMDB\",\"sqlPort\":30015,\"dbUsername\":\"SYSTEM\"}"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/ProviderInstances_List.json b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/ProviderInstances_List.json
new file mode 100644
index 000000000000..746caacf9576
--- /dev/null
+++ b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/ProviderInstances_List.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "api-version": "2020-02-07-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "myResourceGroup",
+    "sapMonitorName": "mySapMonitor"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.HanaOnAzure/sapMonitors/mySapMonitor/providerInstances/myProviderInstance1",
+            "name": "myProviderInstance1",
+            "type": "Microsoft.HanaOnAzure/sapMonitors/providerInstances",
+            "properties": {
+              "type": "hana",
+              "properties": "{\"hostname\":\"10.0.0.10\",\"dbName\":\"SYSTEMDB\",\"sqlPort\":30015,\"dbUsername\":\"SYSTEM\"}"
+            }
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.HanaOnAzure/sapMonitors/mySapMonitor/providerInstances/myProviderInstance2",
+            "name": "myProviderInstance2",
+            "type": "Microsoft.HanaOnAzure/sapMonitors/providerInstances",
+            "properties": {
+              "type": "hana",
+              "properties": "{\"hostname\":\"10.0.0.11\",\"dbName\":\"SYSTEMDB\",\"sqlPort\":30015,\"dbUsername\":\"SYSTEM\"}"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/SapMonitors_Create.json b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/SapMonitors_Create.json
new file mode 100644
index 000000000000..055f3a318453
--- /dev/null
+++ b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/SapMonitors_Create.json
@@ -0,0 +1,65 @@
+{
+  "parameters": {
+    "api-version": "2020-02-07-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "myResourceGroup",
+    "sapMonitorName": "mySapMonitor",
+    "sapMonitorParameter": {
+      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.HanaOnAzure/sapMonitors/mySapMonitor",
+      "name": "mySapMonitor",
+      "type": "Microsoft.HanaOnAzure/sapMonitors",
+      "location": "westus",
+      "tags": {
+        "key": "value"
+      },
+      "properties": {
+        "enableCustomerAnalytics": true,
+        "logAnalyticsWorkspaceArmId": "",
+        "logAnalyticsWorkspaceId": "",
+        "logAnalyticsWorkspaceSharedKey": ""
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.HanaOnAzure/hanaInstances/myHanaInstance",
+        "name": "myHanaInstance",
+        "type": "Microsoft.HanaOnAzure/hanaInstances",
+        "location": "westus",
+        "tags": {
+          "key": "value"
+        },
+        "properties": {
+          "enableCustomerAnalytics": true,
+          "logAnalyticsWorkspaceArmId": "",
+          "logAnalyticsWorkspaceId": "",
+          "logAnalyticsWorkspaceSharedKey": "",
+          "managedResourceGroupName": "",
+          "sapMonitorCollectorVersion": "",
+          "provisioningState": "Succeeded"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.HanaOnAzure/hanaInstances/myHanaInstance",
+        "name": "myHanaInstance",
+        "type": "Microsoft.HanaOnAzure/hanaInstances",
+        "location": "westus",
+        "tags": {
+          "key": "value"
+        },
+        "properties": {
+          "enableCustomerAnalytics": true,
+          "logAnalyticsWorkspaceArmId": "",
+          "logAnalyticsWorkspaceId": "",
+          "logAnalyticsWorkspaceSharedKey": "",
+          "managedResourceGroupName": "",
+          "sapMonitorCollectorVersion": "",
+          "provisioningState": "Accepted"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/SapMonitors_Delete.json b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/SapMonitors_Delete.json
new file mode 100644
index 000000000000..94841d22526a
--- /dev/null
+++ b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/SapMonitors_Delete.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "api-version": "2020-02-07-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "myResourceGroup",
+    "sapMonitorName": "mySapMonitor"
+  },
+  "responses": {
+    "200": {},
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/SapMonitors_Get.json b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/SapMonitors_Get.json
new file mode 100644
index 000000000000..ff22fcd5be25
--- /dev/null
+++ b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/SapMonitors_Get.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "api-version": "2020-02-07-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "myResourceGroup",
+    "sapMonitorName": "mySapMonitor"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.HanaOnAzure/sapMonitors/mySapMonitor",
+        "name": "mySapMonitor",
+        "type": "Microsoft.HanaOnAzure/sapMonitors",
+        "location": "westus",
+        "tags": {
+          "key": "value"
+        },
+        "properties": {
+          "enableCustomerAnalytics": true,
+          "logAnalyticsWorkspaceArmId": "",
+          "logAnalyticsWorkspaceId": "",
+          "logAnalyticsWorkspaceSharedKey": "",
+          "managedResourceGroupName": "",
+          "sapMonitorCollectorVersion": "",
+          "provisioningState": "Succeeded"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/SapMonitors_List.json b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/SapMonitors_List.json
new file mode 100644
index 000000000000..d8706519f371
--- /dev/null
+++ b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/SapMonitors_List.json
@@ -0,0 +1,50 @@
+{
+  "parameters": {
+    "api-version": "2020-02-07-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.HanaOnAzure/sapMonitors/mySapMonitor1",
+            "name": "mySapMonitor1",
+            "type": "Microsoft.HanaOnAzure/sapMonitors",
+            "location": "westus",
+            "tags": {
+              "key": "value"
+            },
+            "properties": {
+              "enableCustomerAnalytics": true,
+              "logAnalyticsWorkspaceArmId": "",
+              "logAnalyticsWorkspaceId": "",
+              "logAnalyticsWorkspaceSharedKey": "",
+              "managedResourceGroupName": "",
+              "sapMonitorCollectorVersion": "",
+              "provisioningState": "Succeeded"
+            }
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.HanaOnAzure/sapMonitors/mySapMonitor2",
+            "name": "mySapMonitor2",
+            "type": "Microsoft.HanaOnAzure/sapMonitors",
+            "location": "westus",
+            "tags": {
+              "key": "value"
+            },
+            "properties": {
+              "enableCustomerAnalytics": true,
+              "logAnalyticsWorkspaceArmId": "",
+              "logAnalyticsWorkspaceId": "",
+              "logAnalyticsWorkspaceSharedKey": "",
+              "managedResourceGroupName": "",
+              "sapMonitorCollectorVersion": "",
+              "provisioningState": "Succeeded"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/SapMonitors_PatchTags.json b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/SapMonitors_PatchTags.json
new file mode 100644
index 000000000000..0e4796827ea7
--- /dev/null
+++ b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/SapMonitors_PatchTags.json
@@ -0,0 +1,35 @@
+{
+  "parameters": {
+    "api-version": "2020-02-07-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "myResourceGroup",
+    "sapMonitorName": "mySapMonitor",
+    "tagsParameter": {
+      "tags": {
+        "testkey": "testvalue"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.HanaOnAzure/sapMonitors/mySapMonitor",
+        "name": "mySapMonitor",
+        "type": "Microsoft.HanaOnAzure/sapMonitors",
+        "location": "westus",
+        "tags": {
+          "testkey": "testvalue"
+        },
+        "properties": {
+          "enableCustomerAnalytics": true,
+          "logAnalyticsWorkspaceArmId": "",
+          "logAnalyticsWorkspaceId": "",
+          "logAnalyticsWorkspaceSharedKey": "",
+          "managedResourceGroupName": "",
+          "sapMonitorCollectorVersion": "",
+          "provisioningState": "Succeeded"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/SapMonitors_PatchTags_Delete.json b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/SapMonitors_PatchTags_Delete.json
new file mode 100644
index 000000000000..08aabdc9078d
--- /dev/null
+++ b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/examples/SapMonitors_PatchTags_Delete.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "api-version": "2020-02-07-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "myResourceGroup",
+    "sapMonitorName": "mySapMonitor",
+    "tagsParameter": {
+      "tags": {}
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.HanaOnAzure/sapMonitors/mySapMonitor",
+        "name": "mySapMonitor",
+        "type": "Microsoft.HanaOnAzure/sapMonitors",
+        "location": "westus",
+        "tags": {},
+        "properties": {
+          "enableCustomerAnalytics": true,
+          "logAnalyticsWorkspaceArmId": "",
+          "logAnalyticsWorkspaceId": "",
+          "logAnalyticsWorkspaceSharedKey": "",
+          "managedResourceGroupName": "",
+          "sapMonitorCollectorVersion": "",
+          "provisioningState": "Succeeded"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/hanaonazure.json b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/hanaonazure.json
new file mode 100644
index 000000000000..de62afbb7180
--- /dev/null
+++ b/specification/hanaonazure/resource-manager/Microsoft.HanaOnAzure/preview/2020-02-07-preview/hanaonazure.json
@@ -0,0 +1,757 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "HanaManagementClient",
+    "description": "The SAP HANA on Azure Management Client.",
+    "version": "2020-02-07-preview"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/providers/Microsoft.HanaOnAzure/sapMonitors": {
+      "get": {
+        "tags": [
+          "HanaOnAzure"
+        ],
+        "operationId": "SapMonitors_List",
+        "summary": "Gets a list of SAP monitors in the specified subscription.",
+        "description": "Gets a list of SAP monitors in the specified subscription. The operations returns various properties of each SAP monitor.",
+        "x-ms-examples": {
+          "List all SAP Monitors in a subscription": {
+            "$ref": "./examples/SapMonitors_List.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/SapMonitorListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HanaOnAzure/sapMonitors/{sapMonitorName}": {
+      "get": {
+        "tags": [
+          "HanaOnAzure"
+        ],
+        "operationId": "SapMonitors_Get",
+        "summary": "Gets properties of a SAP monitor.",
+        "description": "Gets properties of a SAP monitor for the specified subscription, resource group, and resource name.",
+        "x-ms-examples": {
+          "Get properties of a SAP monitor": {
+            "$ref": "./examples/SapMonitors_Get.json"
+          }
+        },
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/SapMonitorNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/SapMonitor"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "HanaOnAzure"
+        ],
+        "operationId": "SapMonitors_Create",
+        "x-ms-long-running-operation": true,
+        "summary": "Creates a SAP monitor.",
+        "description": "Creates a SAP monitor for the specified subscription, resource group, and resource name.",
+        "x-ms-examples": {
+          "Create a SAP Monitor": {
+            "$ref": "./examples/SapMonitors_Create.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/SapMonitorNameParameter"
+          },
+          {
+            "$ref": "#/parameters/SapMonitorParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Created SapMonitor",
+            "schema": {
+              "$ref": "#/definitions/SapMonitor"
+            }
+          },
+          "201": {
+            "description": "Creating SapMonitor",
+            "schema": {
+              "$ref": "#/definitions/SapMonitor"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "HanaOnAzure"
+        ],
+        "operationId": "SapMonitors_Delete",
+        "x-ms-long-running-operation": true,
+        "summary": "Deletes a SAP monitor.",
+        "description": "Deletes a SAP monitor with the specified subscription, resource group, and monitor name.",
+        "x-ms-examples": {
+          "Deletes a SAP monitor": {
+            "$ref": "./examples/SapMonitors_Delete.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/SapMonitorNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Deleted SapMonitor"
+          },
+          "202": {
+            "description": "Deleting SapMonitor"
+          },
+          "204": {
+            "description": "No SapMonitor to delete"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "HanaOnAzure"
+        ],
+        "operationId": "SapMonitors_Update",
+        "summary": "Patches the Tags field of a SAP monitor.",
+        "description": "Patches the Tags field of a SAP monitor for the specified subscription, resource group, and monitor name.",
+        "x-ms-examples": {
+          "Update Tags field of a SAP monitor": {
+            "$ref": "./examples/SapMonitors_PatchTags.json"
+          },
+          "Delete Tags field of a SAP monitor": {
+            "$ref": "./examples/SapMonitors_PatchTags_Delete.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/SapMonitorNameParameter"
+          },
+          {
+            "$ref": "#/parameters/TagsParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/SapMonitor"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HanaOnAzure/sapMonitors/{sapMonitorName}/providerInstances": {
+      "get": {
+        "tags": [
+          "HanaOnAzure"
+        ],
+        "operationId": "ProviderInstances_List",
+        "summary": "Gets a list of provider instances in the specified SAP monitor.",
+        "description": "Gets a list of provider instances in the specified SAP monitor. The operations returns various properties of each provider instances.",
+        "x-ms-examples": {
+          "List all SAP Monitors in a subscription": {
+            "$ref": "./examples/ProviderInstances_List.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/SapMonitorNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ProviderInstanceListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HanaOnAzure/sapMonitors/{sapMonitorName}/providerInstances/{providerInstanceName}": {
+      "get": {
+        "tags": [
+          "HanaOnAzure"
+        ],
+        "operationId": "ProviderInstances_Get",
+        "summary": "Gets properties of a provider instance.",
+        "description": "Gets properties of a provider instance for the specified subscription, resource group, SapMonitor name, and resource name.",
+        "x-ms-examples": {
+          "Get properties of a SAP monitor": {
+            "$ref": "./examples/ProviderInstances_Get.json"
+          }
+        },
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/SapMonitorNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ProviderInstanceNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ProviderInstance"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "HanaOnAzure"
+        ],
+        "operationId": "ProviderInstance_Create",
+        "x-ms-long-running-operation": true,
+        "summary": "Creates a provider instance.",
+        "description": "Creates a provider instance for the specified subscription, resource group, SapMonitor name, and resource name.",
+        "x-ms-examples": {
+          "Create a SAP Monitor": {
+            "$ref": "./examples/ProviderInstances_Create.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/SapMonitorNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ProviderInstanceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ProviderInstanceParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Created provider instance",
+            "schema": {
+              "$ref": "#/definitions/ProviderInstance"
+            }
+          },
+          "201": {
+            "description": "Creating provider instance",
+            "schema": {
+              "$ref": "#/definitions/ProviderInstance"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "HanaOnAzure"
+        ],
+        "operationId": "ProviderInstance_Delete",
+        "x-ms-long-running-operation": true,
+        "summary": "Deletes a provider instance.",
+        "description": "Deletes a provider instance for the specified subscription, resource group, SapMonitor name, and resource name.",
+        "x-ms-examples": {
+          "Deletes a SAP monitor": {
+            "$ref": "./examples/ProviderInstances_Delete.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/SapMonitorNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ProviderInstanceNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Deleted provider instance"
+          },
+          "202": {
+            "description": "Deleting provider instance"
+          },
+          "204": {
+            "description": "No provider instance to delete"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "Resource": {
+      "description": "The core properties of ARM resources",
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Fully qualified resource Id for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName}"
+        },
+        "name": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The name of the resource"
+        },
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The type of the resource. Ex- Microsoft.Network/trafficManagerProfiles."
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "TrackedResource": {
+      "description": "The resource model definition for a ARM tracked top level resource",
+      "properties": {
+        "tags": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "x-ms-mutability": [
+            "read",
+            "create",
+            "update"
+          ],
+          "description": "Resource tags."
+        },
+        "location": {
+          "type": "string",
+          "x-ms-mutability": [
+            "read",
+            "create"
+          ],
+          "description": "The Azure Region where the resource lives"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/Resource"
+        }
+      ]
+    },
+    "ProxyResource": {
+      "description": "The resource model definition for a ARM proxy resource. It will have everything other than required location and tags",
+      "allOf": [
+        {
+          "$ref": "#/definitions/Resource"
+        }
+      ]
+    },
+    "ErrorResponse": {
+      "description": "Describes the format of Error response.",
+      "type": "object",
+      "properties": {
+        "code": {
+          "description": "Error code",
+          "type": "string"
+        },
+        "message": {
+          "description": "Error message indicating why the operation failed.",
+          "type": "string"
+        }
+      }
+    },
+    "Tags": {
+      "type": "object",
+      "properties": {
+        "tags": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Tags field of the resource."
+        }
+      },
+      "description": "Tags field of the resource."
+    },
+    "SapMonitorListResult": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SapMonitor"
+          },
+          "description": "The list of SAP monitors."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "The URL to get the next set of SAP monitors."
+        }
+      },
+      "description": "The response from the List SAP monitors operation."
+    },
+    "SapMonitor": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/SapMonitorProperties",
+          "description": "SAP monitor properties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/TrackedResource"
+        }
+      ],
+      "description": "SAP monitor info on Azure (ARM properties and SAP monitor properties)"
+    },
+    "SapMonitorProperties": {
+      "properties": {
+        "provisioningState": {
+          "readOnly": true,
+          "type": "string",
+          "enum": [
+            "Accepted",
+            "Creating",
+            "Updating",
+            "Failed",
+            "Succeeded",
+            "Deleting",
+            "Migrating"
+          ],
+          "x-ms-enum": {
+            "name": "HanaProvisioningStatesEnum",
+            "modelAsString": true
+          },
+          "description": "State of provisioning of the HanaInstance"
+        },
+        "managedResourceGroupName": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The name of the resource group the SAP Monitor resources get deployed into."
+        },
+        "logAnalyticsWorkspaceArmId": {
+          "type": "string",
+          "description": "The ARM ID of the Log Analytics Workspace that is used for monitoring"
+        },
+        "enableCustomerAnalytics": {
+          "type": "boolean",
+          "description": "The value indicating whether to send analytics to Microsoft"
+        },
+        "logAnalyticsWorkspaceId": {
+          "type": "string",
+          "description": "The workspace ID of the log analytics workspace to be used for monitoring"
+        },
+        "logAnalyticsWorkspaceSharedKey": {
+          "type": "string",
+          "description": "The shared key of the log analytics workspace that is used for monitoring"
+        },
+        "sapMonitorCollectorVersion": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The version of the payload running in the Collector VM"
+        }
+      },
+      "description": "Describes the properties of a SAP monitor."
+    },
+    "ProviderInstanceListResult": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ProviderInstance"
+          },
+          "description": "The list of provider instances."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "The URL to get the next set of provider instances."
+        }
+      },
+      "description": "The response from the List provider instances operation."
+    },
+    "ProviderInstance": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ProviderInstanceProperties",
+          "description": "Provider Instance properties"
+        },
+        "provisioningState": {
+          "readOnly": true,
+          "type": "string",
+          "enum": [
+            "Accepted",
+            "Creating",
+            "Updating",
+            "Failed",
+            "Succeeded",
+            "Deleting",
+            "Migrating"
+          ],
+          "x-ms-enum": {
+            "name": "HanaProvisioningStatesEnum",
+            "modelAsString": true
+          },
+          "description": "State of provisioning of the provider instance"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ProxyResource"
+        }
+      ],
+      "description": "A provider instance associated with a SAP monitor."
+    },
+    "ProviderInstanceProperties": {
+      "properties": {
+        "type": {
+          "type": "string",
+          "description": "The type of provider instance."
+        },
+        "properties": {
+          "type": "string",
+          "description": "A JSON string containing the properties of the provider instance."
+        }
+      },
+      "description": "Describes the properties of a provider instance."
+    }
+  },
+  "parameters": {
+    "SubscriptionIdParameter": {
+      "name": "subscriptionId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
+    },
+    "ResourceGroupNameParameter": {
+      "name": "resourceGroupName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Name of the resource group.",
+      "x-ms-parameter-location": "method"
+    },
+    "SapMonitorNameParameter": {
+      "name": "sapMonitorName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Name of the SAP monitor resource.",
+      "x-ms-parameter-location": "method"
+    },
+    "ProviderInstanceNameParameter": {
+      "name": "providerInstanceName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Name of the provider instance.",
+      "x-ms-parameter-location": "method"
+    },
+    "ApiVersionParameter": {
+      "name": "api-version",
+      "in": "query",
+      "required": true,
+      "type": "string",
+      "description": "Client API version."
+    },
+    "TagsParameter": {
+      "name": "tagsParameter",
+      "in": "body",
+      "required": true,
+      "schema": {
+        "$ref": "#/definitions/Tags"
+      },
+      "description": "Request body that only contains the new Tags field",
+      "x-ms-parameter-location": "method"
+    },
+    "SapMonitorParameter": {
+      "name": "sapMonitorParameter",
+      "in": "body",
+      "required": true,
+      "schema": {
+        "$ref": "#/definitions/SapMonitor"
+      },
+      "description": "Request body representing a SAP Monitor",
+      "x-ms-parameter-location": "method"
+    },
+    "ProviderInstanceParameter": {
+      "name": "providerInstanceParameter",
+      "in": "body",
+      "required": true,
+      "schema": {
+        "$ref": "#/definitions/ProviderInstance"
+      },
+      "description": "Request body representing a provider instance",
+      "x-ms-parameter-location": "method"
+    }
+  }
+}
diff --git a/specification/hanaonazure/resource-manager/readme.md b/specification/hanaonazure/resource-manager/readme.md
index 2faae789bcf4..e44a10cc10b4 100644
--- a/specification/hanaonazure/resource-manager/readme.md
+++ b/specification/hanaonazure/resource-manager/readme.md
@@ -42,6 +42,16 @@ input-file:
 - Microsoft.HanaOnAzure/preview/2017-11-03-preview/hanaonazure.json
 ```
 
+### Tag: package-2020-02-07-preview
+
+These settings apply only when `--tag=package-2020-02-07-preview` is specified on the command line.
+
+``` yaml $(tag) == 'package-2020-02-07-preview'
+input-file:
+- Microsoft.HanaOnAzure/preview/2020-02-07-preview/hanaonazure.json
+```
+
+
 # Code Generation
 
 
@@ -112,6 +122,7 @@ require: $(this-folder)/../../../profiles/readme.md
 # all the input files across all versions
 input-file:
   - $(this-folder)/Microsoft.HanaOnAzure/preview/2017-11-03-preview/hanaonazure.json
+  - $(this-folder)/Microsoft.HanaOnAzure/preview/2020-02-07-preview/hanaonazure.json
 
 ```
 
diff --git a/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/CancelImageBuild.json b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/CancelImageBuild.json
new file mode 100644
index 000000000000..088a634ea1e1
--- /dev/null
+++ b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/CancelImageBuild.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "imageTemplateName": "myImageTemplate",
+    "api-version": "2020-02-14"
+  },
+  "responses": {
+    "204": {},
+    "202": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.VirtualMachineImages/locations/{location}/operations/{operation-id}?api-version=2020-02-14"
+      }
+    }
+  }
+}
diff --git a/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/CreateImageTemplateLinux.json b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/CreateImageTemplateLinux.json
new file mode 100644
index 000000000000..fa6908fb1ca2
--- /dev/null
+++ b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/CreateImageTemplateLinux.json
@@ -0,0 +1,123 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2020-02-14",
+    "imageTemplateName": "myImageTemplate",
+    "parameters": {
+      "location": "westus",
+      "tags": {
+        "imagetemplate_tag1": "IT_T1",
+        "imagetemplate_tag2": "IT_T2"
+      },
+      "properties": {
+        "source": {
+          "type": "ManagedImage",
+          "imageId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/images/source_image"
+        },
+        "customize": [
+          {
+            "type": "Shell",
+            "name": "Shell Customizer Example",
+            "scriptUri": "https://example.com/path/to/script.sh"
+          }
+        ],
+        "distribute": [
+          {
+            "type": "ManagedImage",
+            "location": "1_location",
+            "runOutputName": "image_it_pir_1",
+            "imageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/image_it_1",
+            "artifactTags": {
+              "tagName": "value"
+            }
+          }
+        ],
+        "vmProfile": {
+          "vmSize": "Standard_D2s_v3",
+          "osDiskSizeGB": 64,
+          "vnetConfig": {
+            "subnetId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/subnet_name"
+          }
+        }
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate",
+        "name": "myImageTemplate",
+        "location": "westus",
+        "type": "Microsoft.VirtualMachineImages/imageTemplate",
+        "properties": {
+          "source": {
+            "type": "ManagedImage",
+            "imageId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/images/source_image"
+          },
+          "customize": [
+            {
+              "type": "Shell",
+              "name": "Shell Customizer Example",
+              "scriptUri": "https://example.com/path/to/script.sh"
+            }
+          ],
+          "distribute": [
+            {
+              "type": "ManagedImage",
+              "location": "1_location",
+              "runOutputName": "image_it_pir_1",
+              "imageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/image_it_1",
+              "artifactTags": {
+                "tagName": "value"
+              }
+            }
+          ],
+          "vmProfile": {
+            "vmSize": "Standard_D2s_v3",
+            "osDiskSizeGB": 64,
+            "vnetConfig": {
+              "subnetId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/subnet_name"
+            }
+          }
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate",
+        "name": "myImageTemplate",
+        "location": "westus",
+        "type": "Microsoft.VirtualMachineImages/imageTemplate",
+        "properties": {
+          "source": {
+            "type": "ManagedImage",
+            "imageId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/images/source_image"
+          },
+          "customize": [
+            {
+              "type": "Shell",
+              "name": "Shell Customizer Example",
+              "scriptUri": "https://example.com/path/to/script.sh"
+            }
+          ],
+          "distribute": [
+            {
+              "type": "ManagedImage",
+              "location": "1_location",
+              "runOutputName": "image_it_pir_1",
+              "imageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/image_it_1",
+              "artifactTags": {
+                "tagName": "value"
+              }
+            }
+          ],
+          "vmProfile": {
+            "vmSize": "Standard_D2s_v3",
+            "osDiskSizeGB": 64
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/CreateImageTemplateWindows.json b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/CreateImageTemplateWindows.json
new file mode 100644
index 000000000000..0d062e7bba28
--- /dev/null
+++ b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/CreateImageTemplateWindows.json
@@ -0,0 +1,152 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2020-02-14",
+    "imageTemplateName": "myImageTemplate",
+    "parameters": {
+      "location": "westus",
+      "tags": {
+        "imagetemplate_tag1": "IT_T1",
+        "imagetemplate_tag2": "IT_T2"
+      },
+      "properties": {
+        "source": {
+          "type": "ManagedImage",
+          "imageId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/images/source_image"
+        },
+        "customize": [
+          {
+            "type": "PowerShell",
+            "name": "PowerShell (inline) Customizer Example",
+            "inline": [
+              "Powershell command-1",
+              "Powershell command-2",
+              "Powershell command-3"
+            ]
+          },
+          {
+            "type": "PowerShell",
+            "name": "PowerShell (script) Customizer Example",
+            "scriptUri": "https://example.com/path/to/script.ps1",
+            "validExitCodes": [
+              0,
+              1
+            ]
+          },
+          {
+            "type": "WindowsRestart",
+            "name": "Restart Customizer Example",
+            "restartCommand": "shutdown /f /r /t 0 /c \"packer restart\"",
+            "restartCheckCommand": "powershell -command \"& {Write-Output 'restarted.'}\"",
+            "restartTimeout": "10m"
+          },
+          {
+            "type": "WindowsUpdate",
+            "name": "Windows Update Customizer Example",
+            "searchCriteria": "BrowseOnly=0 and IsInstalled=0",
+            "filters": [
+              "$_.BrowseOnly"
+            ],
+            "updateLimit": 100
+          }
+        ],
+        "distribute": [
+          {
+            "type": "ManagedImage",
+            "location": "1_location",
+            "runOutputName": "image_it_pir_1",
+            "imageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/image_it_1",
+            "artifactTags": {
+              "tagName": "value"
+            }
+          }
+        ],
+        "vmProfile": {
+          "vmSize": "Standard_D2s_v3",
+          "osDiskSizeGB": 64,
+          "vnetConfig": {
+            "subnetId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/subnet_name"
+          }
+        }
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate",
+        "name": "myImageTemplate",
+        "location": "westus",
+        "type": "Microsoft.VirtualMachineImages/imageTemplate",
+        "properties": {
+          "source": {
+            "type": "ManagedImage",
+            "imageId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/images/source_image"
+          },
+          "customize": [
+            {
+              "type": "Shell",
+              "name": "Shell Customizer Example",
+              "scriptUri": "https://example.com/path/to/script.sh"
+            }
+          ],
+          "distribute": [
+            {
+              "type": "ManagedImage",
+              "location": "1_location",
+              "runOutputName": "image_it_pir_1",
+              "imageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/image_it_1",
+              "artifactTags": {
+                "tagName": "value"
+              }
+            }
+          ],
+          "vmProfile": {
+            "vmSize": "Standard_D2s_v3",
+            "osDiskSizeGB": 64,
+            "vnetConfig": {
+              "subnetId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/subnet_name"
+            }
+          }
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate",
+        "name": "myImageTemplate",
+        "location": "westus",
+        "type": "Microsoft.VirtualMachineImages/imageTemplate",
+        "properties": {
+          "source": {
+            "type": "ManagedImage",
+            "imageId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/images/source_image"
+          },
+          "customize": [
+            {
+              "type": "Shell",
+              "name": "Shell Customizer Example",
+              "scriptUri": "https://example.com/path/to/script.sh"
+            }
+          ],
+          "distribute": [
+            {
+              "type": "ManagedImage",
+              "location": "1_location",
+              "runOutputName": "image_it_pir_1",
+              "imageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/image_it_1",
+              "artifactTags": {
+                "tagName": "value"
+              }
+            }
+          ],
+          "vmProfile": {
+            "vmSize": "Standard_D2s_v3",
+            "osDiskSizeGB": 64
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/CreateImageTemplateWithUserAssignedIdentity.json b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/CreateImageTemplateWithUserAssignedIdentity.json
new file mode 100644
index 000000000000..1b9970d8d04a
--- /dev/null
+++ b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/CreateImageTemplateWithUserAssignedIdentity.json
@@ -0,0 +1,141 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2020-02-14",
+    "imageTemplateName": "myImageTemplate",
+    "parameters": {
+      "location": "westus",
+      "tags": {
+        "imagetemplate_tag1": "IT_T1",
+        "imagetemplate_tag2": "IT_T2"
+      },
+      "identity": {
+        "type": "UserAssigned",
+        "userAssignedIdentities": {
+          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity_1": {}
+        }
+      },
+      "properties": {
+        "source": {
+          "type": "ManagedImage",
+          "imageId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/images/source_image"
+        },
+        "customize": [
+          {
+            "type": "Shell",
+            "name": "Shell Customizer Example",
+            "scriptUri": "https://example.com/path/to/script.sh"
+          }
+        ],
+        "distribute": [
+          {
+            "type": "ManagedImage",
+            "location": "1_location",
+            "runOutputName": "image_it_pir_1",
+            "imageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/image_it_1",
+            "artifactTags": {
+              "tagName": "value"
+            }
+          }
+        ],
+        "vmProfile": {
+          "vmSize": "Standard_D2s_v3",
+          "osDiskSizeGB": 64
+        }
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate",
+        "name": "myImageTemplate",
+        "location": "westus",
+        "type": "Microsoft.VirtualMachineImages/imageTemplate",
+        "identity": {
+          "type": "UserAssigned",
+          "userAssignedIdentities": {
+            "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity_1": {
+              "clientId": "00000000-0000-0000-0000-000000000000",
+              "principalId": "00000000-0000-0000-0000-000000000000"
+            }
+          }
+        },
+        "properties": {
+          "source": {
+            "type": "ManagedImage",
+            "imageId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/images/source_image"
+          },
+          "customize": [
+            {
+              "type": "Shell",
+              "name": "Shell Customizer Example",
+              "scriptUri": "https://example.com/path/to/script.sh"
+            }
+          ],
+          "distribute": [
+            {
+              "type": "ManagedImage",
+              "location": "1_location",
+              "runOutputName": "image_it_pir_1",
+              "imageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/image_it_1",
+              "artifactTags": {
+                "tagName": "value"
+              }
+            }
+          ],
+          "vmProfile": {
+            "vmSize": "Standard_D2s_v3",
+            "osDiskSizeGB": 64
+          }
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate",
+        "name": "myImageTemplate",
+        "location": "westus",
+        "type": "Microsoft.VirtualMachineImages/imageTemplate",
+        "identity": {
+          "type": "UserAssigned",
+          "userAssignedIdentities": {
+            "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity_1": {
+              "clientId": "00000000-0000-0000-0000-000000000000",
+              "principalId": "00000000-0000-0000-0000-000000000000"
+            }
+          }
+        },
+        "properties": {
+          "source": {
+            "type": "ManagedImage",
+            "imageId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/images/source_image"
+          },
+          "customize": [
+            {
+              "type": "Shell",
+              "name": "Shell Customizer Example",
+              "scriptUri": "https://example.com/path/to/script.sh"
+            }
+          ],
+          "distribute": [
+            {
+              "type": "ManagedImage",
+              "location": "1_location",
+              "runOutputName": "image_it_pir_1",
+              "imageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/image_it_1",
+              "artifactTags": {
+                "tagName": "value"
+              }
+            }
+          ],
+          "vmProfile": {
+            "vmSize": "Standard_D2s_v3",
+            "osDiskSizeGB": 64
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/DeleteImageTemplate.json b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/DeleteImageTemplate.json
new file mode 100644
index 000000000000..0ae9833a53b9
--- /dev/null
+++ b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/DeleteImageTemplate.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "imageTemplateName": "myImageTemplate",
+    "api-version": "2020-02-14"
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.VirtualMachineImages/locations/{location}/operations/{operation-id}?api-version=2020-02-14"
+      }
+    },
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/GetImageTemplate.json b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/GetImageTemplate.json
new file mode 100644
index 000000000000..7880d2da1d8d
--- /dev/null
+++ b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/GetImageTemplate.json
@@ -0,0 +1,46 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2020-02-14",
+    "imageTemplateName": "myImageTemplate"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate",
+        "name": "myImageTemplate",
+        "location": "westus",
+        "type": "Microsoft.VirtualMachineImages/imageTemplate",
+        "properties": {
+          "source": {
+            "type": "ManagedImage",
+            "imageId": "/subscriptions/{subscription-id}/resourceGroups/source_rg/providers/Microsoft.Compute/images/source_image"
+          },
+          "customize": [
+            {
+              "type": "Shell",
+              "name": "Shell Customizer Example",
+              "scriptUri": "https://example.com/path/to/script.sh"
+            }
+          ],
+          "distribute": [
+            {
+              "type": "ManagedImage",
+              "location": "1_location",
+              "runOutputName": "image_it_pir_1",
+              "imageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/image_it_1",
+              "artifactTags": {
+                "tagName": "value"
+              }
+            }
+          ],
+          "vmProfile": {
+            "vmSize": "Standard_D2s_v3",
+            "osDiskSizeGB": 64
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/GetRunOutput.json b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/GetRunOutput.json
new file mode 100644
index 000000000000..af93537a6335
--- /dev/null
+++ b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/GetRunOutput.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "imageTemplateName": "myImageTemplate",
+    "runOutputName": "myManagedImageOutput",
+    "api-version": "2020-02-14"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/{subscription-id}/resourcegroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate/runOutputs/myManagedImageOutput",
+        "name": "myManagedImageOutput",
+        "properties": {
+          "artifactId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/output_managed_image",
+          "provisioningState": "Succeeded"
+        },
+        "type": "Microsoft.VirtualMachineImages/imageTemplates/runOutputs"
+      }
+    }
+  }
+}
diff --git a/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/ListImageTemplates.json b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/ListImageTemplates.json
new file mode 100644
index 000000000000..93f1ff55494a
--- /dev/null
+++ b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/ListImageTemplates.json
@@ -0,0 +1,91 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "api-version": "2020-02-14"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate",
+            "name": "myImageTemplate",
+            "location": "westus",
+            "type": "Microsoft.VirtualMachineImages/imageTemplate",
+            "properties": {
+              "source": {
+                "type": "ManagedImage",
+                "imageId": "/subscriptions/{subscription-id}/resourceGroups/source_rg/providers/Microsoft.Compute/images/source_image"
+              },
+              "customize": [
+                {
+                  "type": "Shell",
+                  "name": "Shell customization example",
+                  "scriptUri": "https://example.com/path/to/script.sh"
+                }
+              ],
+              "distribute": [
+                {
+                  "type": "ManagedImage",
+                  "location": "1_location",
+                  "runOutputName": "image_it_pir_1",
+                  "imageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/image_it_1",
+                  "artifactTags": {
+                    "tagName": "value"
+                  }
+                }
+              ],
+              "vmProfile": {
+                "vmSize": "Standard_D2s_v3",
+                "osDiskSizeGB": 64
+              }
+            }
+          },
+          {
+            "id": "/subscriptions/{subscription-id}/resourceGroups/myOtherResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/mySecondImageTemplate",
+            "name": "mySecondImageTemplate",
+            "location": "westus",
+            "type": "Microsoft.VirtualMachineImages/imageTemplate",
+            "properties": {
+              "source": {
+                "type": "PlatformImage",
+                "publisher": "Canonical",
+                "offer": "UbuntuServer",
+                "sku": "18.04-LTS",
+                "version": "18.04.201902121",
+                "planInfo": {
+                  "planName": "example_plan_name",
+                  "planProduct": "example_plan_product",
+                  "planPublisher": "example_plan_publisher"
+                }
+              },
+              "customize": [
+                {
+                  "type": "Shell",
+                  "name": "Shell customization example",
+                  "scriptUri": "https://example.com/path/to/script.sh"
+                }
+              ],
+              "distribute": [
+                {
+                  "type": "ManagedImage",
+                  "location": "eastus",
+                  "runOutputName": "eus",
+                  "imageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/mySecondImage-eus",
+                  "artifactTags": {
+                    "stage": "development"
+                  }
+                }
+              ],
+              "vmProfile": {
+                "vmSize": "Standard_D8s_v3",
+                "osDiskSizeGB": 32
+              }
+            }
+          }
+        ],
+        "nextLink": "/subscriptions/{subscription-id}/providers/Microsoft.VirtualMachineImages/imageTemplates?api-version=2018-02-01-preview&skip-token=2"
+      }
+    }
+  }
+}
diff --git a/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/ListImageTemplatesByRg.json b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/ListImageTemplatesByRg.json
new file mode 100644
index 000000000000..0fae34193c72
--- /dev/null
+++ b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/ListImageTemplatesByRg.json
@@ -0,0 +1,100 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2020-02-14"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate",
+            "name": "myImageTemplate",
+            "location": "westus",
+            "type": "Microsoft.VirtualMachineImages/imageTemplate",
+            "properties": {
+              "source": {
+                "type": "ManagedImage",
+                "imageId": "/subscriptions/{subscription-id}/resourceGroups/source_rg/providers/Microsoft.Compute/images/source_image"
+              },
+              "customize": [
+                {
+                  "type": "Shell",
+                  "name": "Shell customization example",
+                  "scriptUri": "https://example.com/path/to/script.sh"
+                }
+              ],
+              "distribute": [
+                {
+                  "type": "ManagedImage",
+                  "location": "1_location",
+                  "runOutputName": "image_it_pir_1",
+                  "imageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/image_it_1",
+                  "artifactTags": {
+                    "tagName": "value"
+                  }
+                }
+              ],
+              "vmProfile": {
+                "vmSize": "Standard_D2s_v3",
+                "osDiskSizeGB": 64
+              }
+            }
+          },
+          {
+            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myOtherImageTemplate",
+            "name": "myOtherImageTemplate",
+            "location": "eastus",
+            "type": "Microsoft.VirtualMachineImages/imageTemplate",
+            "properties": {
+              "source": {
+                "type": "PlatformImage",
+                "publisher": "Canonical",
+                "offer": "UbuntuServer",
+                "sku": "18.04-LTS",
+                "version": "18.04.201902121",
+                "planInfo": {
+                  "planName": "example_plan_name",
+                  "planProduct": "example_plan_product",
+                  "planPublisher": "example_plan_publisher"
+                }
+              },
+              "customize": [
+                {
+                  "type": "Shell",
+                  "name": "Shell customization example",
+                  "scriptUri": "https://example.com/path/to/script.sh"
+                }
+              ],
+              "distribute": [
+                {
+                  "type": "ManagedImage",
+                  "location": "centralus",
+                  "runOutputName": "singleImage",
+                  "imageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/baseimage-cus"
+                },
+                {
+                  "type": "SharedImage",
+                  "galleryImageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/gallery/baseimages/images/baseimage",
+                  "replicationRegions": [
+                    "eastus",
+                    "westus"
+                  ],
+                  "runOutputName": "gallery",
+                  "excludeFromLatest": true,
+                  "storageAccountType": "Standard_LRS"
+                }
+              ],
+              "vmProfile": {
+                "vmSize": "Standard_D8s_v3",
+                "osDiskSizeGB": 64
+              }
+            }
+          }
+        ],
+        "nextLink": "/subscriptions/{subscription-id}/resourceGroup/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates?api-version=2020-02-14&skip-token=2"
+      }
+    }
+  }
+}
diff --git a/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/ListRunOutputs.json b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/ListRunOutputs.json
new file mode 100644
index 000000000000..9800dfd27088
--- /dev/null
+++ b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/ListRunOutputs.json
@@ -0,0 +1,35 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "imageTemplateName": "myImageTemplate",
+    "api-version": "2020-02-14"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/{subscription-id}/resourcegroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate/runOutputs/myManagedImageOutput",
+            "name": "myManagedImageOutput",
+            "properties": {
+              "artifactId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/output_managed_image",
+              "provisioningState": "Succeeded"
+            },
+            "type": "Microsoft.VirtualMachineImages/imageTemplates/runOutputs"
+          },
+          {
+            "id": "/subscriptions/{subscription-id}/resourcegroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate/runOutputs/mySharedImageOutput",
+            "name": "mySharedImageOutput",
+            "properties": {
+              "artifactId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/galleries/Gallery1/images/SharedImageOutput/imageversions/1.2.3",
+              "provisioningState": "Succeeded"
+            },
+            "type": "Microsoft.VirtualMachineImages/imageTemplates/runOutputs"
+          }
+        ],
+        "nextLink": "/subscriptions/{subscription-id}/resourcegroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate/runOutputs?api-version=2018-02-01-preview&$skipToken=3"
+      }
+    }
+  }
+}
diff --git a/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/RunImageTemplate.json b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/RunImageTemplate.json
new file mode 100644
index 000000000000..bf61cbeecee5
--- /dev/null
+++ b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/RunImageTemplate.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "imageTemplateName": "myImageTemplate",
+    "api-version": "2020-02-14"
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.VirtualMachineImages/locations/{location}/operations/{operation-id}?api-version=2020-02-14"
+      }
+    },
+    "204": {}
+  }
+}
diff --git a/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/UpdateImageTemplateTags.json b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/UpdateImageTemplateTags.json
new file mode 100644
index 000000000000..0d99573bea25
--- /dev/null
+++ b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/UpdateImageTemplateTags.json
@@ -0,0 +1,59 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "imageTemplateName": "myImageTemplate",
+    "api-version": "2020-02-14",
+    "parameters": {
+      "tags": {
+        "new-tag": "new-value"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate",
+        "name": "myImageTemplate",
+        "location": "westus",
+        "type": "Microsoft.VirtualMachineImages/imageTemplate",
+        "tags": {
+          "new-tag": "new-value"
+        },
+        "properties": {
+          "source": {
+            "type": "ManagedImage",
+            "imageId": "/subscriptions/{subscription-id}/resourceGroups/source_rg/providers/Microsoft.Compute/images/source_image"
+          },
+          "customize": [
+            {
+              "type": "Shell",
+              "name": "Shell customization example",
+              "scriptUri": "https://example.com/path/to/script.sh"
+            }
+          ],
+          "distribute": [
+            {
+              "type": "ManagedImage",
+              "location": "1_location",
+              "runOutputName": "image_it_pir_1",
+              "imageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/image_it_1",
+              "artifactTags": {
+                "tagName": "value"
+              }
+            }
+          ],
+          "vmProfile": {
+            "vmSize": "Standard_D2s_v3",
+            "osDiskSizeGB": 64
+          }
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.VirtualMachineImages/locations/{location}/operations/{operation-id}?api-version=2020-02-14"
+      }
+    }
+  }
+}
diff --git a/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/UpdateImageTemplateToRemoveIdentities.json b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/UpdateImageTemplateToRemoveIdentities.json
new file mode 100644
index 000000000000..af55358db823
--- /dev/null
+++ b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/examples/UpdateImageTemplateToRemoveIdentities.json
@@ -0,0 +1,62 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "imageTemplateName": "myImageTemplate",
+    "api-version": "2020-02-14",
+    "parameters": {
+      "identity": {
+        "type": "None"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate",
+        "name": "myImageTemplate",
+        "location": "westus",
+        "type": "Microsoft.VirtualMachineImages/imageTemplate",
+        "identity": {
+          "type": "None"
+        },
+        "tags": {
+          "new-tag": "new-value"
+        },
+        "properties": {
+          "source": {
+            "type": "ManagedImage",
+            "imageId": "/subscriptions/{subscription-id}/resourceGroups/source_rg/providers/Microsoft.Compute/images/source_image"
+          },
+          "customize": [
+            {
+              "type": "Shell",
+              "name": "Shell customization example",
+              "scriptUri": "https://example.com/path/to/script.sh"
+            }
+          ],
+          "distribute": [
+            {
+              "type": "ManagedImage",
+              "location": "1_location",
+              "runOutputName": "image_it_pir_1",
+              "imageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/image_it_1",
+              "artifactTags": {
+                "tagName": "value"
+              }
+            }
+          ],
+          "vmProfile": {
+            "vmSize": "Standard_D2s_v3",
+            "osDiskSizeGB": 64
+          }
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.VirtualMachineImages/locations/{location}/operations/{operation-id}?api-version=2020-02-14"
+      }
+    }
+  }
+}
diff --git a/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/imagebuilder.json b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/imagebuilder.json
new file mode 100644
index 000000000000..16c3411621c9
--- /dev/null
+++ b/specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2020-02-14/imagebuilder.json
@@ -0,0 +1,1445 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "VirtualMachineImageTemplate",
+    "description": "Virtual Machine Image Template",
+    "version": "2020-02-14"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/providers/Microsoft.VirtualMachineImages/imageTemplates": {
+      "get": {
+        "tags": [
+          "VirtualMachineImageTemplate"
+        ],
+        "operationId": "VirtualMachineImageTemplates_List",
+        "description": "Gets information about the VM image templates associated with the subscription.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ImageTemplateListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ApiError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-examples": {
+          "List images by subscription.": {
+            "$ref": "./examples/ListImageTemplates.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates": {
+      "get": {
+        "tags": [
+          "VirtualMachineImageTemplate"
+        ],
+        "operationId": "VirtualMachineImageTemplates_ListByResourceGroup",
+        "description": "Gets information about the VM image templates associated with the specified resource group.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ImageTemplateListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ApiError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-examples": {
+          "List images by resource group": {
+            "$ref": "./examples/ListImageTemplatesByRg.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}": {
+      "put": {
+        "tags": [
+          "VirtualMachineImageTemplate"
+        ],
+        "operationId": "VirtualMachineImageTemplates_CreateOrUpdate",
+        "description": "Create or update a virtual machine image template",
+        "parameters": [
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ImageTemplate"
+            },
+            "description": "Parameters supplied to the CreateImageTemplate operation"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ImageTemplateNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ImageTemplate"
+            }
+          },
+          "201": {
+            "description": "Created",
+            "schema": {
+              "$ref": "#/definitions/ImageTemplate"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ApiError"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "azure-async-operation"
+        },
+        "x-ms-examples": {
+          "Create an Image Template for Linux.": {
+            "$ref": "./examples/CreateImageTemplateLinux.json"
+          },
+          "Create an Image Template for Windows.": {
+            "$ref": "./examples/CreateImageTemplateWindows.json"
+          },
+          "Create an Image Template with a user assigned identity configured": {
+            "$ref": "./examples/CreateImageTemplateWithUserAssignedIdentity.json"
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "VirtualMachineImageTemplate"
+        ],
+        "operationId": "VirtualMachineImageTemplates_Update",
+        "description": "Update the tags for this Virtual Machine Image Template",
+        "parameters": [
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ImageTemplateUpdateParameters"
+            },
+            "description": "Additional parameters for Image Template update."
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ImageTemplateNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ImageTemplate"
+            }
+          },
+          "202": {
+            "description": "The operation will be completed asynchronously."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ApiError"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "azure-async-operation"
+        },
+        "x-ms-examples": {
+          "Update the tags for an Image Template.": {
+            "$ref": "./examples/UpdateImageTemplateTags.json"
+          },
+          "Remove identities for an Image Template.": {
+            "$ref": "./examples/UpdateImageTemplateToRemoveIdentities.json"
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "VirtualMachineImageTemplate"
+        ],
+        "operationId": "VirtualMachineImageTemplates_Get",
+        "description": "Get information about a virtual machine image template",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ImageTemplateNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ImageTemplate"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ApiError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Retrieve an Image Template.": {
+            "$ref": "./examples/GetImageTemplate.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "VirtualMachineImageTemplate"
+        ],
+        "operationId": "VirtualMachineImageTemplates_Delete",
+        "description": "Delete a virtual machine image template",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ImageTemplateNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation was successful."
+          },
+          "202": {
+            "description": "The operation will be completed asynchronously."
+          },
+          "204": {
+            "description": "NoContent -- VM image template does not exist in the subscription."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ApiError"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "azure-async-operation"
+        },
+        "x-ms-examples": {
+          "Delete an Image Template.": {
+            "$ref": "./examples/DeleteImageTemplate.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}/run": {
+      "post": {
+        "tags": [
+          "VirtualMachineImageTemplate"
+        ],
+        "operationId": "VirtualMachineImageTemplates_Run",
+        "description": "Create artifacts from a existing image template",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ImageTemplateNameParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The operation was successful."
+          },
+          "202": {
+            "description": "The operation will be completed asynchronously."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ApiError"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "azure-async-operation"
+        },
+        "x-ms-examples": {
+          "Create image(s) from existing imageTemplate.": {
+            "$ref": "./examples/RunImageTemplate.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}/cancel": {
+      "post": {
+        "tags": [
+          "VirtualMachineImageTemplate"
+        ],
+        "operationId": "VirtualMachineImageTemplates_Cancel",
+        "description": "Cancel the long running image build based on the image template",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ImageTemplateNameParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The long running image build has been canceled."
+          },
+          "202": {
+            "description": "The request is accepted."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ApiError"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "azure-async-operation"
+        },
+        "x-ms-examples": {
+          "Cancel the image build based on the imageTemplate.": {
+            "$ref": "./examples/CancelImageBuild.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}/runOutputs": {
+      "get": {
+        "tags": [
+          "VirtualMachineImageTemplate"
+        ],
+        "operationId": "VirtualMachineImageTemplates_ListRunOutputs",
+        "description": "List all run outputs for the specified Image Template resource",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ImageTemplateNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/RunOutputCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ApiError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-examples": {
+          "Retrieve a list of all outputs created by the last run of an Image Template": {
+            "$ref": "./examples/ListRunOutputs.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}/runOutputs/{runOutputName}": {
+      "get": {
+        "tags": [
+          "VirtualMachineImageTemplate"
+        ],
+        "operationId": "VirtualMachineImageTemplates_GetRunOutput",
+        "description": "Get the specified run output for the specified image template resource",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ImageTemplateNameParameter"
+          },
+          {
+            "$ref": "#/parameters/RunOutputNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/RunOutput"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ApiError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Retrieve single runOutput": {
+            "$ref": "./examples/GetRunOutput.json"
+          }
+        }
+      }
+    },
+    "/providers/Microsoft.VirtualMachineImages/operations": {
+      "get": {
+        "tags": [
+          "Operations"
+        ],
+        "operationId": "Operations_List",
+        "description": "Lists available operations for the Microsoft.VirtualMachineImages provider",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation was successful. The response contains the list of available operations.",
+            "schema": {
+              "$ref": "#/definitions/OperationListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ApiError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    }
+  },
+  "definitions": {
+    "ImageTemplateListResult": {
+      "description": "The result of List image templates operation",
+      "properties": {
+        "value": {
+          "description": "An array of image templates",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ImageTemplate"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "The continuation token."
+        }
+      }
+    },
+    "ImageTemplateSource": {
+      "description": "Describes a virtual machine image source for building, customizing and distributing",
+      "discriminator": "type",
+      "properties": {
+        "type": {
+          "type": "string",
+          "description": "Specifies the type of source image you want to start with."
+        }
+      },
+      "required": [
+        "type"
+      ]
+    },
+    "ImageTemplatePlatformImageSource": {
+      "description": "Describes an image source from [Azure Gallery Images](https://docs.microsoft.com/en-us/rest/api/compute/virtualmachineimages).",
+      "x-ms-discriminator-value": "PlatformImage",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ImageTemplateSource"
+        }
+      ],
+      "properties": {
+        "publisher": {
+          "type": "string",
+          "description": "Image Publisher in [Azure Gallery Images](https://docs.microsoft.com/en-us/rest/api/compute/virtualmachineimages)."
+        },
+        "offer": {
+          "type": "string",
+          "description": "Image offer from the [Azure Gallery Images](https://docs.microsoft.com/en-us/rest/api/compute/virtualmachineimages)."
+        },
+        "sku": {
+          "type": "string",
+          "description": "Image sku from the [Azure Gallery Images](https://docs.microsoft.com/en-us/rest/api/compute/virtualmachineimages)."
+        },
+        "version": {
+          "type": "string",
+          "description": "Image version from the [Azure Gallery Images](https://docs.microsoft.com/en-us/rest/api/compute/virtualmachineimages)."
+        },
+        "planInfo": {
+          "$ref": "#/definitions/PlatformImagePurchasePlan",
+          "description": "Optional configuration of purchase plan for platform image."
+        }
+      }
+    },
+    "ImageTemplateManagedImageSource": {
+      "description": "Describes an image source that is a managed image in customer subscription.",
+      "x-ms-discriminator-value": "ManagedImage",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ImageTemplateSource"
+        }
+      ],
+      "properties": {
+        "imageId": {
+          "type": "string",
+          "description": "ARM resource id of the managed image in customer subscription"
+        }
+      },
+      "required": [
+        "imageId"
+      ]
+    },
+    "ImageTemplateSharedImageVersionSource": {
+      "description": "Describes an image source that is an image version in a shared image gallery.",
+      "x-ms-discriminator-value": "SharedImageVersion",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ImageTemplateSource"
+        }
+      ],
+      "properties": {
+        "imageVersionId": {
+          "type": "string",
+          "description": "ARM resource id of the image version in the shared image gallery"
+        }
+      },
+      "required": [
+        "imageVersionId"
+      ]
+    },
+    "ImageTemplateCustomizer": {
+      "description": "Describes a unit of image customization",
+      "discriminator": "type",
+      "properties": {
+        "type": {
+          "type": "string",
+          "description": "The type of customization tool you want to use on the Image. For example, \"Shell\" can be shell customizer"
+        },
+        "name": {
+          "type": "string",
+          "description": "Friendly Name to provide context on what this customization step does"
+        }
+      },
+      "required": [
+        "type"
+      ]
+    },
+    "ImageTemplateShellCustomizer": {
+      "description": "Runs a shell script during the customization phase (Linux). Corresponds to Packer shell provisioner. Exactly one of 'scriptUri' or 'inline' can be specified.",
+      "x-ms-discriminator-value": "Shell",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ImageTemplateCustomizer"
+        }
+      ],
+      "properties": {
+        "scriptUri": {
+          "type": "string",
+          "description": "URI of the shell script to be run for customizing. It can be a github link, SAS URI for Azure Storage, etc"
+        },
+        "sha256Checksum": {
+          "type": "string",
+          "description": "SHA256 checksum of the shell script provided in the scriptUri field"
+        },
+        "inline": {
+          "type": "array",
+          "description": "Array of shell commands to execute",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "ImageTemplateRestartCustomizer": {
+      "description": "Reboots a VM and waits for it to come back online (Windows). Corresponds to Packer windows-restart provisioner",
+      "x-ms-discriminator-value": "WindowsRestart",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ImageTemplateCustomizer"
+        }
+      ],
+      "properties": {
+        "restartCommand": {
+          "type": "string",
+          "description": "Command to execute the restart [Default: 'shutdown /r /f /t 0 /c \"packer restart\"']"
+        },
+        "restartCheckCommand": {
+          "type": "string",
+          "description": "Command to check if restart succeeded [Default: '']"
+        },
+        "restartTimeout": {
+          "type": "string",
+          "description": "Restart timeout specified as a string of magnitude and unit, e.g. '5m' (5 minutes) or '2h' (2 hours) [Default: '5m']"
+        }
+      }
+    },
+    "ImageTemplateWindowsUpdateCustomizer": {
+      "description": "Installs Windows Updates. Corresponds to Packer Windows Update Provisioner (https://github.com/rgl/packer-provisioner-windows-update)",
+      "x-ms-discriminator-value": "WindowsUpdate",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ImageTemplateCustomizer"
+        }
+      ],
+      "properties": {
+        "searchCriteria": {
+          "type": "string",
+          "description": "Criteria to search updates. Omit or specify empty string to use the default (search all). Refer to above link for examples and detailed description of this field."
+        },
+        "filters": {
+          "type": "array",
+          "description": "Array of filters to select updates to apply. Omit or specify empty array to use the default (no filter). Refer to above link for examples and detailed description of this field.",
+          "items": {
+            "type": "string"
+          }
+        },
+        "updateLimit": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Maximum number of updates to apply at a time. Omit or specify 0 to use the default (1000)"
+        }
+      }
+    },
+    "ImageTemplatePowerShellCustomizer": {
+      "description": "Runs the specified PowerShell on the VM (Windows). Corresponds to Packer powershell provisioner. Exactly one of 'scriptUri' or 'inline' can be specified.",
+      "x-ms-discriminator-value": "PowerShell",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ImageTemplateCustomizer"
+        }
+      ],
+      "properties": {
+        "scriptUri": {
+          "type": "string",
+          "description": "URI of the PowerShell script to be run for customizing. It can be a github link, SAS URI for Azure Storage, etc"
+        },
+        "sha256Checksum": {
+          "type": "string",
+          "description": "SHA256 checksum of the power shell script provided in the scriptUri field above"
+        },
+        "inline": {
+          "type": "array",
+          "description": "Array of PowerShell commands to execute",
+          "items": {
+            "type": "string"
+          }
+        },
+        "runElevated": {
+          "type": "boolean",
+          "description": "If specified, the PowerShell script will be run with elevated privileges"
+        },
+        "validExitCodes": {
+          "type": "array",
+          "description": "Valid exit codes for the PowerShell script. [Default: 0]",
+          "items": {
+            "type": "integer"
+          }
+        }
+      }
+    },
+    "ImageTemplateFileCustomizer": {
+      "description": "Uploads files to VMs (Linux, Windows). Corresponds to Packer file provisioner",
+      "x-ms-discriminator-value": "File",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ImageTemplateCustomizer"
+        }
+      ],
+      "properties": {
+        "sourceUri": {
+          "type": "string",
+          "description": "The URI of the file to be uploaded for customizing the VM. It can be a github link, SAS URI for Azure Storage, etc"
+        },
+        "sha256Checksum": {
+          "type": "string",
+          "description": "SHA256 checksum of the file provided in the sourceUri field above"
+        },
+        "destination": {
+          "type": "string",
+          "description": "The absolute path to a file (with nested directory structures already created) where the file (from sourceUri) will be uploaded to in the VM"
+        }
+      }
+    },
+    "ImageTemplateDistributor": {
+      "type": "object",
+      "description": "Generic distribution object",
+      "discriminator": "type",
+      "properties": {
+        "type": {
+          "type": "string",
+          "description": "Type of distribution."
+        },
+        "runOutputName": {
+          "type": "string",
+          "description": "The name to be used for the associated RunOutput.",
+          "pattern": "^[A-Za-z0-9-_.]{1,64}$"
+        },
+        "artifactTags": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Tags that will be applied to the artifact once it has been created/updated by the distributor."
+        }
+      },
+      "required": [
+        "type",
+        "runOutputName"
+      ]
+    },
+    "ImageTemplateManagedImageDistributor": {
+      "x-ms-discriminator-value": "ManagedImage",
+      "description": "Distribute as a Managed Disk Image.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ImageTemplateDistributor"
+        }
+      ],
+      "properties": {
+        "imageId": {
+          "type": "string",
+          "description": "Resource Id of the Managed Disk Image"
+        },
+        "location": {
+          "type": "string",
+          "description": "Azure location for the image, should match if image already exists"
+        }
+      },
+      "required": [
+        "imageId",
+        "location"
+      ]
+    },
+    "ImageTemplateSharedImageDistributor": {
+      "x-ms-discriminator-value": "SharedImage",
+      "description": "Distribute via Shared Image Gallery.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ImageTemplateDistributor"
+        }
+      ],
+      "properties": {
+        "galleryImageId": {
+          "type": "string",
+          "description": "Resource Id of the Shared Image Gallery image"
+        },
+        "replicationRegions": {
+          "description": "A list of regions that the image will be replicated to",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "excludeFromLatest": {
+          "type": "boolean",
+          "description": "Flag that indicates whether created image version should be excluded from latest. Omit to use the default (false)."
+        },
+        "storageAccountType": {
+          "type": "string",
+          "enum": [
+            "Standard_LRS",
+            "Standard_ZRS"
+          ],
+          "x-ms-enum": {
+            "name": "SharedImageStorageAccountType",
+            "modelAsString": false
+          },
+          "description": "Storage account type to be used to store the shared image. Omit to use the default (Standard_LRS)."
+        }
+      },
+      "required": [
+        "galleryImageId",
+        "replicationRegions"
+      ]
+    },
+    "ImageTemplateVhdDistributor": {
+      "x-ms-discriminator-value": "VHD",
+      "description": "Distribute via VHD in a storage account.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ImageTemplateDistributor"
+        }
+      ]
+    },
+    "PlatformImagePurchasePlan": {
+      "description": "Purchase plan configuration for platform image.",
+      "properties": {
+        "planName": {
+          "type": "string",
+          "description": "Name of the purchase plan."
+        },
+        "planProduct": {
+          "type": "string",
+          "description": "Product of the purchase plan."
+        },
+        "planPublisher": {
+          "type": "string",
+          "description": "Publisher of the purchase plan."
+        }
+      },
+      "required": [
+        "planName",
+        "planProduct",
+        "planPublisher"
+      ]
+    },
+    "VirtualNetworkConfig": {
+      "description": "Virtual Network configuration.",
+      "properties": {
+        "subnetId": {
+          "type": "string",
+          "description": "Resource id of a pre-existing subnet."
+        }
+      }
+    },
+    "ImageTemplateVmProfile": {
+      "description": "Describes the virtual machine used to build, customize and capture images",
+      "properties": {
+        "vmSize": {
+          "type": "string",
+          "description": "Size of the virtual machine used to build, customize and capture images. Omit or specify empty string to use the default (Standard_D1_v2)."
+        },
+        "osDiskSizeGB": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Size of the OS disk in GB. Omit or specify 0 to use Azure's default OS disk size."
+        },
+        "vnetConfig": {
+          "$ref": "#/definitions/VirtualNetworkConfig",
+          "description": "Optional configuration of the virtual network to use to deploy the build virtual machine in. Omit if no specific virtual network needs to be used."
+        }
+      }
+    },
+    "ProvisioningState": {
+      "type": "string",
+      "enum": [
+        "Creating",
+        "Updating",
+        "Succeeded",
+        "Failed",
+        "Deleting"
+      ],
+      "x-ms-enum": {
+        "name": "ProvisioningState",
+        "modelAsString": false
+      },
+      "description": "Provisioning state of the resource"
+    },
+    "ProvisioningError": {
+      "description": "Describes the error happened when create or update an image template",
+      "properties": {
+        "provisioningErrorCode": {
+          "type": "string",
+          "enum": [
+            "BadSourceType",
+            "BadPIRSource",
+            "BadManagedImageSource",
+            "BadSharedImageVersionSource",
+            "BadCustomizerType",
+            "UnsupportedCustomizerType",
+            "NoCustomizerScript",
+            "BadDistributeType",
+            "BadSharedImageDistribute",
+            "ServerError",
+            "Other"
+          ],
+          "x-ms-enum": {
+            "name": "ProvisioningErrorCode",
+            "modelAsString": true
+          },
+          "description": "Error code of the provisioning failure"
+        },
+        "message": {
+          "type": "string",
+          "description": "Verbose error message about the provisioning failure"
+        }
+      }
+    },
+    "ImageTemplateLastRunStatus": {
+      "description": "Describes the latest status of running an image template",
+      "properties": {
+        "startTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Start time of the last run (UTC)"
+        },
+        "endTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "End time of the last run (UTC)"
+        },
+        "runState": {
+          "type": "string",
+          "enum": [
+            "Running",
+            "Canceling",
+            "Succeeded",
+            "PartiallySucceeded",
+            "Failed",
+            "Canceled"
+          ],
+          "x-ms-enum": {
+            "name": "RunState",
+            "modelAsString": false
+          },
+          "description": "State of the last run"
+        },
+        "runSubState": {
+          "type": "string",
+          "enum": [
+            "Queued",
+            "Building",
+            "Customizing",
+            "Distributing"
+          ],
+          "x-ms-enum": {
+            "name": "RunSubState",
+            "modelAsString": false
+          },
+          "description": "Sub-state of the last run"
+        },
+        "message": {
+          "type": "string",
+          "description": "Verbose information about the last run state"
+        }
+      }
+    },
+    "ImageTemplateProperties": {
+      "description": "Describes the properties of an image template",
+      "properties": {
+        "source": {
+          "$ref": "#/definitions/ImageTemplateSource",
+          "description": "Specifies the properties used to describe the source image."
+        },
+        "customize": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ImageTemplateCustomizer"
+          },
+          "description": "Specifies the properties used to describe the customization steps of the image, like Image source etc"
+        },
+        "distribute": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ImageTemplateDistributor"
+          },
+          "description": "The distribution targets where the image output needs to go to."
+        },
+        "provisioningState": {
+          "$ref": "#/definitions/ProvisioningState",
+          "description": "Provisioning state of the resource",
+          "readOnly": true
+        },
+        "provisioningError": {
+          "$ref": "#/definitions/ProvisioningError",
+          "description": "Provisioning error, if any",
+          "readOnly": true
+        },
+        "lastRunStatus": {
+          "$ref": "#/definitions/ImageTemplateLastRunStatus",
+          "description": "State of 'run' that is currently executing or was last executed.",
+          "readOnly": true
+        },
+        "buildTimeoutInMinutes": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 960,
+          "description": "Maximum duration to wait while building the image template. Omit or specify 0 to use the default (4 hours)."
+        },
+        "vmProfile": {
+          "$ref": "#/definitions/ImageTemplateVmProfile",
+          "description": "Describes how virtual machine is set up to build images"
+        }
+      },
+      "required": [
+        "source",
+        "distribute"
+      ]
+    },
+    "ImageTemplateIdentity": {
+      "properties": {
+        "type": {
+          "type": "string",
+          "description": "The type of identity used for the image template. The type 'None' will remove any identities from the image template.",
+          "enum": [
+            "UserAssigned",
+            "None"
+          ],
+          "x-ms-enum": {
+            "name": "ResourceIdentityType",
+            "modelAsString": false
+          }
+        },
+        "userAssignedIdentities": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "principalId": {
+                "readOnly": true,
+                "type": "string",
+                "description": "The principal id of user assigned identity."
+              },
+              "clientId": {
+                "readOnly": true,
+                "type": "string",
+                "description": "The client id of user assigned identity."
+              }
+            }
+          },
+          "description": "The list of user identities associated with the image template. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'."
+        }
+      },
+      "description": "Identity for the image template."
+    },
+    "RunOutputProperties": {
+      "description": "Describes the properties of a run output",
+      "properties": {
+        "artifactId": {
+          "type": "string",
+          "description": "The resource id of the artifact."
+        },
+        "artifactUri": {
+          "type": "string",
+          "description": "The location URI of the artifact."
+        },
+        "provisioningState": {
+          "$ref": "#/definitions/ProvisioningState",
+          "description": "Provisioning state of the resource",
+          "readOnly": true
+        }
+      }
+    },
+    "ImageTemplate": {
+      "description": "Image template is an ARM resource managed by Microsoft.VirtualMachineImages provider",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ImageTemplateProperties",
+          "description": "The properties of the image template"
+        },
+        "identity": {
+          "$ref": "#/definitions/ImageTemplateIdentity",
+          "description": "The identity of the image template, if configured."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/Resource"
+        }
+      ]
+    },
+    "ImageTemplateUpdateParameters": {
+      "properties": {
+        "identity": {
+          "$ref": "#/definitions/ImageTemplateIdentity",
+          "description": "The identity of the image template, if configured."
+        },
+        "tags": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "The user-specified tags associated with the image template."
+        }
+      },
+      "description": "Parameters for updating an image template."
+    },
+    "RunOutput": {
+      "description": "Represents an output that was created by running an image template.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/SubResource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/RunOutputProperties",
+          "x-ms-client-flatten": true,
+          "description": "The properties of the run output"
+        }
+      }
+    },
+    "RunOutputCollection": {
+      "description": "The result of List run outputs operation",
+      "properties": {
+        "value": {
+          "description": "An array of run outputs",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/RunOutput"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "The continuation token."
+        }
+      }
+    },
+    "Resource": {
+      "description": "The Resource model definition.",
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Resource Id"
+        },
+        "name": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Resource name"
+        },
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Resource type"
+        },
+        "location": {
+          "type": "string",
+          "description": "Resource location",
+          "x-ms-mutability": [
+            "create",
+            "read"
+          ]
+        },
+        "tags": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Resource tags"
+        }
+      },
+      "required": [
+        "location"
+      ],
+      "x-ms-azure-resource": true
+    },
+    "SubResource": {
+      "description": "The Sub Resource model definition.",
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Resource Id"
+        },
+        "name": {
+          "type": "string",
+          "description": "Resource name"
+        },
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Resource type"
+        }
+      },
+      "required": [
+        "name"
+      ]
+    },
+    "Operation": {
+      "title": "A REST API operation",
+      "type": "object",
+      "properties": {
+        "name": {
+          "title": "The operation name.",
+          "description": "This is of the format {provider}/{resource}/{operation}",
+          "type": "string"
+        },
+        "display": {
+          "title": "The object that describes the operation.",
+          "properties": {
+            "provider": {
+              "title": "Friendly name of the resource provider.",
+              "type": "string"
+            },
+            "operation": {
+              "title": "The operation type.",
+              "description": "For example: read, write, delete, or listKeys/action",
+              "type": "string"
+            },
+            "resource": {
+              "title": "The resource type on which the operation is performed.",
+              "type": "string"
+            },
+            "description": {
+              "title": "The friendly name of the operation",
+              "type": "string"
+            }
+          }
+        },
+        "origin": {
+          "title": "The intended executor of the operation.",
+          "type": "string"
+        },
+        "properties": {
+          "title": "Properties of the operation.",
+          "type": "object"
+        },
+        "isDataAction": {
+          "title": "The flag that indicates whether the operation applies to data plane.",
+          "type": "boolean"
+        }
+      }
+    },
+    "OperationListResult": {
+      "title": "Result of the request to list REST API operations. It contains a list of operations and a URL nextLink to get the next set of results.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Operation"
+          },
+          "title": "The list of operations supported by the resource provider."
+        },
+        "nextLink": {
+          "type": "string",
+          "title": "The URL to get the next set of operation list results if there are any."
+        }
+      }
+    },
+    "ApiErrorBase": {
+      "properties": {
+        "code": {
+          "type": "string",
+          "description": "The error code."
+        },
+        "target": {
+          "type": "string",
+          "description": "The target of the particular error."
+        },
+        "message": {
+          "type": "string",
+          "description": "The error message."
+        }
+      },
+      "description": "Api error base."
+    },
+    "InnerError": {
+      "properties": {
+        "exceptionType": {
+          "type": "string",
+          "description": "The exception type."
+        },
+        "errorDetail": {
+          "type": "string",
+          "description": "The internal error message or exception dump."
+        }
+      },
+      "description": "Inner error details."
+    },
+    "ApiError": {
+      "properties": {
+        "details": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ApiErrorBase"
+          },
+          "description": "The Api error details"
+        },
+        "innerError": {
+          "$ref": "#/definitions/InnerError",
+          "description": "The Api inner error"
+        },
+        "code": {
+          "type": "string",
+          "description": "The error code."
+        },
+        "target": {
+          "type": "string",
+          "description": "The target of the particular error."
+        },
+        "message": {
+          "type": "string",
+          "description": "The error message."
+        }
+      },
+      "description": "Api error."
+    }
+  },
+  "parameters": {
+    "SubscriptionIdParameter": {
+      "name": "subscriptionId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription Id forms part of the URI for every service call."
+    },
+    "ResourceGroupNameParameter": {
+      "name": "resourceGroupName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The name of the resource group.",
+      "x-ms-parameter-location": "method"
+    },
+    "ImageTemplateNameParameter": {
+      "name": "imageTemplateName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The name of the image Template",
+      "pattern": "^[A-Za-z0-9-_.]{1,64}$",
+      "x-ms-parameter-location": "method"
+    },
+    "RunOutputNameParameter": {
+      "name": "runOutputName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The name of the run output",
+      "pattern": "^[A-Za-z0-9-_.]{1,64}$",
+      "x-ms-parameter-location": "method"
+    },
+    "LocationParameter": {
+      "name": "location",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Location of the service.",
+      "x-ms-parameter-location": "method"
+    },
+    "ApiVersionParameter": {
+      "name": "api-version",
+      "in": "query",
+      "required": true,
+      "type": "string",
+      "description": "Client Api Version."
+    }
+  }
+}
diff --git a/specification/imagebuilder/resource-manager/readme.md b/specification/imagebuilder/resource-manager/readme.md
index 6bf671ebfe8e..9d1af6e035c1 100644
--- a/specification/imagebuilder/resource-manager/readme.md
+++ b/specification/imagebuilder/resource-manager/readme.md
@@ -28,19 +28,28 @@ These are the global settings for the Virtual Machine Image Builder API.
 title: ImageBuilderClient
 description: Azure Virtual Machine Image Builder Client
 openapi-type: arm
-tag: package-preview-2019-05
+tag: package-2020-02
 azure-arm: true
 ```
 
 
+### Tag: package-2020-02
+
+These settings apply only when `--tag=package-2020-02` is specified on the command line.
+
+```yaml $(tag) == 'package-2020-02'
+input-file:
+  - Microsoft.VirtualMachineImages/stable/2020-02-14/imagebuilder.json
+```
 ### Tag: package-preview-2019-05
 
 These settings apply only when `--tag=package-preview-2019-05` is specified on the command line.
 
-```yaml $(tag) == 'package-preview-2019-05'
+``` yaml $(tag) == 'package-preview-2019-05'
 input-file:
   - Microsoft.VirtualMachineImages/preview/2019-05-01-preview/imagebuilder.json
 ```
+
 ### Tag: package-2018-02
 
 These settings apply only when `--tag=package-2018-02` is specified on the command line.
@@ -156,7 +165,7 @@ regenerate-manager: true
 generate-interface: true
 ```
 
-## Multi-API/Profile support for AutoRest v3 generators 
+## Multi-API/Profile support for AutoRest v3 generators
 
 AutoRest V3 generators require the use of `--tag=all-api-versions` to select api files.
 
@@ -168,17 +177,17 @@ require: $(this-folder)/../../../profiles/readme.md
 
 # all the input files across all versions
 input-file:
+  - $(this-folder)/Microsoft.VirtualMachineImages/stable/2020-02-14/imagebuilder.json
   - $(this-folder)/Microsoft.VirtualMachineImages/preview/2019-05-01-preview/imagebuilder.json
   - $(this-folder)/Microsoft.VirtualMachineImages/preview/2018-02-01-preview/imagebuilder.json
   - $(this-folder)/Microsoft.VirtualMachineImages/preview/2019-02-01-preview/imagebuilder.json
 
 ```
 
-If there are files that should not be in the `all-api-versions` set, 
+If there are files that should not be in the `all-api-versions` set,
 uncomment the  `exclude-file` section below and add the file paths.
 
 ``` yaml $(tag) == 'all-api-versions'
 #exclude-file: 
 #  - $(this-folder)/Microsoft.Example/stable/2010-01-01/somefile.json
 ```
-
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2018-03-01-preview/machineLearningServices.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2018-03-01-preview/machineLearningServices.json
index 782995dfe9c5..8868b1aa282e 100644
--- a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2018-03-01-preview/machineLearningServices.json
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2018-03-01-preview/machineLearningServices.json
@@ -1046,7 +1046,6 @@
         },
         "identity": {
           "$ref": "#/definitions/Identity",
-          "readOnly": true,
           "description": "The identity of the resource."
         },
         "location": {
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/ListSkus.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/ListSkus.json
new file mode 100644
index 000000000000..d2762d31a31b
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/ListSkus.json
@@ -0,0 +1,79 @@
+{
+  "parameters": {
+    "api-version": "2020-02-18-preview",
+    "subscriptionId": "{subscription-id}"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "resourceType": "workspaces",
+            "name": "Basic",
+            "tier": "Basic",
+            "locations": [
+              "westus"
+            ],
+            "locationInfo": [
+              {
+                "location": "westus",
+                "zones": [
+                  "westus-AZ02",
+                  "westus-AZ01"
+                ]
+              }
+            ],
+            "capabilities": [
+              {
+                "name": "automatedml_readhyperdrivesdk",
+                "value": "{\n  \"id\": \"automatedml_ readhyperdrivesdk\",\n  \"name\": \"Read hyperdrive SDK\",\n  \"description\": \"Read only access to Hyperdrive in the SDK\"\n}"
+              },
+              {
+                "name": "workspace_upgradeworkspacesdk",
+                "value": "{\n  \"id\": \"workspace_upgradeworkspacesdk\",\n  \"name\": \"Upgrade workspace SDK\",\n  \"description\": \"Upgrade workspace from Basic to enterprise from the SDK\"\n}"
+              }
+            ],
+            "restrictions": []
+          },
+          {
+            "resourceType": "workspaces",
+            "name": "Enterprise",
+            "tier": "Enterprise",
+            "locations": [
+              "westus"
+            ],
+            "locationInfo": [
+              {
+                "location": "westus",
+                "zones": [
+                  "westus-AZ01"
+                ],
+                "zoneDetails": [
+                  {
+                    "name": [
+                      "westus-AZ01"
+                    ],
+                    "capabilities": [
+                      {
+                        "name": "automatedml_createeditexperimentssdk",
+                        "value": "{\n  \"id\": \"automatedml_createeditexperimentssdk\",\n  \"name\": \"Create edit experiments SDK\",\n  \"description\": \"Create, edit or delete AutoML experiments in the SDK\"\n}"
+                      }
+                    ]
+                  }
+                ]
+              }
+            ],
+            "capabilities": [
+              {
+                "name": "automatedml_createeditexperimentssdk",
+                "value": "{\n  \"id\": \"automatedml_createeditexperimentssdk\",\n  \"name\": \"Create edit experiments SDK\",\n  \"description\": \"Create, edit or delete AutoML experiments in the SDK\"\n}"
+              }
+            ],
+            "restrictions": []
+          }
+        ],
+        "nextLink": null
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/ListUsages.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/ListUsages.json
new file mode 100644
index 000000000000..b9026c10fc40
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/ListUsages.json
@@ -0,0 +1,400 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "location": "eastus",
+    "api-version": "2020-02-18-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages",
+            "type": "Microsoft.MachineLearningServices/totalCores/usages",
+            "currentValue": 7,
+            "limit": 100,
+            "name": {
+              "localizedValue": "Clusters",
+              "value": "Clusters"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages",
+            "type": "Microsoft.MachineLearningServices/dedicatedCores/usages",
+            "currentValue": 14,
+            "limit": 24,
+            "name": {
+              "localizedValue": "Total Cluster Dedicated Regional vCPUs",
+              "value": "Total Cluster Dedicated Regional vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_D_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/usages",
+            "currentValue": 0,
+            "limit": 48,
+            "name": {
+              "localizedValue": "Standard D Family Cluster Dedicated vCPUs",
+              "value": "Standard D Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_DSv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/usages",
+            "currentValue": 2,
+            "limit": 24,
+            "name": {
+              "value": "Standard DSv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard DSv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/usages/Standard_DSv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/usages",
+            "currentValue": 2,
+            "limit": 24,
+            "name": {
+              "value": "Standard DSv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard DSv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/computes/demo_cluster1_dsv2/usages/Standard_DSv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/computes/usages",
+            "currentValue": 2,
+            "limit": 24,
+            "name": {
+              "value": "Standard DSv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard DSv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/computes/demo_cluster2_dsv2/usages/Standard_DSv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/computes/usages",
+            "currentValue": 0,
+            "limit": 24,
+            "name": {
+              "value": "Standard DSv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard DSv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_Dv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/usages",
+            "currentValue": 0,
+            "limit": 24,
+            "name": {
+              "localizedValue": "Standard Dv2 Family Cluster Dedicated vCPUs",
+              "value": "Standard Dv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_FSv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/usages",
+            "currentValue": 0,
+            "limit": 24,
+            "name": {
+              "value": "Standard FSv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard FSv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_NC_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/usages",
+            "currentValue": 12,
+            "limit": 24,
+            "name": {
+              "localizedValue": "Standard NC Family Cluster Dedicated vCPUs",
+              "value": "Standard NC Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/usages/Standard_NC_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspace/usages",
+            "currentValue": 6,
+            "limit": 24,
+            "name": {
+              "localizedValue": "Standard NC Family Cluster Dedicated vCPUs",
+              "value": "Standard NC Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/computes/demo_cluster1_nc/usages/Standard_NC_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspace/computes/usages",
+            "currentValue": 6,
+            "limit": 24,
+            "name": {
+              "localizedValue": "Standard NC Family Cluster Dedicated vCPUs",
+              "value": "Standard NC Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/usages/Standard_NC_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/usages",
+            "currentValue": 6,
+            "limit": 24,
+            "name": {
+              "value": "Standard NC Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard NC Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/computes/demo_cluser1_nc/usages/Standard_NC_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/computes/usages",
+            "currentValue": 6,
+            "limit": 24,
+            "name": {
+              "value": "Standard NC Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard NC Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_NCv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/usages",
+            "currentValue": 0,
+            "limit": 0,
+            "name": {
+              "localizedValue": "Standard NCv2 Family Cluster Dedicated vCPUs",
+              "value": "Standard NCv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_NCv3_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/usages",
+            "currentValue": 0,
+            "limit": 0,
+            "name": {
+              "localizedValue": "Standard NCv3 Family Cluster Dedicated vCPUs",
+              "value": "Standard NCv3 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_ND_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/usages",
+            "currentValue": 0,
+            "limit": 0,
+            "name": {
+              "localizedValue": "Standard ND Family Cluster Dedicated vCPUs",
+              "value": "Standard ND Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_NDv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/usages",
+            "currentValue": 0,
+            "limit": 0,
+            "name": {
+              "value": "Standard NDv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard NDv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_NV_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/usages",
+            "currentValue": 0,
+            "limit": 24,
+            "name": {
+              "localizedValue": "Standard NV Family Cluster Dedicated vCPUs",
+              "value": "Standard NV Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages",
+            "type": "Microsoft.MachineLearningServices/lowPriorityCores/usages",
+            "currentValue": 18,
+            "limit": 50,
+            "name": {
+              "localizedValue": "Total Cluster LowPriority Regional vCPUs",
+              "value": "Total Cluster LowPriority Regional vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_D_Family_Cluster_LowPriority_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/usages",
+            "currentValue": 0,
+            "limit": -1,
+            "name": {
+              "value": "Standard D Family Cluster LowPriority vCPUs",
+              "localizedValue": "Standard D Family Cluster LowPriority vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_DSv2_Family_Cluster_LowPriority_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/usages",
+            "currentValue": 0,
+            "limit": -1,
+            "name": {
+              "localizedValue": "Standard DSv2 Family Cluster LowPriority vCPUs",
+              "value": "Standard DSv2 Family Cluster LowPriority vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_Dv2_Family_Cluster_LowPriority_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/usages",
+            "currentValue": 0,
+            "limit": -1,
+            "name": {
+              "localizedValue": "Standard Dv2 Family Cluster LowPriority vCPUs",
+              "value": "Standard Dv2 Family Cluster LowPriority vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_FSv2_Family_Cluster_LowPriority_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/usages",
+            "currentValue": 0,
+            "limit": -1,
+            "name": {
+              "localizedValue": "Standard FSv2 Family Cluster LowPriority vCPUs",
+              "value": "Standard FSv2 Family Cluster LowPriority vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_NC_Family_Cluster_LowPriority_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/usages",
+            "currentValue": 18,
+            "limit": -1,
+            "name": {
+              "localizedValue": "Standard NC Family Cluster LowPriority vCPUs",
+              "value": "Standard NC Family Cluster LowPriority vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/usages/Standard_NC_Family_Cluster_LowPriority_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspace/usages",
+            "currentValue": 6,
+            "limit": -1,
+            "name": {
+              "localizedValue": "Standard NC Family Cluster LowPriority vCPUs",
+              "value": "Standard NC Family Cluster LowPriority vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/computes/demo_cluster1_lowPriority_nc/usages/Standard_NC_Family_Cluster_LowPriority_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspace/computes/usages",
+            "currentValue": 6,
+            "limit": -1,
+            "name": {
+              "localizedValue": "Standard NC Family Cluster LowPriority vCPUs",
+              "value": "Standard NC Family Cluster LowPriority vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/usages/Standard_NC_Family_Cluster_LowPriority_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspace/usages",
+            "currentValue": 12,
+            "limit": -1,
+            "name": {
+              "localizedValue": "Standard NC Family Cluster LowPriority vCPUs",
+              "value": "Standard NC Family Cluster LowPriority vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/computes/demo_cluster2_lowPriority_nc/usages/Standard_NC_Family_Cluster_LowPriority_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspace/computes/usages",
+            "currentValue": 6,
+            "limit": -1,
+            "name": {
+              "localizedValue": "Standard NC Family Cluster LowPriority vCPUs",
+              "value": "Standard NC Family Cluster LowPriority vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/computes/demo_cluster3_lowPriority_nc/usages/Standard_NC_Family_Cluster_LowPriority_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspace/computes/usages",
+            "currentValue": 6,
+            "limit": -1,
+            "name": {
+              "localizedValue": "Standard NC Family Cluster LowPriority vCPUs",
+              "value": "Standard NC Family Cluster LowPriority vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_NCv2_Family_Cluster_LowPriority_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/usages",
+            "currentValue": 0,
+            "limit": -1,
+            "name": {
+              "localizedValue": "Standard NCv2 Family Cluster LowPriority vCPUs",
+              "value": "Standard NCv2 Family Cluster LowPriority vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_NCv3_Family_Cluster_LowPriority_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/usages",
+            "currentValue": 0,
+            "limit": -1,
+            "name": {
+              "localizedValue": "Standard NCv3 Family Cluster LowPriority vCPUs",
+              "value": "Standard NCv3 Family Cluster LowPriority vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_ND_Family_Cluster_LowPriority_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/usages",
+            "currentValue": 0,
+            "limit": -1,
+            "name": {
+              "localizedValue": "Standard ND Family Cluster LowPriority vCPUs",
+              "value": "Standard ND Family Cluster LowPriority vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_NDv2_Family_Cluster_LowPriority_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/usages",
+            "currentValue": 0,
+            "limit": -1,
+            "name": {
+              "localizedValue": "Standard NDv2 Family Cluster LowPriority vCPUs",
+              "value": "Standard NDv2 Family Cluster LowPriority vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_NV_Family_Cluster_LowPriority_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/usages",
+            "currentValue": 0,
+            "limit": -1,
+            "name": {
+              "localizedValue": "Standard NV Family Cluster LowPriority vCPUs",
+              "value": "Standard NV Family Cluster LowPriority vCPUs"
+            },
+            "unit": "Count"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/ListVMSizesResult.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/ListVMSizesResult.json
new file mode 100644
index 000000000000..f6c8ebb8deb5
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/ListVMSizesResult.json
@@ -0,0 +1,455 @@
+{
+  "parameters": {
+    "subscriptionId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
+    "api-version": "2020-02-18-preview",
+    "location": "eastus"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "amlCompute": [
+          {
+            "name": "Standard_F2s_v2",
+            "family": "standardFSv2Family",
+            "vCPUs": 2,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 16384,
+            "memoryGB": 4.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_F4s_v2",
+            "family": "standardFSv2Family",
+            "vCPUs": 4,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 32768,
+            "memoryGB": 8.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_F8s_v2",
+            "family": "standardFSv2Family",
+            "vCPUs": 8,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 65536,
+            "memoryGB": 16.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_F16s_v2",
+            "family": "standardFSv2Family",
+            "vCPUs": 16,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 131072,
+            "memoryGB": 32.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_F32s_v2",
+            "family": "standardFSv2Family",
+            "vCPUs": 32,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 262144,
+            "memoryGB": 64.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_F64s_v2",
+            "family": "standardFSv2Family",
+            "vCPUs": 64,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 524288,
+            "memoryGB": 128.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_F72s_v2",
+            "family": "standardFSv2Family",
+            "vCPUs": 72,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 589824,
+            "memoryGB": 144.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_D1_v2",
+            "family": "standardDv2Family",
+            "vCPUs": 1,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 51200,
+            "memoryGB": 3.5,
+            "lowPriorityCapable": true,
+            "premiumIO": false
+          },
+          {
+            "name": "Standard_D2_v2",
+            "family": "standardDv2Family",
+            "vCPUs": 2,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 102400,
+            "memoryGB": 7.0,
+            "lowPriorityCapable": true,
+            "premiumIO": false
+          },
+          {
+            "name": "Standard_D3_v2",
+            "family": "standardDv2Family",
+            "vCPUs": 4,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 204800,
+            "memoryGB": 14.0,
+            "lowPriorityCapable": true,
+            "premiumIO": false
+          },
+          {
+            "name": "Standard_D4_v2",
+            "family": "standardDv2Family",
+            "vCPUs": 8,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 409600,
+            "memoryGB": 28.0,
+            "lowPriorityCapable": true,
+            "premiumIO": false
+          },
+          {
+            "name": "Standard_D11_v2",
+            "family": "standardDv2Family",
+            "vCPUs": 2,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 102400,
+            "memoryGB": 14.0,
+            "lowPriorityCapable": true,
+            "premiumIO": false
+          },
+          {
+            "name": "Standard_D12_v2",
+            "family": "standardDv2Family",
+            "vCPUs": 4,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 204800,
+            "memoryGB": 28.0,
+            "lowPriorityCapable": true,
+            "premiumIO": false
+          },
+          {
+            "name": "Standard_D13_v2",
+            "family": "standardDv2Family",
+            "vCPUs": 8,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 409600,
+            "memoryGB": 56.0,
+            "lowPriorityCapable": true,
+            "premiumIO": false
+          },
+          {
+            "name": "Standard_D14_v2",
+            "family": "standardDv2Family",
+            "vCPUs": 16,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 819200,
+            "memoryGB": 112.0,
+            "lowPriorityCapable": true,
+            "premiumIO": false
+          },
+          {
+            "name": "Standard_DS1_v2",
+            "family": "standardDSv2Family",
+            "vCPUs": 1,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 7168,
+            "memoryGB": 3.5,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_DS2_v2",
+            "family": "standardDSv2Family",
+            "vCPUs": 2,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 14336,
+            "memoryGB": 7.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_DS3_v2",
+            "family": "standardDSv2Family",
+            "vCPUs": 4,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 28672,
+            "memoryGB": 14.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_DS4_v2",
+            "family": "standardDSv2Family",
+            "vCPUs": 8,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 57344,
+            "memoryGB": 28.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_DS5_v2",
+            "family": "standardDSv2Family",
+            "vCPUs": 16,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 114688,
+            "memoryGB": 56.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_DS11_v2",
+            "family": "standardDSv2Family",
+            "vCPUs": 2,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 28672,
+            "memoryGB": 14.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_DS12_v2",
+            "family": "standardDSv2Family",
+            "vCPUs": 4,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 57344,
+            "memoryGB": 28.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_DS13_v2",
+            "family": "standardDSv2Family",
+            "vCPUs": 8,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 114688,
+            "memoryGB": 56.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_DS14_v2",
+            "family": "standardDSv2Family",
+            "vCPUs": 16,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 229376,
+            "memoryGB": 112.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_DS15_v2",
+            "family": "standardDSv2Family",
+            "vCPUs": 20,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 286720,
+            "memoryGB": 140.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_NC6s_v2",
+            "family": "standardNCSv2Family",
+            "vCPUs": 6,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 344064,
+            "memoryGB": 112.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_NC12s_v2",
+            "family": "standardNCSv2Family",
+            "vCPUs": 12,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 688128,
+            "memoryGB": 224.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_NC24rs_v2",
+            "family": "standardNCSv2Family",
+            "vCPUs": 24,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 1376256,
+            "memoryGB": 448.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_NC24s_v2",
+            "family": "standardNCSv2Family",
+            "vCPUs": 24,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 1376256,
+            "memoryGB": 448.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_NC6s_v3",
+            "family": "standardNCSv3Family",
+            "vCPUs": 6,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 344064,
+            "memoryGB": 112.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_NC12s_v3",
+            "family": "standardNCSv3Family",
+            "vCPUs": 12,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 688128,
+            "memoryGB": 224.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_NC24rs_v3",
+            "family": "standardNCSv3Family",
+            "vCPUs": 24,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 1376256,
+            "memoryGB": 448.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_NC24s_v3",
+            "family": "standardNCSv3Family",
+            "vCPUs": 24,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 1376256,
+            "memoryGB": 448.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_NC6",
+            "family": "standardNCFamily",
+            "vCPUs": 6,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 389120,
+            "memoryGB": 56.0,
+            "lowPriorityCapable": true,
+            "premiumIO": false
+          },
+          {
+            "name": "Standard_NC12",
+            "family": "standardNCFamily",
+            "vCPUs": 12,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 696320,
+            "memoryGB": 112.0,
+            "lowPriorityCapable": true,
+            "premiumIO": false
+          },
+          {
+            "name": "Standard_NC24",
+            "family": "standardNCFamily",
+            "vCPUs": 24,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 1474560,
+            "memoryGB": 224.0,
+            "lowPriorityCapable": true,
+            "premiumIO": false
+          },
+          {
+            "name": "Standard_NC24r",
+            "family": "standardNCFamily",
+            "vCPUs": 24,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 1474560,
+            "memoryGB": 224.0,
+            "lowPriorityCapable": true,
+            "premiumIO": false
+          },
+          {
+            "name": "Standard_NV6",
+            "family": "standardNVFamily",
+            "vCPUs": 6,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 389120,
+            "memoryGB": 56.0,
+            "lowPriorityCapable": true,
+            "premiumIO": false
+          },
+          {
+            "name": "Standard_NV12",
+            "family": "standardNVFamily",
+            "vCPUs": 12,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 696320,
+            "memoryGB": 112.0,
+            "lowPriorityCapable": true,
+            "premiumIO": false
+          },
+          {
+            "name": "Standard_NV24",
+            "family": "standardNVFamily",
+            "vCPUs": 24,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 1474560,
+            "memoryGB": 224.0,
+            "lowPriorityCapable": true,
+            "premiumIO": false
+          },
+          {
+            "name": "Standard_ND6s",
+            "family": "standardNDSFamily",
+            "vCPUs": 6,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 344064,
+            "memoryGB": 112.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_ND12s",
+            "family": "standardNDSFamily",
+            "vCPUs": 12,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 688128,
+            "memoryGB": 224.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_ND24rs",
+            "family": "standardNDSFamily",
+            "vCPUs": 24,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 1376256,
+            "memoryGB": 448.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          },
+          {
+            "name": "Standard_ND24s",
+            "family": "standardNDSFamily",
+            "vCPUs": 24,
+            "osVhdSizeMB": 1047552,
+            "maxResourceVolumeMB": 1376256,
+            "memoryGB": 448.0,
+            "lowPriorityCapable": true,
+            "premiumIO": true
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/ListWorkspaceFeatures.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/ListWorkspaceFeatures.json
new file mode 100644
index 000000000000..6d6f05afcb3b
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/ListWorkspaceFeatures.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "api-version": "2020-02-18-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "myResourceGroup",
+    "workspaceName": "testworkspace"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "automatedml_createeditexperimentsui",
+            "displayName": "Create edit experiments UI",
+            "description": "Create, edit or delete AutoML experiments in the SDK"
+          },
+          {
+            "id": "workspace_upgradeworkspaceui",
+            "displayName": "Upgrade workspace UI",
+            "description": "Upgrade workspace from Basic to enterprise from the UI"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/ListWorkspaceQuotasByVMFamily.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/ListWorkspaceQuotasByVMFamily.json
new file mode 100644
index 000000000000..e401271fe5bc
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/ListWorkspaceQuotasByVMFamily.json
@@ -0,0 +1,415 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "location": "eastus",
+    "api-version": "2020-02-18-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/quotas/Standard_D_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/quotas",
+            "limit": 48,
+            "name": {
+              "localizedValue": "Standard D Family Cluster Dedicated vCPUs",
+              "value": "Standard D Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/quotas/Standard_D_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 12,
+            "name": {
+              "value": "Standard D Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard D Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/quotas/Standard_D_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 12,
+            "name": {
+              "value": "Standard D Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard D Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace3/quotas/Standard_D_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 24,
+            "name": {
+              "value": "Standard D Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard D Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/quotas/Standard_DSv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/quota",
+            "limit": 24,
+            "name": {
+              "value": "Standard DSv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard DSv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/quotas/Standard_DSv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 24,
+            "name": {
+              "value": "Standard DSv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard DSv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/quotas/Standard_DSv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 12,
+            "name": {
+              "value": "Standard DSv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard DSv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace3/quotas/Standard_DSv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 12,
+            "name": {
+              "value": "Standard DSv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard DSv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/quotas/Standard_Dv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/quotas",
+            "limit": 24,
+            "name": {
+              "localizedValue": "Standard Dv2 Family Cluster Dedicated vCPUs",
+              "value": "Standard Dv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/quotas/Standard_Dv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 0,
+            "name": {
+              "value": "Standard Dv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard Dv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/quotas/Standard_Dv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 24,
+            "name": {
+              "value": "Standard Dv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard Dv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace3/quotas/Standard_Dv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 0,
+            "name": {
+              "value": "Standard Dv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard Dv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/quotas/Standard_FSv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/quotas",
+            "limit": 24,
+            "name": {
+              "value": "Standard FSv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard FSv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/quotas/Standard_FSv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 0,
+            "name": {
+              "value": "Standard FSv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard FSv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/quotas/Standard_FSv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 24,
+            "name": {
+              "value": "Standard FSv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard FSv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace3/quotas/Standard_FSv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 12,
+            "name": {
+              "value": "Standard FSv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard FSv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/quotas/Standard_NC_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/quotas",
+            "limit": 24,
+            "name": {
+              "localizedValue": "Standard NC Family Cluster Dedicated vCPUs",
+              "value": "Standard NC Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/quotas/Standard_NC_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 24,
+            "name": {
+              "value": "Standard NC Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard NC Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/quotas/Standard_NC_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 24,
+            "name": {
+              "value": "Standard NC Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard NC Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace3/quotas/Standard_NC_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 24,
+            "name": {
+              "value": "Standard NC Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard NC Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/quotas/Standard_NCv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/quotas",
+            "limit": 0,
+            "name": {
+              "localizedValue": "Standard NCv2 Family Cluster Dedicated vCPUs",
+              "value": "Standard NCv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/quotas/Standard_NCv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 0,
+            "name": {
+              "value": "Standard NCv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard NCv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/quotas/Standard_NCv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 0,
+            "name": {
+              "value": "Standard NCv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard NCv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace3/quotas/Standard_NCv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 0,
+            "name": {
+              "value": "Standard NCv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard NCv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/quotas/Standard_NCv3_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/quotas",
+            "limit": 0,
+            "name": {
+              "localizedValue": "Standard NCv3 Family Cluster Dedicated vCPUs",
+              "value": "Standard NCv3 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/quotas/Standard_NCv3_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 0,
+            "name": {
+              "value": "Standard NCv3 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard NCv3 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/quotas/Standard_NCv3_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 0,
+            "name": {
+              "value": "Standard NCv3 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard NCv3 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace3/quotas/Standard_NCv3_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 0,
+            "name": {
+              "value": "Standard NCv3 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard NCv3 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/quotas/Standard_ND_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/quotas",
+            "limit": 0,
+            "name": {
+              "localizedValue": "Standard ND Family Cluster Dedicated vCPUs",
+              "value": "Standard ND Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/quotas/Standard_ND_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 0,
+            "name": {
+              "value": "Standard ND Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard ND Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/quotas/Standard_ND_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 0,
+            "name": {
+              "value": "Standard ND Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard ND Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace3/quotas/Standard_ND_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 0,
+            "name": {
+              "value": "Standard ND Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard ND Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/quotas/Standard_NDv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/quotas",
+            "limit": 0,
+            "name": {
+              "value": "Standard NDv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard NDv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/quotas/Standard_NDv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 0,
+            "name": {
+              "value": "Standard NDv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard NDv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/quotas/Standard_NDv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 0,
+            "name": {
+              "value": "Standard NDv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard NDv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace3/quotas/Standard_NDv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 0,
+            "name": {
+              "value": "Standard NDv2 Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard NDv2 Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/quotas/Standard_NV_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/vmFamily/quotas",
+            "limit": 24,
+            "name": {
+              "localizedValue": "Standard NV Family Cluster Dedicated vCPUs",
+              "value": "Standard NV Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/quotas/Standard_NV_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 24,
+            "name": {
+              "value": "Standard NV Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard NV Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/quotas/Standard_NV_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 24,
+            "name": {
+              "value": "Standard NV Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard NV Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace3/quotas/Standard_NV_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 24,
+            "name": {
+              "value": "Standard NV Family Cluster Dedicated vCPUs",
+              "localizedValue": "Standard NV Family Cluster Dedicated vCPUs"
+            },
+            "unit": "Count"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/amlComputeListNodes.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/amlComputeListNodes.json
new file mode 100644
index 000000000000..80a80592ec11
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/amlComputeListNodes.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "subscriptionId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
+    "resourceGroupName": "testrg123",
+    "workspaceName": "workspaces123",
+    "computeName": "compute123",
+    "api-version": "2020-02-18-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "computeType": "AmlCompute",
+        "nodes": [
+          {
+            "nodeId": "tvm-3601533753_1-20170719t162906z",
+            "privateIpAddress": "13.84.190.124",
+            "publicIpAddress": "13.84.190.134",
+            "port": 50000,
+            "nodeState": "running",
+            "runId": "2f378a44-38f2-443a-9f0d-9909d0b47890"
+          },
+          {
+            "nodeId": "tvm-3601533753_2-20170719t162906z",
+            "privateIpAddress": "13.84.190.124",
+            "publicIpAddress": "13.84.190.134",
+            "port": 50001,
+            "nodeState": "idle"
+          }
+        ],
+        "nextLink": "nextLink"
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/createBasicAKSCompute.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/createBasicAKSCompute.json
new file mode 100644
index 000000000000..f491e3784a91
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/createBasicAKSCompute.json
@@ -0,0 +1,44 @@
+{
+  "parameters": {
+    "subscriptionId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
+    "resourceGroupName": "testrg123",
+    "workspaceName": "workspaces123",
+    "computeName": "compute123",
+    "api-version": "2020-02-18-preview",
+    "parameters": {
+      "location": "eastus",
+      "properties": {
+        "computeType": "AKS"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
+        "type": "Microsoft.MachineLearningServices/workspaces/computes",
+        "name": "compute123",
+        "location": "eastus",
+        "properties": {
+          "computeType": "AKS",
+          "provisioningState": "Creating"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
+        "type": "Microsoft.MachineLearningServices/workspaces/computes",
+        "name": "compute123",
+        "location": "eastus",
+        "properties": {
+          "computeType": "AKS",
+          "provisioningState": "Creating"
+        }
+      },
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/...pathToOperationStatus..."
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/createBasicAmlCompute.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/createBasicAmlCompute.json
new file mode 100644
index 000000000000..df6e59c449e1
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/createBasicAmlCompute.json
@@ -0,0 +1,54 @@
+{
+  "parameters": {
+    "subscriptionId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
+    "resourceGroupName": "testrg123",
+    "workspaceName": "workspaces123",
+    "computeName": "compute123",
+    "api-version": "2020-02-18-preview",
+    "parameters": {
+      "location": "eastus",
+      "properties": {
+        "computeType": "AmlCompute",
+        "properties": {
+          "vmSize": "STANDARD_NC6",
+          "vmPriority": "Dedicated",
+          "scaleSettings": {
+            "maxNodeCount": 1,
+            "minNodeCount": 0,
+            "nodeIdleTimeBeforeScaleDown": "PT5M"
+          },
+          "remoteLoginPortPublicAccess": "NotSpecified"
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
+        "type": "Microsoft.MachineLearningServices/workspaces/computes",
+        "name": "compute123",
+        "location": "eastus",
+        "properties": {
+          "computeType": "AmlCompute",
+          "provisioningState": "Creating"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
+        "type": "Microsoft.MachineLearningServices/workspaces/computes",
+        "name": "compute123",
+        "location": "eastus",
+        "properties": {
+          "computeType": "AmlCompute",
+          "provisioningState": "Creating"
+        }
+      },
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/...pathToOperationStatus..."
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/createBasicDataFactoryCompute.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/createBasicDataFactoryCompute.json
new file mode 100644
index 000000000000..cbac0e3b16ff
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/createBasicDataFactoryCompute.json
@@ -0,0 +1,44 @@
+{
+  "parameters": {
+    "subscriptionId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
+    "resourceGroupName": "testrg123",
+    "workspaceName": "workspaces123",
+    "computeName": "compute123",
+    "api-version": "2020-02-18-preview",
+    "parameters": {
+      "location": "eastus",
+      "properties": {
+        "computeType": "DataFactory"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
+        "type": "Microsoft.MachineLearningServices/workspaces/computes",
+        "name": "compute123",
+        "location": "eastus",
+        "properties": {
+          "computeType": "DataFactory",
+          "provisioningState": "Creating"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
+        "type": "Microsoft.MachineLearningServices/workspaces/computes",
+        "name": "compute123",
+        "location": "eastus",
+        "properties": {
+          "computeType": "DataFactory",
+          "provisioningState": "Creating"
+        }
+      },
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/...pathToOperationStatus..."
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/createComputeInstance.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/createComputeInstance.json
new file mode 100644
index 000000000000..ff84d4308695
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/createComputeInstance.json
@@ -0,0 +1,52 @@
+{
+  "parameters": {
+    "subscriptionId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
+    "resourceGroupName": "testrg123",
+    "workspaceName": "workspaces123",
+    "computeName": "compute123",
+    "api-version": "2020-02-18-preview",
+    "parameters": {
+      "location": "eastus",
+      "properties": {
+        "computeType": "ComputeInstance",
+        "properties": {
+          "vmSize": "STANDARD_NC6",
+          "subnet": "test-subnet-resource-id",
+          "applicationSharingPolicy": "Personal",
+          "sshSettings": {
+            "sshPublicAccess": "Disabled"
+          }
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
+        "type": "Microsoft.MachineLearningServices/workspaces/computes",
+        "name": "compute123",
+        "location": "eastus",
+        "properties": {
+          "computeType": "ComputeInstance",
+          "provisioningState": "Creating"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
+        "type": "Microsoft.MachineLearningServices/workspaces/computes",
+        "name": "compute123",
+        "location": "eastus",
+        "properties": {
+          "computeType": "ComputeInstance",
+          "provisioningState": "Creating"
+        }
+      },
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/...pathToOperationStatus..."
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/createComputeInstanceMinimal.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/createComputeInstanceMinimal.json
new file mode 100644
index 000000000000..3aa86d408d76
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/createComputeInstanceMinimal.json
@@ -0,0 +1,47 @@
+{
+  "parameters": {
+    "subscriptionId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
+    "resourceGroupName": "testrg123",
+    "workspaceName": "workspaces123",
+    "computeName": "compute123",
+    "api-version": "2020-02-18-preview",
+    "parameters": {
+      "location": "eastus",
+      "properties": {
+        "computeType": "ComputeInstance",
+        "properties": {
+          "vmSize": "STANDARD_NC6"
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
+        "type": "Microsoft.MachineLearningServices/workspaces/computes",
+        "name": "compute123",
+        "location": "eastus",
+        "properties": {
+          "computeType": "ComputeInstance",
+          "provisioningState": "Creating"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
+        "type": "Microsoft.MachineLearningServices/workspaces/computes",
+        "name": "compute123",
+        "location": "eastus",
+        "properties": {
+          "computeType": "ComputeInstance",
+          "provisioningState": "Creating"
+        }
+      },
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/...pathToOperationStatus..."
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/createWorkspace.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/createWorkspace.json
new file mode 100644
index 000000000000..2012134c758d
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/createWorkspace.json
@@ -0,0 +1,127 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-1111-2222-3333-444444444444",
+    "resourceGroupName": "workspace-1234",
+    "workspaceName": "testworkspace",
+    "api-version": "2020-02-18-preview",
+    "parameters": {
+      "location": "eastus2euap",
+      "sku": {
+        "name": "Basic",
+        "tier": "Basic"
+      },
+      "properties": {
+        "friendlyName": "HelloName",
+        "description": "test description",
+        "containerRegistry": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.ContainerRegistry/registries/testRegistry",
+        "keyVault": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.KeyVault/vaults/testkv",
+        "applicationInsights": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/microsoft.insights/components/testinsights",
+        "storageAccount": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/accountcrud-1234/providers/Microsoft.Storage/storageAccounts/testStorageAccount",
+        "encryption": {
+          "status": "Enabled",
+          "keyVaultProperties": {
+            "keyVaultArmId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.KeyVault/vaults/testkv",
+            "keyIdentifier": "https://testkv.vault.azure.net/keys/testkey/aabbccddee112233445566778899aabb",
+            "identityClientId": ""
+          }
+        },
+        "hbiWorkspace": false
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace",
+        "name": "testworkspace",
+        "type": "Microsoft.MachineLearningServices/workspaces",
+        "location": "eastus2euap",
+        "sku": {
+          "name": "Basic",
+          "tier": "Basic"
+        },
+        "properties": {
+          "containerRegistry": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.ContainerRegistry/registries/testRegistry",
+          "keyVault": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.KeyVault/vaults/testkv",
+          "applicationInsights": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/microsoft.insights/components/testinsights",
+          "storageAccount": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/accountcrud-1234/providers/Microsoft.Storage/storageAccounts/testStorageAccount",
+          "discoveryUrl": "http://example.com",
+          "creationTime": "2017-03-01T23:14:37.0707808Z",
+          "friendlyName": "HelloName",
+          "description": "test description",
+          "encryption": {
+            "status": "Enabled",
+            "keyVaultProperties": {
+              "keyVaultArmId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.KeyVault/vaults/testkv",
+              "keyIdentifier": "https://testkv.vault.azure.net/keys/testkey/aabbccddee112233445566778899aabb",
+              "identityClientId": ""
+            }
+          },
+          "hbiWorkspace": false
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace",
+        "name": "testworkspace",
+        "type": "Microsoft.MachineLearningServices/workspaces",
+        "location": "eastus2euap",
+        "sku": {
+          "name": "Basic",
+          "tier": "Basic"
+        },
+        "properties": {
+          "containerRegistry": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.ContainerRegistry/registries/testRegistry",
+          "keyVault": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.KeyVault/vaults/testkv",
+          "applicationInsights": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/microsoft.insights/components/testinsights",
+          "storageAccount": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/accountcrud-1234/providers/Microsoft.Storage/storageAccounts/testStorageAccount",
+          "discoveryUrl": "http://example.com",
+          "creationTime": "2017-03-01T23:14:37.0707808Z",
+          "friendlyName": "HelloName",
+          "description": "test description",
+          "encryption": {
+            "status": "Enabled",
+            "keyVaultProperties": {
+              "keyVaultArmId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.KeyVault/vaults/testkv",
+              "keyIdentifier": "https://testkv.vault.azure.net/keys/testkey/aabbccddee112233445566778899aabb",
+              "identityClientId": ""
+            }
+          },
+          "hbiWorkspace": false
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace",
+        "name": "testworkspace",
+        "type": "Microsoft.MachineLearningServices/workspaces",
+        "location": "eastus2euap",
+        "sku": {
+          "name": "Basic",
+          "tier": "Basic"
+        },
+        "properties": {
+          "containerRegistry": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.ContainerRegistry/registries/testRegistry",
+          "keyVault": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.KeyVault/vaults/testkv",
+          "applicationInsights": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/microsoft.insights/components/testinsights",
+          "storageAccount": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/accountcrud-1234/providers/Microsoft.Storage/storageAccounts/testStorageAccount",
+          "discoveryUrl": "http://example.com",
+          "creationTime": "2017-03-01T23:14:37.0707808Z",
+          "friendlyName": "HelloName",
+          "description": "test description",
+          "encryption": {
+            "status": "Enabled",
+            "keyVaultProperties": {
+              "keyVaultArmId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.KeyVault/vaults/testkv",
+              "keyIdentifier": "https://testkv.vault.azure.net/keys/testkey/aabbccddee112233445566778899aabb",
+              "identityClientId": ""
+            }
+          },
+          "hbiWorkspace": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/deleteCompute.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/deleteCompute.json
new file mode 100644
index 000000000000..42c0626dc9df
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/deleteCompute.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "subscriptionId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
+    "resourceGroupName": "testrg123",
+    "workspaceName": "workspaces123",
+    "computeName": "compute123",
+    "api-version": "2020-02-18-preview",
+    "underlyingResourceAction": "Delete"
+  },
+  "responses": {
+    "200": {},
+    "202": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/...pathToOperationStatus...",
+        "Location": "https://management.azure.com/subscriptions/...pathToOperationResult..."
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/deleteWorkspace.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/deleteWorkspace.json
new file mode 100644
index 000000000000..a973a13a3e93
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/deleteWorkspace.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-1111-2222-3333-444444444444",
+    "resourceGroupName": "workspace-1234",
+    "workspaceName": "testworkspace",
+    "api-version": "2020-02-18-preview"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/getAKSCompute.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/getAKSCompute.json
new file mode 100644
index 000000000000..d42737e87c4b
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/getAKSCompute.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "subscriptionId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
+    "resourceGroupName": "testrg123",
+    "workspaceName": "workspaces123",
+    "computeName": "compute123",
+    "api-version": "2020-02-18-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
+        "type": "Microsoft.MachineLearningServices/workspaces/computes",
+        "name": "compute123",
+        "location": "eastus",
+        "properties": {
+          "description": "some compute",
+          "resourceId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourcegroups/testrg123/providers/Microsoft.ContainerService/managedClusters/compute123-56826-c9b00420020b2",
+          "computeType": "AKS",
+          "provisioningState": "Succeeded"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/getAmlCompute.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/getAmlCompute.json
new file mode 100644
index 000000000000..6809f3c45a83
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/getAmlCompute.json
@@ -0,0 +1,49 @@
+{
+  "parameters": {
+    "subscriptionId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
+    "resourceGroupName": "testrg123",
+    "workspaceName": "workspaces123",
+    "computeName": "compute123",
+    "api-version": "2020-02-18-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
+        "type": "Microsoft.MachineLearningServices/workspaces/computes",
+        "name": "compute123",
+        "location": "eastus2",
+        "properties": {
+          "description": "some compute",
+          "computeType": "AmlCompute",
+          "createdOn": "2017-09-26T22:28:08.327Z",
+          "provisioningState": "Succeeded",
+          "properties": {
+            "vmSize": "STANDARD_NC6",
+            "vmPriority": "Dedicated",
+            "subnet": "test-subnet-resource-id",
+            "scaleSettings": {
+              "maxNodeCount": 1,
+              "minNodeCount": 0,
+              "nodeIdleTimeBeforeScaleDown": "PT5M"
+            },
+            "remoteLoginPortPublicAccess": "Enabled",
+            "allocationState": "Resizing",
+            "allocationStateTransitionTime": "2017-09-27T22:28:08.998Z",
+            "errors": null,
+            "currentNodeCount": 0,
+            "targetNodeCount": 1,
+            "nodeStateCounts": {
+              "preparingNodeCount": 0,
+              "runningNodeCount": 0,
+              "idleNodeCount": 0,
+              "unusableNodeCount": 0,
+              "leavingNodeCount": 0,
+              "preemptedNodeCount": 0
+            }
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/getComputeInstance.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/getComputeInstance.json
new file mode 100644
index 000000000000..c368311a4b38
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/getComputeInstance.json
@@ -0,0 +1,52 @@
+{
+  "parameters": {
+    "subscriptionId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
+    "resourceGroupName": "testrg123",
+    "workspaceName": "workspaces123",
+    "computeName": "compute123",
+    "api-version": "2020-02-18-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
+        "type": "Microsoft.MachineLearningServices/workspaces/computes",
+        "name": "compute123",
+        "location": "eastus2",
+        "properties": {
+          "description": "some compute",
+          "computeType": "ComputeInstance",
+          "createdOn": "2017-09-26T22:28:08.327Z",
+          "provisioningState": "Succeeded",
+          "properties": {
+            "vmSize": "STANDARD_NC6",
+            "subnet": "test-subnet-resource-id",
+            "applicationSharingPolicy": "Shared",
+            "sshSettings": {
+              "sshPublicAccess": "Enabled",
+              "adminUserName": "azureuser",
+              "sshPort": 22
+            },
+            "createdBy": {
+              "userName": "foobar@microsoft.com",
+              "userOrgId": "00000000-0000-0000-0000-000000000000",
+              "userId": "00000000-0000-0000-0000-000000000000"
+            },
+            "connectivityEndpoints": {
+              "publicIpAddress": "10.0.0.1",
+              "privateIpAddress": "10.0.0.1"
+            },
+            "applications": [
+              {
+                "displayName": "Jupyter",
+                "endpointUri": "https://compute123.eastus2.azureml.net/jupyter"
+              }
+            ],
+            "errors": null,
+            "state": "Running"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/getComputes.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/getComputes.json
new file mode 100644
index 000000000000..fab1f721a9a8
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/getComputes.json
@@ -0,0 +1,41 @@
+{
+  "parameters": {
+    "subscriptionId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
+    "resourceGroupName": "testrg123",
+    "workspaceName": "workspaces123",
+    "api-version": "2020-02-18-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
+            "type": "Microsoft.MachineLearningServices/workspaces/computes",
+            "name": "compute123",
+            "location": "eastus",
+            "properties": {
+              "description": "some compute",
+              "resourceId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourcegroups/testrg123/providers/Microsoft.ContainerService/managedClusters/compute123-56826-c9b00420020b2",
+              "computeType": "AKS",
+              "provisioningState": "Succeeded"
+            }
+          },
+          {
+            "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute1234",
+            "type": "Microsoft.MachineLearningServices/workspaces/computes",
+            "name": "compute1234",
+            "location": "eastus",
+            "properties": {
+              "description": "some compute",
+              "resourceId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourcegroups/testrg123/providers/Microsoft.ContainerService/managedClusters/compute1234-56826-c9b00420020b2",
+              "computeType": "AKS",
+              "provisioningState": "Succeeded"
+            }
+          }
+        ],
+        "nextLink": "nextLink"
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/getWorkspace.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/getWorkspace.json
new file mode 100644
index 000000000000..60c8f7e2353e
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/getWorkspace.json
@@ -0,0 +1,42 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-1111-2222-3333-444444444444",
+    "resourceGroupName": "workspace-1234",
+    "workspaceName": "testworkspace",
+    "api-version": "2020-02-18-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace",
+        "name": "testworkspace",
+        "type": "Microsoft.MachineLearningServices/workspaces",
+        "location": "eastus2euap",
+        "sku": {
+          "name": "Enterprise",
+          "tier": "Enterprise"
+        },
+        "properties": {
+          "containerRegistry": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.ContainerRegistry/registries/testRegistry",
+          "keyVault": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.KeyVault/vaults/testkv",
+          "applicationInsights": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/microsoft.insights/components/testinsights",
+          "storageAccount": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/accountcrud-1234/providers/Microsoft.Storage/storageAccounts/testStorageAccount",
+          "discoveryUrl": "http://example.com",
+          "creationTime": "2017-03-01T23:14:37.0707808Z",
+          "friendlyName": "HelloName",
+          "description": "test description",
+          "encryption": {
+            "status": "Enabled",
+            "keyVaultProperties": {
+              "keyVaultArmId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.KeyVault/vaults/testkv",
+              "keyIdentifier": "https://testkv.vault.azure.net/keys/testkey/aabbccddee112233445566778899aabb",
+              "identityClientId": ""
+            }
+          },
+          "hbiWorkspace": false,
+          "serviceProvisionedResourceGroup": "testworkspace_0000111122223333"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/getWorkspacesByResourceGroup.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/getWorkspacesByResourceGroup.json
new file mode 100644
index 000000000000..0c2c862eb8e7
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/getWorkspacesByResourceGroup.json
@@ -0,0 +1,56 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-1111-2222-3333-444444444444",
+    "resourceGroupName": "workspace-1234",
+    "api-version": "2020-02-18-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace",
+            "name": "testworkspace",
+            "type": "Microsoft.MachineLearningServices/workspaces",
+            "location": "eastus2euap",
+            "sku": {
+              "name": "Basic",
+              "tier": "Basic"
+            },
+            "properties": {
+              "containerRegistry": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.ContainerRegistry/registries/testRegistry",
+              "keyVault": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.KeyVault/vaults/testkv",
+              "applicationInsights": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/microsoft.insights/components/testinsights",
+              "storageAccount": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/accountcrud-1234/providers/Microsoft.Storage/storageAccounts/testStorageAccount",
+              "discoveryUrl": "http://example.com",
+              "creationTime": "2017-03-01T23:14:37.0707808Z",
+              "friendlyName": "HelloName",
+              "description": "test description"
+            }
+          },
+          {
+            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace1",
+            "name": "testworkspace1",
+            "type": "Microsoft.MachineLearningServices/workspaces",
+            "location": "eastus2euap",
+            "sku": {
+              "name": "Basic",
+              "tier": "Basic"
+            },
+            "properties": {
+              "containerRegistry": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.ContainerRegistry/registries/testRegistryNew",
+              "keyVault": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.KeyVault/vaults/testkvNew",
+              "applicationInsights": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/microsoft.insights/components/testinsights",
+              "storageAccount": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/accountcrud-1234/providers/Microsoft.Storage/storageAccounts/testStorageAccountOld",
+              "discoveryUrl": "http://example.com",
+              "creationTime": "2017-03-01T23:14:37.0707808Z",
+              "friendlyName": "HelloName 1",
+              "description": "test description"
+            }
+          }
+        ],
+        "nextLink": "nextLink"
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/getWorkspacesBySubscription.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/getWorkspacesBySubscription.json
new file mode 100644
index 000000000000..17dac933ecc9
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/getWorkspacesBySubscription.json
@@ -0,0 +1,55 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-1111-2222-3333-444444444444",
+    "api-version": "2020-02-18-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace",
+            "name": "testworkspace",
+            "type": "Microsoft.MachineLearningServices/workspaces",
+            "location": "eastus2euap",
+            "sku": {
+              "name": "Enterprise",
+              "tier": "Enterprise"
+            },
+            "properties": {
+              "containerRegistry": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.ContainerRegistry/registries/testRegistry",
+              "keyVault": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.KeyVault/vaults/testkv",
+              "applicationInsights": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/microsoft.insights/components/testinsights",
+              "storageAccount": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/accountcrud-1234/providers/Microsoft.Storage/storageAccounts/testStorageAccount",
+              "discoveryUrl": "http://example.com",
+              "creationTime": "2017-03-01T23:14:37.0707808Z",
+              "friendlyName": "HelloName",
+              "description": "test description"
+            }
+          },
+          {
+            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-5678/providers/Microsoft.MachineLearningServices/workspaces/testworkspace",
+            "name": "testworkspace",
+            "type": "Microsoft.MachineLearningServices/workspaces",
+            "location": "eastus2euap",
+            "sku": {
+              "name": "Enterprise",
+              "tier": "Enterprise"
+            },
+            "properties": {
+              "containerRegistry": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.ContainerRegistry/registries/testRegistryNew",
+              "keyVault": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.KeyVault/vaults/testkvNew",
+              "applicationInsights": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/microsoft.insights/components/testinsights",
+              "storageAccount": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/accountcrud-1234/providers/Microsoft.Storage/storageAccounts/testStorageAccountOld",
+              "discoveryUrl": "http://example.com",
+              "creationTime": "2017-03-01T23:14:37.0707808Z",
+              "friendlyName": "HelloName",
+              "description": "test description"
+            }
+          }
+        ],
+        "nextLink": "nextLink"
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/listKeysAKSCompute.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/listKeysAKSCompute.json
new file mode 100644
index 000000000000..3d6c3a70801d
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/listKeysAKSCompute.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "subscriptionId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
+    "resourceGroupName": "testrg123",
+    "workspaceName": "workspaces123",
+    "computeName": "compute123",
+    "api-version": "2020-02-18-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "computeType": "AKS",
+        "userKubeConfig": "user kube config...",
+        "adminKubeConfig": "admin kube config...",
+        "imagePullSecretName": "the image pull secret name"
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/listWorkspaceKeys.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/listWorkspaceKeys.json
new file mode 100644
index 000000000000..3fabc0a7bcc6
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/listWorkspaceKeys.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "subscriptionId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
+    "resourceGroupName": "testrg123",
+    "workspaceName": "workspaces123",
+    "api-version": "2020-02-18-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "userStorageKey": "r5rKCJ018TLk+bdAi/9YaVzgcQ0nkLsUqGyUN03KsdCFtqG0SjFGPV8+vT1frWqkvBL0bGoPpLc1BlZSSaZmOA==",
+        "userStorageResourceId": "/subscriptions/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/resourceGroups/ragargeastus2euap/providers/Microsoft.Storage/storageAccounts/testdemoworkazashomr",
+        "appInsightsInstrumentationKey": null,
+        "containerRegistryCredentials": {
+          "location": null,
+          "username": "testdemoworkjmjmeykp",
+          "passwords": [
+            {
+              "name": "password",
+              "value": "vBvVhYgAGtUSewVCUv3w95p4/q5Yrsnw"
+            },
+            {
+              "name": "password2",
+              "value": "0KARRQoQHSUq1yViPWg7YFernOS=Ic/t"
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/patchAmlCompute.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/patchAmlCompute.json
new file mode 100644
index 000000000000..cc78aae3e43f
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/patchAmlCompute.json
@@ -0,0 +1,36 @@
+{
+  "parameters": {
+    "subscriptionId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
+    "resourceGroupName": "testrg123",
+    "workspaceName": "workspaces123",
+    "computeName": "compute123",
+    "api-version": "2020-02-18-preview",
+    "parameters": {
+      "properties": {
+        "scaleSettings": {
+          "maxNodeCount": 4,
+          "minNodeCount": 4,
+          "nodeIdleTimeBeforeScaleDown": "PT5M"
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
+        "type": "Microsoft.MachineLearningServices/workspaces/computes",
+        "name": "compute123",
+        "location": "eastus2",
+        "properties": {
+          "description": "some compute",
+          "computeType": "AmlCompute",
+          "provisioningState": "Updating"
+        }
+      },
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/...pathToOperationStatus..."
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/restartComputeInstance.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/restartComputeInstance.json
new file mode 100644
index 000000000000..04e8ec2789f3
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/restartComputeInstance.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "subscriptionId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
+    "resourceGroupName": "testrg123",
+    "workspaceName": "workspaces123",
+    "computeName": "compute123",
+    "api-version": "2020-02-18-preview"
+  },
+  "responses": {
+    "200": {}
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/resyncWorkspaceKeys.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/resyncWorkspaceKeys.json
new file mode 100644
index 000000000000..a93596d594d3
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/resyncWorkspaceKeys.json
@@ -0,0 +1,11 @@
+{
+  "parameters": {
+    "subscriptionId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
+    "resourceGroupName": "testrg123",
+    "workspaceName": "workspaces123",
+    "api-version": "2020-02-18-preview"
+  },
+  "responses": {
+    "200": {}
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/startComputeInstance.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/startComputeInstance.json
new file mode 100644
index 000000000000..04e8ec2789f3
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/startComputeInstance.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "subscriptionId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
+    "resourceGroupName": "testrg123",
+    "workspaceName": "workspaces123",
+    "computeName": "compute123",
+    "api-version": "2020-02-18-preview"
+  },
+  "responses": {
+    "200": {}
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/stopComputeInstance.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/stopComputeInstance.json
new file mode 100644
index 000000000000..04e8ec2789f3
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/stopComputeInstance.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "subscriptionId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
+    "resourceGroupName": "testrg123",
+    "workspaceName": "workspaces123",
+    "computeName": "compute123",
+    "api-version": "2020-02-18-preview"
+  },
+  "responses": {
+    "200": {}
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/updateAKSCompute.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/updateAKSCompute.json
new file mode 100644
index 000000000000..42e71959ac35
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/updateAKSCompute.json
@@ -0,0 +1,54 @@
+{
+  "parameters": {
+    "subscriptionId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
+    "resourceGroupName": "testrg123",
+    "workspaceName": "workspaces123",
+    "computeName": "compute123",
+    "api-version": "2020-02-18-preview",
+    "parameters": {
+      "id": "compute123",
+      "location": "eastus",
+      "properties": {
+        "description": "some compute",
+        "resourceId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourcegroups/testrg123/providers/Microsoft.ContainerService/managedClusters/compute123-56826-c9b00420020b2",
+        "computeType": "AKS",
+        "properties": {
+          "agentCount": 4
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
+        "type": "Microsoft.MachineLearningServices/workspaces/computes",
+        "name": "compute123",
+        "location": "eastus",
+        "properties": {
+          "description": "some compute",
+          "resourceId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourcegroups/testrg123/providers/Microsoft.ContainerService/managedClusters/compute123-56826-c9b00420020b2",
+          "computeType": "AKS",
+          "provisioningState": "Updating"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
+        "type": "Microsoft.MachineLearningServices/workspaces/computes",
+        "name": "compute123",
+        "location": "eastus",
+        "properties": {
+          "description": "some compute",
+          "resourceId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourcegroups/testrg123/providers/Microsoft.ContainerService/managedClusters/compute123-56826-c9b00420020b2",
+          "computeType": "AKS",
+          "provisioningState": "Updating"
+        }
+      },
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/...pathToOperationStatus..."
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/updateAmlCompute.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/updateAmlCompute.json
new file mode 100644
index 000000000000..8c543528291a
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/updateAmlCompute.json
@@ -0,0 +1,57 @@
+{
+  "parameters": {
+    "subscriptionId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
+    "resourceGroupName": "testrg123",
+    "workspaceName": "workspaces123",
+    "computeName": "compute123",
+    "api-version": "2020-02-18-preview",
+    "parameters": {
+      "location": "eastus",
+      "properties": {
+        "computeType": "AmlCompute",
+        "properties": {
+          "description": "some compute",
+          "computeType": "AmlCompute",
+          "properties": {
+            "scaleSettings": {
+              "maxNodeCount": 4,
+              "minNodeCount": 4,
+              "nodeIdleTimeBeforeScaleDown": "PT5M"
+            }
+          }
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
+        "type": "Microsoft.MachineLearningServices/workspaces/computes",
+        "name": "compute123",
+        "location": "eastus2",
+        "properties": {
+          "description": "some compute",
+          "computeType": "AmlCompute",
+          "provisioningState": "Updating"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
+        "type": "Microsoft.MachineLearningServices/workspaces/computes",
+        "name": "compute123",
+        "location": "eastus2",
+        "properties": {
+          "description": "some compute",
+          "computeType": "AmlCompute",
+          "provisioningState": "Updating"
+        }
+      },
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/...pathToOperationStatus..."
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/updateQuota.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/updateQuota.json
new file mode 100644
index 000000000000..98e40459697f
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/updateQuota.json
@@ -0,0 +1,45 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "location": "eastus",
+    "api-version": "2020-02-18-preview",
+    "parameters": {
+      "value": [
+        {
+          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/quotas/Standard_DSv2_Family_Cluster_Dedicated_vCPUs",
+          "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+          "limit": 100,
+          "unit": "Count"
+        },
+        {
+          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/quotas/Standard_DSv2_Family_Cluster_Dedicated_vCPUs",
+          "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+          "limit": 200,
+          "unit": "Count"
+        }
+      ]
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/quotas/Standard_DSv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 100,
+            "unit": "Count",
+            "status": "Success"
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/quotas/Standard_DSv2_Family_Cluster_Dedicated_vCPUs",
+            "type": "Microsoft.MachineLearningServices/workspaces/quotas",
+            "limit": 200,
+            "unit": "Count",
+            "status": "Success"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/updateWorkspace.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/updateWorkspace.json
new file mode 100644
index 000000000000..665b69b2b198
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/updateWorkspace.json
@@ -0,0 +1,42 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-1111-2222-3333-444444444444",
+    "resourceGroupName": "workspace-1234",
+    "workspaceName": "testworkspace",
+    "api-version": "2020-02-18-preview",
+    "parameters": {
+      "sku": {
+        "name": "Enterprise",
+        "tier": "Enterprise"
+      },
+      "properties": {
+        "friendlyName": "New friendly name",
+        "description": "new description"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace",
+        "name": "testworkspace",
+        "type": "Microsoft.MachineLearningServices/workspaces",
+        "location": "eastus2euap",
+        "sku": {
+          "name": "Enterprise",
+          "tier": "Enterprise"
+        },
+        "properties": {
+          "containerRegistry": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.ContainerRegistry/registries/testRegistry",
+          "keyVault": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/Microsoft.KeyVault/vaults/testkv",
+          "applicationInsights": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workspace-1234/providers/microsoft.insights/components/testinsights",
+          "storageAccount": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/accountcrud-1234/providers/Microsoft.Storage/storageAccounts/testStorageAccount",
+          "discoveryUrl": "http://example.com",
+          "creationTime": "2017-03-01T23:14:37.0707808Z",
+          "friendlyName": "New friendly name",
+          "description": "new description"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/workspaceDeletePrivateEndpointConnection.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/workspaceDeletePrivateEndpointConnection.json
new file mode 100644
index 000000000000..66ea9ba11e56
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/workspaceDeletePrivateEndpointConnection.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-1111-2222-3333-444444444444",
+    "resourceGroupName": "rg-1234",
+    "workspaceName": "testworkspace",
+    "privateEndpointConnectionName": "{privateEndpointConnectionName}",
+    "api-version": "2020-02-18-preview",
+    "monitor": "true"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/workspaceGetPrivateEndpointConnection.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/workspaceGetPrivateEndpointConnection.json
new file mode 100644
index 000000000000..fefdc38a3acf
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/workspaceGetPrivateEndpointConnection.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-1111-2222-3333-444444444444",
+    "resourceGroupName": "rg-1234",
+    "workspaceName": "testworkspace",
+    "privateEndpointConnectionName": "{privateEndpointConnectionName}",
+    "api-version": "2020-02-18-preview",
+    "monitor": "true"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/rg-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/privateEndpointConnections/{privateEndpointConnectionName}",
+        "name": "{privateEndpointConnectionName}",
+        "type": "Microsoft.MachineLearningServices/workspaces/privateEndpointConnections",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "privateEndpoint": {
+            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/rg-1234/providers/Microsoft.Network/privateEndpoints/petest01"
+          },
+          "privateLinkServiceConnectionState": {
+            "status": "Approved",
+            "description": "Auto-Approved",
+            "actionRequired": "None"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/workspaceListPrivateLinkResources.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/workspaceListPrivateLinkResources.json
new file mode 100644
index 000000000000..cae1379d01fe
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/workspaceListPrivateLinkResources.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-1111-2222-3333-444444444444",
+    "resourceGroupName": "rg-1234",
+    "workspaceName": "testworkspace",
+    "api-version": "2020-02-18-preview",
+    "monitor": "true"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/rg-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/privateLinkResources/amlworkspace",
+            "name": "amlworkspace",
+            "type": "Microsoft.Storage/workspaces/privateLinkResources",
+            "properties": {
+              "groupId": "amlworkspace",
+              "requiredMembers": [
+                "default"
+              ]
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/workspacePutPrivateEndpointConnection.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/workspacePutPrivateEndpointConnection.json
new file mode 100644
index 000000000000..bcdaee3cab98
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/examples/workspacePutPrivateEndpointConnection.json
@@ -0,0 +1,38 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-1111-2222-3333-444444444444",
+    "resourceGroupName": "rg-1234",
+    "workspaceName": "testworkspace",
+    "privateEndpointConnectionName": "{privateEndpointConnectionName}",
+    "api-version": "2020-02-18-preview",
+    "monitor": "true",
+    "properties": {
+      "properties": {
+        "privateLinkServiceConnectionState": {
+          "status": "Approved",
+          "description": "Auto-Approved"
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/rg-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/privateEndpointConnections/{privateEndpointConnectionName}",
+        "name": "{privateEndpointConnectionName}",
+        "type": "Microsoft.MachineLearningServices/workspaces/privateEndpointConnections",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "privateEndpoint": {
+            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/rg-1234/providers/Microsoft.Network/privateEndpoints/petest01"
+          },
+          "privateLinkServiceConnectionState": {
+            "status": "Approved",
+            "description": "Auto-Approved",
+            "actionRequired": "None"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/machineLearningServices.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/machineLearningServices.json
new file mode 100644
index 000000000000..6bde4dba311c
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-02-18-preview/machineLearningServices.json
@@ -0,0 +1,3603 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "Azure Machine Learning Workspaces",
+    "description": "These APIs allow end users to operate on Azure Machine Learning Workspace resources.",
+    "version": "2020-02-18-preview"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/providers/Microsoft.MachineLearningServices/operations": {
+      "get": {
+        "tags": [
+          "Operation"
+        ],
+        "description": "Lists all of the available Azure Machine Learning Workspaces REST API operations.",
+        "operationId": "Operations_List",
+        "parameters": [
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/OperationListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}": {
+      "get": {
+        "tags": [
+          "Workspaces"
+        ],
+        "description": "Gets the properties of the specified machine learning workspace.",
+        "operationId": "Workspaces_Get",
+        "x-ms-examples": {
+          "Get Workspace": {
+            "$ref": "./examples/getWorkspace.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/Workspace"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Workspaces"
+        ],
+        "description": "Creates or updates a workspace with the specified parameters.",
+        "operationId": "Workspaces_CreateOrUpdate",
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Create Workspace": {
+            "$ref": "./examples/createWorkspace.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "description": "The parameters for creating or updating a machine learning workspace.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/Workspace"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/Workspace"
+            }
+          },
+          "201": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/Workspace"
+            }
+          },
+          "202": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/Workspace"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Workspaces"
+        ],
+        "description": "Deletes a machine learning workspace.",
+        "operationId": "Workspaces_Delete",
+        "x-ms-examples": {
+          "Delete Workspace": {
+            "$ref": "./examples/deleteWorkspace.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly."
+          },
+          "204": {
+            "description": "The machine learning workspace does not exist in the subscription."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "Workspaces"
+        ],
+        "description": "Updates a machine learning workspace with the specified parameters.",
+        "operationId": "Workspaces_Update",
+        "x-ms-examples": {
+          "Update Workspace": {
+            "$ref": "./examples/updateWorkspace.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "description": "The parameters for updating a machine learning workspace.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/WorkspaceUpdateParameters"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/Workspace"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/features": {
+      "get": {
+        "tags": [
+          "Workspaces"
+        ],
+        "description": "Lists all enabled features for a workspace",
+        "operationId": "WorkspaceFeatures_List",
+        "x-ms-examples": {
+          "List Workspace features": {
+            "$ref": "./examples/ListWorkspaceFeatures.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/ListAmlUserFeatureResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces": {
+      "get": {
+        "tags": [
+          "Workspaces"
+        ],
+        "description": "Lists all the available machine learning workspaces under the specified resource group.",
+        "operationId": "Workspaces_ListByResourceGroup",
+        "x-ms-examples": {
+          "Get Workspaces by Resource Group": {
+            "$ref": "./examples/getWorkspacesByResourceGroup.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/PaginationParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/WorkspaceListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/listKeys": {
+      "post": {
+        "tags": [
+          "Workspaces"
+        ],
+        "description": "Lists all the keys associated with this workspace. This includes keys for the storage account, app insights and password for container registry",
+        "operationId": "Workspaces_ListKeys",
+        "x-ms-examples": {
+          "List Workspace Keys": {
+            "$ref": "./examples/listWorkspaceKeys.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/ListWorkspaceKeysResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/resyncKeys": {
+      "post": {
+        "tags": [
+          "Workspaces"
+        ],
+        "description": "Resync all the keys associated with this workspace. This includes keys for the storage account, app insights and password for container registry",
+        "operationId": "Workspaces_ResyncKeys",
+        "x-ms-examples": {
+          "Resync Workspace Keys": {
+            "$ref": "./examples/resyncWorkspaceKeys.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningServices/locations/{location}/usages": {
+      "get": {
+        "tags": [
+          "Usage"
+        ],
+        "operationId": "Usages_List",
+        "description": "Gets the current usage information as well as limits for AML resources for given subscription and location.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "name": "location",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The location for which resource usage is queried.",
+            "pattern": "^[-\\w\\._]+$"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ListUsagesResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-examples": {
+          "List Usages": {
+            "$ref": "./examples/ListUsages.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningServices/locations/{location}/vmSizes": {
+      "get": {
+        "tags": [
+          "VirtualMachineSizes"
+        ],
+        "operationId": "VirtualMachineSizes_List",
+        "description": "Returns supported VM Sizes in a location",
+        "parameters": [
+          {
+            "name": "location",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The location upon which virtual-machine-sizes is queried.",
+            "pattern": "^[-\\w\\._]+$"
+          },
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/VirtualMachineSizeListResult"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "List VM Sizes": {
+            "$ref": "./examples/ListVMSizesResult.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningServices/locations/{location}/updateQuotas": {
+      "post": {
+        "tags": [
+          "Quota"
+        ],
+        "operationId": "Quotas_Update",
+        "description": "Update quota for each VM family in workspace.",
+        "parameters": [
+          {
+            "name": "location",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The location for update quota is queried.",
+            "pattern": "^[-\\w\\._]+$"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/QuotaUpdateParameters"
+            },
+            "description": "Quota update parameters."
+          },
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation was successful.",
+            "schema": {
+              "$ref": "#/definitions/UpdateWorkspaceQuotasResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "update quotas": {
+            "$ref": "./examples/updateQuota.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningServices/locations/{location}/Quotas": {
+      "get": {
+        "tags": [
+          "Quota"
+        ],
+        "operationId": "Quotas_List",
+        "description": "Gets the currently assigned Workspace Quotas based on VMFamily.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "name": "location",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The location for which resource usage is queried.",
+            "pattern": "^[-\\w\\._]+$"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ListWorkspaceQuotas"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-examples": {
+          "List workspace quotas by VMFamily": {
+            "$ref": "./examples/ListWorkspaceQuotasByVMFamily.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningServices/workspaces": {
+      "get": {
+        "tags": [
+          "Workspaces"
+        ],
+        "description": "Lists all the available machine learning workspaces under the specified subscription.",
+        "operationId": "Workspaces_ListBySubscription",
+        "x-ms-examples": {
+          "Get Workspaces by subscription": {
+            "$ref": "./examples/getWorkspacesBySubscription.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/PaginationParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/WorkspaceListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/computes": {
+      "get": {
+        "tags": [
+          "OperationalizationClusters",
+          "MachineLearningComputes"
+        ],
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "operationId": "MachineLearningCompute_ListByWorkspace",
+        "description": "Gets computes in specified workspace.",
+        "x-ms-examples": {
+          "Get Computes": {
+            "$ref": "./examples/getComputes.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/PaginationParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response includes a paginated array of Machine Learning computes and a URI to the next set of results, if any. For the more information the limits of the number of items in a resource group, see https://azure.microsoft.com/en-us/documentation/articles/azure-subscription-service-limits/.",
+            "schema": {
+              "$ref": "#/definitions/PaginatedComputeResourcesList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the request failed.",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/computes/{computeName}": {
+      "get": {
+        "tags": [
+          "OperationalizationClusters",
+          "MachineLearningComputes"
+        ],
+        "operationId": "MachineLearningCompute_Get",
+        "description": "Gets compute definition by its name. Any secrets (storage keys, service credentials, etc) are not returned - use 'keys' nested resource to get them.",
+        "x-ms-examples": {
+          "Get a AKS Compute": {
+            "$ref": "./examples/getAKSCompute.json"
+          },
+          "Get a AML Compute": {
+            "$ref": "./examples/getAmlCompute.json"
+          },
+          "Get a ComputeInstance": {
+            "$ref": "./examples/getComputeInstance.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ComputeNameParameter"
+          },
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "schema": {
+              "$ref": "#/definitions/ComputeResource"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the request failed.",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "OperationalizationClusters",
+          "MachineLearningComputes"
+        ],
+        "operationId": "MachineLearningCompute_CreateOrUpdate",
+        "description": "Creates or updates compute. This call will overwrite a compute if it exists. This is a nonrecoverable operation. If your intent is to create a new compute, do a GET first to verify that it does not exist yet.",
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Create a AML Compute": {
+            "$ref": "./examples/createBasicAmlCompute.json"
+          },
+          "Create a ComputeInstance Compute with minimal inputs": {
+            "$ref": "./examples/createComputeInstanceMinimal.json"
+          },
+          "Create a ComputeInstance Compute": {
+            "$ref": "./examples/createComputeInstance.json"
+          },
+          "Create AKS Compute": {
+            "$ref": "./examples/createBasicAKSCompute.json"
+          },
+          "Create a DataFactory Compute": {
+            "$ref": "./examples/createBasicDataFactoryCompute.json"
+          },
+          "Update a AML Compute": {
+            "$ref": "./examples/updateAmlCompute.json"
+          },
+          "Update a AKS Compute": {
+            "$ref": "./examples/updateAKSCompute.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ComputeNameParameter"
+          },
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/ComputeDefinitionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Compute creation or update initiated.",
+            "schema": {
+              "$ref": "#/definitions/ComputeResource"
+            }
+          },
+          "201": {
+            "description": "Compute creation or update initiated.",
+            "headers": {
+              "Azure-AsyncOperation": {
+                "description": "URI to poll for asynchronous operation status.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "#/definitions/ComputeResource"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the request failed.",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "OperationalizationClusters",
+          "MachineLearningComputes"
+        ],
+        "operationId": "MachineLearningCompute_Update",
+        "description": "Updates properties of a compute. This call will overwrite a compute if it exists. This is a nonrecoverable operation.",
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Update a AmlCompute Compute": {
+            "$ref": "./examples/patchAmlCompute.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ComputeNameParameter"
+          },
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ClusterUpdateParameters"
+            },
+            "description": "Additional parameters for cluster update."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Compute update initiated.",
+            "schema": {
+              "$ref": "#/definitions/ComputeResource"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the request failed.",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "OperationalizationClusters",
+          "MachineLearningComputes"
+        ],
+        "operationId": "MachineLearningCompute_Delete",
+        "description": "Deletes specified Machine Learning compute.",
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Delete Compute": {
+            "$ref": "./examples/deleteCompute.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ComputeNameParameter"
+          },
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/UnderlyingResourceActionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly."
+          },
+          "202": {
+            "description": "Compute deletion initiated.",
+            "headers": {
+              "Azure-AsyncOperation": {
+                "description": "URI to poll for asynchronous operation status.",
+                "type": "string"
+              },
+              "Location": {
+                "description": "URI to poll for asynchronous operation result.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the request failed.",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/computes/{computeName}/listNodes": {
+      "post": {
+        "tags": [
+          "MachineLearningComputes"
+        ],
+        "operationId": "MachineLearningCompute_ListNodes",
+        "description": "Get the details (e.g IP address, port etc) of all the compute nodes in the compute.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ComputeNameParameter"
+          },
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation was successful. The response contains the list of IP addresses.",
+            "schema": {
+              "$ref": "#/definitions/AmlComputeNodesInformation"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Get compute nodes information for a compute": {
+            "$ref": "./examples/amlComputeListNodes.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/computes/{computeName}/listKeys": {
+      "post": {
+        "tags": [
+          "OperationalizationClusters",
+          "MachineLearningComputes"
+        ],
+        "operationId": "MachineLearningCompute_ListKeys",
+        "description": "Gets secrets related to Machine Learning compute (storage keys, service credentials, etc).",
+        "x-ms-examples": {
+          "List AKS Compute Keys": {
+            "$ref": "./examples/listKeysAKSCompute.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ComputeNameParameter"
+          },
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "schema": {
+              "$ref": "#/definitions/ComputeSecrets"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningServices/workspaces/skus": {
+      "get": {
+        "tags": [
+          "WorkspaceSkus"
+        ],
+        "description": "Lists all skus with associated features",
+        "operationId": "ListSkus",
+        "x-ms-examples": {
+          "List Skus": {
+            "$ref": "./examples/ListSkus.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/SkuListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/privateEndpointConnections/{privateEndpointConnectionName}": {
+      "get": {
+        "tags": [
+          "WorkspacePrivateEndpointConnections"
+        ],
+        "operationId": "PrivateEndpointConnections_Get",
+        "description": "Gets the specified private endpoint connection associated with the workspace.",
+        "x-ms-examples": {
+          "WorkspaceGetPrivateEndpointConnection": {
+            "$ref": "./examples/workspaceGetPrivateEndpointConnection.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/PrivateEndpointConnectionName"
+          },
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK -- Get the private endpoint connection properties successfully.",
+            "schema": {
+              "$ref": "#/definitions/PrivateEndpointConnection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "WorkspacePrivateEndpointConnections"
+        ],
+        "operationId": "PrivateEndpointConnections_Put",
+        "description": "Update the state of specified private endpoint connection associated with the workspace.",
+        "x-ms-examples": {
+          "WorkspacePutPrivateEndpointConnection": {
+            "$ref": "./examples/workspacePutPrivateEndpointConnection.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/PrivateEndpointConnectionName"
+          },
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          },
+          {
+            "name": "properties",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/PrivateEndpointConnection"
+            },
+            "description": "The private endpoint connection properties."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK -- Update the private endpoint connection properties successfully.",
+            "schema": {
+              "$ref": "#/definitions/PrivateEndpointConnection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "WorkspacePrivateEndpointConnections"
+        ],
+        "operationId": "PrivateEndpointConnections_Delete",
+        "description": "Deletes the specified private endpoint connection associated with the workspace.",
+        "x-ms-examples": {
+          "WorkspaceDeletePrivateEndpointConnection": {
+            "$ref": "./examples/workspaceDeletePrivateEndpointConnection.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/PrivateEndpointConnectionName"
+          },
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK -- Delete the private endpoint connection successfully."
+          },
+          "204": {
+            "description": "No Content -- The private endpoint connection does not exist."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/privateLinkResources": {
+      "get": {
+        "tags": [
+          "WorkspacePrivateLinkResources"
+        ],
+        "operationId": "PrivateLinkResources_ListByWorkspace",
+        "description": "Gets the private link resources that need to be created for a workspace.",
+        "x-ms-examples": {
+          "WorkspaceListPrivateLinkResources": {
+            "$ref": "./examples/workspaceListPrivateLinkResources.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successfully retrieved private link resources.",
+            "schema": {
+              "$ref": "#/definitions/PrivateLinkResourceListResult"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/computes/{computeName}/start": {
+      "post": {
+        "tags": [
+          "OperationalizationClusters",
+          "MachineLearningComputes"
+        ],
+        "operationId": "MachineLearningCompute_Start",
+        "description": "Posts a start action to a compute instance",
+        "x-ms-examples": {
+          "Start ComputeInstance Compute": {
+            "$ref": "./examples/startComputeInstance.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ComputeNameParameter"
+          },
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/computes/{computeName}/stop": {
+      "post": {
+        "tags": [
+          "OperationalizationClusters",
+          "MachineLearningComputes"
+        ],
+        "operationId": "MachineLearningCompute_Stop",
+        "description": "Posts a stop action to a compute instance",
+        "x-ms-examples": {
+          "Stop ComputeInstance Compute": {
+            "$ref": "./examples/stopComputeInstance.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ComputeNameParameter"
+          },
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/computes/{computeName}/restart": {
+      "post": {
+        "tags": [
+          "OperationalizationClusters",
+          "MachineLearningComputes"
+        ],
+        "operationId": "MachineLearningCompute_Restart",
+        "description": "Posts a restart action to a compute instance",
+        "x-ms-examples": {
+          "Restart ComputeInstance Compute": {
+            "$ref": "./examples/restartComputeInstance.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ComputeNameParameter"
+          },
+          {
+            "$ref": "#/parameters/APIVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/MachineLearningServiceError"
+            }
+          }
+        }
+      }
+    }
+  },
+  "parameters": {
+    "SubscriptionIdParameter": {
+      "name": "subscriptionId",
+      "description": "Azure subscription identifier.",
+      "in": "path",
+      "type": "string",
+      "required": true
+    },
+    "ResourceGroupNameParameter": {
+      "name": "resourceGroupName",
+      "description": "Name of the resource group in which workspace is located.",
+      "in": "path",
+      "type": "string",
+      "required": true,
+      "x-ms-parameter-location": "method"
+    },
+    "WorkspaceNameParameter": {
+      "name": "workspaceName",
+      "description": "Name of Azure Machine Learning workspace.",
+      "in": "path",
+      "type": "string",
+      "required": true,
+      "x-ms-parameter-location": "method"
+    },
+    "ComputeNameParameter": {
+      "name": "computeName",
+      "description": "Name of the Azure Machine Learning compute.",
+      "in": "path",
+      "type": "string",
+      "required": true,
+      "x-ms-parameter-location": "method"
+    },
+    "AsyncOperationIdParameter": {
+      "name": "asyncOperationId",
+      "description": "Identifier of an asynchronous Azure Machine Learning compute operation.",
+      "in": "path",
+      "type": "string",
+      "required": true,
+      "x-ms-parameter-location": "method"
+    },
+    "LocationParameter": {
+      "name": "location",
+      "description": "The name of the Azure location/region.",
+      "in": "path",
+      "type": "string",
+      "required": true,
+      "x-ms-parameter-location": "method"
+    },
+    "APIVersionParameter": {
+      "in": "query",
+      "name": "api-version",
+      "type": "string",
+      "description": "Version of Azure Machine Learning resource provider API.",
+      "required": true
+    },
+    "PaginationParameter": {
+      "in": "query",
+      "name": "$skiptoken",
+      "type": "string",
+      "description": "Continuation token for pagination.",
+      "required": false,
+      "x-ms-parameter-location": "method"
+    },
+    "ComputeDefinitionParameter": {
+      "in": "body",
+      "name": "parameters",
+      "description": "Payload with Machine Learning compute definition.",
+      "required": true,
+      "schema": {
+        "$ref": "#/definitions/ComputeResource"
+      },
+      "x-ms-parameter-location": "method"
+    },
+    "ComputeTypeParameter": {
+      "in": "query",
+      "name": "compute-type",
+      "type": "string",
+      "description": "Type of compute to filter by.",
+      "required": false,
+      "x-ms-parameter-location": "method"
+    },
+    "UnderlyingResourceActionParameter": {
+      "in": "query",
+      "name": "underlyingResourceAction",
+      "type": "string",
+      "description": "Delete the underlying compute if 'Delete', or detach the underlying compute from workspace if 'Detach'.",
+      "required": true,
+      "enum": [
+        "Delete",
+        "Detach"
+      ],
+      "x-ms-enum": {
+        "name": "UnderlyingResourceAction",
+        "modelAsString": true
+      },
+      "x-ms-parameter-location": "method"
+    },
+    "PrivateEndpointConnectionName": {
+      "name": "privateEndpointConnectionName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The name of the private endpoint connection associated with the workspace",
+      "x-ms-parameter-location": "method"
+    }
+  },
+  "definitions": {
+    "Operation": {
+      "description": "Azure Machine Learning workspace REST API operation",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "Operation name: {provider}/{resource}/{operation}",
+          "type": "string"
+        },
+        "display": {
+          "description": "Display name of operation",
+          "properties": {
+            "provider": {
+              "description": "The resource provider name: Microsoft.MachineLearningExperimentation",
+              "type": "string"
+            },
+            "resource": {
+              "description": "The resource on which the operation is performed.",
+              "type": "string"
+            },
+            "operation": {
+              "description": "The operation that users can perform.",
+              "type": "string"
+            },
+            "description": {
+              "description": "The description for the operation.",
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "OperationListResult": {
+      "description": "An array of operations supported by the resource provider.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Operation"
+          },
+          "description": "List of AML workspace operations supported by the AML workspace resource provider."
+        }
+      }
+    },
+    "Workspace": {
+      "type": "object",
+      "description": "An object that represents a machine learning workspace.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/Resource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/WorkspaceProperties",
+          "description": "The properties of the machine learning workspace.",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "WorkspaceProperties": {
+      "type": "object",
+      "description": "The properties of a machine learning workspace.",
+      "properties": {
+        "workspaceId": {
+          "description": "The immutable id associated with this workspace.",
+          "type": "string",
+          "readOnly": true
+        },
+        "description": {
+          "description": "The description of this workspace.",
+          "type": "string"
+        },
+        "friendlyName": {
+          "description": "The friendly name for this workspace. This name in mutable",
+          "type": "string"
+        },
+        "creationTime": {
+          "format": "date-time",
+          "description": "The creation time of the machine learning workspace in ISO8601 format.",
+          "type": "string",
+          "readOnly": true
+        },
+        "keyVault": {
+          "description": "ARM id of the key vault associated with this workspace. This cannot be changed once the workspace has been created",
+          "type": "string"
+        },
+        "applicationInsights": {
+          "description": "ARM id of the application insights associated with this workspace. This cannot be changed once the workspace has been created",
+          "type": "string"
+        },
+        "containerRegistry": {
+          "description": "ARM id of the container registry associated with this workspace. This cannot be changed once the workspace has been created",
+          "type": "string"
+        },
+        "storageAccount": {
+          "description": "ARM id of the storage account associated with this workspace. This cannot be changed once the workspace has been created",
+          "type": "string"
+        },
+        "discoveryUrl": {
+          "description": "Url for the discovery service to identify regional endpoints for machine learning experimentation services",
+          "type": "string"
+        },
+        "provisioningState": {
+          "type": "string",
+          "enum": [
+            "Unknown",
+            "Updating",
+            "Creating",
+            "Deleting",
+            "Succeeded",
+            "Failed",
+            "Canceled"
+          ],
+          "x-ms-enum": {
+            "name": "ProvisioningState",
+            "modelAsString": true
+          },
+          "readOnly": true,
+          "description": "The current deployment state of workspace resource. The provisioningState is to indicate states for resource provisioning."
+        },
+        "encryption": {
+          "$ref": "#/definitions/EncryptionProperty",
+          "description": "The encryption settings of Azure ML workspace."
+        },
+        "hbiWorkspace": {
+          "type": "boolean",
+          "description": "The flag to signal HBI data in the workspace and reduce diagnostic data collected by the service",
+          "default": false
+        },
+        "serviceProvisionedResourceGroup": {
+          "type": "string",
+          "description": "The name of the managed resource group created by workspace RP in customer subscription if the workspace is CMK workspace",
+          "readOnly": true
+        }
+      }
+    },
+    "WorkspaceUpdateParameters": {
+      "description": "The parameters for updating a machine learning workspace.",
+      "properties": {
+        "tags": {
+          "description": "The resource tags for the machine learning workspace.",
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "sku": {
+          "$ref": "#/definitions/Sku",
+          "description": "The sku of the workspace."
+        },
+        "properties": {
+          "$ref": "#/definitions/WorkspacePropertiesUpdateParameters",
+          "description": "The properties that the machine learning workspace will be updated with.",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "WorkspacePropertiesUpdateParameters": {
+      "description": "The parameters for updating the properties of a machine learning workspace.",
+      "properties": {
+        "description": {
+          "description": "The description of this workspace.",
+          "type": "string"
+        },
+        "friendlyName": {
+          "description": "The friendly name for this workspace.",
+          "type": "string"
+        }
+      }
+    },
+    "AmlUserFeature": {
+      "description": "Features enabled for a workspace",
+      "type": "object",
+      "properties": {
+        "id": {
+          "description": "Specifies the feature ID",
+          "type": "string"
+        },
+        "displayName": {
+          "description": "Specifies the feature name ",
+          "type": "string"
+        },
+        "description": {
+          "description": "Describes the feature for user experience",
+          "type": "string"
+        }
+      }
+    },
+    "ListAmlUserFeatureResult": {
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/AmlUserFeature"
+          },
+          "description": "The list of AML user facing features."
+        },
+        "nextLink": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The URI to fetch the next page of AML user features information. Call ListNext() with this to fetch the next page of AML user features information."
+        }
+      },
+      "description": "The List Aml user feature operation response."
+    },
+    "UsageName": {
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The name of the resource."
+        },
+        "localizedValue": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The localized name of the resource."
+        }
+      },
+      "description": "The Usage Names."
+    },
+    "Usage": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Specifies the resource ID."
+        },
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Specifies the resource type."
+        },
+        "unit": {
+          "readOnly": true,
+          "type": "string",
+          "description": "An enum describing the unit of usage measurement.",
+          "enum": [
+            "Count"
+          ],
+          "x-ms-enum": {
+            "name": "UsageUnit",
+            "modelAsString": true
+          }
+        },
+        "currentValue": {
+          "readOnly": true,
+          "type": "integer",
+          "format": "int64",
+          "description": "The current usage of the resource."
+        },
+        "limit": {
+          "readOnly": true,
+          "type": "integer",
+          "format": "int64",
+          "description": "The maximum permitted usage of the resource."
+        },
+        "name": {
+          "readOnly": true,
+          "$ref": "#/definitions/UsageName",
+          "description": "The name of the type of usage."
+        }
+      },
+      "description": "Describes AML Resource Usage."
+    },
+    "ListUsagesResult": {
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Usage"
+          },
+          "description": "The list of AML resource usages."
+        },
+        "nextLink": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The URI to fetch the next page of AML resource usage information. Call ListNext() with this to fetch the next page of AML resource usage information."
+        }
+      },
+      "description": "The List Usages operation response."
+    },
+    "VirtualMachineSize": {
+      "properties": {
+        "name": {
+          "type": "string",
+          "title": "Virtual Machine size name",
+          "description": "The name of the virtual machine size.",
+          "readOnly": true
+        },
+        "family": {
+          "type": "string",
+          "title": "Virtual Machine family name",
+          "description": "The family name of the virtual machine size.",
+          "readOnly": true
+        },
+        "vCPUs": {
+          "type": "integer",
+          "format": "int32",
+          "title": "Number of vPUs",
+          "description": "The number of vCPUs supported by the virtual machine size.",
+          "readOnly": true
+        },
+        "gpus": {
+          "type": "integer",
+          "format": "int32",
+          "title": "Number of gPUs",
+          "description": "The number of gPUs supported by the virtual machine size.",
+          "readOnly": true
+        },
+        "osVhdSizeMB": {
+          "type": "integer",
+          "format": "int32",
+          "title": "OS VHD Disk size",
+          "description": "The OS VHD disk size, in MB, allowed by the virtual machine size.",
+          "readOnly": true
+        },
+        "maxResourceVolumeMB": {
+          "type": "integer",
+          "format": "int32",
+          "title": "Resource volume size",
+          "description": "The resource volume size, in MB, allowed by the virtual machine size.",
+          "readOnly": true
+        },
+        "memoryGB": {
+          "type": "number",
+          "format": "double",
+          "title": "Memory size",
+          "description": "The amount of memory, in GB, supported by the virtual machine size.",
+          "readOnly": true
+        },
+        "lowPriorityCapable": {
+          "type": "boolean",
+          "title": "Low priority capable",
+          "description": "Specifies if the virtual machine size supports low priority VMs.",
+          "readOnly": true
+        },
+        "premiumIO": {
+          "type": "boolean",
+          "title": "Premium IO supported",
+          "description": "Specifies if the virtual machine size supports premium IO.",
+          "readOnly": true
+        }
+      },
+      "description": "Describes the properties of a VM size."
+    },
+    "VirtualMachineSizeListResult": {
+      "properties": {
+        "amlCompute": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/VirtualMachineSize"
+          },
+          "description": "The list of virtual machine sizes supported by AmlCompute."
+        }
+      },
+      "description": "The List Virtual Machine size operation response."
+    },
+    "WorkspaceListResult": {
+      "description": "The result of a request to list machine learning workspaces.",
+      "properties": {
+        "value": {
+          "description": "The list of machine learning workspaces. Since this list may be incomplete, the nextLink field should be used to request the next list of machine learning workspaces.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Workspace"
+          }
+        },
+        "nextLink": {
+          "description": "The URI that can be used to request the next list of machine learning workspaces.",
+          "type": "string"
+        }
+      }
+    },
+    "QuotaBaseProperties": {
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Specifies the resource ID."
+        },
+        "type": {
+          "type": "string",
+          "description": "Specifies the resource type."
+        },
+        "limit": {
+          "type": "integer",
+          "format": "int64",
+          "title": "Limit.",
+          "description": "The maximum permitted quota of the resource."
+        },
+        "unit": {
+          "type": "string",
+          "description": "An enum describing the unit of quota measurement.",
+          "enum": [
+            "Count"
+          ],
+          "x-ms-enum": {
+            "name": "QuotaUnit",
+            "modelAsString": true
+          }
+        }
+      },
+      "description": "The properties for Quota update or retrieval."
+    },
+    "QuotaUpdateParameters": {
+      "properties": {
+        "value": {
+          "description": "The list for update quota.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/QuotaBaseProperties"
+          }
+        }
+      },
+      "description": "Quota update parameters."
+    },
+    "UpdateWorkspaceQuotasResult": {
+      "properties": {
+        "value": {
+          "description": "The list of workspace quota update result.",
+          "items": {
+            "$ref": "#/definitions/UpdateWorkspaceQuotas"
+          },
+          "readOnly": true,
+          "type": "array"
+        },
+        "nextLink": {
+          "description": "The URI to fetch the next page of workspace quota update result. Call ListNext() with this to fetch the next page of Workspace Quota update result.",
+          "readOnly": true,
+          "type": "string"
+        }
+      },
+      "description": "The result of update workspace quota."
+    },
+    "UpdateWorkspaceQuotas": {
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Specifies the resource ID."
+        },
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Specifies the resource type."
+        },
+        "limit": {
+          "type": "integer",
+          "format": "int64",
+          "title": "Limit.",
+          "description": "The maximum permitted quota of the resource."
+        },
+        "unit": {
+          "readOnly": true,
+          "type": "string",
+          "description": "An enum describing the unit of quota measurement.",
+          "enum": [
+            "Count"
+          ],
+          "x-ms-enum": {
+            "name": "QuotaUnit",
+            "modelAsString": true
+          }
+        },
+        "status": {
+          "type": "string",
+          "readOnly": false,
+          "title": "Update Workspace Quota Status.",
+          "description": "Status of update workspace quota.",
+          "enum": [
+            "Undefined",
+            "Success",
+            "Failure",
+            "InvalidQuotaBelowClusterMinimum",
+            "InvalidQuotaExceedsSubscriptionLimit",
+            "InvalidVMFamilyName",
+            "OperationNotSupportedForSku",
+            "OperationNotEnabledForRegion"
+          ],
+          "x-ms-enum": {
+            "name": "status",
+            "modelAsString": true
+          }
+        }
+      },
+      "description": "The properties for update Quota response."
+    },
+    "ResourceName": {
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The name of the resource."
+        },
+        "localizedValue": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The localized name of the resource."
+        }
+      },
+      "description": "The Resource Name."
+    },
+    "ResourceQuota": {
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Specifies the resource ID."
+        },
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Specifies the resource type."
+        },
+        "name": {
+          "$ref": "#/definitions/ResourceName",
+          "description": "Name of the resource.",
+          "readOnly": true
+        },
+        "limit": {
+          "readOnly": true,
+          "type": "integer",
+          "format": "int64",
+          "title": "Limit.",
+          "description": "The maximum permitted quota of the resource."
+        },
+        "unit": {
+          "readOnly": true,
+          "type": "string",
+          "description": "An enum describing the unit of quota measurement.",
+          "enum": [
+            "Count"
+          ],
+          "x-ms-enum": {
+            "name": "QuotaUnit",
+            "modelAsString": true
+          }
+        }
+      },
+      "description": "The quota assigned to a resource."
+    },
+    "ListWorkspaceQuotas": {
+      "properties": {
+        "value": {
+          "description": "The list of Workspace Quotas by VM Family",
+          "items": {
+            "$ref": "#/definitions/ResourceQuota"
+          },
+          "readOnly": true,
+          "type": "array"
+        },
+        "nextLink": {
+          "description": "The URI to fetch the next page of workspace quota information by VM Family. Call ListNext() with this to fetch the next page of Workspace Quota information.",
+          "readOnly": true,
+          "type": "string"
+        }
+      },
+      "description": "The List WorkspaceQuotasByVMFamily operation response."
+    },
+    "Identity": {
+      "properties": {
+        "principalId": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The principal ID of resource identity."
+        },
+        "tenantId": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The tenant ID of resource."
+        },
+        "type": {
+          "type": "string",
+          "description": "The identity type.",
+          "enum": [
+            "SystemAssigned"
+          ],
+          "x-ms-enum": {
+            "name": "ResourceIdentityType",
+            "modelAsString": false
+          }
+        }
+      },
+      "description": "Identity for the resource."
+    },
+    "Resource": {
+      "description": "Azure Resource Manager resource envelope.",
+      "x-ms-azure-resource": true,
+      "properties": {
+        "id": {
+          "description": "Specifies the resource ID.",
+          "type": "string",
+          "readOnly": true
+        },
+        "name": {
+          "description": "Specifies the name of the resource.",
+          "type": "string",
+          "readOnly": true
+        },
+        "identity": {
+          "$ref": "#/definitions/Identity",
+          "description": "The identity of the resource."
+        },
+        "location": {
+          "description": "Specifies the location of the resource.",
+          "type": "string"
+        },
+        "type": {
+          "description": "Specifies the type of the resource.",
+          "type": "string",
+          "readOnly": true
+        },
+        "tags": {
+          "description": "Contains resource tags defined as key/value pairs.",
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "sku": {
+          "$ref": "#/definitions/Sku",
+          "description": "The sku of the workspace."
+        }
+      }
+    },
+    "ResourceId": {
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "The ID of the resource"
+        }
+      },
+      "required": [
+        "id"
+      ],
+      "description": "Represents a resource ID. For example, for a subnet, it is the resource URL for the subnet.",
+      "x-ms-azure-resource": true
+    },
+    "ListWorkspaceKeysResult": {
+      "type": "object",
+      "properties": {
+        "userStorageKey": {
+          "readOnly": true,
+          "type": "string"
+        },
+        "userStorageResourceId": {
+          "readOnly": true,
+          "type": "string"
+        },
+        "appInsightsInstrumentationKey": {
+          "readOnly": true,
+          "type": "string"
+        },
+        "containerRegistryCredentials": {
+          "readOnly": true,
+          "$ref": "#/definitions/RegistryListCredentialsResult"
+        }
+      }
+    },
+    "RegistryListCredentialsResult": {
+      "type": "object",
+      "properties": {
+        "location": {
+          "readOnly": true,
+          "type": "string"
+        },
+        "username": {
+          "readOnly": true,
+          "type": "string"
+        },
+        "passwords": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Password"
+          }
+        }
+      }
+    },
+    "Password": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "readOnly": true,
+          "type": "string"
+        },
+        "value": {
+          "readOnly": true,
+          "type": "string"
+        }
+      }
+    },
+    "PaginatedComputeResourcesList": {
+      "type": "object",
+      "description": "Paginated list of Machine Learning compute objects wrapped in ARM resource envelope.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "description": "An array of Machine Learning compute objects wrapped in ARM resource envelope.",
+          "items": {
+            "$ref": "#/definitions/ComputeResource"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "A continuation link (absolute URI) to the next page of results in the list."
+        }
+      }
+    },
+    "ComputeResource": {
+      "type": "object",
+      "description": "Machine Learning compute object wrapped into ARM resource envelope.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/Resource"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "properties": {
+              "description": "Compute properties",
+              "$ref": "#/definitions/Compute"
+            }
+          }
+        }
+      ]
+    },
+    "Compute": {
+      "type": "object",
+      "description": "Machine Learning compute object.",
+      "discriminator": "computeType",
+      "properties": {
+        "computeType": {
+          "description": "The type of compute",
+          "$ref": "#/definitions/ComputeType"
+        },
+        "computeLocation": {
+          "description": "Location for the underlying compute",
+          "type": "string"
+        },
+        "provisioningState": {
+          "type": "string",
+          "description": "The provision state of the cluster. Valid values are Unknown, Updating, Provisioning, Succeeded, and Failed.",
+          "enum": [
+            "Unknown",
+            "Updating",
+            "Creating",
+            "Deleting",
+            "Succeeded",
+            "Failed",
+            "Canceled"
+          ],
+          "x-ms-enum": {
+            "name": "ProvisioningState",
+            "modelAsString": true
+          },
+          "readOnly": true
+        },
+        "description": {
+          "type": "string",
+          "description": "The description of the Machine Learning compute."
+        },
+        "createdOn": {
+          "type": "string",
+          "description": "The date and time when the compute was created.",
+          "format": "date-time",
+          "readOnly": true
+        },
+        "modifiedOn": {
+          "type": "string",
+          "description": "The date and time when the compute was last modified.",
+          "format": "date-time",
+          "readOnly": true
+        },
+        "resourceId": {
+          "type": "string",
+          "description": "ARM resource id of the underlying compute"
+        },
+        "provisioningErrors": {
+          "type": "array",
+          "description": "Errors during provisioning",
+          "items": {
+            "$ref": "#/definitions/MachineLearningServiceError"
+          },
+          "readOnly": true
+        },
+        "isAttachedCompute": {
+          "type": "boolean",
+          "description": "Indicating whether the compute was provisioned by user and brought from outside if true, or machine learning service provisioned it if false.",
+          "readOnly": true
+        }
+      },
+      "required": [
+        "computeType"
+      ]
+    },
+    "AKS": {
+      "description": "A Machine Learning compute based on AKS.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/Compute"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "properties": {
+              "type": "object",
+              "description": "AKS properties",
+              "properties": {
+                "clusterFqdn": {
+                  "description": "Cluster full qualified domain name",
+                  "type": "string"
+                },
+                "systemServices": {
+                  "type": "array",
+                  "description": "System services",
+                  "items": {
+                    "$ref": "#/definitions/SystemService"
+                  },
+                  "readOnly": true
+                },
+                "agentCount": {
+                  "description": "Number of agents",
+                  "type": "integer",
+                  "minimum": 1
+                },
+                "agentVMSize": {
+                  "description": "Agent virtual machine size",
+                  "type": "string"
+                },
+                "sslConfiguration": {
+                  "description": "SSL configuration",
+                  "$ref": "#/definitions/SslConfiguration"
+                },
+                "aksNetworkingConfiguration": {
+                  "description": "AKS networking configuration for vnet",
+                  "$ref": "#/definitions/AksNetworkingConfiguration"
+                }
+              }
+            }
+          }
+        }
+      ],
+      "x-ms-discriminator-value": "AKS"
+    },
+    "AmlCompute": {
+      "description": "An Azure Machine Learning compute.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/Compute"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "properties": {
+              "description": "AML Compute properties",
+              "type": "object",
+              "properties": {
+                "vmSize": {
+                  "description": "Virtual Machine Size",
+                  "type": "string"
+                },
+                "vmPriority": {
+                  "description": "Virtual Machine priority",
+                  "type": "string",
+                  "enum": [
+                    "Dedicated",
+                    "LowPriority"
+                  ],
+                  "x-ms-enum": {
+                    "name": "VmPriority",
+                    "modelAsString": true
+                  }
+                },
+                "osType": {
+                  "type": "string",
+                  "description": "OS Type.",
+                  "default": "Linux",
+                  "enum": [
+                    "Linux",
+                    "Windows"
+                  ],
+                  "x-ms-enum": {
+                    "name": "osType",
+                    "modelAsString": true
+                  }
+                },
+                "virtualMachineImage": {
+                  "title": "Custom VM image.",
+                  "description": "The ARM resource identifier of the virtual machine image for the compute nodes. This is of the form /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{gallery name}/images/{image definition name}/versions/{version id}. The virtual machine image must be in the same region and subscription as the cluster.",
+                  "$ref": "#/definitions/ResourceId"
+                },
+                "scaleSettings": {
+                  "description": "Scale settings for AML Compute",
+                  "$ref": "#/definitions/ScaleSettings"
+                },
+                "userAccountCredentials": {
+                  "title": "User account credentials.",
+                  "description": "Credentials for an administrator user account that will be created on each compute node.",
+                  "$ref": "#/definitions/UserAccountCredentials"
+                },
+                "subnet": {
+                  "title": "Subnet.",
+                  "description": "Virtual network subnet resource ID the compute nodes belong to.",
+                  "$ref": "#/definitions/ResourceId"
+                },
+                "remoteLoginPortPublicAccess": {
+                  "type": "string",
+                  "default": "NotSpecified",
+                  "title": "Close remote Login Access Port",
+                  "description": "State of the public SSH port. Possible values are: Disabled - Indicates that the public ssh port is closed on all nodes of the cluster. Enabled - Indicates that the public ssh port is open on all nodes of the cluster. NotSpecified - Indicates that the public ssh port is closed on all nodes of the cluster if VNet is defined, else is open all public nodes. It can be default only during cluster creation time, after creation it will be either enabled or disabled.",
+                  "enum": [
+                    "Enabled",
+                    "Disabled",
+                    "NotSpecified"
+                  ],
+                  "x-ms-enum": {
+                    "name": "remoteLoginPortPublicAccess",
+                    "modelAsString": true
+                  }
+                },
+                "allocationState": {
+                  "type": "string",
+                  "readOnly": true,
+                  "title": "Allocation state.",
+                  "description": "Allocation state of the compute. Possible values are: steady - Indicates that the compute is not resizing. There are no changes to the number of compute nodes in the compute in progress. A compute enters this state when it is created and when no operations are being performed on the compute to change the number of compute nodes. resizing - Indicates that the compute is resizing; that is, compute nodes are being added to or removed from the compute.",
+                  "enum": [
+                    "Steady",
+                    "Resizing"
+                  ],
+                  "x-ms-enum": {
+                    "name": "AllocationState",
+                    "modelAsString": true
+                  }
+                },
+                "allocationStateTransitionTime": {
+                  "type": "string",
+                  "readOnly": true,
+                  "format": "date-time",
+                  "title": "Allocation state transition time.",
+                  "description": "The time at which the compute entered its current allocation state."
+                },
+                "errors": {
+                  "readOnly": true,
+                  "title": "Errors.",
+                  "description": "Collection of errors encountered by various compute nodes during node setup.",
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/definitions/MachineLearningServiceError"
+                  }
+                },
+                "currentNodeCount": {
+                  "type": "integer",
+                  "readOnly": true,
+                  "format": "int32",
+                  "title": "Current node count.",
+                  "description": "The number of compute nodes currently assigned to the compute."
+                },
+                "targetNodeCount": {
+                  "type": "integer",
+                  "readOnly": true,
+                  "format": "int32",
+                  "title": "Target node count.",
+                  "description": "The target number of compute nodes for the compute. If the allocationState is resizing, this property denotes the target node count for the ongoing resize operation. If the allocationState is steady, this property denotes the target node count for the previous resize operation."
+                },
+                "nodeStateCounts": {
+                  "title": "Node state counts.",
+                  "description": "Counts of various node states on the compute.",
+                  "readOnly": true,
+                  "$ref": "#/definitions/NodeStateCounts"
+                }
+              }
+            }
+          }
+        }
+      ],
+      "x-ms-discriminator-value": "AmlCompute"
+    },
+    "ComputeInstance": {
+      "description": "An Azure Machine Learning compute instance.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/Compute"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "properties": {
+              "description": "Compute Instance properties",
+              "type": "object",
+              "properties": {
+                "vmSize": {
+                  "description": "Virtual Machine Size",
+                  "type": "string"
+                },
+                "subnet": {
+                  "title": "Subnet.",
+                  "description": "Virtual network subnet resource ID the compute nodes belong to.",
+                  "$ref": "#/definitions/ResourceId"
+                },
+                "applicationSharingPolicy": {
+                  "type": "string",
+                  "default": "Shared",
+                  "title": "Sharing policy for applications on this compute instance",
+                  "description": "Policy for sharing applications on this compute instance among users of parent workspace. If Personal, only the creator can access applications on this compute instance. When Shared, any workspace user can access applications on this instance depending on his/her assigned role.",
+                  "enum": [
+                    "Personal",
+                    "Shared"
+                  ],
+                  "x-ms-enum": {
+                    "name": "applicationSharingPolicy",
+                    "modelAsString": true
+                  }
+                },
+                "sshSettings": {
+                  "description": "Specifies policy and settings for SSH access.",
+                  "$ref": "#/definitions/ComputeInstanceSshSettings"
+                },
+                "connectivityEndpoints": {
+                  "readOnly": true,
+                  "description": "Describes all connectivity endpoints available for this ComputeInstance.",
+                  "$ref": "#/definitions/ComputeInstanceConnectivityEndpoints"
+                },
+                "applications": {
+                  "type": "array",
+                  "readOnly": true,
+                  "description": "Describes available applications and their endpoints on this ComputeInstance.",
+                  "items": {
+                    "$ref": "#/definitions/ComputeInstanceApplication"
+                  }
+                },
+                "createdBy": {
+                  "readOnly": true,
+                  "description": "Describes information on user who created this ComputeInstance.",
+                  "$ref": "#/definitions/ComputeInstanceCreatedBy"
+                },
+                "errors": {
+                  "readOnly": true,
+                  "title": "Errors.",
+                  "description": "Collection of errors encountered on this ComputeInstance.",
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/definitions/MachineLearningServiceError"
+                  }
+                },
+                "state": {
+                  "description": "The current state of this ComputeInstance.",
+                  "$ref": "#/definitions/ComputeInstanceState",
+                  "readOnly": true
+                }
+              }
+            }
+          }
+        }
+      ],
+      "x-ms-discriminator-value": "ComputeInstance"
+    },
+    "VirtualMachine": {
+      "description": "A Machine Learning compute based on Azure Virtual Machines.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/Compute"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "properties": {
+              "type": "object",
+              "properties": {
+                "virtualMachineSize": {
+                  "description": "Virtual Machine size",
+                  "type": "string"
+                },
+                "sshPort": {
+                  "description": "Port open for ssh connections.",
+                  "type": "integer"
+                },
+                "address": {
+                  "description": "Public IP address of the virtual machine.",
+                  "type": "string"
+                },
+                "administratorAccount": {
+                  "description": "Admin credentials for virtual machine",
+                  "$ref": "#/definitions/VirtualMachineSshCredentials"
+                }
+              }
+            }
+          }
+        }
+      ],
+      "x-ms-discriminator-value": "VirtualMachine"
+    },
+    "HDInsight": {
+      "description": "A HDInsight compute.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/Compute"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "properties": {
+              "type": "object",
+              "properties": {
+                "sshPort": {
+                  "description": "Port open for ssh connections on the master node of the cluster.",
+                  "type": "integer"
+                },
+                "address": {
+                  "description": "Public IP address of the master node of the cluster.",
+                  "type": "string"
+                },
+                "administratorAccount": {
+                  "description": "Admin credentials for master node of the cluster",
+                  "$ref": "#/definitions/VirtualMachineSshCredentials"
+                }
+              }
+            }
+          }
+        }
+      ],
+      "x-ms-discriminator-value": "HDInsight"
+    },
+    "DataFactory": {
+      "description": "A DataFactory compute.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/Compute"
+        }
+      ],
+      "x-ms-discriminator-value": "DataFactory"
+    },
+    "Databricks": {
+      "description": "A DataFactory compute.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/Compute"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "properties": {
+              "type": "object",
+              "properties": {
+                "databricksAccessToken": {
+                  "description": "Databricks access token",
+                  "type": "string"
+                }
+              }
+            }
+          }
+        }
+      ],
+      "x-ms-discriminator-value": "Databricks"
+    },
+    "DataLakeAnalytics": {
+      "description": "A DataLakeAnalytics compute.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/Compute"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "properties": {
+              "type": "object",
+              "properties": {
+                "dataLakeStoreAccountName": {
+                  "description": "DataLake Store Account Name",
+                  "type": "string"
+                }
+              }
+            }
+          }
+        }
+      ],
+      "x-ms-discriminator-value": "DataLakeAnalytics"
+    },
+    "ServicePrincipalCredentials": {
+      "type": "object",
+      "description": "Service principal credentials.",
+      "properties": {
+        "clientId": {
+          "description": "Client Id",
+          "type": "string"
+        },
+        "clientSecret": {
+          "description": "Client secret",
+          "type": "string"
+        }
+      },
+      "required": [
+        "clientId",
+        "clientSecret"
+      ]
+    },
+    "SystemService": {
+      "type": "object",
+      "description": "A system service running on a compute.",
+      "properties": {
+        "systemServiceType": {
+          "description": "The type of this system service.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "publicIpAddress": {
+          "type": "string",
+          "description": "Public IP address",
+          "readOnly": true
+        },
+        "version": {
+          "description": "The version for this type.",
+          "readOnly": true,
+          "type": "string"
+        }
+      }
+    },
+    "SslConfiguration": {
+      "type": "object",
+      "description": "The ssl configuration for scoring",
+      "properties": {
+        "status": {
+          "description": "Enable or disable ssl for scoring",
+          "type": "string",
+          "enum": [
+            "Disabled",
+            "Enabled"
+          ]
+        },
+        "cert": {
+          "description": "Cert data",
+          "type": "string"
+        },
+        "key": {
+          "description": "Key data",
+          "type": "string"
+        },
+        "cname": {
+          "description": "CNAME of the cert",
+          "type": "string"
+        }
+      }
+    },
+    "AksNetworkingConfiguration": {
+      "type": "object",
+      "description": "Advance configuration for AKS networking",
+      "properties": {
+        "subnetId": {
+          "description": "Virtual network subnet resource ID the compute nodes belong to",
+          "type": "string"
+        },
+        "serviceCidr": {
+          "pattern": "^([0-9]{1,3}\\.){3}[0-9]{1,3}(\\/([0-9]|[1-2][0-9]|3[0-2]))?$",
+          "description": "A CIDR notation IP range from which to assign service cluster IPs. It must not overlap with any Subnet IP ranges.",
+          "type": "string"
+        },
+        "dnsServiceIP": {
+          "pattern": "^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$",
+          "description": "An IP address assigned to the Kubernetes DNS service. It must be within the Kubernetes service address range specified in serviceCidr.",
+          "type": "string"
+        },
+        "dockerBridgeCidr": {
+          "pattern": "^([0-9]{1,3}\\.){3}[0-9]{1,3}(\\/([0-9]|[1-2][0-9]|3[0-2]))?$",
+          "description": "A CIDR notation IP range assigned to the Docker bridge network. It must not overlap with any Subnet IP ranges or the Kubernetes service address range.",
+          "type": "string"
+        }
+      }
+    },
+    "UserAccountCredentials": {
+      "properties": {
+        "adminUserName": {
+          "type": "string",
+          "title": "User name.",
+          "description": "Name of the administrator user account which can be used to SSH to nodes."
+        },
+        "adminUserSshPublicKey": {
+          "type": "string",
+          "title": "SSH public key.",
+          "description": "SSH public key of the administrator user account. This property is only supported on Linux based clusters."
+        },
+        "adminUserPassword": {
+          "type": "string",
+          "title": "Password.",
+          "description": "Password of the administrator user account."
+        }
+      },
+      "required": [
+        "adminUserName"
+      ],
+      "description": "Settings for user account that gets created on each on the nodes of a compute."
+    },
+    "ScaleSettings": {
+      "type": "object",
+      "description": "scale settings for AML Compute",
+      "properties": {
+        "maxNodeCount": {
+          "description": "Max number of nodes to use",
+          "type": "integer"
+        },
+        "minNodeCount": {
+          "description": "Min number of nodes to use",
+          "type": "integer",
+          "default": 0
+        },
+        "nodeIdleTimeBeforeScaleDown": {
+          "type": "string",
+          "format": "duration",
+          "description": "Node Idle Time before scaling down amlCompute"
+        }
+      },
+      "required": [
+        "maxNodeCount"
+      ]
+    },
+    "NodeStateCounts": {
+      "properties": {
+        "idleNodeCount": {
+          "readOnly": true,
+          "type": "integer",
+          "format": "int32",
+          "title": "Idle node count.",
+          "description": "Number of compute nodes in idle state."
+        },
+        "runningNodeCount": {
+          "readOnly": true,
+          "type": "integer",
+          "format": "int32",
+          "title": "Running node count.",
+          "description": "Number of compute nodes which are running jobs."
+        },
+        "preparingNodeCount": {
+          "readOnly": true,
+          "type": "integer",
+          "format": "int32",
+          "title": "Preparing node count.",
+          "description": "Number of compute nodes which are being prepared."
+        },
+        "unusableNodeCount": {
+          "readOnly": true,
+          "type": "integer",
+          "format": "int32",
+          "title": "Unusable node count.",
+          "description": "Number of compute nodes which are in unusable state."
+        },
+        "leavingNodeCount": {
+          "readOnly": true,
+          "type": "integer",
+          "format": "int32",
+          "title": "Leaving node count.",
+          "description": "Number of compute nodes which are leaving the amlCompute."
+        },
+        "preemptedNodeCount": {
+          "readOnly": true,
+          "type": "integer",
+          "format": "int32",
+          "title": "Preempted node count.",
+          "description": "Number of compute nodes which are in preempted state."
+        }
+      },
+      "description": "Counts of various compute node states on the amlCompute."
+    },
+    "ClusterUpdateProperties": {
+      "properties": {
+        "scaleSettings": {
+          "$ref": "#/definitions/ScaleSettings",
+          "title": "Scale settings.",
+          "description": "Desired scale settings for the amlCompute."
+        }
+      },
+      "description": "The properties of a amlCompute that need to be updated."
+    },
+    "ClusterUpdateParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ClusterUpdateProperties",
+          "description": "The properties of the amlCompute."
+        }
+      },
+      "description": "AmlCompute update parameters."
+    },
+    "ComputeNodesInformation": {
+      "type": "object",
+      "description": "Compute nodes information related to a Machine Learning compute. Might differ for every type of compute.",
+      "discriminator": "computeType",
+      "properties": {
+        "computeType": {
+          "description": "The type of compute",
+          "$ref": "#/definitions/ComputeType"
+        },
+        "nextLink": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The continuation token."
+        }
+      },
+      "required": [
+        "computeType"
+      ]
+    },
+    "AmlComputeNodesInformation": {
+      "description": "Compute node information related to a AmlCompute.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ComputeNodesInformation"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "nodes": {
+              "readOnly": true,
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/AmlComputeNodeInformation"
+              },
+              "description": "The collection of returned AmlCompute nodes details."
+            }
+          }
+        }
+      ],
+      "x-ms-discriminator-value": "AmlCompute"
+    },
+    "AmlComputeNodeInformation": {
+      "description": "Compute node information related to a AmlCompute.",
+      "properties": {
+        "nodeId": {
+          "readOnly": true,
+          "type": "string",
+          "title": "Node ID.",
+          "description": "ID of the compute node."
+        },
+        "privateIpAddress": {
+          "readOnly": true,
+          "type": "string",
+          "title": "Private IP address.",
+          "description": "Private IP address of the compute node."
+        },
+        "publicIpAddress": {
+          "readOnly": true,
+          "type": "string",
+          "title": "Public IP address.",
+          "description": "Public IP address of the compute node."
+        },
+        "port": {
+          "readOnly": true,
+          "type": "number",
+          "format": "int32",
+          "title": "Port.",
+          "description": "SSH port number of the node."
+        },
+        "nodeState": {
+          "readOnly": true,
+          "type": "string",
+          "enum": [
+            "idle",
+            "running",
+            "preparing",
+            "unusable",
+            "leaving",
+            "preempted"
+          ],
+          "description": "State of the compute node. Values are idle, running, preparing, unusable, leaving and preempted.",
+          "x-ms-enum": {
+            "name": "nodeState",
+            "modelAsString": true
+          }
+        },
+        "runId": {
+          "readOnly": true,
+          "type": "string",
+          "title": "Run ID.",
+          "description": "ID of the Experiment running on the node, if any else null."
+        }
+      },
+      "x-ms-discriminator-value": "AmlCompute"
+    },
+    "VirtualMachineSshCredentials": {
+      "type": "object",
+      "description": "Admin credentials for virtual machine",
+      "properties": {
+        "username": {
+          "description": "Username of admin account",
+          "type": "string"
+        },
+        "password": {
+          "description": "Password of admin account",
+          "type": "string"
+        },
+        "publicKeyData": {
+          "description": "Public key data",
+          "type": "string"
+        },
+        "privateKeyData": {
+          "description": "Private key data",
+          "type": "string"
+        }
+      }
+    },
+    "ComputeSecrets": {
+      "type": "object",
+      "description": "Secrets related to a Machine Learning compute. Might differ for every type of compute.",
+      "discriminator": "computeType",
+      "properties": {
+        "computeType": {
+          "description": "The type of compute",
+          "$ref": "#/definitions/ComputeType"
+        }
+      },
+      "required": [
+        "computeType"
+      ]
+    },
+    "AksComputeSecrets": {
+      "description": "Secrets related to a Machine Learning compute based on AKS.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ComputeSecrets"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "userKubeConfig": {
+              "type": "string",
+              "description": "Content of kubeconfig file that can be used to connect to the Kubernetes cluster."
+            },
+            "adminKubeConfig": {
+              "type": "string",
+              "description": "Content of kubeconfig file that can be used to connect to the Kubernetes cluster."
+            },
+            "imagePullSecretName": {
+              "type": "string",
+              "description": "Image registry pull secret."
+            }
+          }
+        }
+      ],
+      "x-ms-discriminator-value": "AKS"
+    },
+    "VirtualMachineSecrets": {
+      "description": "Secrets related to a Machine Learning compute based on AKS.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ComputeSecrets"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "administratorAccount": {
+              "description": "Admin credentials for virtual machine.",
+              "$ref": "#/definitions/VirtualMachineSshCredentials"
+            }
+          }
+        }
+      ],
+      "x-ms-discriminator-value": "VirtualMachine"
+    },
+    "DatabricksComputeSecrets": {
+      "description": "Secrets related to a Machine Learning compute based on Databricks.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ComputeSecrets"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "databricksAccessToken": {
+              "description": "access token for databricks account.",
+              "type": "string"
+            }
+          }
+        }
+      ],
+      "x-ms-discriminator-value": "Databricks"
+    },
+    "ComputeType": {
+      "type": "string",
+      "description": "The type of compute",
+      "enum": [
+        "AKS",
+        "AmlCompute",
+        "ComputeInstance",
+        "DataFactory",
+        "VirtualMachine",
+        "HDInsight",
+        "Databricks",
+        "DataLakeAnalytics"
+      ],
+      "x-ms-enum": {
+        "name": "ComputeType",
+        "modelAsString": true
+      }
+    },
+    "MachineLearningServiceError": {
+      "type": "object",
+      "description": "Wrapper for error response to follow ARM guidelines.",
+      "properties": {
+        "error": {
+          "description": "The error response.",
+          "$ref": "#/definitions/ErrorResponse",
+          "readOnly": true
+        }
+      }
+    },
+    "ErrorResponse": {
+      "type": "object",
+      "description": "Error response information.",
+      "properties": {
+        "code": {
+          "type": "string",
+          "description": "Error code.",
+          "readOnly": true
+        },
+        "message": {
+          "type": "string",
+          "description": "Error message.",
+          "readOnly": true
+        },
+        "details": {
+          "type": "array",
+          "description": "An array of error detail objects.",
+          "items": {
+            "$ref": "#/definitions/ErrorDetail"
+          },
+          "readOnly": true
+        }
+      }
+    },
+    "ErrorDetail": {
+      "type": "object",
+      "description": "Error detail information.",
+      "properties": {
+        "code": {
+          "type": "string",
+          "description": "Error code."
+        },
+        "message": {
+          "type": "string",
+          "description": "Error message."
+        }
+      },
+      "required": [
+        "code",
+        "message"
+      ]
+    },
+    "SKUCapability": {
+      "description": "Features/user capabilities associated with the sku",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "Capability/Feature ID",
+          "type": "string"
+        },
+        "value": {
+          "description": "Details about the feature/capability",
+          "type": "string"
+        }
+      }
+    },
+    "ResourceSkuLocationInfo": {
+      "properties": {
+        "location": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Location of the SKU"
+        },
+        "zones": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "List of availability zones where the SKU is supported."
+        },
+        "zoneDetails": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ResourceSkuZoneDetails"
+          },
+          "description": "Details of capabilities available to a SKU in specific zones."
+        }
+      }
+    },
+    "ResourceSkuZoneDetails": {
+      "properties": {
+        "name": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "type": "string"
+          },
+          "description": "The set of zones that the SKU is available in with the specified capabilities."
+        },
+        "capabilities": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/SKUCapability"
+          },
+          "description": "A list of capabilities that are available for the SKU in the specified list of zones."
+        }
+      },
+      "description": "Describes The zonal capabilities of a SKU."
+    },
+    "WorkspaceSku": {
+      "description": "Describes Workspace Sku details and features",
+      "type": "object",
+      "properties": {
+        "locations": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "The set of locations that the SKU is available. This will be supported and registered Azure Geo Regions (e.g. West US, East US, Southeast Asia, etc.)."
+        },
+        "locationInfo": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/ResourceSkuLocationInfo"
+          },
+          "description": "A list of locations and availability zones in those locations where the SKU is available."
+        },
+        "tier": {
+          "description": "Sku Tier like Basic or Enterprise",
+          "type": "string",
+          "readOnly": true
+        },
+        "resourceType": {
+          "type": "string",
+          "readOnly": true
+        },
+        "name": {
+          "type": "string",
+          "readOnly": true
+        },
+        "capabilities": {
+          "description": "List of features/user capabilities associated with the sku",
+          "uniqueItems": false,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SKUCapability"
+          },
+          "readOnly": true
+        },
+        "restrictions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Restriction"
+          },
+          "description": "The restrictions because of which SKU cannot be used. This is empty if there are no restrictions."
+        }
+      }
+    },
+    "Restriction": {
+      "properties": {
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The type of restrictions. As of now only possible value for this is location."
+        },
+        "values": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "The value of restrictions. If the restriction type is set to location. This would be different locations where the SKU is restricted."
+        },
+        "reasonCode": {
+          "type": "string",
+          "enum": [
+            "NotSpecified",
+            "NotAvailableForRegion",
+            "NotAvailableForSubscription"
+          ],
+          "x-ms-enum": {
+            "name": "ReasonCode",
+            "modelAsString": true
+          },
+          "description": "The reason for the restriction."
+        }
+      },
+      "description": "The restriction because of which SKU cannot be used."
+    },
+    "SkuListResult": {
+      "description": "List of skus with features",
+      "type": "object",
+      "properties": {
+        "value": {
+          "uniqueItems": false,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/WorkspaceSku"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "The URI to fetch the next page of Workspace Skus. Call ListNext() with this URI to fetch the next page of Workspace Skus"
+        }
+      }
+    },
+    "Sku": {
+      "description": "Sku of the resource",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "Name of the sku",
+          "type": "string"
+        },
+        "tier": {
+          "description": "Tier of the sku like Basic or Enterprise",
+          "type": "string"
+        }
+      }
+    },
+    "PrivateEndpointConnection": {
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/PrivateEndpointConnectionProperties",
+          "x-ms-client-flatten": true,
+          "description": "Resource properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/Resource"
+        }
+      ],
+      "description": "The Private Endpoint Connection resource."
+    },
+    "PrivateEndpointConnectionProperties": {
+      "properties": {
+        "privateEndpoint": {
+          "$ref": "#/definitions/PrivateEndpoint",
+          "description": "The resource of private end point."
+        },
+        "privateLinkServiceConnectionState": {
+          "$ref": "#/definitions/PrivateLinkServiceConnectionState",
+          "description": "A collection of information about the state of the connection between service consumer and provider."
+        },
+        "provisioningState": {
+          "$ref": "#/definitions/PrivateEndpointConnectionProvisioningState",
+          "description": "The provisioning state of the private endpoint connection resource."
+        }
+      },
+      "required": [
+        "privateLinkServiceConnectionState"
+      ],
+      "description": "Properties of the PrivateEndpointConnectProperties."
+    },
+    "PrivateEndpoint": {
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The ARM identifier for Private Endpoint"
+        }
+      },
+      "description": "The Private Endpoint resource."
+    },
+    "PrivateLinkServiceConnectionState": {
+      "properties": {
+        "status": {
+          "$ref": "#/definitions/PrivateEndpointServiceConnectionStatus",
+          "description": "Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service."
+        },
+        "description": {
+          "type": "string",
+          "description": "The reason for approval/rejection of the connection."
+        },
+        "actionRequired": {
+          "type": "string",
+          "description": "A message indicating if changes on the service provider require any updates on the consumer."
+        }
+      },
+      "description": "A collection of information about the state of the connection between service consumer and provider."
+    },
+    "PrivateEndpointServiceConnectionStatus": {
+      "type": "string",
+      "description": "The private endpoint connection status.",
+      "enum": [
+        "Pending",
+        "Approved",
+        "Rejected"
+      ],
+      "x-ms-enum": {
+        "name": "PrivateEndpointServiceConnectionStatus",
+        "modelAsString": true
+      }
+    },
+    "PrivateEndpointConnectionProvisioningState": {
+      "type": "string",
+      "readOnly": true,
+      "description": "The current provisioning state.",
+      "enum": [
+        "Succeeded",
+        "Creating",
+        "Deleting",
+        "Failed"
+      ],
+      "x-ms-enum": {
+        "name": "PrivateEndpointConnectionProvisioningState",
+        "modelAsString": true
+      }
+    },
+    "PrivateLinkResourceListResult": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "description": "Array of private link resources",
+          "items": {
+            "$ref": "#/definitions/PrivateLinkResource"
+          }
+        }
+      },
+      "description": "A list of private link resources"
+    },
+    "PrivateLinkResource": {
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/PrivateLinkResourceProperties",
+          "description": "Resource properties.",
+          "x-ms-client-flatten": true
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/Resource"
+        }
+      ],
+      "description": "A private link resource"
+    },
+    "PrivateLinkResourceProperties": {
+      "properties": {
+        "groupId": {
+          "description": "The private link resource group id.",
+          "type": "string",
+          "readOnly": true
+        },
+        "requiredMembers": {
+          "description": "The private link resource required member names.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "readOnly": true
+        },
+        "requiredZoneNames": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "The private link resource Private link DNS zone name."
+        }
+      },
+      "description": "Properties of a private link resource."
+    },
+    "EncryptionProperty": {
+      "properties": {
+        "status": {
+          "description": "Indicates whether or not the encryption is enabled for the workspace.",
+          "enum": [
+            "Enabled",
+            "Disabled"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "EncryptionStatus",
+            "modelAsString": true
+          }
+        },
+        "keyVaultProperties": {
+          "$ref": "#/definitions/KeyVaultProperties",
+          "description": "Customer Key vault properties."
+        }
+      },
+      "required": [
+        "status",
+        "keyVaultProperties"
+      ],
+      "type": "object"
+    },
+    "KeyVaultProperties": {
+      "properties": {
+        "keyVaultArmId": {
+          "description": "The ArmId of the keyVault where the customer owned encryption key is present.",
+          "type": "string"
+        },
+        "keyIdentifier": {
+          "description": "Key vault uri to access the encryption key.",
+          "type": "string"
+        },
+        "identityClientId": {
+          "description": "For future use - The client id of the identity which will be used to access key vault.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "keyIdentifier",
+        "keyVaultArmId"
+      ],
+      "type": "object"
+    },
+    "ComputeInstanceSshSettings": {
+      "type": "object",
+      "description": "Specifies policy and settings for SSH access.",
+      "properties": {
+        "sshPublicAccess": {
+          "type": "string",
+          "default": "Disabled",
+          "title": "Access policy for SSH",
+          "description": "State of the public SSH port. Possible values are: Disabled - Indicates that the public ssh port is closed on this instance. Enabled - Indicates that the public ssh port is open and accessible according to the VNet/subnet policy if applicable.",
+          "enum": [
+            "Enabled",
+            "Disabled"
+          ],
+          "x-ms-enum": {
+            "name": "sshPublicAccess",
+            "modelAsString": true
+          }
+        },
+        "adminUserName": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Describes the admin user name."
+        },
+        "sshPort": {
+          "type": "integer",
+          "format": "int32",
+          "readOnly": true,
+          "description": "Describes the port for connecting through SSH."
+        },
+        "adminPublicKey": {
+          "type": "string",
+          "description": "Specifies the SSH rsa public key file as a string. Use \"ssh-keygen -t rsa -b 2048\" to generate your SSH key pairs."
+        }
+      }
+    },
+    "ComputeInstanceState": {
+      "type": "string",
+      "description": "Current state of a ComputeInstance.",
+      "enum": [
+        "Creating",
+        "CreateFailed",
+        "Deleting",
+        "Running",
+        "Restarting",
+        "RestartFailed",
+        "JobRunning",
+        "SettingUp",
+        "Starting",
+        "StartFailed",
+        "StopFailed",
+        "Stopped",
+        "Stopping",
+        "UserSettingUp",
+        "Unknown",
+        "Unusable"
+      ],
+      "x-ms-enum": {
+        "name": "ComputeInstanceState",
+        "modelAsString": true
+      }
+    },
+    "ComputeInstanceApplication": {
+      "type": "object",
+      "description": "Defines an Aml Instance application and its connectivity endpoint URI.",
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "Name of the ComputeInstance application."
+        },
+        "endpointUri": {
+          "type": "string",
+          "description": "Application' endpoint URI."
+        }
+      }
+    },
+    "ComputeInstanceConnectivityEndpoints": {
+      "type": "object",
+      "readOnly": true,
+      "description": "Defines all connectivity endpoints and properties for a ComputeInstance.",
+      "properties": {
+        "publicIpAddress": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Public IP Address of this ComputeInstance."
+        },
+        "privateIpAddress": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Private IP Address of this ComputeInstance (local to the VNET in which the compute instance is deployed)."
+        }
+      }
+    },
+    "ComputeInstanceCreatedBy": {
+      "type": "object",
+      "readOnly": true,
+      "description": "Describes information on user who created this ComputeInstance.",
+      "properties": {
+        "userName": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Name of the user."
+        },
+        "userOrgId": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Uniquely identifies user' Azure Active Directory organization."
+        },
+        "userId": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Uniquely identifies the user within his/her organization."
+        }
+      }
+    }
+  }
+}
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/stable/2018-11-19/machineLearningServices.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/stable/2018-11-19/machineLearningServices.json
index 299f2559cdb7..0178bb7c73d3 100644
--- a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/stable/2018-11-19/machineLearningServices.json
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/stable/2018-11-19/machineLearningServices.json
@@ -1329,7 +1329,6 @@
         },
         "identity": {
           "$ref": "#/definitions/Identity",
-          "readOnly": true,
           "description": "The identity of the resource."
         },
         "location": {
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/stable/2019-05-01/machineLearningServices.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/stable/2019-05-01/machineLearningServices.json
index 9dd954ced322..03836d3773af 100644
--- a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/stable/2019-05-01/machineLearningServices.json
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/stable/2019-05-01/machineLearningServices.json
@@ -1346,7 +1346,6 @@
         },
         "identity": {
           "$ref": "#/definitions/Identity",
-          "readOnly": true,
           "description": "The identity of the resource."
         },
         "location": {
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/stable/2019-06-01/machineLearningServices.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/stable/2019-06-01/machineLearningServices.json
index d7979ee4da13..8f6d8aa125f2 100644
--- a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/stable/2019-06-01/machineLearningServices.json
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/stable/2019-06-01/machineLearningServices.json
@@ -1630,7 +1630,6 @@
         },
         "identity": {
           "$ref": "#/definitions/Identity",
-          "readOnly": true,
           "description": "The identity of the resource."
         },
         "location": {
diff --git a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/stable/2020-03-01/machineLearningServices.json b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/stable/2020-03-01/machineLearningServices.json
index 94acde613c2a..b5dede913fa4 100644
--- a/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/stable/2020-03-01/machineLearningServices.json
+++ b/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/stable/2020-03-01/machineLearningServices.json
@@ -1970,7 +1970,6 @@
         },
         "identity": {
           "$ref": "#/definitions/Identity",
-          "readOnly": true,
           "description": "The identity of the resource."
         },
         "location": {
diff --git a/specification/machinelearningservices/resource-manager/readme.az.md b/specification/machinelearningservices/resource-manager/readme.az.md
new file mode 100644
index 000000000000..0f4ebb2376b1
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/readme.az.md
@@ -0,0 +1,12 @@
+## AZ
+
+These settings apply only when `--az` is specified on the command line.
+
+``` yaml $(az)
+az:
+  extensions: machinelearningservices
+  namespace: azure.mgmt.machinelearningservices
+  package-name: azure-mgmt-machinelearningservices
+python-sdk-output-folder: "$(output-folder)/src/machinelearningservices/azext_machinelearningservices/vendored_sdks/machinelearningservices"
+  
+```
diff --git a/specification/machinelearningservices/resource-manager/readme.cli.md b/specification/machinelearningservices/resource-manager/readme.cli.md
new file mode 100644
index 000000000000..98b6efc498ad
--- /dev/null
+++ b/specification/machinelearningservices/resource-manager/readme.cli.md
@@ -0,0 +1,9 @@
+ CLI
+
+These settings apply only when `--cli` is specified on the command line.
+
+``` yaml $(cli)
+#cli:
+#  test-scenario:
+#    - name: Workspace_CreateOrUpdate
+```
diff --git a/specification/machinelearningservices/resource-manager/readme.go.md b/specification/machinelearningservices/resource-manager/readme.go.md
index 88ece532fc0c..13ba41849b86 100644
--- a/specification/machinelearningservices/resource-manager/readme.go.md
+++ b/specification/machinelearningservices/resource-manager/readme.go.md
@@ -19,6 +19,7 @@ batch:
   - tag: package-2019-06-01
   - tag: package-2019-05-01
   - tag: package-2018-11-19
+  - tag: package-2020-02-18-preview
   - tag: package-2018-03-preview
 ```
 
@@ -76,6 +77,15 @@ Please also specify `--go-sdk-folder=<path to the root directory of your azure-s
 output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2018-11-19/$(namespace)
 ```
 
+### Tag: package-2020-02-18-preview and go
+
+These settings apply only when `--tag=package-2020-02-18-preview --go` is specified on the command line.
+Please also specify `--go-sdk-folder=<path to the root directory of your azure-sdk-for-go clone>`.
+
+```yaml $(tag)=='package-2020-02-18-preview' && $(go)
+output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2020-02-18-preview/$(namespace)
+```
+
 ### Tag: package-2018-03-preview and go
 
 These settings apply only when `--tag=package-2018-03-preview --go` is specified on the command line.
diff --git a/specification/machinelearningservices/resource-manager/readme.md b/specification/machinelearningservices/resource-manager/readme.md
index dd4ede701f92..e4181ee9e488 100644
--- a/specification/machinelearningservices/resource-manager/readme.md
+++ b/specification/machinelearningservices/resource-manager/readme.md
@@ -84,6 +84,15 @@ input-file:
 - Microsoft.MachineLearningServices/stable/2018-11-19/machineLearningServices.json
 ```
 
+### Tag: package-2020-02-18-preview
+
+These settings apply only when `--tag=package-2020-02-18-preview` is specified on the command line.
+
+``` yaml $(tag) == 'package-2020-02-18-preview'
+input-file:
+- Microsoft.MachineLearningServices/preview/2020-02-18-preview/machineLearningServices.json
+```
+
 ### Tag: package-2018-03-preview
 
 These settings apply only when `--tag=package-2018-03-preview` is specified on the command line.
@@ -109,6 +118,7 @@ swagger-to-sdk:
   - repo: azure-sdk-for-python
   - repo: azure-sdk-for-js
   - repo: azure-sdk-for-node
+  - repo: azure-cli-extensions
 ```
 
 ## C#
@@ -153,6 +163,7 @@ batch:
   - tag: package-2019-06-01
   - tag: package-2019-05-01
   - tag: package-2018-11-19
+  - tag: package-2020-02-18-preview
   - tag: package-2018-03-preview
 ```
 
@@ -265,6 +276,7 @@ input-file:
   - $(this-folder)/Microsoft.MachineLearningServices/stable/2019-06-01/machineLearningServices.json
   - $(this-folder)/Microsoft.MachineLearningServices/stable/2019-05-01/machineLearningServices.json
   - $(this-folder)/Microsoft.MachineLearningServices/stable/2018-11-19/machineLearningServices.json
+  - $(this-folder)/Microsoft.MachineLearningServices/preview/2020-02-18-preview/machineLearningServices.json
   - $(this-folder)/Microsoft.MachineLearningServices/preview/2018-03-01-preview/machineLearningServices.json
 
 ```
diff --git a/specification/monitor/resource-manager/Microsoft.Insights/stable/2016-03-01/alertRules_API.json b/specification/monitor/resource-manager/Microsoft.Insights/stable/2016-03-01/alertRules_API.json
index f9d1e42c1f5e..0f5f7a89919c 100644
--- a/specification/monitor/resource-manager/Microsoft.Insights/stable/2016-03-01/alertRules_API.json
+++ b/specification/monitor/resource-manager/Microsoft.Insights/stable/2016-03-01/alertRules_API.json
@@ -38,7 +38,7 @@
   "paths": {
     "/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/microsoft.insights/alertrules/{ruleName}": {
       "put": {
-        "description": "Creates or updates an alert rule.",
+        "description": "Creates or updates a classic metric alert rule.",
         "tags": [
           "AlertRules"
         ],
@@ -93,7 +93,7 @@
         }
       },
       "delete": {
-        "description": "Deletes an alert rule",
+        "description": "Deletes a classic metric alert rule",
         "tags": [
           "AlertRules"
         ],
@@ -127,7 +127,7 @@
         }
       },
       "get": {
-        "description": "Gets an alert rule",
+        "description": "Gets a classic metric alert rule",
         "tags": [
           "AlertRules"
         ],
@@ -161,7 +161,7 @@
         }
       },
       "patch": {
-        "description": "Updates an existing AlertRuleResource. To update other fields use the CreateOrUpdate method.",
+        "description": "Updates an existing classic metric AlertRuleResource. To update other fields use the CreateOrUpdate method.",
         "operationId": "AlertRules_Update",
         "parameters": [
           {
@@ -219,7 +219,7 @@
           "AlertRules"
         ],
         "operationId": "AlertRules_ListByResourceGroup",
-        "description": "List the alert rules within a resource group.",
+        "description": "List the classic metric alert rules within a resource group.",
         "parameters": [
           {
             "$ref": "#/parameters/ResourceGroupNameParameter"
@@ -255,7 +255,7 @@
           "AlertRules"
         ],
         "operationId": "AlertRules_ListBySubscription",
-        "description": "List the alert rules within a subscription.",
+        "description": "List the classic metric alert rules within a subscription.",
         "parameters": [
           {
             "$ref": "#/parameters/ApiVersionParameter"
diff --git a/specification/monitor/resource-manager/Microsoft.Insights/stable/2016-03-01/examples/createOrUpdateAlertRule.json b/specification/monitor/resource-manager/Microsoft.Insights/stable/2016-03-01/examples/createOrUpdateAlertRule.json
index 50712ab18981..9b2847370ee1 100644
--- a/specification/monitor/resource-manager/Microsoft.Insights/stable/2016-03-01/examples/createOrUpdateAlertRule.json
+++ b/specification/monitor/resource-manager/Microsoft.Insights/stable/2016-03-01/examples/createOrUpdateAlertRule.json
@@ -23,7 +23,6 @@
           "windowSize": "PT5M",
           "timeAggregation": "Total"
         },
-        "lastUpdatedTime": "2016-11-23T21:23:52.0221265Z",
         "actions": []
       }
     }
diff --git a/specification/monitor/resource-manager/Microsoft.Insights/stable/2016-03-01/examples/patchAlertRule.json b/specification/monitor/resource-manager/Microsoft.Insights/stable/2016-03-01/examples/patchAlertRule.json
index df5d714900ba..4c7dca8d33cf 100644
--- a/specification/monitor/resource-manager/Microsoft.Insights/stable/2016-03-01/examples/patchAlertRule.json
+++ b/specification/monitor/resource-manager/Microsoft.Insights/stable/2016-03-01/examples/patchAlertRule.json
@@ -24,7 +24,6 @@
           "windowSize": "PT5M",
           "timeAggregation": "Total"
         },
-        "lastUpdatedTime": "2016-11-23T21:23:52.0221265Z",
         "actions": []
       }
     }
diff --git a/specification/monitor/resource-manager/Microsoft.Insights/stable/2018-03-01/metricAlert_API.json b/specification/monitor/resource-manager/Microsoft.Insights/stable/2018-03-01/metricAlert_API.json
index ff54ab2714a8..79be5f2a8c27 100644
--- a/specification/monitor/resource-manager/Microsoft.Insights/stable/2018-03-01/metricAlert_API.json
+++ b/specification/monitor/resource-manager/Microsoft.Insights/stable/2018-03-01/metricAlert_API.json
@@ -525,7 +525,7 @@
         },
         "autoMitigate": {
           "type": "boolean",
-          "description": "the flag that indicates whether the alert should be auto resolved or not."
+          "description": "the flag that indicates whether the alert should be auto resolved or not. The default is true."
         },
         "actions": {
           "type": "array",
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2019-11-01/netapp.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2019-11-01/netapp.json
index 3425ca769201..a43c16dd1958 100644
--- a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2019-11-01/netapp.json
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2019-11-01/netapp.json
@@ -2182,7 +2182,7 @@
           "type": "array",
           "description": "List of mount targets",
           "items": {
-            "$ref": "#/definitions/mountTargetList"
+            "$ref": "#/definitions/mountTarget"
           }
         },
         "volumeType": {
diff --git a/specification/network/resource-manager/readme.go.md b/specification/network/resource-manager/readme.go.md
index 462ea5427069..8c11af1029a7 100644
--- a/specification/network/resource-manager/readme.go.md
+++ b/specification/network/resource-manager/readme.go.md
@@ -13,6 +13,7 @@ go:
 
 ``` yaml $(go) && $(multiapi)
 batch:
+  - tag: package-2019-12
   - tag: package-2019-11
   - tag: package-2019-09
   - tag: package-2019-08
@@ -43,6 +44,15 @@ batch:
   - tag: package-2015-05-preview
 ```
 
+### Tag: package-2019-12 and go
+
+These settings apply only when `--tag=package-2019-12 --go` is specified on the command line.
+Please also specify `--go-sdk-folder=<path to the root directory of your azure-sdk-for-go clone>`.
+
+``` yaml $(tag) == 'package-2019-12' && $(go)
+output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2019-12-01/$(namespace)
+```
+
 ### Tag: package-2019-11 and go
 
 These settings apply only when `--tag=package-2019-11 --go` is specified on the command line.
diff --git a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/LinkedServices.json b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/LinkedServices.json
new file mode 100644
index 000000000000..3cfe38dc5c86
--- /dev/null
+++ b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/LinkedServices.json
@@ -0,0 +1,325 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "Azure Log Analytics",
+    "description": "Azure Log Analytics API reference",
+    "version": "2015-11-01-preview"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/linkedServices/{linkedServiceName}": {
+      "put": {
+        "tags": [
+          "LinkedServices"
+        ],
+        "x-ms-examples": {
+          "LinkedServicesCreate": {
+            "$ref": "./examples/LinkedServicesCreate.json"
+          }
+        },
+        "operationId": "LinkedServices_CreateOrUpdate",
+        "description": "Create or update a linked service.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "name": "workspaceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of the Log Analytics Workspace that will contain the linkedServices resource"
+          },
+          {
+            "name": "linkedServiceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of the linkedServices resource"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/LinkedService"
+            },
+            "description": "The parameters required to create or update a linked service."
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK response definition.",
+            "schema": {
+              "$ref": "#/definitions/LinkedService"
+            }
+          },
+          "201": {
+            "description": "Created response definition.",
+            "schema": {
+              "$ref": "#/definitions/LinkedService"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "LinkedServices"
+        ],
+        "x-ms-examples": {
+          "LinkedServicesDelete": {
+            "$ref": "./examples/LinkedServicesDelete.json"
+          }
+        },
+        "operationId": "LinkedServices_Delete",
+        "description": "Deletes a linked service instance.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "name": "workspaceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of the Log Analytics Workspace that contains the linkedServices resource"
+          },
+          {
+            "name": "linkedServiceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of the linked service."
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK response definition."
+          },
+          "204": {
+            "description": "NoContent response definition."
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "LinkedServices"
+        ],
+        "x-ms-examples": {
+          "LinkedServicesGet": {
+            "$ref": "./examples/LinkedServicesGet.json"
+          }
+        },
+        "operationId": "LinkedServices_Get",
+        "description": "Gets a linked service instance.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "name": "workspaceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of the Log Analytics Workspace that contains the linkedServices resource"
+          },
+          {
+            "name": "linkedServiceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of the linked service."
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK response definition.",
+            "schema": {
+              "$ref": "#/definitions/LinkedService"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/linkedServices": {
+      "get": {
+        "tags": [
+          "LinkedServices"
+        ],
+        "x-ms-examples": {
+          "LinkedServicesListByWorkspace": {
+            "$ref": "./examples/LinkedServicesListByWorkspace.json"
+          }
+        },
+        "operationId": "LinkedServices_ListByWorkspace",
+        "description": "Gets the linked services instances in a workspace.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "name": "workspaceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of the Log Analytics Workspace that contains the linked services."
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK response definition.",
+            "schema": {
+              "$ref": "#/definitions/LinkedServiceListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    }
+  },
+  "definitions": {
+    "LinkedServiceProperties": {
+      "properties": {
+        "resourceId": {
+          "type": "string",
+          "description": "The resource id of the resource that will be linked to the workspace."
+        }
+      },
+      "required": [
+        "resourceId"
+      ],
+      "description": "Linked service properties."
+    },
+    "LinkedService": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/LinkedServiceProperties",
+          "description": "The properties of the linked service."
+        }
+      },
+      "required": [
+        "properties"
+      ],
+      "allOf": [
+        {
+          "$ref": "#/definitions/ProxyResource"
+        }
+      ],
+      "description": "The top level Linked service resource container.",
+      "x-ms-azure-resource": true
+    },
+    "LinkedServiceListResult": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/LinkedService"
+          },
+          "description": "Gets or sets a list of linked service instances."
+        }
+      },
+      "description": "The list linked service operation response."
+    },
+    "ProxyResource": {
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Resource ID."
+        },
+        "name": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Resource name."
+        },
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Resource type."
+        }
+      },
+      "description": "Common properties of proxy resource."
+    }
+  },
+  "parameters": {
+    "SubscriptionIdParameter": {
+      "name": "subscriptionId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Gets subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
+    },
+    "ApiVersionParameter": {
+      "name": "api-version",
+      "in": "query",
+      "required": true,
+      "type": "string",
+      "description": "Client Api Version."
+    },
+    "ResourceGroupNameParameter": {
+      "name": "resourceGroupName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "description": "The name of the resource group to get. The name is case insensitive.",
+      "pattern": "^[-\\w\\._\\(\\)]+$",
+      "minLength": 1,
+      "maxLength": 90
+    }
+  }
+}
diff --git a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/OperationalInsights.json b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/OperationalInsights.json
index 9d47ed4d361a..ff3f6fe86d1a 100644
--- a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/OperationalInsights.json
+++ b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/OperationalInsights.json
@@ -34,201 +34,6 @@
     }
   },
   "paths": {
-    "/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/linkedServices/{linkedServiceName}": {
-      "put": {
-        "tags": [
-          "LinkedServices"
-        ],
-        "x-ms-examples": {
-          "LinkedServicesCreate": {
-            "$ref": "./examples/LinkedServicesCreate.json"
-          }
-        },
-        "operationId": "LinkedServices_CreateOrUpdate",
-        "description": "Create or update a linked service.",
-        "parameters": [
-          {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
-          },
-          {
-            "name": "workspaceName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "Name of the Log Analytics Workspace that will contain the linkedServices resource"
-          },
-          {
-            "name": "linkedServiceName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "Name of the linkedServices resource"
-          },
-          {
-            "name": "parameters",
-            "in": "body",
-            "required": true,
-            "schema": {
-              "$ref": "#/definitions/LinkedService"
-            },
-            "description": "The parameters required to create or update a linked service."
-          },
-          {
-            "$ref": "#/parameters/SubscriptionIdParameter"
-          },
-          {
-            "$ref": "#/parameters/ApiVersionParameter"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK response definition.",
-            "schema": {
-              "$ref": "#/definitions/LinkedService"
-            }
-          },
-          "201": {
-            "description": "Created response definition.",
-            "schema": {
-              "$ref": "#/definitions/LinkedService"
-            }
-          }
-        }
-      },
-      "delete": {
-        "tags": [
-          "LinkedServices"
-        ],
-        "x-ms-examples": {
-          "LinkedServicesDelete": {
-            "$ref": "./examples/LinkedServicesDelete.json"
-          }
-        },
-        "operationId": "LinkedServices_Delete",
-        "description": "Deletes a linked service instance.",
-        "parameters": [
-          {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
-          },
-          {
-            "name": "workspaceName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "Name of the Log Analytics Workspace that contains the linkedServices resource"
-          },
-          {
-            "name": "linkedServiceName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "Name of the linked service."
-          },
-          {
-            "$ref": "#/parameters/ApiVersionParameter"
-          },
-          {
-            "$ref": "#/parameters/SubscriptionIdParameter"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK response definition."
-          },
-          "204": {
-            "description": "NoContent response definition."
-          }
-        }
-      },
-      "get": {
-        "tags": [
-          "LinkedServices"
-        ],
-        "x-ms-examples": {
-          "LinkedServicesGet": {
-            "$ref": "./examples/LinkedServicesGet.json"
-          }
-        },
-        "operationId": "LinkedServices_Get",
-        "description": "Gets a linked service instance.",
-        "parameters": [
-          {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
-          },
-          {
-            "name": "workspaceName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "Name of the Log Analytics Workspace that contains the linkedServices resource"
-          },
-          {
-            "name": "linkedServiceName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "Name of the linked service."
-          },
-          {
-            "$ref": "#/parameters/ApiVersionParameter"
-          },
-          {
-            "$ref": "#/parameters/SubscriptionIdParameter"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK response definition.",
-            "schema": {
-              "$ref": "#/definitions/LinkedService"
-            }
-          }
-        }
-      }
-    },
-    "/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/linkedServices": {
-      "get": {
-        "tags": [
-          "LinkedServices"
-        ],
-        "x-ms-examples": {
-          "LinkedServicesListByWorkspace": {
-            "$ref": "./examples/LinkedServicesListByWorkspace.json"
-          }
-        },
-        "operationId": "LinkedServices_ListByWorkspace",
-        "description": "Gets the linked services instances in a workspace.",
-        "parameters": [
-          {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
-          },
-          {
-            "name": "workspaceName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "Name of the Log Analytics Workspace that contains the linked services."
-          },
-          {
-            "$ref": "#/parameters/ApiVersionParameter"
-          },
-          {
-            "$ref": "#/parameters/SubscriptionIdParameter"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK response definition.",
-            "schema": {
-              "$ref": "#/definitions/LinkedServiceListResult"
-            }
-          }
-        },
-        "x-ms-pageable": {
-          "nextLinkName": null
-        }
-      }
-    },
     "/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/dataSources/{dataSourceName}": {
       "put": {
         "tags": [
@@ -991,288 +796,6 @@
         }
       }
     },
-    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/privateLinkResources": {
-      "get": {
-        "tags": [
-          "PrivateLinkResources"
-        ],
-        "description": "Gets the private link resources that need to be created for a Log Analytics Workspace.",
-        "operationId": "PrivateLinkResources_ListByWorkspace",
-        "x-ms-pageable": {
-          "nextLinkName": "nextLink"
-        },
-        "parameters": [
-          {
-            "$ref": "#/parameters/SubscriptionIdParameter"
-          },
-          {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
-          },
-          {
-            "$ref": "#/parameters/ApiVersionParameter"
-          },
-          {
-            "name": "workspaceName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "Name of the Log Analytics Workspace that will contain the datasource"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved private link resources.",
-            "schema": {
-              "$ref": "#/definitions/PrivateLinkResourceListResult"
-            }
-          }
-        },
-        "x-ms-examples": {
-          "Gets private endpoint connection.": {
-            "$ref": "./examples/WorkspacePrivateLinkResourceListGet.json"
-          }
-        }
-      }
-    },
-    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/privateLinkResources/{groupName}": {
-      "get": {
-        "tags": [
-          "PrivateLinkResources"
-        ],
-        "description": "Gets the private link resources that need to be created for a Log Analytics Workspace.",
-        "operationId": "PrivateLinkResources_Get",
-        "parameters": [
-          {
-            "$ref": "#/parameters/SubscriptionIdParameter"
-          },
-          {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
-          },
-          {
-            "$ref": "#/parameters/ApiVersionParameter"
-          },
-          {
-            "name": "workspaceName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "Name of the Log Analytics Workspace that will contain the datasource"
-          },
-          {
-            "$ref": "#/parameters/GroupNameParameter"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved a specified private link resource.",
-            "schema": {
-              "$ref": "#/definitions/PrivateLinkResource"
-            }
-          }
-        },
-        "x-ms-examples": {
-          "Gets private endpoint connection.": {
-            "$ref": "./examples/WorkspacePrivateLinkResourceGet.json"
-          }
-        }
-      }
-    },
-    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/privateEndpointConnections/{privateEndpointConnectionName}": {
-      "get": {
-        "tags": [
-          "PrivateEndpointConnections"
-        ],
-        "description": "Gets a private endpoint connection.",
-        "operationId": "PrivateEndpointConnections_Get",
-        "parameters": [
-          {
-            "$ref": "#/parameters/SubscriptionIdParameter"
-          },
-          {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
-          },
-          {
-            "$ref": "#/parameters/ApiVersionParameter"
-          },
-          {
-            "name": "workspaceName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "Name of the Log Analytics Workspace that will contain the datasource"
-          },
-          {
-            "name": "privateEndpointConnectionName",
-            "in": "path",
-            "description": "The name of the private endpoint connection.",
-            "required": true,
-            "type": "string"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved a specified private endpoint connection.",
-            "schema": {
-              "$ref": "#/definitions/PrivateEndpointConnection"
-            }
-          }
-        },
-        "x-ms-examples": {
-          "Gets private endpoint connection.": {
-            "$ref": "./examples/PrivateEndpointConnectionGet.json"
-          }
-        }
-      },
-      "put": {
-        "tags": [
-          "PrivateEndpointConnections"
-        ],
-        "description": "Approve or reject a private endpoint connection with a given name.",
-        "operationId": "PrivateEndpointConnections_CreateOrUpdate",
-        "parameters": [
-          {
-            "$ref": "#/parameters/SubscriptionIdParameter"
-          },
-          {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
-          },
-          {
-            "$ref": "#/parameters/ApiVersionParameter"
-          },
-          {
-            "name": "workspaceName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "Name of the Log Analytics Workspace that will contain the datasource"
-          },
-          {
-            "name": "privateEndpointConnectionName",
-            "in": "path",
-            "description": "The name of the private endpoint connection.",
-            "required": true,
-            "type": "string"
-          },
-          {
-            "name": "parameters",
-            "in": "body",
-            "required": true,
-            "schema": {
-              "$ref": "#/definitions/PrivateEndpointConnection"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully approved or rejected private endpoint connection.",
-            "schema": {
-              "$ref": "#/definitions/PrivateEndpointConnection"
-            }
-          },
-          "202": {
-            "description": "Accepted"
-          }
-        },
-        "x-ms-long-running-operation": true,
-        "x-ms-examples": {
-          "Approve or reject a private endpoint connection with a given name.": {
-            "$ref": "./examples/PrivateEndpointConnectionUpdate.json"
-          }
-        }
-      },
-      "delete": {
-        "tags": [
-          "PrivateEndpointConnections"
-        ],
-        "description": "Deletes a private endpoint connection with a given name.",
-        "operationId": "PrivateEndpointConnections_Delete",
-        "parameters": [
-          {
-            "$ref": "#/parameters/SubscriptionIdParameter"
-          },
-          {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
-          },
-          {
-            "$ref": "#/parameters/ApiVersionParameter"
-          },
-          {
-            "name": "workspaceName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "Name of the Log Analytics Workspace that will contain the datasource"
-          },
-          {
-            "name": "privateEndpointConnectionName",
-            "in": "path",
-            "description": "The name of the private endpoint connection.",
-            "required": true,
-            "type": "string"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully deleted private endpoint connection."
-          },
-          "202": {
-            "description": "Accepted"
-          },
-          "204": {
-            "description": "Private endpoint connection does not exist."
-          }
-        },
-        "x-ms-long-running-operation": true,
-        "x-ms-examples": {
-          "Deletes a private endpoint connection with a given name.": {
-            "$ref": "./examples/PrivateEndpointConnectionDelete.json"
-          }
-        }
-      }
-    },
-    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/privateEndpointConnections": {
-      "get": {
-        "tags": [
-          "PrivateEndpointConnections"
-        ],
-        "description": "Gets all private endpoint connections on a workspace.",
-        "operationId": "PrivateEndpointConnections_ListByWorkspace",
-        "parameters": [
-          {
-            "$ref": "#/parameters/SubscriptionIdParameter"
-          },
-          {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
-          },
-          {
-            "$ref": "#/parameters/ApiVersionParameter"
-          },
-          {
-            "name": "workspaceName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "Name of the Log Analytics Workspace that will contain the datasource"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved private endpoint connections.",
-            "schema": {
-              "$ref": "#/definitions/PrivateEndpointConnectionListResult"
-            }
-          }
-        },
-        "x-ms-pageable": {
-          "nextLinkName": "nextLink"
-        },
-        "x-ms-examples": {
-          "Gets list of private endpoint connections on a workspace.": {
-            "$ref": "./examples/PrivateEndpointConnectionList.json"
-          }
-        }
-      }
-    },
     "/subscriptions/{subscriptionId}/providers/Microsoft.OperationalInsights/locations/{location}/operationStatuses/{asyncOperationId}": {
       "get": {
         "x-ms-examples": {
@@ -1362,49 +885,6 @@
         }
       }
     },
-    "LinkedServiceProperties": {
-      "properties": {
-        "resourceId": {
-          "type": "string",
-          "description": "The resource id of the resource that will be linked to the workspace."
-        }
-      },
-      "required": [
-        "resourceId"
-      ],
-      "description": "Linked service properties."
-    },
-    "LinkedService": {
-      "properties": {
-        "properties": {
-          "x-ms-client-flatten": true,
-          "$ref": "#/definitions/LinkedServiceProperties",
-          "description": "The properties of the linked service."
-        }
-      },
-      "required": [
-        "properties"
-      ],
-      "allOf": [
-        {
-          "$ref": "#/definitions/ProxyResource"
-        }
-      ],
-      "description": "The top level Linked service resource container.",
-      "x-ms-azure-resource": true
-    },
-    "LinkedServiceListResult": {
-      "properties": {
-        "value": {
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/LinkedService"
-          },
-          "description": "Gets or sets a list of linked service instances."
-        }
-      },
-      "description": "The list linked service operation response."
-    },
     "DataSourceKind": {
       "type": "string",
       "enum": [
@@ -1797,149 +1277,6 @@
       },
       "description": "Common properties of proxy resource."
     },
-    "PrivateLinkResourceListResult": {
-      "description": "A list of private link resources",
-      "type": "object",
-      "properties": {
-        "value": {
-          "description": "Array of results.",
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/PrivateLinkResource"
-          },
-          "readOnly": true
-        },
-        "nextLink": {
-          "description": "Link to retrieve next page of results.",
-          "type": "string",
-          "readOnly": true
-        }
-      }
-    },
-    "PrivateLinkResource": {
-      "description": "A private link resource",
-      "type": "object",
-      "properties": {
-        "properties": {
-          "$ref": "#/definitions/PrivateLinkResourceProperties",
-          "description": "Resource properties.",
-          "x-ms-client-flatten": true
-        }
-      },
-      "allOf": [
-        {
-          "$ref": "#/definitions/ProxyResource"
-        }
-      ]
-    },
-    "PrivateLinkResourceProperties": {
-      "description": "Properties of a private link resource.",
-      "type": "object",
-      "properties": {
-        "groupId": {
-          "description": "The private link resource group id.",
-          "type": "string",
-          "readOnly": true
-        },
-        "requiredMembers": {
-          "description": "The private link resource required member names.",
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "readOnly": true
-        }
-      }
-    },
-    "PrivateEndpointConnectionProperties": {
-      "description": "Properties of a private endpoint connection.",
-      "type": "object",
-      "properties": {
-        "privateEndpoint": {
-          "$ref": "#/definitions/PrivateEndpointProperty",
-          "description": "Private endpoint which the connection belongs to."
-        },
-        "privateLinkServiceConnectionState": {
-          "$ref": "#/definitions/PrivateLinkServiceConnectionStateProperty",
-          "description": "Connection state of the private endpoint connection."
-        },
-        "provisioningState": {
-          "description": "State of the private endpoint connection.",
-          "type": "string",
-          "readOnly": true
-        }
-      }
-    },
-    "PrivateEndpointProperty": {
-      "description": "Private endpoint which the connection belongs to.",
-      "type": "object",
-      "properties": {
-        "id": {
-          "description": "Resource id of the private endpoint.",
-          "type": "string"
-        }
-      },
-      "x-ms-azure-resource": true
-    },
-    "PrivateLinkServiceConnectionStateProperty": {
-      "description": "State of the private endpoint connection.",
-      "type": "object",
-      "required": [
-        "status",
-        "description"
-      ],
-      "properties": {
-        "status": {
-          "description": "The private link service connection status.",
-          "type": "string"
-        },
-        "description": {
-          "description": "The private link service connection description.",
-          "type": "string"
-        },
-        "actionsRequired": {
-          "description": "The actions required for private link service connection.",
-          "type": "string",
-          "readOnly": true
-        }
-      }
-    },
-    "PrivateEndpointConnection": {
-      "description": "A private endpoint connection",
-      "x-ms-azure-resource": true,
-      "type": "object",
-      "allOf": [
-        {
-          "$ref": "#/definitions/ProxyResource"
-        }
-      ],
-      "properties": {
-        "properties": {
-          "$ref": "#/definitions/PrivateEndpointConnectionProperties",
-          "description": "Resource properties.",
-          "x-ms-client-flatten": true
-        }
-      }
-    },
-    "PrivateEndpointConnectionListResult": {
-      "description": "A list of private endpoint connections.",
-      "type": "object",
-      "properties": {
-        "value": {
-          "description": "Array of results.",
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/PrivateEndpointConnection"
-          },
-          "readOnly": true
-        },
-        "nextLink": {
-          "description": "Link to retrieve next page of results.",
-          "type": "string",
-          "readOnly": true
-        }
-      }
-    },
     "ErrorResponse": {
       "description": "Describes the format of Error response.",
       "type": "object",
@@ -2011,14 +1348,6 @@
       "pattern": "^[-\\w\\._\\(\\)]+$",
       "minLength": 1,
       "maxLength": 90
-    },
-    "GroupNameParameter": {
-      "name": "groupName",
-      "in": "path",
-      "description": "The name of the private link resource.",
-      "required": true,
-      "x-ms-parameter-location": "method",
-      "type": "string"
     }
   }
 }
diff --git a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/examples/PrivateEndpointConnectionDelete.json b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/examples/PrivateEndpointConnectionDelete.json
deleted file mode 100644
index c1056b274ca4..000000000000
--- a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/examples/PrivateEndpointConnectionDelete.json
+++ /dev/null
@@ -1,14 +0,0 @@
-{
-  "parameters": {
-    "subscriptionId": "00000000-1111-2222-3333-444444444444",
-    "resourceGroupName": "MyResourceGroup",
-    "workspaceName": "MyWorkspace",
-    "privateEndpointConnectionName": "private-endpoint-connection-name",
-    "api-version": "2015-11-01-preview"
-  },
-  "responses": {
-    "200": {},
-    "202": {},
-    "204": {}
-  }
-}
diff --git a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/examples/PrivateEndpointConnectionGet.json b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/examples/PrivateEndpointConnectionGet.json
deleted file mode 100644
index 5f47b5967dd9..000000000000
--- a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/examples/PrivateEndpointConnectionGet.json
+++ /dev/null
@@ -1,29 +0,0 @@
-{
-  "parameters": {
-    "subscriptionId": "00000000-1111-2222-3333-444444444444",
-    "resourceGroupName": "MyResourceGroup",
-    "workspaceName": "MyWorkspace",
-    "privateEndpointConnectionName": "private-endpoint-connection-name",
-    "api-version": "2015-11-01-preview"
-  },
-  "responses": {
-    "200": {
-      "body": {
-        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/MyResourceGroup/providers/Microsoft.OperationalInsights/workspaces/MyWorkspace/privateEndpointConnections/private-endpoint-connection-name",
-        "name": "private-endpoint-connection-name",
-        "type": "Microsoft.OperationalInsights/workspaces/privateEndpointConnections",
-        "properties": {
-          "provisioningState": "Succeeded",
-          "privateEndpoint": {
-            "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
-          },
-          "privateLinkServiceConnectionState": {
-            "status": "Approved",
-            "description": "Auto-approved",
-            "actionsRequired": "None"
-          }
-        }
-      }
-    }
-  }
-}
diff --git a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/examples/PrivateEndpointConnectionList.json b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/examples/PrivateEndpointConnectionList.json
deleted file mode 100644
index 7eb0f56d6d96..000000000000
--- a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/examples/PrivateEndpointConnectionList.json
+++ /dev/null
@@ -1,48 +0,0 @@
-{
-  "parameters": {
-    "subscriptionId": "00000000-1111-2222-3333-444444444444",
-    "resourceGroupName": "MyResourceGroup",
-    "workspaceName": "MyWorkspace",
-    "api-version": "2015-11-01-preview"
-  },
-  "responses": {
-    "200": {
-      "body": {
-        "value": [
-          {
-            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/MyResourceGroup/providers/Microsoft.OperationalInsights/workspaces/MyWorkspace/privateEndpointConnections/private-endpoint-connection-name-2",
-            "name": "private-endpoint-connection-name",
-            "type": "Microsoft.OperationalInsights/workspaces/privateEndpointConnections",
-            "properties": {
-              "provisioningState": "Succeeded",
-              "privateEndpoint": {
-                "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
-              },
-              "privateLinkServiceConnectionState": {
-                "status": "Approved",
-                "description": "Auto-approved",
-                "actionsRequired": "None"
-              }
-            }
-          },
-          {
-            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/MyResourceGroup/providers/Microsoft.OperationalInsights/workspaces/MyWorkspace/privateEndpointConnections/private-endpoint-connection-name-2",
-            "name": "private-endpoint-connection-name-2",
-            "type": "Microsoft.OperationalInsights/workspaces/privateEndpointConnections",
-            "properties": {
-              "provisioningState": "Succeeded",
-              "privateEndpoint": {
-                "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name-2"
-              },
-              "privateLinkServiceConnectionState": {
-                "status": "Pending",
-                "description": "Please approve my connection.",
-                "actionsRequired": "None"
-              }
-            }
-          }
-        ]
-      }
-    }
-  }
-}
diff --git a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/examples/PrivateEndpointConnectionUpdate.json b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/examples/PrivateEndpointConnectionUpdate.json
deleted file mode 100644
index cb0dcdc32e4a..000000000000
--- a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/examples/PrivateEndpointConnectionUpdate.json
+++ /dev/null
@@ -1,38 +0,0 @@
-{
-  "parameters": {
-    "subscriptionId": "00000000-1111-2222-3333-444444444444",
-    "resourceGroupName": "MyResourceGroup",
-    "workspaceName": "MyWorkspace",
-    "privateEndpointConnectionName": "private-endpoint-connection-name",
-    "api-version": "2015-11-01-preview",
-    "parameters": {
-      "properties": {
-        "privateLinkServiceConnectionState": {
-          "status": "Approved",
-          "description": "Approved by johndoe@contoso.com"
-        }
-      }
-    }
-  },
-  "responses": {
-    "200": {
-      "body": {
-        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/MyResourceGroup/providers/Microsoft.OperationalInsights/workspaces/MyWorkspace/privateEndpointConnections/private-endpoint-connection-name",
-        "name": "private-endpoint-connection-name",
-        "type": "Microsoft.OperationalInsights/workspaces/privateEndpointConnections",
-        "properties": {
-          "provisioningState": "Succeeded",
-          "privateEndpoint": {
-            "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
-          },
-          "privateLinkServiceConnectionState": {
-            "status": "Approved",
-            "description": "Approved by johndoe@contoso.com",
-            "actionsRequired": "None"
-          }
-        }
-      }
-    },
-    "202": {}
-  }
-}
diff --git a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/examples/WorkspacePrivateLinkResourceGet.json b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/examples/WorkspacePrivateLinkResourceGet.json
deleted file mode 100644
index b9448d3f6e99..000000000000
--- a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/examples/WorkspacePrivateLinkResourceGet.json
+++ /dev/null
@@ -1,26 +0,0 @@
-{
-  "parameters": {
-    "subscriptionId": "00000000-1111-2222-3333-444444444444",
-    "resourceGroupName": "MyResourceGroup",
-    "workspaceName": "MyWorkspace",
-    "api-version": "2015-11-01-preview",
-    "groupName": "workspace"
-  },
-  "responses": {
-    "200": {
-      "body": {
-        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/MyResourceGroup/providers/Microsoft.OperationalInsights/workspaces/MyWorkspace/privateLinkResources/workspace",
-        "name": "workspace",
-        "type": "Microsoft.OperationalInsights/workspaces/privateLinkResources",
-        "properties": {
-          "groupId": "workspace",
-          "requiredMembers": [
-            "oms",
-            "agent",
-            "ods"
-          ]
-        }
-      }
-    }
-  }
-}
diff --git a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/examples/WorkspacePrivateLinkResourceListGet.json b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/examples/WorkspacePrivateLinkResourceListGet.json
deleted file mode 100644
index fa14310f3ad7..000000000000
--- a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2015-11-01-preview/examples/WorkspacePrivateLinkResourceListGet.json
+++ /dev/null
@@ -1,30 +0,0 @@
-{
-  "parameters": {
-    "subscriptionId": "00000000-1111-2222-3333-444444444444",
-    "resourceGroupName": "MyResourceGroup",
-    "workspaceName": "MyWorkspace",
-    "api-version": "2015-11-01-preview"
-  },
-  "responses": {
-    "200": {
-      "body": {
-        "value": [
-          {
-            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/MyResourceGroup/providers/Microsoft.OperationalInsights/workspaces/MyWorkspace/privateLinkResources/workspace",
-            "name": "workspace",
-            "type": "Microsoft.OperationalInsights/workspaces/privateLinkResources",
-            "properties": {
-              "groupId": "workspace",
-              "requiredMembers": [
-                "oms",
-                "agent",
-                "ods"
-              ]
-            }
-          }
-        ],
-        "nextLink": null
-      }
-    }
-  }
-}
diff --git a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/Clusters.json b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/Clusters.json
index 80c78abf7074..197cfe9edba2 100644
--- a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/Clusters.json
+++ b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/Clusters.json
@@ -162,17 +162,8 @@
           }
         ],
         "responses": {
-          "200": {
-            "description": "OK response definition.",
-            "schema": {
-              "$ref": "#/definitions/Cluster"
-            }
-          },
-          "201": {
-            "description": "Created response definition.",
-            "schema": {
-              "$ref": "#/definitions/Cluster"
-            }
+          "202": {
+            "description": "Accepted response definition."
           },
           "default": {
             "description": "Error response describing why the operation failed.",
@@ -370,9 +361,9 @@
             "modelAsString": true
           }
         },
-        "encryptionKeyUri": {
-          "type": "string",
-          "description": "The Key Vault key or certificate path associated with the Log Analytics cluster."
+        "keyVaultProperties": {
+          "$ref": "#/definitions/keyVaultProperties",
+          "description": "The associated key properties."
         }
       },
       "description": "Cluster properties."
@@ -409,9 +400,9 @@
     },
     "ClusterPatchProperties": {
       "properties": {
-        "encryptionKeyUri": {
-          "type": "string",
-          "description": "The Key Vault key or certificate path associated with the Log Analytics cluster."
+        "keyVaultProperties": {
+          "$ref": "#/definitions/keyVaultProperties",
+          "description": "The associated key properties."
         }
       },
       "description": "Log Analytics cluster patch properties."
@@ -423,6 +414,10 @@
           "$ref": "#/definitions/ClusterPatchProperties",
           "description": "Log Analytics cluster properties."
         },
+        "sku": {
+          "$ref": "#/definitions/sku",
+          "description": "The sku properties."
+        },
         "tags": {
           "type": "object",
           "additionalProperties": {
@@ -440,6 +435,10 @@
           "$ref": "#/definitions/Identity",
           "description": "The identity of the resource."
         },
+        "sku": {
+          "$ref": "#/definitions/sku",
+          "description": "The sku properties."
+        },
         "properties": {
           "x-ms-client-flatten": true,
           "$ref": "#/definitions/ClusterProperties",
@@ -470,6 +469,42 @@
       },
       "description": "The list clusters operation response."
     },
+    "keyVaultProperties": {
+      "properties": {
+        "keyVaultUri": {
+          "description": "The Key Vault uri which holds they key associated with the Log Analytics cluster.",
+          "type": "string"
+        },
+        "keyName": {
+          "description": "The name of the key associated with the Log Analytics cluster.",
+          "type": "string"
+        },
+        "keyVersion": {
+          "description": "The version of the key associated with the Log Analytics cluster.",
+          "type": "string"
+        }
+      }
+    },
+    "sku": {
+      "properties": {
+        "capacity": {
+          "description": "The capacity value",
+          "type": "integer",
+          "format": "int64"
+        },
+        "name": {
+          "type": "string",
+          "description": "The name of the SKU.",
+          "enum": [
+            "CapacityReservation"
+          ],
+          "x-ms-enum": {
+            "name": "SkuNameEnum",
+            "modelAsString": true
+          }
+        }
+      }
+    },
     "Identity": {
       "properties": {
         "principalId": {
diff --git a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/LinkedServices.json b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/LinkedServices.json
new file mode 100644
index 000000000000..745bc549f03b
--- /dev/null
+++ b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/LinkedServices.json
@@ -0,0 +1,326 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "Azure Log Analytics",
+    "description": "Azure Log Analytics API reference",
+    "version": "2019-08-01-preview"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/linkedServices/{linkedServiceName}": {
+      "put": {
+        "tags": [
+          "LinkedServices"
+        ],
+        "x-ms-examples": {
+          "LinkedServicesCreate": {
+            "$ref": "./examples/LinkedServicesCreate.json"
+          }
+        },
+        "operationId": "LinkedServices_CreateOrUpdate",
+        "description": "Create or update a linked service.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "name": "workspaceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of the Log Analytics Workspace that will contain the linkedServices resource"
+          },
+          {
+            "name": "linkedServiceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of the linkedServices resource"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/LinkedService"
+            },
+            "description": "The parameters required to create or update a linked service."
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK response definition.",
+            "schema": {
+              "$ref": "#/definitions/LinkedService"
+            }
+          },
+          "201": {
+            "description": "Created response definition.",
+            "schema": {
+              "$ref": "#/definitions/LinkedService"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "LinkedServices"
+        ],
+        "x-ms-examples": {
+          "LinkedServicesDelete": {
+            "$ref": "./examples/LinkedServicesDelete.json"
+          }
+        },
+        "operationId": "LinkedServices_Delete",
+        "description": "Deletes a linked service instance.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "name": "workspaceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of the Log Analytics Workspace that contains the linkedServices resource"
+          },
+          {
+            "name": "linkedServiceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of the linked service."
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK response definition."
+          },
+          "204": {
+            "description": "NoContent response definition."
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "LinkedServices"
+        ],
+        "x-ms-examples": {
+          "LinkedServicesGet": {
+            "$ref": "./examples/LinkedServicesGet.json"
+          }
+        },
+        "operationId": "LinkedServices_Get",
+        "description": "Gets a linked service instance.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "name": "workspaceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of the Log Analytics Workspace that contains the linkedServices resource"
+          },
+          {
+            "name": "linkedServiceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of the linked service."
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK response definition.",
+            "schema": {
+              "$ref": "#/definitions/LinkedService"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/linkedServices": {
+      "get": {
+        "tags": [
+          "LinkedServices"
+        ],
+        "x-ms-examples": {
+          "LinkedServicesListByWorkspace": {
+            "$ref": "./examples/LinkedServicesListByWorkspace.json"
+          }
+        },
+        "operationId": "LinkedServices_ListByWorkspace",
+        "description": "Gets the linked services instances in a workspace.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "name": "workspaceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Name of the Log Analytics Workspace that contains the linked services."
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK response definition.",
+            "schema": {
+              "$ref": "#/definitions/LinkedServiceListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    }
+  },
+  "definitions": {
+    "LinkedServiceProperties": {
+      "properties": {
+        "resourceId": {
+          "type": "string",
+          "description": "The resource id of the resource that will be linked to the workspace. This should be used for linking resources which require read access"
+        },
+        "writeAccessResourceId": {
+          "type": "string",
+          "description": "The resource id of the resource that will be linked to the workspace. This should be used for linking resources which require write access"
+        }
+      },
+      "description": "Linked service properties."
+    },
+    "LinkedService": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/LinkedServiceProperties",
+          "description": "The properties of the linked service."
+        }
+      },
+      "required": [
+        "properties"
+      ],
+      "allOf": [
+        {
+          "$ref": "#/definitions/ProxyResource"
+        }
+      ],
+      "description": "The top level Linked service resource container.",
+      "x-ms-azure-resource": true
+    },
+    "LinkedServiceListResult": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/LinkedService"
+          },
+          "description": "The list of linked service instances"
+        }
+      },
+      "description": "The list linked service operation response."
+    },
+    "ProxyResource": {
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Resource ID."
+        },
+        "name": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Resource name."
+        },
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Resource type."
+        }
+      },
+      "description": "Common properties of proxy resource."
+    }
+  },
+  "parameters": {
+    "SubscriptionIdParameter": {
+      "name": "subscriptionId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Gets subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
+    },
+    "ApiVersionParameter": {
+      "name": "api-version",
+      "in": "query",
+      "required": true,
+      "type": "string",
+      "description": "Client Api Version."
+    },
+    "ResourceGroupNameParameter": {
+      "name": "resourceGroupName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "description": "The name of the resource group to get. The name is case insensitive.",
+      "pattern": "^[-\\w\\._\\(\\)]+$",
+      "minLength": 1,
+      "maxLength": 90
+    }
+  }
+}
diff --git a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/OperationalInsights.json b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/OperationalInsights.json
index eb20d8ad6aed..2a01a76827ae 100644
--- a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/OperationalInsights.json
+++ b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/OperationalInsights.json
@@ -578,8 +578,9 @@
       "type": "object",
       "properties": {
         "dataSourceType": {
-          "description": "linked storage accounts type.",
+          "description": "Linked storage accounts type.",
           "type": "string",
+          "readOnly": true,
           "enum": [
             "CustomLogs",
             "AzureWatson"
@@ -590,7 +591,7 @@
           }
         },
         "storageAccountIds": {
-          "description": "linked storage accounts resource ids.",
+          "description": "Linked storage accounts resources ids.",
           "type": "array",
           "items": {
             "type": "string"
@@ -677,7 +678,7 @@
         "name": "DataSourceType",
         "modelAsString": false
       },
-      "description": "Linked storage account type.",
+      "description": "Linked storage accounts type.",
       "x-ms-parameter-location": "method"
     }
   }
diff --git a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/ClustersCreate.json b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/ClustersCreate.json
index 7b1b0ca8bda4..253b026facb6 100644
--- a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/ClustersCreate.json
+++ b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/ClustersCreate.json
@@ -4,7 +4,15 @@
     "clusterName": "oiautorest6685",
     "parameters": {
       "properties": {
-        "encryptionKeyUri": "https://aztest2170.vault.azure.net/certificates/aztest2170cert/654ft6c4e63845cbb50fd6fg51540429"
+        "keyVaultProperties": {
+          "keyVaultUri": "https://aztest2170.vault.azure.net",
+          "keyName": "aztest2170cert",
+          "keyVersion": "654ft6c4e63845cbb50fd6fg51540429"
+        }
+      },
+      "sku": {
+        "name": "CapacityReservation",
+        "capacity": 1000
       },
       "location": "australiasoutheast",
       "tags": {
@@ -15,47 +23,6 @@
     "subscriptionId": "00000000-0000-0000-0000-00000000000"
   },
   "responses": {
-    "200": {
-      "body": {
-        "id": "/subscriptions/00000000-0000-0000-0000-000000000005/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/clusters/aztest2170",
-        "identity": {
-          "principalId": "356d057d-cba5-44dd-8a30-b2e547bc416b",
-          "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
-          "type": "SystemAssigned"
-        },
-        "name": "AzTest2170",
-        "type": "Microsoft.OperationalInsights/clusters",
-        "location": "australiasoutheast",
-        "tags": {
-          "tag1": "val1"
-        },
-        "properties": {
-          "clusterId": "bc089d7b-485c-4aff-a71e-c00f362d8d2f",
-          "provisioningState": "Creating",
-          "encryptionKeyUri": "https://aztest2170.vault.azure.net/certificates/aztest2170cert/654ft6c4e63845cbb50fd6fg51540429"
-        }
-      }
-    },
-    "201": {
-      "body": {
-        "id": "/subscriptions/00000000-0000-0000-0000-000000000005/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/clusters/aztest2170",
-        "identity": {
-          "principalId": "356d057d-cba5-44dd-8a30-b2e547bc416b",
-          "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
-          "type": "SystemAssigned"
-        },
-        "name": "AzTest2170",
-        "type": "Microsoft.OperationalInsights/clusters",
-        "location": "australiasoutheast",
-        "tags": {
-          "tag1": "val1"
-        },
-        "properties": {
-          "clusterId": "bc089d7b-485c-4aff-a71e-c00f362d8d2f",
-          "provisioningState": "Creating",
-          "encryptionKeyUri": "https://aztest2170.vault.azure.net/certificates/aztest2170cert/654ft6c4e63845cbb50fd6fg51540429"
-        }
-      }
-    }
+    "202": {}
   }
 }
diff --git a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/ClustersGet.json b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/ClustersGet.json
index bbbd3287a60c..d8791aaa5d3b 100644
--- a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/ClustersGet.json
+++ b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/ClustersGet.json
@@ -10,9 +10,13 @@
       "body": [
         {
           "properties": {
-            "clusterId": "5b02755b-5bf4-430c-9487-45502a2a7e62",
+            "keyVaultProperties": {
+              "keyVaultUri": "https://aztest2170.vault.azure.net",
+              "keyName": "aztest2170cert",
+              "keyVersion": "654ft6c4e63845cbb50fd6fg51540429"
+            },
             "provisioningState": "Succeeded",
-            "encryptionKeyUri": "https://aztest2170.vault.azure.net/certificates/aztest2170cert/654ft6c4e63845cbb50fd6fg51540429"
+            "clusterId": "5b02755b-5bf4-430c-9487-45502a2a7e62"
           },
           "id": "/subscriptions/594038b5-1093-476e-a366-482775671c11/resourcegroups/calbot-rg/providers/microsoft.operationalinsights/clusters/testresourcelock",
           "identity": {
@@ -20,15 +24,23 @@
             "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
             "type": "SystemAssigned"
           },
+          "sku": {
+            "name": "CapacityReservation",
+            "capacity": 1000
+          },
           "name": "TestResourceLock",
           "type": "Microsoft.OperationalInsights/clusters",
           "location": "eastus"
         },
         {
           "properties": {
-            "clusterId": "5b02755b-5bf4-430c-9487-45502a2a7e62",
+            "keyVaultProperties": {
+              "keyVaultUri": "https://aztest2170.vault.azure.net",
+              "keyName": "aztest2170cert",
+              "keyVersion": "654ft6c4e63845cbb50fd6fg51540429"
+            },
             "provisioningState": "Succeeded",
-            "encryptionKeyUri": "https://aztest2170.vault.azure.net/certificates/aztest2170cert/654ft6c4e63845cbb50fd6fg51540429"
+            "clusterId": "5b02755b-5bf4-430c-9487-45502a2a7e62"
           },
           "id": "/subscriptions/594038b5-1093-476e-a366-482775671c11/resourcegroups/mms-eus/providers/microsoft.operationalinsights/clusters/southukws",
           "identity": {
@@ -36,6 +48,10 @@
             "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
             "type": "SystemAssigned"
           },
+          "sku": {
+            "name": "CapacityReservation",
+            "capacity": 1000
+          },
           "name": "SouthUKWS",
           "type": "Microsoft.OperationalInsights/clusters",
           "location": "East US"
diff --git a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/ClustersListByResourceGroup.json b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/ClustersListByResourceGroup.json
index a1ff7a25d694..cfbe90c48e13 100644
--- a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/ClustersListByResourceGroup.json
+++ b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/ClustersListByResourceGroup.json
@@ -9,9 +9,17 @@
       "body": [
         {
           "properties": {
-            "clusterId": "5b02755b-5bf4-430c-9487-45502a2a7e62",
+            "keyVaultProperties": {
+              "keyVaultUri": "https://aztest2170.vault.azure.net",
+              "keyName": "aztest2170cert",
+              "keyVersion": "654ft6c4e63845cbb50fd6fg51540429"
+            },
             "provisioningState": "Succeeded",
-            "encryptionKeyUri": "https://aztest2170.vault.azure.net/certificates/aztest2170cert/654ft6c4e63845cbb50fd6fg51540429"
+            "clusterId": "5b02755b-5bf4-430c-9487-45502a2a7e62"
+          },
+          "sku": {
+            "name": "CapacityReservation",
+            "capacity": 1000
           },
           "id": "/subscriptions/594038b5-1093-476e-a366-482775671c11/resourcegroups/calbot-rg/providers/microsoft.operationalinsights/clusters/testresourcelock",
           "identity": {
diff --git a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/ClustersSubscriptionList.json b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/ClustersSubscriptionList.json
index 1e7b4fe07231..c4162fadc385 100644
--- a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/ClustersSubscriptionList.json
+++ b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/ClustersSubscriptionList.json
@@ -8,9 +8,17 @@
       "body": [
         {
           "properties": {
-            "clusterId": "5b02755b-5bf4-430c-9487-45502a2a7e62",
+            "keyVaultProperties": {
+              "keyVaultUri": "https://aztest2170.vault.azure.net",
+              "keyName": "aztest2170cert",
+              "keyVersion": "654ft6c4e63845cbb50fd6fg51540429"
+            },
             "provisioningState": "Succeeded",
-            "encryptionKeyUri": "https://aztest2170.vault.azure.net/certificates/aztest2170cert/654ft6c4e63845cbb50fd6fg51540429"
+            "clusterId": "5b02755b-5bf4-430c-9487-45502a2a7e62"
+          },
+          "sku": {
+            "name": "CapacityReservation",
+            "capacity": 1000
           },
           "id": "/subscriptions/594038b5-1093-476e-a366-482775671c11/resourcegroups/calbot-rg/providers/microsoft.operationalinsights/clusters/testresourcelock",
           "identity": {
diff --git a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/ClustersUpdate.json b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/ClustersUpdate.json
index 35a4720af359..023cdae25644 100644
--- a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/ClustersUpdate.json
+++ b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/ClustersUpdate.json
@@ -4,7 +4,15 @@
     "clusterName": "oiautorest6685",
     "parameters": {
       "properties": {
-        "encryptionKeyUri": "https://aztest2170.vault.azure.net/certificates/aztest2170cert/654ft6c4e63845cbb50fd6fg51540429"
+        "keyVaultProperties": {
+          "keyVaultUri": "https://aztest2170.vault.azure.net",
+          "keyName": "aztest2170cert",
+          "keyVersion": "654ft6c4e63845cbb50fd6fg51540429"
+        }
+      },
+      "sku": {
+        "name": "CapacityReservation",
+        "capacity": 1000
       },
       "tags": {
         "tag1": "val1"
@@ -17,7 +25,17 @@
     "200": {
       "body": {
         "properties": {
-          "encryptionKeyUri": "https://aztest2170.vault.azure.net/certificates/aztest2170cert/654ft6c4e63845cbb50fd6fg51540429"
+          "keyVaultProperties": {
+            "keyVaultUri": "https://aztest2170.vault.azure.net",
+            "keyName": "aztest2170cert",
+            "keyVersion": "654ft6c4e63845cbb50fd6fg51540429"
+          },
+          "provisioningState": "Succeeded",
+          "clusterId": "1c3f2afc-9ec1-4e74-bfe8-022b83bcd7b1"
+        },
+        "sku": {
+          "name": "CapacityReservation",
+          "capacity": 1000
         },
         "location": "australiasoutheast",
         "tags": {
diff --git a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/LinkedServicesCreate.json b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/LinkedServicesCreate.json
new file mode 100644
index 000000000000..ea1a94a6bca8
--- /dev/null
+++ b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/LinkedServicesCreate.json
@@ -0,0 +1,36 @@
+{
+  "parameters": {
+    "resourceGroupName": "mms-eus",
+    "workspaceName": "TestLinkWS",
+    "linkedServiceName": "TestLinkWS/Cluster",
+    "parameters": {
+      "properties": {
+        "writeAccessResourceId": "/subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/mms-eus/providers/Microsoft.OperationalInsights/automationClusters/testcluster"
+      }
+    },
+    "api-version": "2019-08-01-preview",
+    "subscriptionId": "00000000-0000-0000-0000-00000000000"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "resourceId": "/subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/mms-eus/providers/Microsoft.OperationalInsights/automationClusters/testcluste"
+        },
+        "id": "/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/mms-eus/providers/microsoft.operationalinsights/workspaces/testlinkws/linkedservices/cluster",
+        "name": "TestLinkWS/Cluster",
+        "type": "Microsoft.OperationalInsights/workspaces/linkedServices"
+      }
+    },
+    "201": {
+      "body": {
+        "properties": {
+          "resourceId": "/subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/mms-eus/providers/Microsoft.OperationalInsights/automationClusters/testcluste"
+        },
+        "id": "/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/mms-eus/providers/microsoft.operationalinsights/workspaces/testlinkws/linkedservices/cluster",
+        "name": "TestLinkWS/Cluster",
+        "type": "Microsoft.OperationalInsights/workspaces/linkedServices"
+      }
+    }
+  }
+}
diff --git a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/LinkedServicesDelete.json b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/LinkedServicesDelete.json
new file mode 100644
index 000000000000..99f07e2aaa74
--- /dev/null
+++ b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/LinkedServicesDelete.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "linkedServiceName": "TestLinkWS/Cluster",
+    "workspaceName": "TestLinkWS",
+    "resourceGroupName": "rg1",
+    "api-version": "2019-08-01-preview",
+    "subscriptionId": "00000000-0000-0000-0000-00000000000"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/LinkedServicesGet.json b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/LinkedServicesGet.json
new file mode 100644
index 000000000000..84de0356b24a
--- /dev/null
+++ b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/LinkedServicesGet.json
@@ -0,0 +1,21 @@
+{
+  "parameters": {
+    "resourceGroupName": "mms-eus",
+    "workspaceName": "TestLinkWS",
+    "linkedServiceName": "TestLinkWS/Cluster",
+    "api-version": "2019-08-01-preview",
+    "subscriptionId": "00000000-0000-0000-0000-00000000000"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000005/resourceGroups/mms-eus/providers/Microsoft.OperationalInsights/Clusters/TestCluster"
+        },
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000005/resourcegroups/mms-eus/providers/microsoft.operationalinsights/workspaces/testlinkws/linkedservices/cluster",
+        "name": "TestLinkWS/Cluster",
+        "type": "Microsoft.OperationalInsights/workspaces/linkedServices"
+      }
+    }
+  }
+}
diff --git a/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/LinkedServicesListByWorkspace.json b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/LinkedServicesListByWorkspace.json
new file mode 100644
index 000000000000..5f5492ad56c8
--- /dev/null
+++ b/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/preview/2019-08-01-preview/examples/LinkedServicesListByWorkspace.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "resourceGroupName": "mms-eus",
+    "workspaceName": "TestLinkWS",
+    "api-version": "2019-08-01-preview",
+    "subscriptionId": "00000000-0000-0000-0000-00000000000"
+  },
+  "responses": {
+    "200": {
+      "body": [
+        {
+          "properties": {
+            "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000005/resourceGroups/mms-eus/providers/Microsoft.Automation/automationAccounts/TestAccount"
+          },
+          "id": "/subscriptions/00000000-0000-0000-0000-000000000005/resourcegroups/mms-eus/providers/microsoft.operationalinsights/workspaces/testlinkws/linkedservices/automation",
+          "name": "TestLinkWS/Automation",
+          "type": "Microsoft.OperationalInsights/workspaces/linkedServices"
+        },
+        {
+          "properties": {
+            "writeAccessResourceId": "/subscriptions/00000000-0000-0000-0000-000000000005/resourceGroups/mms-eus/providers/Microsoft.OperationalInsights/clusters/TestCluster"
+          },
+          "id": "/subscriptions/00000000-0000-0000-0000-000000000005/resourcegroups/mms-eus/providers/microsoft.operationalinsights/workspaces/testlinkws/linkedservices/cluster",
+          "name": "TestLinkWS/Cluster",
+          "type": "Microsoft.OperationalInsights/workspaces/linkedServices"
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/operationalinsights/resource-manager/readme.md b/specification/operationalinsights/resource-manager/readme.md
index 472b40dcd15e..02ef9095bd4d 100644
--- a/specification/operationalinsights/resource-manager/readme.md
+++ b/specification/operationalinsights/resource-manager/readme.md
@@ -38,6 +38,7 @@ These settings apply only when `--tag=package-2015-11-preview` is specified on t
 
 ``` yaml $(tag) == 'package-2015-11-preview'
 input-file:
+- Microsoft.OperationalInsights/preview/2015-11-01-preview/LinkedServices.json
 - Microsoft.OperationalInsights/preview/2015-11-01-preview/OperationalInsights.json
 ```
 
@@ -57,6 +58,7 @@ These settings apply only when `--tag=package-2019-08-preview` is specified on t
 ``` yaml $(tag) == 'package-2019-08-preview'
 input-file:
 - Microsoft.OperationalInsights/preview/2019-08-01-preview/Clusters.json
+- Microsoft.OperationalInsights/preview/2019-08-01-preview/LinkedServices.json
 - Microsoft.OperationalInsights/preview/2019-08-01-preview/OperationalInsights.json
 ```
 
@@ -157,9 +159,11 @@ require: $(this-folder)/../../../profiles/readme.md
 
 # all the input files across all versions
 input-file:
+  - $(this-folder)/Microsoft.OperationalInsights/preview/2015-11-01-preview/LinkedServices.json
   - $(this-folder)/Microsoft.OperationalInsights/preview/2015-11-01-preview/OperationalInsights.json
   - $(this-folder)/Microsoft.OperationalInsights/stable/2015-03-20/OperationalInsights.json
   - $(this-folder)/Microsoft.OperationalInsights/preview/2019-08-01-preview/Clusters.json
+  - $(this-folder)/Microsoft.OperationalInsights/preview/2019-08-01-preview/LinkedServices.json
   - $(this-folder)/Microsoft.OperationalInsights/preview/2019-08-01-preview/OperationalInsights.json
 
 ```
diff --git a/specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2020-02-02/bms.json b/specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2020-02-02/bms.json
new file mode 100644
index 000000000000..1336ac488311
--- /dev/null
+++ b/specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2020-02-02/bms.json
@@ -0,0 +1,473 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "version": "2020-02-02",
+    "title": "RecoveryServicesBackupClient",
+    "x-ms-code-generation-settings": {
+      "internalConstructors": false
+    }
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "paths": {
+    "/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/privateEndpointConnections/{privateEndpointConnectionName}": {
+      "get": {
+        "tags": [
+          "PrivateEndpointConnection"
+        ],
+        "description": "Get Private Endpoint Connection. This call is made by Backup Admin.",
+        "operationId": "PrivateEndpointConnection_Get",
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion"
+          },
+          {
+            "$ref": "#/parameters/VaultName"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "name": "privateEndpointConnectionName",
+            "in": "path",
+            "description": "The name of the private endpoint connection.",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/PrivateEndpointConnectionResource"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../../../common-types/resource-management/v1/types.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Get PrivateEndpointConnection": {
+            "$ref": "./examples/PrivateEndpointConnection/GetPrivateEndpointConnection.json"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "PrivateEndpointConnection"
+        ],
+        "description": "Approve or Reject Private Endpoint requests. This call is made by Backup Admin.",
+        "operationId": "PrivateEndpointConnection_Put",
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion"
+          },
+          {
+            "$ref": "#/parameters/VaultName"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "name": "privateEndpointConnectionName",
+            "in": "path",
+            "description": "The name of the private endpoint connection.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "description": "Request body for operation",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/PrivateEndpointConnectionResource"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/PrivateEndpointConnectionResource"
+            }
+          },
+          "201": {
+            "description": "Created",
+            "schema": {
+              "$ref": "#/definitions/PrivateEndpointConnectionResource"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Update PrivateEndpointConnection": {
+            "$ref": "./examples/PrivateEndpointConnection/PutPrivateEndpointConnection.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "PrivateEndpointConnection"
+        ],
+        "description": "Delete Private Endpoint requests. This call is made by Backup Admin.",
+        "operationId": "PrivateEndpointConnection_Delete",
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion"
+          },
+          {
+            "$ref": "#/parameters/VaultName"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "name": "privateEndpointConnectionName",
+            "in": "path",
+            "description": "The name of the private endpoint connection.",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "204": {
+            "description": "NoContent"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../../../common-types/resource-management/v1/types.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Delete PrivateEndpointConnection": {
+            "$ref": "./examples/PrivateEndpointConnection/DeletePrivateEndpointConnection.json"
+          }
+        }
+      }
+    },
+    "/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/privateEndpointConnections/{privateEndpointConnectionName}/operationsStatus/{operationId}": {
+      "get": {
+        "tags": [
+          "PrivateEndpoint"
+        ],
+        "summary": "Gets the operation status for a private endpoint connection.",
+        "operationId": "GetOperationStatus",
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion"
+          },
+          {
+            "$ref": "#/parameters/VaultName"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "name": "privateEndpointConnectionName",
+            "in": "path",
+            "description": "The name of the private endpoint connection.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "operationId",
+            "in": "path",
+            "description": "Operation id",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/OperationStatus"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../../../common-types/resource-management/v1/types.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Get OperationStatus": {
+            "$ref": "./examples/PrivateEndpointConnection/GetPrivateEndpointConnectionOperationStatus.json"
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "OperationStatus": {
+      "description": "Operation status.",
+      "type": "object",
+      "properties": {
+        "id": {
+          "description": "ID of the operation.",
+          "type": "string"
+        },
+        "name": {
+          "description": "Name of the operation.",
+          "type": "string"
+        },
+        "status": {
+          "description": "Operation status.",
+          "enum": [
+            "Invalid",
+            "InProgress",
+            "Succeeded",
+            "Failed",
+            "Canceled"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "OperationStatusValues",
+            "modelAsString": true
+          }
+        },
+        "startTime": {
+          "format": "date-time",
+          "description": "Operation start time. Format: ISO-8601.",
+          "type": "string"
+        },
+        "endTime": {
+          "format": "date-time",
+          "description": "Operation end time. Format: ISO-8601.",
+          "type": "string"
+        },
+        "error": {
+          "$ref": "#/definitions/OperationStatusError",
+          "description": "Error information related to this operation."
+        }
+      }
+    },
+    "OperationStatusError": {
+      "description": "Error information associated with operation status call.",
+      "type": "object",
+      "properties": {
+        "code": {
+          "description": "Error code of the operation failure.",
+          "type": "string"
+        },
+        "message": {
+          "description": "Error message displayed if the operation failure.",
+          "type": "string"
+        }
+      }
+    },
+    "PrivateEndpoint": {
+      "description": "The Private Endpoint network resource that is linked to the Private Endpoint connection",
+      "type": "object",
+      "properties": {
+        "id": {
+          "description": "Gets or sets id",
+          "type": "string"
+        }
+      }
+    },
+    "PrivateEndpointConnection": {
+      "description": "Private Endpoint Connection Response Properties",
+      "type": "object",
+      "properties": {
+        "provisioningState": {
+          "description": "Gets or sets provisioning state of the private endpoint connection",
+          "enum": [
+            "Succeeded",
+            "Deleting",
+            "Failed",
+            "Pending"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "ProvisioningState",
+            "modelAsString": true
+          }
+        },
+        "privateEndpoint": {
+          "$ref": "#/definitions/PrivateEndpoint",
+          "description": "Gets or sets private endpoint associated with the private endpoint connection"
+        },
+        "privateLinkServiceConnectionState": {
+          "$ref": "#/definitions/PrivateLinkServiceConnectionState",
+          "description": "Gets or sets private link service connection state"
+        }
+      }
+    },
+    "PrivateEndpointConnectionResource": {
+      "description": "Private Endpoint Connection Response Properties",
+      "allOf": [
+        {
+          "$ref": "#/definitions/Resource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/PrivateEndpointConnection",
+          "description": "PrivateEndpointConnectionResource properties"
+        }
+      }
+    },
+    "Resource": {
+      "description": "ARM Resource.",
+      "type": "object",
+      "properties": {
+        "id": {
+          "description": "Resource Id represents the complete path to the resource.",
+          "type": "string",
+          "readOnly": true
+        },
+        "name": {
+          "description": "Resource name associated with the resource.",
+          "type": "string",
+          "readOnly": true
+        },
+        "type": {
+          "description": "Resource type represents the complete path of the form Namespace/ResourceType/ResourceType/...",
+          "type": "string",
+          "readOnly": true
+        },
+        "location": {
+          "description": "Resource location.",
+          "type": "string"
+        },
+        "tags": {
+          "description": "Resource tags.",
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "eTag": {
+          "description": "Optional ETag.",
+          "type": "string"
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "PrivateLinkServiceConnectionState": {
+      "description": "Private Link Service Connection State",
+      "type": "object",
+      "properties": {
+        "status": {
+          "description": "Gets or sets the status",
+          "enum": [
+            "Pending",
+            "Approved",
+            "Rejected",
+            "Disconnected"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "PrivateEndpointConnectionStatus",
+            "modelAsString": true
+          }
+        },
+        "description": {
+          "description": "Gets or sets description",
+          "type": "string"
+        },
+        "actionRequired": {
+          "description": "Gets or sets actions required",
+          "type": "string"
+        }
+      }
+    }
+  },
+  "parameters": {
+    "SubscriptionId": {
+      "name": "subscriptionId",
+      "in": "path",
+      "description": "The subscription Id.",
+      "required": true,
+      "type": "string"
+    },
+    "ResourceGroupName": {
+      "name": "resourceGroupName",
+      "in": "path",
+      "description": "The name of the resource group where the recovery services vault is present.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "VaultName": {
+      "name": "vaultName",
+      "in": "path",
+      "description": "The name of the recovery services vault.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "ApiVersion": {
+      "name": "api-version",
+      "in": "query",
+      "description": "Client Api Version.",
+      "required": true,
+      "type": "string"
+    }
+  },
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "description": "Azure Active Directory OAuth2 Flow",
+      "flow": "implicit",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "scopes": {
+        "user_impersonation": "impersonate your user account."
+      }
+    }
+  },
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ]
+}
diff --git a/specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2020-02-02/examples/PrivateEndpointConnection/DeletePrivateEndpointConnection.json b/specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2020-02-02/examples/PrivateEndpointConnection/DeletePrivateEndpointConnection.json
new file mode 100644
index 000000000000..afce2b84d2c8
--- /dev/null
+++ b/specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2020-02-02/examples/PrivateEndpointConnection/DeletePrivateEndpointConnection.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "subscriptionId": "04cf684a-d41f-4550-9f70-7708a3a2283b",
+    "resourceGroupName": "gaallaRG",
+    "vaultName": "gaallavaultbvtd2msi",
+    "privateEndpointConnectionName": "gaallatestpe2.5704c932-249a-490b-a142-1396838cd3b",
+    "api-version": "2020-02-02"
+  },
+  "responses": {
+    "200": {},
+    "202": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/6c48fa17-39c7-45f1-90ac-47a587128ace/resourceGroups/backupadminrg/providers/Microsoft.RecoveryServices/Vaults/demo-pevault-2/privateEndpointConnections/autoapprovalpeecy4.3679789459502941542.backup.5ede856d-d9f0-461e-a15b-370c84525817/operationsStatus/2908a25d-8036-48d2-bdcc-fdce26b9771f?api-versi",
+        "Retry-After": "60"
+      }
+    },
+    "204": {}
+  }
+}
diff --git a/specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2020-02-02/examples/PrivateEndpointConnection/GetPrivateEndpointConnection.json b/specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2020-02-02/examples/PrivateEndpointConnection/GetPrivateEndpointConnection.json
new file mode 100644
index 000000000000..45dee7c44bcc
--- /dev/null
+++ b/specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2020-02-02/examples/PrivateEndpointConnection/GetPrivateEndpointConnection.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "subscriptionId": "04cf684a-d41f-4550-9f70-7708a3a2283b",
+    "resourceGroupName": "gaallaRG",
+    "vaultName": "gaallavaultbvtd2msi",
+    "privateEndpointConnectionName": "gaallatestpe2.5704c932-249a-490b-a142-1396838cd3b",
+    "api-version": "2020-02-02"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/gaallaRG/providers/Microsoft.RecoveryServicesBVTD2/vaults/gaallavaultbvtd2msi/privateEndpointConnections/gaallatestpe3.3592346090307038890.backup.5704c932-249a-490b-a142-1396838cd3b",
+        "name": "gaallatestpe1.3592346090307038890.backup.5704c932-249a-490b-a142-1396838cd3b",
+        "type": "Microsoft.RecoveryServices/vaults/privateEndpointConnections",
+        "properties": {
+          "provisioningState": "Pending",
+          "privateEndpoint": {
+            "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/gaallaRG/providers/Microsoft.Network/privateEndpoints/gaallatestpe3"
+          },
+          "privateLinkServiceConnectionState": {
+            "status": "Approved",
+            "description": "Approved by johndoe@company.com"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2020-02-02/examples/PrivateEndpointConnection/GetPrivateEndpointConnectionOperationStatus.json b/specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2020-02-02/examples/PrivateEndpointConnection/GetPrivateEndpointConnectionOperationStatus.json
new file mode 100644
index 000000000000..f91c1f9849d3
--- /dev/null
+++ b/specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2020-02-02/examples/PrivateEndpointConnection/GetPrivateEndpointConnectionOperationStatus.json
@@ -0,0 +1,21 @@
+{
+  "parameters": {
+    "subscriptionId": "04cf684a-d41f-4550-9f70-7708a3a2283b",
+    "resourceGroupName": "gaallaRG",
+    "privateEndpointConnectionName": "gaallatestpe2.5704c932-249a-490b-a142-1396838cd3b",
+    "vaultName": "gaallavaultbvtd2msi",
+    "operationId": "0f48183b-0a44-4dca-aec1-bba5daab888a",
+    "api-version": "2020-02-02"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "0f48183b-0a44-4dca-aec1-bba5daab888a",
+        "name": "0f48183b-0a44-4dca-aec1-bba5daab888a",
+        "status": "Succeeded",
+        "startTime": "2020-02-27T11:59:47.5901592Z",
+        "endTime": "2020-02-27T11:59:47.5901592Z"
+      }
+    }
+  }
+}
diff --git a/specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2020-02-02/examples/PrivateEndpointConnection/PutPrivateEndpointConnection.json b/specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2020-02-02/examples/PrivateEndpointConnection/PutPrivateEndpointConnection.json
new file mode 100644
index 000000000000..2e8c586ecd08
--- /dev/null
+++ b/specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2020-02-02/examples/PrivateEndpointConnection/PutPrivateEndpointConnection.json
@@ -0,0 +1,61 @@
+{
+  "parameters": {
+    "subscriptionId": "04cf684a-d41f-4550-9f70-7708a3a2283b",
+    "resourceGroupName": "gaallaRG",
+    "vaultName": "gaallavaultbvtd2msi",
+    "privateEndpointConnectionName": "gaallatestpe2.5704c932-249a-490b-a142-1396838cd3b",
+    "api-version": "2020-02-02",
+    "parameters": {
+      "properties": {
+        "provisioningState": "Succeeded",
+        "privateEndpoint": {
+          "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/gaallaRG/providers/Microsoft.Network/privateEndpoints/gaallatestpe3"
+        },
+        "privateLinkServiceConnectionState": {
+          "status": "Approved",
+          "description": "Approved by johndoe@company.com"
+        }
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/gaallaRG/providers/Microsoft.RecoveryServicesBVTD2/vaults/gaallavaultbvtd2msi/privateEndpointConnections/gaallatestpe3.3592346090307038890.backup.5704c932-249a-490b-a142-1396838cd3b",
+        "name": "gaallatestpe1.3592346090307038890.backup.5704c932-249a-490b-a142-1396838cd3b",
+        "type": "Microsoft.RecoveryServices/vaults/privateEndpointConnections",
+        "properties": {
+          "provisioningState": "Pending",
+          "privateEndpoint": {
+            "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/gaallaRG/providers/Microsoft.Network/privateEndpoints/gaallatestpe3"
+          },
+          "privateLinkServiceConnectionState": {
+            "status": "Approved",
+            "description": "Approved by johndoe@company.com"
+          }
+        }
+      },
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/6c48fa17-39c7-45f1-90ac-47a587128ace/resourceGroups/backupadminrg/providers/Microsoft.RecoveryServices/Vaults/demo-pevault-2/privateEndpointConnections/autoapprovalpeecy4.3679789459502941542.backup.5ede856d-d9f0-461e-a15b-370c84525817/operationsStatus/2908a25d-8036-48d2-bdcc-fdce26b9771f?api-versi",
+        "Retry-After": "60"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/gaallaRG/providers/Microsoft.RecoveryServicesBVTD2/vaults/gaallavaultbvtd2msi/privateEndpointConnections/gaallatestpe3.3592346090307038890.backup.5704c932-249a-490b-a142-1396838cd3b",
+        "name": "gaallatestpe1.3592346090307038890.backup.5704c932-249a-490b-a142-1396838cd3b",
+        "type": "Microsoft.RecoveryServices/vaults/privateEndpointConnections",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "privateEndpoint": {
+            "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/gaallaRG/providers/Microsoft.Network/privateEndpoints/gaallatestpe3"
+          },
+          "privateLinkServiceConnectionState": {
+            "status": "Approved",
+            "description": "Approved by johndoe@company.com"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/recoveryservicesbackup/resource-manager/readme.go.md b/specification/recoveryservicesbackup/resource-manager/readme.go.md
index b82f4110080d..7d6540136972 100644
--- a/specification/recoveryservicesbackup/resource-manager/readme.go.md
+++ b/specification/recoveryservicesbackup/resource-manager/readme.go.md
@@ -13,6 +13,7 @@ go:
 
 ``` yaml $(go) && $(multiapi)
 batch:
+  - tag: package-2020-02
   - tag: package-2019-06
   - tag: package-2019-05
   - tag: package-2017-07
@@ -20,6 +21,15 @@ batch:
   - tag: package-2016-06
 ```
 
+### Tag: package-2020-02 and go
+
+These settings apply only when `--tag=package-2020-02 --go` is specified on the command line.
+Please also specify `--go-sdk-folder=<path to the root directory of your azure-sdk-for-go clone>`.
+
+``` yaml $(tag)=='package-2020-02' && $(go)
+output-folder: $(go-sdk-folder)/services/recoveryservices/mgmt/2020-02-02/$(namespace)
+```
+
 ### Tag: package-2019-06 and go
 
 These settings apply only when `--tag=package-2019-06 --go` is specified on the command line.
diff --git a/specification/recoveryservicesbackup/resource-manager/readme.java.md b/specification/recoveryservicesbackup/resource-manager/readme.java.md
index b54903820c62..4f212d2b9248 100644
--- a/specification/recoveryservicesbackup/resource-manager/readme.java.md
+++ b/specification/recoveryservicesbackup/resource-manager/readme.java.md
@@ -18,6 +18,24 @@ output-folder: $(azure-libraries-for-java-folder)/azure-mgmt-recoveryservicesbac
 ``` yaml $(java) && $(multiapi)
 batch:
   - tag: package-2016-08
+  - tag: package-2020-02
+directive:
+  - rename-operation:
+      from: Operations_List
+      to: Operation_List
+```
+
+### Tag: package-2020-02 and java
+
+These settings apply only when `--tag=package-2020-02 --java` is specified on the command line.
+Please also specify `--azure-libraries-for-java=<path to the root directory of your azure-sdk-for-java clone>`.
+
+``` yaml $(tag) == 'package-2020-02' && $(java) && $(multiapi)
+java:
+  namespace: com.microsoft.azure.management.recoveryservices.backup.v2020_02_02
+  output-folder: $(azure-libraries-for-java-folder)/sdk/recoveryservices.backup/mgmt-v2020_02_02
+regenerate-manager: true
+generate-interface: true
 ```
 
 ### Tag: package-2016-08 and java
diff --git a/specification/recoveryservicesbackup/resource-manager/readme.md b/specification/recoveryservicesbackup/resource-manager/readme.md
index e9ea8c8212d4..fcb830f7613c 100644
--- a/specification/recoveryservicesbackup/resource-manager/readme.md
+++ b/specification/recoveryservicesbackup/resource-manager/readme.md
@@ -28,7 +28,7 @@ These are the global settings for the RecoveryServicesBackup API.
 title: Recovery Services Backup Client
 description: Open API 2.0 Specs for Azure RecoveryServices Backup service
 openapi-type: arm
-tag: package-2019-06
+tag: package-2020-02
 csharp-sdks-folder: ./Generated/CSharp
 python-sdks-folder: ./Generated/Python
 go-sdk-folder: ./Generated/Golang
@@ -45,6 +45,20 @@ model-validator: true
 semantic-validator: true
 message-format: json
 ```
+### Tag: package-2020-02
+
+These settings apply only when `--tag=package-2020-02` is specified on the command line.
+
+``` yaml $(tag) == 'package-2020-02'
+input-file:
+- Microsoft.RecoveryServices/stable/2020-02-02/bms.json
+- Microsoft.RecoveryServices/stable/2019-06-15/bms.json
+- Microsoft.RecoveryServices/stable/2017-07-01/bms.json
+- Microsoft.RecoveryServices/stable/2016-12-01/bms.json
+- Microsoft.RecoveryServices/stable/2016-08-10/operations.json
+```
+
+
 ### Tag: package-2019-06
 
 These settings apply only when `--tag=package-2019-06` is specified on the command line.
@@ -176,6 +190,7 @@ require: $(this-folder)/../../../profiles/readme.md
 
 # all the input files across all versions
 input-file:
+  - $(this-folder)/Microsoft.RecoveryServices/stable/2020-02-02/bms.json
   - $(this-folder)/Microsoft.RecoveryServices/stable/2019-06-15/bms.json
   - $(this-folder)/Microsoft.RecoveryServices/stable/2017-07-01/bms.json
   - $(this-folder)/Microsoft.RecoveryServices/stable/2016-12-01/bms.json
diff --git a/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/OpenShiftClusters_CreateOrUpdate.json b/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/OpenShiftClusters_CreateOrUpdate.json
new file mode 100644
index 000000000000..149b7a8459f0
--- /dev/null
+++ b/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/OpenShiftClusters_CreateOrUpdate.json
@@ -0,0 +1,162 @@
+{
+  "parameters": {
+    "api-version": "2020-04-30",
+    "subscriptionId": "subscriptionId",
+    "resourceGroupName": "resourceGroup",
+    "resourceName": "resourceName",
+    "parameters": {
+      "location": "location",
+      "tags": {
+        "key": "value"
+      },
+      "properties": {
+        "clusterProfile": {
+          "pullSecret": "{\"auths\":{\"registry.connect.redhat.com\":{\"auth\":\"\"},\"registry.redhat.io\":{\"auth\":\"\"}}}",
+          "domain": "cluster.location.aroapp.io",
+          "resourceGroupId": "/subscriptions/subscriptionId/resourceGroups/clusterResourceGroup"
+        },
+        "consoleProfile": {},
+        "servicePrincipalProfile": {
+          "clientId": "clientId",
+          "clientSecret": "clientSecret"
+        },
+        "networkProfile": {
+          "podCidr": "10.128.0.0/14",
+          "serviceCidr": "172.30.0.0/16"
+        },
+        "masterProfile": {
+          "vmSize": "Standard_D8s_v3",
+          "subnetId": "/subscriptions/subscriptionId/resourceGroups/vnetResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet/subnets/master"
+        },
+        "workerProfiles": [
+          {
+            "name": "worker",
+            "vmSize": "Standard_D2s_v3",
+            "diskSizeGB": 128,
+            "subnetId": "/subscriptions/subscriptionId/resourceGroups/vnetResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet/subnets/worker",
+            "count": 3
+          }
+        ],
+        "apiserverProfile": {
+          "visibility": "Public"
+        },
+        "ingressProfiles": [
+          {
+            "name": "default",
+            "visibility": "Public"
+          }
+        ]
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.RedHatOpenShift/OpenShiftClusters/resourceName",
+        "name": "resourceName",
+        "type": "Microsoft.RedHatOpenShift/OpenShiftClusters",
+        "location": "location",
+        "tags": {
+          "key": "value"
+        },
+        "properties": {
+          "provisioningState": "Succeeded",
+          "clusterProfile": {
+            "domain": "cluster.location.aroapp.io",
+            "version": "4.3.0",
+            "resourceGroupId": "/subscriptions/subscriptionId/resourceGroups/clusterResourceGroup"
+          },
+          "consoleProfile": {
+            "url": "https://console-openshift-console.apps.cluster.location.aroapp.io/"
+          },
+          "servicePrincipalProfile": {
+            "clientId": "clientId"
+          },
+          "networkProfile": {
+            "podCidr": "10.128.0.0/14",
+            "serviceCidr": "172.30.0.0/16"
+          },
+          "masterProfile": {
+            "vmSize": "Standard_D8s_v3",
+            "subnetId": "/subscriptions/subscriptionId/resourceGroups/vnetResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet/subnets/master"
+          },
+          "workerProfiles": [
+            {
+              "name": "worker",
+              "vmSize": "Standard_D2s_v3",
+              "diskSizeGB": 128,
+              "subnetId": "/subscriptions/subscriptionId/resourceGroups/vnetResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet/subnets/worker",
+              "count": 3
+            }
+          ],
+          "apiserverProfile": {
+            "visibility": "Public",
+            "url": "https://api.cluster.location.aroapp.io:6443/",
+            "ip": "1.2.3.4"
+          },
+          "ingressProfiles": [
+            {
+              "name": "default",
+              "visibility": "Public",
+              "ip": "1.2.3.4"
+            }
+          ]
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.RedHatOpenShift/OpenShiftClusters/resourceName",
+        "name": "resourceName",
+        "type": "Microsoft.RedHatOpenShift/OpenShiftClusters",
+        "location": "location",
+        "tags": {
+          "key": "value"
+        },
+        "properties": {
+          "provisioningState": "Succeeded",
+          "clusterProfile": {
+            "domain": "cluster.location.aroapp.io",
+            "version": "4.3.0",
+            "resourceGroupId": "/subscriptions/subscriptionId/resourceGroups/clusterResourceGroup"
+          },
+          "consoleProfile": {
+            "url": "https://console-openshift-console.apps.cluster.location.aroapp.io/"
+          },
+          "servicePrincipalProfile": {
+            "clientId": "clientId"
+          },
+          "networkProfile": {
+            "podCidr": "10.128.0.0/14",
+            "serviceCidr": "172.30.0.0/16"
+          },
+          "masterProfile": {
+            "vmSize": "Standard_D8s_v3",
+            "subnetId": "/subscriptions/subscriptionId/resourceGroups/vnetResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet/subnets/master"
+          },
+          "workerProfiles": [
+            {
+              "name": "worker",
+              "vmSize": "Standard_D2s_v3",
+              "diskSizeGB": 128,
+              "subnetId": "/subscriptions/subscriptionId/resourceGroups/vnetResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet/subnets/worker",
+              "count": 3
+            }
+          ],
+          "apiserverProfile": {
+            "visibility": "Public",
+            "url": "https://api.cluster.location.aroapp.io:6443/",
+            "ip": "1.2.3.4"
+          },
+          "ingressProfiles": [
+            {
+              "name": "default",
+              "visibility": "Public",
+              "ip": "1.2.3.4"
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/OpenShiftClusters_Delete.json b/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/OpenShiftClusters_Delete.json
new file mode 100644
index 000000000000..d851985e9f44
--- /dev/null
+++ b/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/OpenShiftClusters_Delete.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "api-version": "2020-04-30",
+    "subscriptionId": "subscriptionId",
+    "resourceGroupName": "resourceGroup",
+    "resourceName": "resourceName"
+  },
+  "responses": {
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/OpenShiftClusters_Get.json b/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/OpenShiftClusters_Get.json
new file mode 100644
index 000000000000..1f64ffeff9cd
--- /dev/null
+++ b/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/OpenShiftClusters_Get.json
@@ -0,0 +1,64 @@
+{
+  "parameters": {
+    "api-version": "2020-04-30",
+    "subscriptionId": "subscriptionId",
+    "resourceGroupName": "resourceGroup",
+    "resourceName": "resourceName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.RedHatOpenShift/OpenShiftClusters/resourceName",
+        "name": "resourceName",
+        "type": "Microsoft.RedHatOpenShift/OpenShiftClusters",
+        "location": "location",
+        "tags": {
+          "key": "value"
+        },
+        "properties": {
+          "provisioningState": "Succeeded",
+          "clusterProfile": {
+            "domain": "cluster.location.aroapp.io",
+            "version": "4.3.0",
+            "resourceGroupId": "/subscriptions/subscriptionId/resourceGroups/clusterResourceGroup"
+          },
+          "consoleProfile": {
+            "url": "https://console-openshift-console.apps.cluster.location.aroapp.io/"
+          },
+          "servicePrincipalProfile": {
+            "clientId": "clientId"
+          },
+          "networkProfile": {
+            "podCidr": "10.128.0.0/14",
+            "serviceCidr": "172.30.0.0/16"
+          },
+          "masterProfile": {
+            "vmSize": "Standard_D8s_v3",
+            "subnetId": "/subscriptions/subscriptionId/resourceGroups/vnetResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet/subnets/master"
+          },
+          "workerProfiles": [
+            {
+              "name": "worker",
+              "vmSize": "Standard_D2s_v3",
+              "diskSizeGB": 128,
+              "subnetId": "/subscriptions/subscriptionId/resourceGroups/vnetResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet/subnets/worker",
+              "count": 3
+            }
+          ],
+          "apiserverProfile": {
+            "visibility": "Public",
+            "url": "https://api.cluster.location.aroapp.io:6443/",
+            "ip": "1.2.3.4"
+          },
+          "ingressProfiles": [
+            {
+              "name": "default",
+              "visibility": "Public",
+              "ip": "1.2.3.4"
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/OpenShiftClusters_List.json b/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/OpenShiftClusters_List.json
new file mode 100644
index 000000000000..6691f0d3078a
--- /dev/null
+++ b/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/OpenShiftClusters_List.json
@@ -0,0 +1,66 @@
+{
+  "parameters": {
+    "api-version": "2020-04-30",
+    "subscriptionId": "subscriptionId"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.RedHatOpenShift/OpenShiftClusters/resourceName",
+            "name": "resourceName",
+            "type": "Microsoft.RedHatOpenShift/OpenShiftClusters",
+            "location": "location",
+            "tags": {
+              "key": "value"
+            },
+            "properties": {
+              "provisioningState": "Succeeded",
+              "clusterProfile": {
+                "domain": "cluster.location.aroapp.io",
+                "version": "4.3.0",
+                "resourceGroupId": "/subscriptions/subscriptionId/resourceGroups/clusterResourceGroup"
+              },
+              "consoleProfile": {
+                "url": "https://console-openshift-console.apps.cluster.location.aroapp.io/"
+              },
+              "servicePrincipalProfile": {
+                "clientId": "clientId"
+              },
+              "networkProfile": {
+                "podCidr": "10.128.0.0/14",
+                "serviceCidr": "172.30.0.0/16"
+              },
+              "masterProfile": {
+                "vmSize": "Standard_D8s_v3",
+                "subnetId": "/subscriptions/subscriptionId/resourceGroups/vnetResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet/subnets/master"
+              },
+              "workerProfiles": [
+                {
+                  "name": "worker",
+                  "vmSize": "Standard_D2s_v3",
+                  "diskSizeGB": 128,
+                  "subnetId": "/subscriptions/subscriptionId/resourceGroups/vnetResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet/subnets/worker",
+                  "count": 3
+                }
+              ],
+              "apiserverProfile": {
+                "visibility": "Public",
+                "url": "https://api.cluster.location.aroapp.io:6443/",
+                "ip": "1.2.3.4"
+              },
+              "ingressProfiles": [
+                {
+                  "name": "default",
+                  "visibility": "Public",
+                  "ip": "1.2.3.4"
+                }
+              ]
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/OpenShiftClusters_ListByResourceGroup.json b/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/OpenShiftClusters_ListByResourceGroup.json
new file mode 100644
index 000000000000..c7af8efe014e
--- /dev/null
+++ b/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/OpenShiftClusters_ListByResourceGroup.json
@@ -0,0 +1,67 @@
+{
+  "parameters": {
+    "api-version": "2020-04-30",
+    "subscriptionId": "subscriptionId",
+    "resourceGroupName": "resourceGroup"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.RedHatOpenShift/OpenShiftClusters/resourceName",
+            "name": "resourceName",
+            "type": "Microsoft.RedHatOpenShift/OpenShiftClusters",
+            "location": "location",
+            "tags": {
+              "key": "value"
+            },
+            "properties": {
+              "provisioningState": "Succeeded",
+              "clusterProfile": {
+                "domain": "cluster.location.aroapp.io",
+                "version": "4.3.0",
+                "resourceGroupId": "/subscriptions/subscriptionId/resourceGroups/clusterResourceGroup"
+              },
+              "consoleProfile": {
+                "url": "https://console-openshift-console.apps.cluster.location.aroapp.io/"
+              },
+              "servicePrincipalProfile": {
+                "clientId": "clientId"
+              },
+              "networkProfile": {
+                "podCidr": "10.128.0.0/14",
+                "serviceCidr": "172.30.0.0/16"
+              },
+              "masterProfile": {
+                "vmSize": "Standard_D8s_v3",
+                "subnetId": "/subscriptions/subscriptionId/resourceGroups/vnetResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet/subnets/master"
+              },
+              "workerProfiles": [
+                {
+                  "name": "worker",
+                  "vmSize": "Standard_D2s_v3",
+                  "diskSizeGB": 128,
+                  "subnetId": "/subscriptions/subscriptionId/resourceGroups/vnetResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet/subnets/worker",
+                  "count": 3
+                }
+              ],
+              "apiserverProfile": {
+                "visibility": "Public",
+                "url": "https://api.cluster.location.aroapp.io:6443/",
+                "ip": "1.2.3.4"
+              },
+              "ingressProfiles": [
+                {
+                  "name": "default",
+                  "visibility": "Public",
+                  "ip": "1.2.3.4"
+                }
+              ]
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/OpenShiftClusters_ListCredentials.json b/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/OpenShiftClusters_ListCredentials.json
new file mode 100644
index 000000000000..aa749c7a2e69
--- /dev/null
+++ b/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/OpenShiftClusters_ListCredentials.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "api-version": "2020-04-30",
+    "subscriptionId": "subscriptionId",
+    "resourceGroupName": "resourceGroup",
+    "resourceName": "resourceName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "kubeadminUsername": "kubeadmin",
+        "kubeadminPassword": "password"
+      }
+    }
+  }
+}
diff --git a/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/OpenShiftClusters_Update.json b/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/OpenShiftClusters_Update.json
new file mode 100644
index 000000000000..74800c50c1af
--- /dev/null
+++ b/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/OpenShiftClusters_Update.json
@@ -0,0 +1,161 @@
+{
+  "parameters": {
+    "api-version": "2020-04-30",
+    "subscriptionId": "subscriptionId",
+    "resourceGroupName": "resourceGroup",
+    "resourceName": "resourceName",
+    "parameters": {
+      "tags": {
+        "key": "value"
+      },
+      "properties": {
+        "clusterProfile": {
+          "pullSecret": "{\"auths\":{\"registry.connect.redhat.com\":{\"auth\":\"\"},\"registry.redhat.io\":{\"auth\":\"\"}}}",
+          "domain": "cluster.location.aroapp.io",
+          "resourceGroupId": "/subscriptions/subscriptionId/resourceGroups/clusterResourceGroup"
+        },
+        "consoleProfile": {},
+        "servicePrincipalProfile": {
+          "clientId": "clientId",
+          "clientSecret": "clientSecret"
+        },
+        "networkProfile": {
+          "podCidr": "10.128.0.0/14",
+          "serviceCidr": "172.30.0.0/16"
+        },
+        "masterProfile": {
+          "vmSize": "Standard_D8s_v3",
+          "subnetId": "/subscriptions/subscriptionId/resourceGroups/vnetResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet/subnets/master"
+        },
+        "workerProfiles": [
+          {
+            "name": "worker",
+            "vmSize": "Standard_D2s_v3",
+            "diskSizeGB": 128,
+            "subnetId": "/subscriptions/subscriptionId/resourceGroups/vnetResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet/subnets/worker",
+            "count": 3
+          }
+        ],
+        "apiserverProfile": {
+          "visibility": "Public"
+        },
+        "ingressProfiles": [
+          {
+            "name": "default",
+            "visibility": "Public"
+          }
+        ]
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.RedHatOpenShift/OpenShiftClusters/resourceName",
+        "name": "resourceName",
+        "type": "Microsoft.RedHatOpenShift/OpenShiftClusters",
+        "location": "location",
+        "tags": {
+          "key": "value"
+        },
+        "properties": {
+          "provisioningState": "Succeeded",
+          "clusterProfile": {
+            "domain": "cluster.location.aroapp.io",
+            "version": "4.3.0",
+            "resourceGroupId": "/subscriptions/subscriptionId/resourceGroups/clusterResourceGroup"
+          },
+          "consoleProfile": {
+            "url": "https://console-openshift-console.apps.cluster.location.aroapp.io/"
+          },
+          "servicePrincipalProfile": {
+            "clientId": "clientId"
+          },
+          "networkProfile": {
+            "podCidr": "10.128.0.0/14",
+            "serviceCidr": "172.30.0.0/16"
+          },
+          "masterProfile": {
+            "vmSize": "Standard_D8s_v3",
+            "subnetId": "/subscriptions/subscriptionId/resourceGroups/vnetResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet/subnets/master"
+          },
+          "workerProfiles": [
+            {
+              "name": "worker",
+              "vmSize": "Standard_D2s_v3",
+              "diskSizeGB": 128,
+              "subnetId": "/subscriptions/subscriptionId/resourceGroups/vnetResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet/subnets/worker",
+              "count": 3
+            }
+          ],
+          "apiserverProfile": {
+            "visibility": "Public",
+            "url": "https://api.cluster.location.aroapp.io:6443/",
+            "ip": "1.2.3.4"
+          },
+          "ingressProfiles": [
+            {
+              "name": "default",
+              "visibility": "Public",
+              "ip": "1.2.3.4"
+            }
+          ]
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.RedHatOpenShift/OpenShiftClusters/resourceName",
+        "name": "resourceName",
+        "type": "Microsoft.RedHatOpenShift/OpenShiftClusters",
+        "location": "location",
+        "tags": {
+          "key": "value"
+        },
+        "properties": {
+          "provisioningState": "Succeeded",
+          "clusterProfile": {
+            "domain": "cluster.location.aroapp.io",
+            "version": "4.3.0",
+            "resourceGroupId": "/subscriptions/subscriptionId/resourceGroups/clusterResourceGroup"
+          },
+          "consoleProfile": {
+            "url": "https://console-openshift-console.apps.cluster.location.aroapp.io/"
+          },
+          "servicePrincipalProfile": {
+            "clientId": "clientId"
+          },
+          "networkProfile": {
+            "podCidr": "10.128.0.0/14",
+            "serviceCidr": "172.30.0.0/16"
+          },
+          "masterProfile": {
+            "vmSize": "Standard_D8s_v3",
+            "subnetId": "/subscriptions/subscriptionId/resourceGroups/vnetResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet/subnets/master"
+          },
+          "workerProfiles": [
+            {
+              "name": "worker",
+              "vmSize": "Standard_D2s_v3",
+              "diskSizeGB": 128,
+              "subnetId": "/subscriptions/subscriptionId/resourceGroups/vnetResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet/subnets/worker",
+              "count": 3
+            }
+          ],
+          "apiserverProfile": {
+            "visibility": "Public",
+            "url": "https://api.cluster.location.aroapp.io:6443/",
+            "ip": "1.2.3.4"
+          },
+          "ingressProfiles": [
+            {
+              "name": "default",
+              "visibility": "Public",
+              "ip": "1.2.3.4"
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/Operations_List.json b/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/Operations_List.json
new file mode 100644
index 000000000000..0683f851f7c1
--- /dev/null
+++ b/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/examples/Operations_List.json
@@ -0,0 +1,21 @@
+{
+  "parameters": {
+    "api-version": "2020-04-30"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "Microsoft.RedHatOpenShift/openShiftClusters/read",
+            "display": {
+              "provider": "Azure Red Hat OpenShift",
+              "resource": "openShiftClusters",
+              "operation": "Read OpenShift cluster"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/redhatopenshift.json b/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/redhatopenshift.json
new file mode 100644
index 000000000000..2baad1416737
--- /dev/null
+++ b/specification/redhatopenshift/resource-manager/Microsoft.RedHatOpenShift/stable/2020-04-30/redhatopenshift.json
@@ -0,0 +1,778 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "Azure Red Hat OpenShift Client",
+    "description": "Rest API for Azure Red Hat OpenShift",
+    "version": "2020-04-30"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "paths": {
+    "/providers/Microsoft.RedHatOpenShift/operations": {
+      "get": {
+        "tags": [
+          "Operations"
+        ],
+        "summary": "Lists all of the available RP operations.",
+        "description": "Lists all of the available RP operations.  The operation returns the RP operations.",
+        "operationId": "Operations_List",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/OperationList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.  If the resource doesn't exist, 404 (Not Found) is returned.  If any of the input parameters is wrong, 400 (Bad Request) is returned.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Lists all of the available RP operations.": {
+            "$ref": "./examples/Operations_List.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.RedHatOpenShift/openShiftClusters": {
+      "get": {
+        "tags": [
+          "OpenShiftClusters"
+        ],
+        "summary": "Lists OpenShift clusters in the specified subscription.",
+        "description": "Lists OpenShift clusters in the specified subscription.  The operation returns properties of each OpenShift cluster.",
+        "operationId": "OpenShiftClusters_List",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/OpenShiftClusterList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.  If the resource doesn't exist, 404 (Not Found) is returned.  If any of the input parameters is wrong, 400 (Bad Request) is returned.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Lists OpenShift clusters in the specified subscription.": {
+            "$ref": "./examples/OpenShiftClusters_List.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RedHatOpenShift/openShiftClusters": {
+      "get": {
+        "tags": [
+          "OpenShiftClusters"
+        ],
+        "summary": "Lists OpenShift clusters in the specified subscription and resource group.",
+        "description": "Lists OpenShift clusters in the specified subscription and resource group.  The operation returns properties of each OpenShift cluster.",
+        "operationId": "OpenShiftClusters_ListByResourceGroup",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/OpenShiftClusterList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.  If the resource doesn't exist, 404 (Not Found) is returned.  If any of the input parameters is wrong, 400 (Bad Request) is returned.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Lists OpenShift clusters in the specified subscription and resource group.": {
+            "$ref": "./examples/OpenShiftClusters_ListByResourceGroup.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RedHatOpenShift/openShiftClusters/{resourceName}": {
+      "get": {
+        "tags": [
+          "OpenShiftClusters"
+        ],
+        "summary": "Gets a OpenShift cluster with the specified subscription, resource group and resource name.",
+        "description": "Gets a OpenShift cluster with the specified subscription, resource group and resource name.  The operation returns properties of a OpenShift cluster.",
+        "operationId": "OpenShiftClusters_Get",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "name": "resourceName",
+            "in": "path",
+            "description": "The name of the OpenShift cluster resource.",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/OpenShiftCluster"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.  If the resource doesn't exist, 404 (Not Found) is returned.  If any of the input parameters is wrong, 400 (Bad Request) is returned.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Gets a OpenShift cluster with the specified subscription, resource group and resource name.": {
+            "$ref": "./examples/OpenShiftClusters_Get.json"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "OpenShiftClusters"
+        ],
+        "summary": "Creates or updates a OpenShift cluster with the specified subscription, resource group and resource name.",
+        "description": "Creates or updates a OpenShift cluster with the specified subscription, resource group and resource name.  The operation returns properties of a OpenShift cluster.",
+        "operationId": "OpenShiftClusters_CreateOrUpdate",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "name": "resourceName",
+            "in": "path",
+            "description": "The name of the OpenShift cluster resource.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "description": "The OpenShift cluster resource.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/OpenShiftCluster"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/OpenShiftCluster"
+            }
+          },
+          "201": {
+            "description": "Created",
+            "schema": {
+              "$ref": "#/definitions/OpenShiftCluster"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.  If the resource doesn't exist, 404 (Not Found) is returned.  If any of the input parameters is wrong, 400 (Bad Request) is returned.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Creates or updates a OpenShift cluster with the specified subscription, resource group and resource name.": {
+            "$ref": "./examples/OpenShiftClusters_CreateOrUpdate.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "OpenShiftClusters"
+        ],
+        "summary": "Deletes a OpenShift cluster with the specified subscription, resource group and resource name.",
+        "description": "Deletes a OpenShift cluster with the specified subscription, resource group and resource name.  The operation returns nothing.",
+        "operationId": "OpenShiftClusters_Delete",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "name": "resourceName",
+            "in": "path",
+            "description": "The name of the OpenShift cluster resource.",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Accepted"
+          },
+          "204": {
+            "description": "No Content"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.  If the resource doesn't exist, 404 (Not Found) is returned.  If any of the input parameters is wrong, 400 (Bad Request) is returned.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Deletes a OpenShift cluster with the specified subscription, resource group and resource name.": {
+            "$ref": "./examples/OpenShiftClusters_Delete.json"
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "OpenShiftClusters"
+        ],
+        "summary": "Creates or updates a OpenShift cluster with the specified subscription, resource group and resource name.",
+        "description": "Creates or updates a OpenShift cluster with the specified subscription, resource group and resource name.  The operation returns properties of a OpenShift cluster.",
+        "operationId": "OpenShiftClusters_Update",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "name": "resourceName",
+            "in": "path",
+            "description": "The name of the OpenShift cluster resource.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "description": "The OpenShift cluster resource.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/OpenShiftClusterUpdate"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/OpenShiftCluster"
+            }
+          },
+          "201": {
+            "description": "Created",
+            "schema": {
+              "$ref": "#/definitions/OpenShiftCluster"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.  If the resource doesn't exist, 404 (Not Found) is returned.  If any of the input parameters is wrong, 400 (Bad Request) is returned.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Creates or updates a OpenShift cluster with the specified subscription, resource group and resource name.": {
+            "$ref": "./examples/OpenShiftClusters_Update.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RedHatOpenShift/openShiftClusters/{resourceName}/listCredentials": {
+      "post": {
+        "tags": [
+          "OpenShiftClusters"
+        ],
+        "summary": "Lists credentials of an OpenShift cluster with the specified subscription, resource group and resource name.",
+        "description": "Lists credentials of an OpenShift cluster with the specified subscription, resource group and resource name.  The operation returns the credentials.",
+        "operationId": "OpenShiftClusters_ListCredentials",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "name": "resourceName",
+            "in": "path",
+            "description": "The name of the OpenShift cluster resource.",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/OpenShiftClusterCredentials"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.  If the resource doesn't exist, 404 (Not Found) is returned.  If any of the input parameters is wrong, 400 (Bad Request) is returned.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Lists credentials of an OpenShift cluster with the specified subscription, resource group and resource name.": {
+            "$ref": "./examples/OpenShiftClusters_ListCredentials.json"
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "APIServerProfile": {
+      "description": "APIServerProfile represents an API server profile.",
+      "properties": {
+        "visibility": {
+          "$ref": "#/definitions/Visibility",
+          "description": "API server visibility (immutable)."
+        },
+        "url": {
+          "description": "The URL to access the cluster API server (immutable).",
+          "type": "string"
+        },
+        "ip": {
+          "description": "The IP of the cluster API server (immutable).",
+          "type": "string"
+        }
+      }
+    },
+    "CloudError": {
+      "description": "CloudError represents a cloud error.",
+      "properties": {
+        "error": {
+          "$ref": "#/definitions/CloudErrorBody",
+          "description": "An error response from the service."
+        }
+      }
+    },
+    "CloudErrorBody": {
+      "description": "CloudErrorBody represents the body of a cloud error.",
+      "properties": {
+        "code": {
+          "description": "An identifier for the error. Codes are invariant and are intended to be consumed programmatically.",
+          "type": "string"
+        },
+        "message": {
+          "description": "A message describing the error, intended to be suitable for display in a user interface.",
+          "type": "string"
+        },
+        "target": {
+          "description": "The target of the particular error. For example, the name of the property in error.",
+          "type": "string"
+        },
+        "details": {
+          "description": "A list of additional details about the error.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/CloudErrorBody"
+          }
+        }
+      }
+    },
+    "ClusterProfile": {
+      "description": "ClusterProfile represents a cluster profile.",
+      "properties": {
+        "pullSecret": {
+          "description": "The pull secret for the cluster (immutable).",
+          "type": "string"
+        },
+        "domain": {
+          "description": "The domain for the cluster (immutable).",
+          "type": "string"
+        },
+        "version": {
+          "description": "The version of the cluster (immutable).",
+          "type": "string"
+        },
+        "resourceGroupId": {
+          "description": "The ID of the cluster resource group (immutable).",
+          "type": "string"
+        }
+      }
+    },
+    "ConsoleProfile": {
+      "description": "ConsoleProfile represents a console profile.",
+      "properties": {
+        "url": {
+          "description": "The URL to access the cluster console (immutable).",
+          "type": "string"
+        }
+      }
+    },
+    "Display": {
+      "description": "Display represents the display details of an operation.",
+      "properties": {
+        "provider": {
+          "description": "Friendly name of the resource provider.",
+          "type": "string"
+        },
+        "resource": {
+          "description": "Resource type on which the operation is performed.",
+          "type": "string"
+        },
+        "operation": {
+          "description": "Operation type: read, write, delete, listKeys/action, etc.",
+          "type": "string"
+        },
+        "description": {
+          "description": "Friendly name of the operation.",
+          "type": "string"
+        }
+      }
+    },
+    "IngressProfile": {
+      "description": "IngressProfile represents an ingress profile.",
+      "properties": {
+        "name": {
+          "description": "The ingress profile name.  Must be \"default\" (immutable).",
+          "type": "string"
+        },
+        "visibility": {
+          "$ref": "#/definitions/Visibility",
+          "description": "Ingress visibility (immutable)."
+        },
+        "ip": {
+          "description": "The IP of the ingress (immutable).",
+          "type": "string"
+        }
+      }
+    },
+    "MasterProfile": {
+      "description": "MasterProfile represents a master profile.",
+      "properties": {
+        "vmSize": {
+          "$ref": "#/definitions/VMSize",
+          "description": "The size of the master VMs (immutable)."
+        },
+        "subnetId": {
+          "description": "The Azure resource ID of the master subnet (immutable).",
+          "type": "string"
+        }
+      }
+    },
+    "NetworkProfile": {
+      "description": "NetworkProfile represents a network profile.",
+      "properties": {
+        "podCidr": {
+          "description": "The CIDR used for OpenShift/Kubernetes Pods (immutable).",
+          "type": "string"
+        },
+        "serviceCidr": {
+          "description": "The CIDR used for OpenShift/Kubernetes Services (immutable).",
+          "type": "string"
+        }
+      }
+    },
+    "OpenShiftCluster": {
+      "description": "OpenShiftCluster represents an Azure Red Hat OpenShift cluster.",
+      "allOf": [
+        {
+          "$ref": "../../../../../common-types/resource-management/v1/types.json#/definitions/TrackedResource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/OpenShiftClusterProperties",
+          "description": "The cluster properties.",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "OpenShiftClusterCredentials": {
+      "description": "OpenShiftClusterCredentials represents an OpenShift cluster's credentials",
+      "properties": {
+        "kubeadminUsername": {
+          "description": "The username for the kubeadmin user",
+          "type": "string"
+        },
+        "kubeadminPassword": {
+          "description": "The password for the kubeadmin user",
+          "type": "string"
+        }
+      }
+    },
+    "OpenShiftClusterList": {
+      "description": "OpenShiftClusterList represents a list of OpenShift clusters.",
+      "properties": {
+        "value": {
+          "description": "The list of OpenShift clusters.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/OpenShiftCluster"
+          }
+        },
+        "nextLink": {
+          "description": "The link used to get the next page of operations.",
+          "type": "string"
+        }
+      }
+    },
+    "OpenShiftClusterProperties": {
+      "description": "OpenShiftClusterProperties represents an OpenShift cluster's properties.",
+      "properties": {
+        "provisioningState": {
+          "$ref": "#/definitions/ProvisioningState",
+          "description": "The cluster provisioning state (immutable)."
+        },
+        "clusterProfile": {
+          "$ref": "#/definitions/ClusterProfile",
+          "description": "The cluster profile."
+        },
+        "consoleProfile": {
+          "$ref": "#/definitions/ConsoleProfile",
+          "description": "The console profile."
+        },
+        "servicePrincipalProfile": {
+          "$ref": "#/definitions/ServicePrincipalProfile",
+          "description": "The cluster service principal profile."
+        },
+        "networkProfile": {
+          "$ref": "#/definitions/NetworkProfile",
+          "description": "The cluster network profile."
+        },
+        "masterProfile": {
+          "$ref": "#/definitions/MasterProfile",
+          "description": "The cluster master profile."
+        },
+        "workerProfiles": {
+          "description": "The cluster worker profiles.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/WorkerProfile"
+          }
+        },
+        "apiserverProfile": {
+          "$ref": "#/definitions/APIServerProfile",
+          "description": "The cluster API server profile."
+        },
+        "ingressProfiles": {
+          "description": "The cluster ingress profiles.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/IngressProfile"
+          }
+        }
+      }
+    },
+    "OpenShiftClusterUpdate": {
+      "description": "OpenShiftCluster represents an Azure Red Hat OpenShift cluster.",
+      "properties": {
+        "tags": {
+          "$ref": "#/definitions/Tags",
+          "description": "The resource tags."
+        },
+        "properties": {
+          "$ref": "#/definitions/OpenShiftClusterProperties",
+          "description": "The cluster properties.",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "Operation": {
+      "description": "Operation represents an RP operation.",
+      "properties": {
+        "name": {
+          "description": "Operation name: {provider}/{resource}/{operation}.",
+          "type": "string"
+        },
+        "display": {
+          "$ref": "#/definitions/Display",
+          "description": "The object that describes the operation."
+        },
+        "origin": {
+          "description": "Sources of requests to this operation.  Comma separated list with valid values user or system, e.g. \"user,system\".",
+          "type": "string"
+        }
+      }
+    },
+    "OperationList": {
+      "description": "OperationList represents an RP operation list.",
+      "properties": {
+        "value": {
+          "description": "List of operations supported by the resource provider.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Operation"
+          }
+        },
+        "nextLink": {
+          "description": "The link used to get the next page of operations.",
+          "type": "string"
+        }
+      }
+    },
+    "ProvisioningState": {
+      "description": "ProvisioningState represents a provisioning state.",
+      "enum": [
+        "AdminUpdating",
+        "Creating",
+        "Deleting",
+        "Failed",
+        "Succeeded",
+        "Updating"
+      ],
+      "type": "string"
+    },
+    "ServicePrincipalProfile": {
+      "description": "ServicePrincipalProfile represents a service principal profile.",
+      "properties": {
+        "clientId": {
+          "description": "The client ID used for the cluster (immutable).",
+          "type": "string"
+        },
+        "clientSecret": {
+          "description": "The client secret used for the cluster (immutable).",
+          "type": "string"
+        }
+      }
+    },
+    "Tags": {
+      "description": "Tags represents an OpenShift cluster's tags.",
+      "type": "object",
+      "additionalProperties": {
+        "type": "string"
+      }
+    },
+    "VMSize": {
+      "description": "VMSize represents a VM size.",
+      "enum": [
+        "Standard_D2s_v3",
+        "Standard_D4s_v3",
+        "Standard_D8s_v3"
+      ],
+      "type": "string"
+    },
+    "Visibility": {
+      "description": "Visibility represents visibility.",
+      "enum": [
+        "Private",
+        "Public"
+      ],
+      "type": "string"
+    },
+    "WorkerProfile": {
+      "description": "WorkerProfile represents a worker profile.",
+      "properties": {
+        "name": {
+          "description": "The worker profile name.  Must be \"worker\" (immutable).",
+          "type": "string"
+        },
+        "vmSize": {
+          "$ref": "#/definitions/VMSize",
+          "description": "The size of the worker VMs (immutable)."
+        },
+        "diskSizeGB": {
+          "description": "The disk size of the worker VMs.  Must be 128 or greater (immutable).",
+          "type": "integer"
+        },
+        "subnetId": {
+          "description": "The Azure resource ID of the worker subnet (immutable).",
+          "type": "string"
+        },
+        "count": {
+          "description": "The number of worker VMs.  Must be between 3 and 20 (immutable).",
+          "type": "integer"
+        }
+      }
+    }
+  },
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "description": "Azure Active Directory OAuth2 Flow",
+      "flow": "implicit",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ]
+}
diff --git a/specification/redhatopenshift/resource-manager/readme.go.md b/specification/redhatopenshift/resource-manager/readme.go.md
new file mode 100644
index 000000000000..a43d0fcd9c52
--- /dev/null
+++ b/specification/redhatopenshift/resource-manager/readme.go.md
@@ -0,0 +1,26 @@
+## Go
+
+These settings apply only when `--go` is specified on the command line.
+
+``` yaml $(go)
+go:
+  license-header: MICROSOFT_APACHE_NO_VERSION
+  namespace: redhatopenshift
+  clear-output-folder: true
+```
+
+### Go multi-api
+
+``` yaml $(go) && $(multiapi)
+batch:
+  - tag: package-2020-04-30
+```
+
+### Tag: package-2020-04-30 and go
+
+These settings apply only when `--tag=package-2020-04-30 --go` is specified on the command line.
+Please also specify `--go-sdk-folder=<path to the root directory of your azure-sdk-for-go clone>`.
+
+``` yaml $(tag) == 'package-2020-04-30' && $(go)
+output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2020-04-30/$(namespace)
+```
diff --git a/specification/redhatopenshift/resource-manager/readme.md b/specification/redhatopenshift/resource-manager/readme.md
new file mode 100644
index 000000000000..d33bcd5b082c
--- /dev/null
+++ b/specification/redhatopenshift/resource-manager/readme.md
@@ -0,0 +1,89 @@
+# Azure Red Hat OpenShift
+
+> see https://aka.ms/autorest
+
+This is the AutoRest configuration file for Azure Red Hat OpenShift.
+
+---
+
+## Getting Started
+
+To build the SDK for Azure Red Hat OpenShift, simply [Install AutoRest](https://aka.ms/autorest/install) and in this folder, run:
+
+> `autorest`
+
+To see additional help and options, run:
+
+> `autorest --help`
+
+---
+
+## Configuration
+
+### Basic Information
+
+These are the global settings for the Azure Red Hat OpenShift API.
+
+``` yaml
+openapi-type: arm
+tag: package-2020-04-30
+```
+
+### Tag: package-2020-04-30
+
+These settings apply only when `--tag=package-2020-04-30` is specified on the command line.
+
+``` yaml $(tag) == 'package-2020-04-30'
+input-file:
+  - Microsoft.RedHatOpenShift/stable/2020-04-30/redhatopenshift.json
+```
+
+---
+
+# Code Generation
+
+## Swagger to SDK
+
+This section describes what SDK should be generated by the automatic system.
+This is not used by Autorest itself.
+
+```yaml $(swagger-to-sdk)
+swagger-to-sdk:
+  - repo: azure-sdk-for-python
+    after_scripts:
+      - python ./scripts/multiapi_init_gen.py azure-mgmt-redhatopenshift
+  - repo: azure-sdk-for-go
+```
+
+## Go
+
+See configuration in [readme.go.md](./readme.go.md)
+
+## Python
+
+See configuration in [readme.python.md](./readme.python.md)
+
+## Multi-API/Profile support for AutoRest v3 generators
+
+AutoRest V3 generators require the use of `--tag=all-api-versions` to select api files.
+
+This block is updated by an automatic script. Edits may be lost!
+
+``` yaml $(tag) == 'all-api-versions' /* autogenerated */
+# include the azure profile definitions from the standard location
+require: $(this-folder)/../../../profiles/readme.md
+
+# all the input files across all versions
+input-file:
+  - $(this-folder)/Microsoft.RedHatOpenShift/stable/2020-04-30/redhatopenshift.json
+
+```
+
+If there are files that should not be in the `all-api-versions` set,
+uncomment the  `exclude-file` section below and add the file paths.
+
+``` yaml $(tag) == 'all-api-versions'
+#exclude-file:
+#  - $(this-folder)/Microsoft.Example/stable/2010-01-01/somefile.json
+```
+
diff --git a/specification/redhatopenshift/resource-manager/readme.python.md b/specification/redhatopenshift/resource-manager/readme.python.md
new file mode 100644
index 000000000000..6ec5494abba7
--- /dev/null
+++ b/specification/redhatopenshift/resource-manager/readme.python.md
@@ -0,0 +1,33 @@
+## Python
+
+These settings apply only when `--python` is specified on the command line.
+
+```yaml $(python)
+python:
+  azure-arm: true
+  license-header: MICROSOFT_MIT_NO_VERSION
+  payload-flattening-threshold: 2
+  package-name: azure-mgmt-redhatopenshift
+  clear-output-folder: true
+  no-namespace-folders: true
+```
+
+### Python multi-api
+
+Generate all API versions currently shipped for this package
+
+```yaml $(python) && $(multiapi)
+batch:
+  - tag: package-2020-04-30
+```
+
+### Tag: package-2020-04-30 and python
+
+These settings apply only when `--tag=package-2020-04-30 --python` is specified on the command line.
+Please also specify `--python-sdks-folder=<path to the root directory of your azure-sdk-for-python clone>`.
+
+``` yaml $(tag) == 'package-2020-04-30' && $(python)
+python:
+  namespace: azure.mgmt.redhatopenshift.v2020_04_30
+  output-folder: $(python-sdks-folder)/redhatopenshift/azure-mgmt-redhatopenshift/azure/mgmt/redhatopenshift/v2020_04_30
+```
diff --git a/specification/resources/resource-manager/Microsoft.Features/stable/2015-12-01/examples/unregisterFeature.json b/specification/resources/resource-manager/Microsoft.Features/stable/2015-12-01/examples/unregisterFeature.json
new file mode 100644
index 000000000000..dc44a62c04ee
--- /dev/null
+++ b/specification/resources/resource-manager/Microsoft.Features/stable/2015-12-01/examples/unregisterFeature.json
@@ -0,0 +1,21 @@
+{
+  "parameters": {
+    "resourceProviderNamespace": "Resource Provider Namespace",
+    "featureName": "feature",
+    "api-version": "2015-12-01",
+    "subscriptionId": "ff23096b-f5a2-46ea-bd62-59c3e93fef9a"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "name": "Feature1",
+        "properties": {
+          "state": "unregistered"
+        },
+        "id": "/subscriptions/ff23096b-f5a2-46ea-bd62-59c3e93fef9a/providers/Microsoft.Features/providers/Microsoft.Test/features/Feature1",
+        "type": "Microsoft.Features/providers/features"
+      }
+    }
+  }
+}
diff --git a/specification/resources/resource-manager/Microsoft.Features/stable/2015-12-01/features.json b/specification/resources/resource-manager/Microsoft.Features/stable/2015-12-01/features.json
index 8b9fbd36e54c..92d52d602189 100644
--- a/specification/resources/resource-manager/Microsoft.Features/stable/2015-12-01/features.json
+++ b/specification/resources/resource-manager/Microsoft.Features/stable/2015-12-01/features.json
@@ -226,6 +226,50 @@
           }
         }
       }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Features/providers/{resourceProviderNamespace}/features/{featureName}/unregister": {
+      "post": {
+        "tags": [
+          "Features"
+        ],
+        "operationId": "Features_Unregister",
+        "description": "Unregisters the preview feature for the subscription.",
+        "x-ms-examples": {
+          "Register feature": {
+            "$ref": "./examples/unregisterFeature.json"
+          }
+        },
+        "parameters": [
+          {
+            "name": "resourceProviderNamespace",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The namespace of the resource provider."
+          },
+          {
+            "name": "featureName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The name of the feature to unregister."
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK - Returns metadata about the unregistered feature. The metadata includes the name of the feature, the registration state, the resource ID, and resource type.",
+            "schema": {
+              "$ref": "#/definitions/FeatureResult"
+            }
+          }
+        }
+      }
     }
   },
   "definitions": {
diff --git a/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/deploymentScripts.json b/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/deploymentScripts.json
index 65e342a4c956..da6550c6d5ff 100644
--- a/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/deploymentScripts.json
+++ b/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/deploymentScripts.json
@@ -439,6 +439,11 @@
             "name": "ScriptType",
             "modelAsString": true
           }
+        },
+        "systemData": {
+          "readOnly": true,
+          "description": "The system metadata related to this resource.",
+          "$ref": "../../../../../common-types/resource-management/v1/types.json#/definitions/systemData"
         }
       },
       "allOf": [
@@ -604,6 +609,11 @@
       "x-ms-external": true,
       "description": "Common properties for the deployment script.",
       "properties": {
+        "containerSettings": {
+          "type": "object",
+          "description": "Container settings.",
+          "$ref": "#/definitions/ContainerConfiguration"
+        },
         "cleanupPreference": {
           "type": "string",
           "description": "The clean up preference when the script execution gets in a terminal state. Default setting is 'Always'.",
@@ -651,6 +661,18 @@
         }
       }
     },
+    "ContainerConfiguration": {
+      "type": "object",
+      "description": "Settings to customize ACI container instance.",
+      "properties": {
+        "containerGroupName": {
+          "type": "string",
+          "description": "Container group name, if not specified then the name will get auto-generated. Not specifying a 'containerGroupName' indicates the system to generate a unique name which might end up flagging an Azure Policy as non-compliant. Use 'containerGroupName' when you have an Azure Policy that expects a specific naming convention or when you want to fully control the name. 'containerGroupName' property must be between 1 and 63 characters long, must contain only lowercase letters, numbers, and dashes and it cannot start or end with a dash and consecutive dashes are not allowed. To specify a 'containerGroupName', add the following object to properties: { \"containerSettings\": { \"containerGroupName\": \"contoso-container\" } }. If you do not want to specify a 'containerGroupName' then do not add 'containerSettings' property.",
+          "minLength": 1,
+          "maxLength": 63
+        }
+      }
+    },
     "ScriptStatus": {
       "type": "object",
       "description": "Generic object modeling results of script execution.",
diff --git a/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_Create.json b/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_Create.json
index 2d4156d8e6df..b1d63f125fed 100644
--- a/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_Create.json
+++ b/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_Create.json
@@ -38,6 +38,14 @@
             "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai": {}
           }
         },
+        "systemData": {
+          "createdBy": "string",
+          "createdByType": "Application",
+          "createdAt": "2020-02-01T01:01:01.1075056Z",
+          "lastModifiedBy": "string",
+          "lastModifiedByType": "Application",
+          "lastModifiedAt": "2020-02-01T01:01:01.1075056Z"
+        },
         "properties": {
           "provisioningState": "Creating",
           "azPowerShellVersion": "1.7.0",
diff --git a/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_Get.json b/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_Get.json
index ee19875a981b..1e8d0566fdbc 100644
--- a/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_Get.json
+++ b/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_Get.json
@@ -16,6 +16,14 @@
             "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai": {}
           }
         },
+        "systemData": {
+          "createdBy": "string",
+          "createdByType": "Application",
+          "createdAt": "2020-02-01T01:01:01.1075056Z",
+          "lastModifiedBy": "string",
+          "lastModifiedByType": "Application",
+          "lastModifiedAt": "2020-02-01T01:01:01.1075056Z"
+        },
         "properties": {
           "provisioningState": "Succeeded",
           "azPowerShellVersion": "1.7.0",
diff --git a/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_ListByResourceGroup.json b/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_ListByResourceGroup.json
index 983b4c2c9cc8..e73c4a21c9d0 100644
--- a/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_ListByResourceGroup.json
+++ b/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_ListByResourceGroup.json
@@ -18,6 +18,14 @@
                 "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai": {}
               }
             },
+            "systemData": {
+              "createdBy": "string",
+              "createdByType": "Application",
+              "createdAt": "2020-02-01T01:01:01.1075056Z",
+              "lastModifiedBy": "string",
+              "lastModifiedByType": "Application",
+              "lastModifiedAt": "2020-02-01T01:01:01.1075056Z"
+            },
             "properties": {
               "provisioningState": "Succeeded",
               "azPowerShellVersion": "1.7.0",
diff --git a/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_ListBySubscription.json b/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_ListBySubscription.json
index 199c1ed77b31..e205c3b34347 100644
--- a/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_ListBySubscription.json
+++ b/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_ListBySubscription.json
@@ -16,6 +16,14 @@
                 "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai": {}
               }
             },
+            "systemData": {
+              "createdBy": "string",
+              "createdByType": "Application",
+              "createdAt": "2020-02-01T01:01:01.1075056Z",
+              "lastModifiedBy": "string",
+              "lastModifiedByType": "Application",
+              "lastModifiedAt": "2020-02-01T01:01:01.1075056Z"
+            },
             "properties": {
               "provisioningState": "Succeeded",
               "azPowerShellVersion": "1.7.0",
diff --git a/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_Min_Create.json b/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_Min_Create.json
index b411784c4591..15100be96f75 100644
--- a/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_Min_Create.json
+++ b/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_Min_Create.json
@@ -32,6 +32,14 @@
             "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai": {}
           }
         },
+        "systemData": {
+          "createdBy": "string",
+          "createdByType": "Application",
+          "createdAt": "2020-02-01T01:01:01.1075056Z",
+          "lastModifiedBy": "string",
+          "lastModifiedByType": "Application",
+          "lastModifiedAt": "2020-02-01T01:01:01.1075056Z"
+        },
         "properties": {
           "provisioningState": "Creating",
           "azPowerShellVersion": "1.7.0",
diff --git a/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_Update.json b/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_Update.json
index c365156e2a9d..f42821d1f4c2 100644
--- a/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_Update.json
+++ b/specification/resources/resource-manager/Microsoft.Resources/preview/2019-10-01-preview/examples/DeploymentScripts_Update.json
@@ -34,6 +34,14 @@
             "output1": "value1"
           }
         },
+        "systemData": {
+          "createdBy": "string",
+          "createdByType": "Application",
+          "createdAt": "2020-02-01T01:01:01.1075056Z",
+          "lastModifiedBy": "string",
+          "lastModifiedByType": "Application",
+          "lastModifiedAt": "2020-02-01T01:01:01.1075056Z"
+        },
         "kind": "AzurePowerShell",
         "location": "westus",
         "identity": {
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2020-01-01/examples/GetLocations.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2020-01-01/examples/GetLocations.json
new file mode 100644
index 000000000000..587ecdee7ccd
--- /dev/null
+++ b/specification/resources/resource-manager/Microsoft.Resources/stable/2020-01-01/examples/GetLocations.json
@@ -0,0 +1,52 @@
+{
+  "parameters": {
+    "subscriptionId": "291bba3f-e0a5-47bc-a099-3bdcb2a50a05",
+    "api-version": "2020-01-01"
+  },
+  "responses": {
+    "200": {
+      "body": [
+        {
+          "id": "/subscriptions/291bba3f-e0a5-47bc-a099-3bdcb2a50a05/locations/centralus",
+          "name": "centralus",
+          "displayName": "Central US",
+          "regionalDisplayName": "(US) Central US",
+          "metadata": {
+            "regionType": "Physical",
+            "regionCategory": "Recommended",
+            "geographyGroup": "US",
+            "longitude": "-93.6208",
+            "latitude": "41.5908",
+            "physicalLocation": "Iowa",
+            "pairedRegion": [
+              {
+                "name": "eastus2",
+                "id": "/subscriptions/291bba3f-e0a5-47bc-a099-3bdcb2a50a05/locations/eastus2"
+              }
+            ]
+          }
+        },
+        {
+          "id": "/subscriptions/291bba3f-e0a5-47bc-a099-3bdcb2a50a05/locations/eastasia",
+          "name": "eastasia",
+          "displayName": "East Asia",
+          "regionalDisplayName": "(Asia Pacific) East Asia",
+          "metadata": {
+            "regionType": "Physical",
+            "regionCategory": "Recommended",
+            "geographyGroup": "Asia Pacific",
+            "longitude": "114.188",
+            "latitude": "22.267",
+            "physicalLocation": "Hong Kong",
+            "pairedRegion": [
+              {
+                "name": "southeastasia",
+                "id": "/subscriptions/291bba3f-e0a5-47bc-a099-3bdcb2a50a05/locations/southeastasia"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2020-01-01/examples/GetSubscription.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2020-01-01/examples/GetSubscription.json
new file mode 100644
index 000000000000..fca6abaef605
--- /dev/null
+++ b/specification/resources/resource-manager/Microsoft.Resources/stable/2020-01-01/examples/GetSubscription.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "subscriptionId": "291bba3f-e0a5-47bc-a099-3bdcb2a50a05",
+    "api-version": "2020-01-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/291bba3f-e0a5-47bc-a099-3bdcb2a50a05",
+        "subscriptionId": "291bba3f-e0a5-47bc-a099-3bdcb2a50a05",
+        "tenantId": "31c75423-32d6-4322-88b7-c478bdde4858",
+        "displayName": "Example Subscription",
+        "state": "Enabled",
+        "subscriptionPolicies": {
+          "locationPlacementId": "Internal_2014-09-01",
+          "quotaId": "Internal_2014-09-01",
+          "spendingLimit": "Off"
+        },
+        "authorizationSource": "Bypassed",
+        "managedByTenants": [
+          {
+            "tenantId": "8f70baf1-1f6e-46a2-a1ff-238dac1ebfb7"
+          }
+        ],
+        "tags": {
+          "tagKey1": "tagValue1",
+          "tagKey2": "tagValue2"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2020-01-01/examples/GetSubscriptions.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2020-01-01/examples/GetSubscriptions.json
new file mode 100644
index 000000000000..56bafb43289b
--- /dev/null
+++ b/specification/resources/resource-manager/Microsoft.Resources/stable/2020-01-01/examples/GetSubscriptions.json
@@ -0,0 +1,61 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/291bba3f-e0a5-47bc-a099-3bdcb2a50a05",
+            "subscriptionId": "291bba3f-e0a5-47bc-a099-3bdcb2a50a05",
+            "tenantId": "31c75423-32d6-4322-88b7-c478bdde4858",
+            "displayName": "Example Subscription",
+            "state": "Enabled",
+            "subscriptionPolicies": {
+              "locationPlacementId": "Internal_2014-09-01",
+              "quotaId": "Internal_2014-09-01",
+              "spendingLimit": "Off"
+            },
+            "authorizationSource": "RoleBased",
+            "managedByTenants": [
+              {
+                "tenantId": "8f70baf1-1f6e-46a2-a1ff-238dac1ebfb7"
+              }
+            ],
+            "tags": {
+              "tagKey1": "tagValue1",
+              "tagKey2": "tagValue2"
+            }
+          },
+          {
+            "id": "/subscriptions/72ac930a-f34e-42d8-b06d-dc2a9e12ed71",
+            "subscriptionId": "72ac930a-f34e-42d8-b06d-dc2a9e12ed71",
+            "tenantId": "2a0ff0de-96b2-4859-bb7c-a430d07a3e0c",
+            "displayName": "Example Subscription2",
+            "state": "Enabled",
+            "subscriptionPolicies": {
+              "locationPlacementId": "Internal_2014-09-01",
+              "quotaId": "Internal_2014-09-01",
+              "spendingLimit": "Off"
+            },
+            "authorizationSource": "RoleBased",
+            "managedByTenants": [
+              {
+                "tenantId": "8f70baf1-1f6e-46a2-a1ff-238dac1ebfb7"
+              },
+              {
+                "tenantId": "f7fb6af2-321d-47c8-9c0f-b0239eaad39a"
+              }
+            ],
+            "tags": {
+              "tagKey1": "tagValue1",
+              "tagKey2": "tagValue2"
+            }
+          }
+        ],
+        "nextLink": "..."
+      }
+    }
+  }
+}
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2020-01-01/examples/GetTenants.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2020-01-01/examples/GetTenants.json
new file mode 100644
index 000000000000..ec04256a4cdc
--- /dev/null
+++ b/specification/resources/resource-manager/Microsoft.Resources/stable/2020-01-01/examples/GetTenants.json
@@ -0,0 +1,53 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/tenants/a70a1586-9c4a-4373-b907-1d310660dbd1",
+            "tenantId": "a70a1586-9c4a-4373-b907-1d310660dbd1",
+            "countryCode": "US",
+            "displayName": "Test_Test_aad50",
+            "domains": [
+              "aad50.ccsctp.net"
+            ],
+            "tenantCategory": "ManagedBy",
+            "defaultDomain": "aad50.ccsctp.net",
+            "tenantType": "AAD"
+          },
+          {
+            "id": "/tenants/83abe5cd-bcc3-441a-bd86-e6a75360cecc",
+            "tenantId": "83abe5cd-bcc3-441a-bd86-e6a75360cecc",
+            "countryCode": "US",
+            "displayName": "Contoso Corp.",
+            "domains": [
+              "auxteststagemanual.ccsctp.net"
+            ],
+            "tenantCategory": "Home",
+            "defaultDomain": "auxteststagemanual.ccsctp.net",
+            "tenantType": "AAD"
+          },
+          {
+            "id": "/tenants/daea2e9b-847b-4c93-850d-2aa6f2d7af33",
+            "tenantId": "daea2e9b-847b-4c93-850d-2aa6f2d7af33",
+            "countryCode": "US",
+            "displayName": "TEST_TEST_RDV",
+            "domains": [
+              "rdvmohoro.ccsctp.net",
+              "rdvmohoro.mail.ccsctp.net",
+              "rdvmohoro.com"
+            ],
+            "tenantCategory": "ProjectedBy",
+            "defaultDomain": "rdvmohoro.ccsctp.net",
+            "tenantType": "AAD",
+            "tenantBrandingLogoUrl": "logo1.logo.rdvmohoro.com"
+          }
+        ],
+        "nextLink": "..."
+      }
+    }
+  }
+}
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2020-01-01/subscriptions.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2020-01-01/subscriptions.json
new file mode 100644
index 000000000000..ee5d51274e47
--- /dev/null
+++ b/specification/resources/resource-manager/Microsoft.Resources/stable/2020-01-01/subscriptions.json
@@ -0,0 +1,587 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "SubscriptionClient",
+    "version": "2020-01-01",
+    "description": "All resource groups and resources exist within subscriptions. These operation enable you get information about your subscriptions and tenants. A tenant is a dedicated instance of Azure Active Directory (Azure AD) for your organization."
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/providers/Microsoft.Resources/operations": {
+      "get": {
+        "tags": [
+          "Operations"
+        ],
+        "operationId": "Operations_List",
+        "description": "Lists all of the available Microsoft.Resources REST API operations.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/OperationListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/locations": {
+      "get": {
+        "tags": [
+          "Subscriptions"
+        ],
+        "operationId": "Subscriptions_ListLocations",
+        "summary": "Gets all available geo-locations.",
+        "description": "This operation provides all the locations that are available for resource providers; however, each resource provider may support a subset of this list.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK - Returns an array of locations.",
+            "schema": {
+              "$ref": "#/definitions/LocationListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "x-ms-examples": {
+          "Get locations with a subscription id": {
+            "$ref": "./examples/GetLocations.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}": {
+      "get": {
+        "tags": [
+          "Subscriptions"
+        ],
+        "operationId": "Subscriptions_Get",
+        "description": "Gets details about a specified subscription.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK - Returns information about the subscription.",
+            "schema": {
+              "$ref": "#/definitions/Subscription"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Get a single subscription.": {
+            "$ref": "./examples/GetSubscription.json"
+          }
+        }
+      }
+    },
+    "/subscriptions": {
+      "get": {
+        "tags": [
+          "Subscriptions"
+        ],
+        "operationId": "Subscriptions_List",
+        "description": "Gets all subscriptions for a tenant.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK - Returns an array of subscriptions.",
+            "schema": {
+              "$ref": "#/definitions/SubscriptionListResult"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Get all subscriptions.": {
+            "$ref": "./examples/GetSubscriptions.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/tenants": {
+      "get": {
+        "tags": [
+          "Tenants"
+        ],
+        "operationId": "Tenants_List",
+        "description": "Gets the tenants for your account.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK - Returns an array of tenants.",
+            "schema": {
+              "$ref": "#/definitions/TenantListResult"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Get all tenants.": {
+            "$ref": "./examples/GetTenants.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    }
+  },
+  "definitions": {
+    "PairedRegion": {
+      "description": "Information regarding paired region.",
+      "properties": {
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "The name of the paired region."
+        },
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The fully qualified ID of the location. For example, /subscriptions/00000000-0000-0000-0000-000000000000/locations/westus."
+        },
+        "subscriptionId": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The subscription ID."
+        }
+      }
+    },
+    "LocationMetadata": {
+      "description": "Location metadata information",
+      "properties": {
+        "regionType": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The type of the region.",
+          "enum": [
+            "Physical",
+            "Logical"
+          ],
+          "x-ms-enum": {
+            "name": "RegionType",
+            "modelAsString": true
+          }
+        },
+        "regionCategory": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The category of the region.",
+          "enum": [
+            "Recommended",
+            "Other"
+          ],
+          "x-ms-enum": {
+            "name": "RegionCategory",
+            "modelAsString": true
+          }
+        },
+        "geographyGroup": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The geography group of the location."
+        },
+        "longitude": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The longitude of the location."
+        },
+        "latitude": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The latitude of the location."
+        },
+        "physicalLocation": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The physical location of the Azure location."
+        },
+        "pairedRegion": {
+          "type": "array",
+          "description": "The regions paired to this region.",
+          "items": {
+            "$ref": "#/definitions/PairedRegion"
+          }
+        }
+      }
+    },
+    "Location": {
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The fully qualified ID of the location. For example, /subscriptions/00000000-0000-0000-0000-000000000000/locations/westus."
+        },
+        "subscriptionId": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The subscription ID."
+        },
+        "name": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The location name."
+        },
+        "displayName": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The display name of the location."
+        },
+        "regionalDisplayName": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The display name of the location and its region."
+        },
+        "metadata": {
+          "description": "Metadata of the location, such as lat/long, paired region, and others.",
+          "$ref": "#/definitions/LocationMetadata"
+        }
+      },
+      "description": "Location information."
+    },
+    "LocationListResult": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Location"
+          },
+          "description": "An array of locations."
+        }
+      },
+      "description": "Location list operation response."
+    },
+    "Subscription": {
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The fully qualified ID for the subscription. For example, /subscriptions/00000000-0000-0000-0000-000000000000."
+        },
+        "subscriptionId": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The subscription ID."
+        },
+        "displayName": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The subscription display name."
+        },
+        "tenantId": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The subscription tenant ID."
+        },
+        "state": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The subscription state. Possible values are Enabled, Warned, PastDue, Disabled, and Deleted.",
+          "enum": [
+            "Enabled",
+            "Warned",
+            "PastDue",
+            "Disabled",
+            "Deleted"
+          ],
+          "x-ms-enum": {
+            "name": "SubscriptionState",
+            "modelAsString": false
+          }
+        },
+        "subscriptionPolicies": {
+          "$ref": "#/definitions/SubscriptionPolicies",
+          "description": "The subscription policies."
+        },
+        "authorizationSource": {
+          "type": "string",
+          "description": "The authorization source of the request. Valid values are one or more combinations of Legacy, RoleBased, Bypassed, Direct and Management. For example, 'Legacy, RoleBased'."
+        },
+        "managedByTenants": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ManagedByTenant"
+          },
+          "description": "An array containing the tenants managing the subscription."
+        },
+        "tags": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string",
+            "description": "The additional properties. "
+          },
+          "description": "The tags attached to the subscription."
+        }
+      },
+      "description": "Subscription information."
+    },
+    "SubscriptionPolicies": {
+      "properties": {
+        "locationPlacementId": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The subscription location placement ID. The ID indicates which regions are visible for a subscription. For example, a subscription with a location placement Id of Public_2014-09-01 has access to Azure public regions."
+        },
+        "quotaId": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The subscription quota ID."
+        },
+        "spendingLimit": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The subscription spending limit.",
+          "enum": [
+            "On",
+            "Off",
+            "CurrentPeriodOff"
+          ],
+          "x-ms-enum": {
+            "name": "spendingLimit",
+            "modelAsString": false
+          }
+        }
+      },
+      "description": "Subscription policies."
+    },
+    "ManagedByTenant": {
+      "properties": {
+        "tenantId": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The tenant ID of the managing tenant. This is a GUID."
+        }
+      },
+      "description": "Information about a tenant managing the subscription."
+    },
+    "SubscriptionListResult": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Subscription"
+          },
+          "description": "An array of subscriptions."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "The URL to get the next set of results."
+        }
+      },
+      "required": [
+        "nextLink"
+      ],
+      "description": "Subscription list operation response."
+    },
+    "TenantIdDescription": {
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The fully qualified ID of the tenant. For example, /tenants/00000000-0000-0000-0000-000000000000."
+        },
+        "tenantId": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The tenant ID. For example, 00000000-0000-0000-0000-000000000000."
+        },
+        "tenantCategory": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Category of the tenant.",
+          "enum": [
+            "Home",
+            "ProjectedBy",
+            "ManagedBy"
+          ],
+          "x-ms-enum": {
+            "name": "TenantCategory",
+            "modelAsString": false
+          }
+        },
+        "country": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Country/region name of the address for the tenant."
+        },
+        "countryCode": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Country/region abbreviation for the tenant."
+        },
+        "displayName": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The display name of the tenant."
+        },
+        "domains": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "description": "The domain name for a tenant."
+          },
+          "description": "The list of domains for the tenant."
+        },
+        "defaultDomain": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The default domain for the tenant."
+        },
+        "tenantType": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The tenant type. Only available for 'Home' tenant category."
+        },
+        "tenantBrandingLogoUrl": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The tenant's branding logo URL. Only available for 'Home' tenant category."
+        }
+      },
+      "description": "Tenant Id information."
+    },
+    "TenantListResult": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/TenantIdDescription"
+          },
+          "description": "An array of tenants."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "The URL to use for getting the next set of results."
+        }
+      },
+      "required": [
+        "nextLink"
+      ],
+      "description": "Tenant Ids information."
+    },
+    "Operation": {
+      "description": "Microsoft.Resources operation",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "Operation name: {provider}/{resource}/{operation}",
+          "type": "string"
+        },
+        "display": {
+          "description": "The object that represents the operation.",
+          "properties": {
+            "provider": {
+              "description": "Service provider: Microsoft.Resources",
+              "type": "string"
+            },
+            "resource": {
+              "description": "Resource on which the operation is performed: Profile, endpoint, etc.",
+              "type": "string"
+            },
+            "operation": {
+              "description": "Operation type: Read, write, delete, etc.",
+              "type": "string"
+            },
+            "description": {
+              "description": "Description of the operation.",
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "OperationListResult": {
+      "description": "Result of the request to list Microsoft.Resources operations. It contains a list of operations and a URL link to get the next set of results.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Operation"
+          },
+          "description": "List of Microsoft.Resources operations."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of operation list results if there are any."
+        }
+      }
+    }
+  },
+  "parameters": {
+    "SubscriptionIdParameter": {
+      "name": "subscriptionId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The ID of the target subscription.",
+      "x-ms-parameter-location": "method"
+    },
+    "ApiVersionParameter": {
+      "name": "api-version",
+      "in": "query",
+      "required": true,
+      "type": "string",
+      "description": "The API version to use for the operation.",
+      "x-ms-parameter-location": "client"
+    }
+  }
+}
diff --git a/specification/resources/resource-manager/readme.md b/specification/resources/resource-manager/readme.md
index c390c1a0b58d..32aea908a345 100644
--- a/specification/resources/resource-manager/readme.md
+++ b/specification/resources/resource-manager/readme.md
@@ -60,6 +60,15 @@ tag: package-managedapplications-2018-06
 tag: package-deploymentscripts-2019-10-preview
 ```
 
+### Tag: package-subscriptions-2020-01
+
+These settings apply only when `--tag=package-subscriptions-2020-01` is specified on the command line.
+
+```yaml $(tag) == 'package-subscriptions-2020-01'
+input-file:
+  - Microsoft.Resources/stable/2020-01-01/subscriptions.json
+```
+
 ### Tag: package-deploymentscripts-2019-10-preview
 
 These settings apply only when `--tag=package-deploymentscripts-2019-10-preview` is specified on the command line.
@@ -535,6 +544,13 @@ directive:
     suppress: OperationsAPIImplementation
     where: $.paths
     reason: OperationsAPI will come from Resources
+  - from: deploymentScripts.json
+    suppress: R3006 #BodyTopLevelProperties
+    where: 
+    - $.definitions.DeploymentScript.properties
+    - $.definitions.AzureCliScript.properties
+    - $.definitions.AzurePowerShellScript.properties
+    reason: Currently systemData is not allowed
 ```
 
 ---
@@ -614,6 +630,7 @@ require: $(this-folder)/../../../profiles/readme.md
 
 # all the input files across all versions
 input-file:
+  - $(this-folder)/Microsoft.Resources/stable/2020-01-01/subscriptions.json
   - $(this-folder)/Microsoft.Resources/preview/2019-10-01-preview/deploymentScripts.json
   - $(this-folder)/Microsoft.Features/stable/2015-12-01/features.json
   - $(this-folder)/Microsoft.Authorization/stable/2016-09-01/locks.json
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2017-08-01-preview/examples/InformationProtectionPolicies/CreateOrUpdateInformationProtectionPolicy_example.json b/specification/security/resource-manager/Microsoft.Security/preview/2017-08-01-preview/examples/InformationProtectionPolicies/CreateOrUpdateInformationProtectionPolicy_example.json
index eeb717b89952..22871f81f4d2 100644
--- a/specification/security/resource-manager/Microsoft.Security/preview/2017-08-01-preview/examples/InformationProtectionPolicies/CreateOrUpdateInformationProtectionPolicy_example.json
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2017-08-01-preview/examples/InformationProtectionPolicies/CreateOrUpdateInformationProtectionPolicy_example.json
@@ -3,7 +3,7 @@
     "api-version": "2017-08-01-preview",
     "scope": "providers/Microsoft.Management/managementGroups/148059f7-faf3-49a6-ba35-85122112291e",
     "informationProtectionPolicyName": "custom",
-    "InformationProtectionPolicy": {
+    "informationProtectionPolicy": {
       "id": "/providers/Microsoft.Management/managementGroups/148059f7-faf3-49a6-ba35-85122112291e/providers/Microsoft.Security/informationProtectionPolicies/custom",
       "name": "custom",
       "type": "Microsoft.Security/informationProtectionPolicies",
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2017-08-01-preview/informationProtectionPolicies.json b/specification/security/resource-manager/Microsoft.Security/preview/2017-08-01-preview/informationProtectionPolicies.json
index 160233ecc06e..ec5d2697906f 100644
--- a/specification/security/resource-manager/Microsoft.Security/preview/2017-08-01-preview/informationProtectionPolicies.json
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2017-08-01-preview/informationProtectionPolicies.json
@@ -95,6 +95,9 @@
           },
           {
             "$ref": "#/parameters/InformationProtectionPolicyName"
+          },
+          {
+            "$ref": "#/parameters/InformationProtectionPolicy"
           }
         ],
         "responses": {
@@ -231,6 +234,25 @@
           "type": "string",
           "description": "The name of the sensitivity label."
         },
+        "description": {
+          "type": "string",
+          "description": "The description of the sensitivity label."
+        },
+        "rank": {
+          "type": "string",
+          "description": "The rank of the sensitivity label.",
+          "enum": [
+            "None",
+            "Low",
+            "Medium",
+            "High",
+            "Critical"
+          ],
+          "x-ms-enum": {
+            "name": "rank",
+            "modelAsString": false
+          }
+        },
         "order": {
           "type": "number",
           "description": "The order of the sensitivity label."
@@ -249,6 +271,10 @@
           "type": "string",
           "description": "The name of the information type."
         },
+        "description": {
+          "type": "string",
+          "description": "The description of the information type."
+        },
         "order": {
           "type": "number",
           "description": "The order of the information type."
@@ -310,6 +336,16 @@
       ],
       "description": "Name of the information protection policy.",
       "x-ms-parameter-location": "method"
+    },
+    "InformationProtectionPolicy": {
+      "name": "informationProtectionPolicy",
+      "in": "body",
+      "required": true,
+      "description": "Information protection policy.",
+      "schema": {
+        "$ref": "#/definitions/InformationProtectionPolicy"
+      },
+      "x-ms-parameter-location": "method"
     }
   }
 }
diff --git a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/CreateJitNetworkAccessPolicy_example.json b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/CreateJitNetworkAccessPolicy_example.json
new file mode 100644
index 000000000000..a6d2b72050f2
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/CreateJitNetworkAccessPolicy_example.json
@@ -0,0 +1,111 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "ascLocation": "westeurope",
+    "resourceGroupName": "myRg1",
+    "jitNetworkAccessPolicyName": "default",
+    "body": {
+      "kind": "Basic",
+      "properties": {
+        "virtualMachines": [
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
+            "ports": [
+              {
+                "number": 22,
+                "protocol": "*",
+                "allowedSourceAddressPrefix": "*",
+                "maxRequestAccessDuration": "PT3H"
+              },
+              {
+                "number": 3389,
+                "protocol": "*",
+                "allowedSourceAddressPrefix": "*",
+                "maxRequestAccessDuration": "PT3H"
+              }
+            ]
+          }
+        ],
+        "requests": [
+          {
+            "virtualMachines": [
+              {
+                "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
+                "ports": [
+                  {
+                    "number": 3389,
+                    "allowedSourceAddressPrefix": "192.127.0.2",
+                    "endTimeUtc": "2018-05-17T09:06:45.5691611Z",
+                    "status": "Initiated",
+                    "statusReason": "UserRequested"
+                  }
+                ]
+              }
+            ],
+            "startTimeUtc": "2018-05-17T08:06:45.5691611Z",
+            "requestor": "barbara@contoso.com"
+          }
+        ],
+        "provisioningState": "Succeeded"
+      },
+      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Security/locations/westeurope/jitNetworkAccessPolicies/default",
+      "name": "default",
+      "type": "Microsoft.Security/locations/jitNetworkAccessPolicies",
+      "location": "westeurope"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "kind": "Basic",
+        "properties": {
+          "virtualMachines": [
+            {
+              "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
+              "ports": [
+                {
+                  "number": 22,
+                  "protocol": "*",
+                  "allowedSourceAddressPrefix": "*",
+                  "maxRequestAccessDuration": "PT3H"
+                },
+                {
+                  "number": 3389,
+                  "protocol": "*",
+                  "allowedSourceAddressPrefix": "*",
+                  "maxRequestAccessDuration": "PT3H"
+                }
+              ]
+            }
+          ],
+          "requests": [
+            {
+              "virtualMachines": [
+                {
+                  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
+                  "ports": [
+                    {
+                      "number": 3389,
+                      "allowedSourceAddressPrefix": "192.127.0.2",
+                      "endTimeUtc": "2018-05-17T09:06:45.5691611Z",
+                      "status": "Initiated",
+                      "statusReason": "UserRequested"
+                    }
+                  ]
+                }
+              ],
+              "startTimeUtc": "2018-05-17T08:06:45.5691611Z",
+              "requestor": "barbara@contoso.com"
+            }
+          ],
+          "provisioningState": "Succeeded"
+        },
+        "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Security/locations/westeurope/jitNetworkAccessPolicies/default",
+        "name": "default",
+        "type": "Microsoft.Security/locations/jitNetworkAccessPolicies",
+        "location": "westeurope"
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/DeleteJitNetworkAccessPolicy_example.json b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/DeleteJitNetworkAccessPolicy_example.json
new file mode 100644
index 000000000000..6b5a94c52cc3
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/DeleteJitNetworkAccessPolicy_example.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "ascLocation": "westeurope",
+    "resourceGroupName": "myRg1",
+    "jitNetworkAccessPolicyName": "default"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/GetJitNetworkAccessPoliciesResourceGroupLocation_example.json b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/GetJitNetworkAccessPoliciesResourceGroupLocation_example.json
new file mode 100644
index 000000000000..7c9ee01bb32b
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/GetJitNetworkAccessPoliciesResourceGroupLocation_example.json
@@ -0,0 +1,66 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "ascLocation": "westeurope",
+    "resourceGroupName": "myRg1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "kind": "Basic",
+            "properties": {
+              "virtualMachines": [
+                {
+                  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
+                  "ports": [
+                    {
+                      "number": 22,
+                      "protocol": "*",
+                      "allowedSourceAddressPrefix": "*",
+                      "maxRequestAccessDuration": "PT3H"
+                    },
+                    {
+                      "number": 3389,
+                      "protocol": "*",
+                      "allowedSourceAddressPrefix": "*",
+                      "maxRequestAccessDuration": "PT3H"
+                    }
+                  ]
+                }
+              ],
+              "requests": [
+                {
+                  "virtualMachines": [
+                    {
+                      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
+                      "ports": [
+                        {
+                          "number": 3389,
+                          "allowedSourceAddressPrefix": "192.127.0.2",
+                          "endTimeUtc": "2018-05-17T09:06:45.5691611Z",
+                          "status": "Initiated",
+                          "statusReason": "UserRequested"
+                        }
+                      ]
+                    }
+                  ],
+                  "startTimeUtc": "2018-05-17T08:06:45.5691611Z",
+                  "requestor": "barbara@contoso.com",
+                  "justification": "testing a new version of the product"
+                }
+              ],
+              "provisioningState": "Succeeded"
+            },
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Security/locations/westeurope/jitNetworkAccessPolicies/default",
+            "name": "default",
+            "type": "Microsoft.Security/locations/jitNetworkAccessPolicies",
+            "location": "westeurope"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/GetJitNetworkAccessPoliciesResourceGroup_example.json b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/GetJitNetworkAccessPoliciesResourceGroup_example.json
new file mode 100644
index 000000000000..35e5db1c748d
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/GetJitNetworkAccessPoliciesResourceGroup_example.json
@@ -0,0 +1,65 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "resourceGroupName": "myRg1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "kind": "Basic",
+            "properties": {
+              "virtualMachines": [
+                {
+                  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
+                  "ports": [
+                    {
+                      "number": 22,
+                      "protocol": "*",
+                      "allowedSourceAddressPrefix": "*",
+                      "maxRequestAccessDuration": "PT3H"
+                    },
+                    {
+                      "number": 3389,
+                      "protocol": "*",
+                      "allowedSourceAddressPrefix": "*",
+                      "maxRequestAccessDuration": "PT3H"
+                    }
+                  ]
+                }
+              ],
+              "requests": [
+                {
+                  "virtualMachines": [
+                    {
+                      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
+                      "ports": [
+                        {
+                          "number": 3389,
+                          "allowedSourceAddressPrefix": "192.127.0.2",
+                          "endTimeUtc": "2018-05-17T09:06:45.5691611Z",
+                          "status": "Initiated",
+                          "statusReason": "UserRequested"
+                        }
+                      ]
+                    }
+                  ],
+                  "startTimeUtc": "2018-05-17T08:06:45.5691611Z",
+                  "requestor": "barbara@contoso.com",
+                  "justification": "testing a new version of the product"
+                }
+              ],
+              "provisioningState": "Succeeded"
+            },
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Security/locations/westeurope/jitNetworkAccessPolicies/default",
+            "name": "default",
+            "type": "Microsoft.Security/locations/jitNetworkAccessPolicies",
+            "location": "westeurope"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/GetJitNetworkAccessPoliciesSubscriptionLocation_example.json b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/GetJitNetworkAccessPoliciesSubscriptionLocation_example.json
new file mode 100644
index 000000000000..fd30dbf338ea
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/GetJitNetworkAccessPoliciesSubscriptionLocation_example.json
@@ -0,0 +1,65 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "ascLocation": "westeurope"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "kind": "Basic",
+            "properties": {
+              "virtualMachines": [
+                {
+                  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
+                  "ports": [
+                    {
+                      "number": 22,
+                      "protocol": "*",
+                      "allowedSourceAddressPrefix": "*",
+                      "maxRequestAccessDuration": "PT3H"
+                    },
+                    {
+                      "number": 3389,
+                      "protocol": "*",
+                      "allowedSourceAddressPrefix": "*",
+                      "maxRequestAccessDuration": "PT3H"
+                    }
+                  ]
+                }
+              ],
+              "requests": [
+                {
+                  "virtualMachines": [
+                    {
+                      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
+                      "ports": [
+                        {
+                          "number": 3389,
+                          "allowedSourceAddressPrefix": "192.127.0.2",
+                          "endTimeUtc": "2018-05-17T09:06:45.5691611Z",
+                          "status": "Initiated",
+                          "statusReason": "UserRequested"
+                        }
+                      ]
+                    }
+                  ],
+                  "startTimeUtc": "2018-05-17T08:06:45.5691611Z",
+                  "requestor": "barbara@contoso.com",
+                  "justification": "testing a new version of the product"
+                }
+              ],
+              "provisioningState": "Succeeded"
+            },
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Security/locations/westeurope/jitNetworkAccessPolicies/default",
+            "name": "default",
+            "type": "Microsoft.Security/locations/jitNetworkAccessPolicies",
+            "location": "westeurope"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/GetJitNetworkAccessPoliciesSubscription_example.json b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/GetJitNetworkAccessPoliciesSubscription_example.json
new file mode 100644
index 000000000000..920ad1d0824d
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/GetJitNetworkAccessPoliciesSubscription_example.json
@@ -0,0 +1,64 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "kind": "Basic",
+            "properties": {
+              "virtualMachines": [
+                {
+                  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
+                  "ports": [
+                    {
+                      "number": 22,
+                      "protocol": "*",
+                      "allowedSourceAddressPrefix": "*",
+                      "maxRequestAccessDuration": "PT3H"
+                    },
+                    {
+                      "number": 3389,
+                      "protocol": "*",
+                      "allowedSourceAddressPrefix": "*",
+                      "maxRequestAccessDuration": "PT3H"
+                    }
+                  ]
+                }
+              ],
+              "requests": [
+                {
+                  "virtualMachines": [
+                    {
+                      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
+                      "ports": [
+                        {
+                          "number": 3389,
+                          "allowedSourceAddressPrefix": "192.127.0.2",
+                          "endTimeUtc": "2018-05-17T09:06:45.5691611Z",
+                          "status": "Initiated",
+                          "statusReason": "UserRequested"
+                        }
+                      ]
+                    }
+                  ],
+                  "startTimeUtc": "2018-05-17T08:06:45.5691611Z",
+                  "requestor": "barbara@contoso.com",
+                  "justification": "testing a new version of the product"
+                }
+              ],
+              "provisioningState": "Succeeded"
+            },
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Security/locations/westeurope/jitNetworkAccessPolicies/default",
+            "name": "default",
+            "type": "Microsoft.Security/locations/jitNetworkAccessPolicies",
+            "location": "westeurope"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/GetJitNetworkAccessPolicy_example.json b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/GetJitNetworkAccessPolicy_example.json
new file mode 100644
index 000000000000..e81ccfd4cc46
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/GetJitNetworkAccessPolicy_example.json
@@ -0,0 +1,63 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "ascLocation": "westeurope",
+    "resourceGroupName": "myRg1",
+    "jitNetworkAccessPolicyName": "default"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "kind": "Basic",
+        "properties": {
+          "virtualMachines": [
+            {
+              "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
+              "ports": [
+                {
+                  "number": 22,
+                  "protocol": "*",
+                  "allowedSourceAddressPrefix": "*",
+                  "maxRequestAccessDuration": "PT3H"
+                },
+                {
+                  "number": 3389,
+                  "protocol": "*",
+                  "allowedSourceAddressPrefix": "*",
+                  "maxRequestAccessDuration": "PT3H"
+                }
+              ]
+            }
+          ],
+          "requests": [
+            {
+              "virtualMachines": [
+                {
+                  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
+                  "ports": [
+                    {
+                      "number": 3389,
+                      "allowedSourceAddressPrefix": "192.127.0.2",
+                      "endTimeUtc": "2018-05-17T09:06:45.5691611Z",
+                      "status": "Initiated",
+                      "statusReason": "UserRequested"
+                    }
+                  ]
+                }
+              ],
+              "startTimeUtc": "2018-05-17T08:06:45.5691611Z",
+              "requestor": "barbara@contoso.com",
+              "justification": "testing a new version of the product"
+            }
+          ],
+          "provisioningState": "Succeeded"
+        },
+        "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Security/locations/westeurope/jitNetworkAccessPolicies/default",
+        "name": "default",
+        "type": "Microsoft.Security/locations/jitNetworkAccessPolicies",
+        "location": "westeurope"
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/InitiateJitNetworkAccessPolicy_example.json b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/InitiateJitNetworkAccessPolicy_example.json
new file mode 100644
index 000000000000..d944942dbf0c
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/JitNetworkAccessPolicies/InitiateJitNetworkAccessPolicy_example.json
@@ -0,0 +1,48 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "ascLocation": "westeurope",
+    "resourceGroupName": "myRg1",
+    "jitNetworkAccessPolicyName": "default",
+    "jitNetworkAccessPolicyInitiateType": "initiate",
+    "body": {
+      "virtualMachines": [
+        {
+          "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
+          "ports": [
+            {
+              "number": 3389,
+              "duration": "PT1H",
+              "allowedSourceAddressPrefix": "192.127.0.2"
+            }
+          ]
+        }
+      ],
+      "justification": "testing a new version of the product"
+    }
+  },
+  "responses": {
+    "202": {
+      "body": {
+        "virtualMachines": [
+          {
+            "id": "/subscriptions/3eeab341-f466-499c-a8be-85427e154baf/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
+            "ports": [
+              {
+                "number": 3389,
+                "allowedSourceAddressPrefix": "192.127.0.2",
+                "endTimeUtc": "2018-07-12T09:53:03.3658798Z",
+                "status": "Initiating",
+                "statusReason": "UserRequested"
+              }
+            ]
+          }
+        ],
+        "startTimeUtc": "2018-07-12T08:53:03.3658798Z",
+        "requestor": "barbara@contoso.com",
+        "justification": "testing a new version of the product"
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/jitNetworkAccessPolicies.json b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/jitNetworkAccessPolicies.json
new file mode 100644
index 000000000000..9014390efee0
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/jitNetworkAccessPolicies.json
@@ -0,0 +1,770 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "Security Center",
+    "description": "API spec for Microsoft.Security (Azure Security Center) resource provider",
+    "version": "2020-01-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Security/jitNetworkAccessPolicies": {
+      "get": {
+        "x-ms-examples": {
+          "Get JIT network access policies on a subscription": {
+            "$ref": "./examples/JitNetworkAccessPolicies/GetJitNetworkAccessPoliciesSubscription_example.json"
+          }
+        },
+        "tags": [
+          "JitNetworkAccessPolicies"
+        ],
+        "description": "Policies for protecting resources using Just-in-Time access control.",
+        "operationId": "JitNetworkAccessPolicies_List",
+        "parameters": [
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/JitNetworkAccessPoliciesList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Security/locations/{ascLocation}/jitNetworkAccessPolicies": {
+      "get": {
+        "x-ms-examples": {
+          "Get JIT network access policies on a subscription from a security data location": {
+            "$ref": "./examples/JitNetworkAccessPolicies/GetJitNetworkAccessPoliciesSubscriptionLocation_example.json"
+          }
+        },
+        "tags": [
+          "JitNetworkAccessPolicies"
+        ],
+        "description": "Policies for protecting resources using Just-in-Time access control for the subscription, location",
+        "operationId": "JitNetworkAccessPolicies_ListByRegion",
+        "parameters": [
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/AscLocation"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/JitNetworkAccessPoliciesList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/jitNetworkAccessPolicies": {
+      "get": {
+        "x-ms-examples": {
+          "Get JIT network access policies on a resource group": {
+            "$ref": "./examples/JitNetworkAccessPolicies/GetJitNetworkAccessPoliciesResourceGroup_example.json"
+          }
+        },
+        "tags": [
+          "JitNetworkAccessPolicies"
+        ],
+        "description": "Policies for protecting resources using Just-in-Time access control for the subscription, location",
+        "operationId": "JitNetworkAccessPolicies_ListByResourceGroup",
+        "parameters": [
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ResourceGroupName"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/JitNetworkAccessPoliciesList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/locations/{ascLocation}/jitNetworkAccessPolicies": {
+      "get": {
+        "x-ms-examples": {
+          "Get JIT network access policies on a resource group from a security data location": {
+            "$ref": "./examples/JitNetworkAccessPolicies/GetJitNetworkAccessPoliciesResourceGroupLocation_example.json"
+          }
+        },
+        "tags": [
+          "JitNetworkAccessPolicies"
+        ],
+        "description": "Policies for protecting resources using Just-in-Time access control for the subscription, location",
+        "operationId": "JitNetworkAccessPolicies_ListByResourceGroupAndRegion",
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ResourceGroupName"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/AscLocation"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/JitNetworkAccessPoliciesList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/locations/{ascLocation}/jitNetworkAccessPolicies/{jitNetworkAccessPolicyName}": {
+      "get": {
+        "x-ms-examples": {
+          "Get JIT network access policy": {
+            "$ref": "./examples/JitNetworkAccessPolicies/GetJitNetworkAccessPolicy_example.json"
+          }
+        },
+        "tags": [
+          "JitNetworkAccessPolicies"
+        ],
+        "description": "Policies for protecting resources using Just-in-Time access control for the subscription, location",
+        "operationId": "JitNetworkAccessPolicies_Get",
+        "parameters": [
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ResourceGroupName"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/AscLocation"
+          },
+          {
+            "$ref": "#/parameters/JitNetworkAccessPolicyName"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/JitNetworkAccessPolicy"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        }
+      },
+      "put": {
+        "x-ms-examples": {
+          "Create JIT network access policy": {
+            "$ref": "./examples/JitNetworkAccessPolicies/CreateJitNetworkAccessPolicy_example.json"
+          }
+        },
+        "tags": [
+          "JitNetworkAccessPolicies"
+        ],
+        "description": "Create a policy for protecting resources using Just-in-Time access control",
+        "operationId": "JitNetworkAccessPolicies_CreateOrUpdate",
+        "parameters": [
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ResourceGroupName"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/AscLocation"
+          },
+          {
+            "$ref": "#/parameters/JitNetworkAccessPolicyName"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
+          },
+          {
+            "$ref": "#/parameters/JitNetworkAccessPolicy"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/JitNetworkAccessPolicy"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        }
+      },
+      "delete": {
+        "x-ms-examples": {
+          "Delete a JIT network access policy": {
+            "$ref": "./examples/JitNetworkAccessPolicies/DeleteJitNetworkAccessPolicy_example.json"
+          }
+        },
+        "tags": [
+          "JitNetworkAccessPolicies"
+        ],
+        "description": "Delete a Just-in-Time access control policy.",
+        "operationId": "JitNetworkAccessPolicies_Delete",
+        "parameters": [
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ResourceGroupName"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/AscLocation"
+          },
+          {
+            "$ref": "#/parameters/JitNetworkAccessPolicyName"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK - Resource was deleted"
+          },
+          "204": {
+            "description": "No Content - Resource does not exist"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/locations/{ascLocation}/jitNetworkAccessPolicies/{jitNetworkAccessPolicyName}/{jitNetworkAccessPolicyInitiateType}": {
+      "post": {
+        "x-ms-examples": {
+          "Initiate an action on a JIT network access policy": {
+            "$ref": "./examples/JitNetworkAccessPolicies/InitiateJitNetworkAccessPolicy_example.json"
+          }
+        },
+        "tags": [
+          "JitNetworkAccessPolicies"
+        ],
+        "description": "Initiate a JIT access from a specific Just-in-Time policy configuration.",
+        "operationId": "JitNetworkAccessPolicies_Initiate",
+        "parameters": [
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ResourceGroupName"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/AscLocation"
+          },
+          {
+            "$ref": "#/parameters/JitNetworkAccessPolicyName"
+          },
+          {
+            "$ref": "#/parameters/JitNetworkAccessPolicyInitiateType"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
+          },
+          {
+            "$ref": "#/parameters/JitNetworkAccessPolicyInitiateRequest"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Accepted",
+            "schema": {
+              "$ref": "#/definitions/JitNetworkAccessRequest"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "JitNetworkAccessPoliciesList": {
+      "type": "object",
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/JitNetworkAccessPolicy"
+          }
+        },
+        "nextLink": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The URI to fetch the next page."
+        }
+      }
+    },
+    "JitNetworkAccessPolicy": {
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/JitNetworkAccessPolicyProperties"
+        }
+      },
+      "required": [
+        "properties"
+      ],
+      "allOf": [
+        {
+          "$ref": "../../../common/v1/types.json#/definitions/Resource"
+        },
+        {
+          "$ref": "../../../common/v1/types.json#/definitions/Kind"
+        },
+        {
+          "$ref": "../../../common/v1/types.json#/definitions/Location"
+        }
+      ]
+    },
+    "JitNetworkAccessPolicyProperties": {
+      "type": "object",
+      "properties": {
+        "virtualMachines": {
+          "type": "array",
+          "description": "Configurations for Microsoft.Compute/virtualMachines resource type.",
+          "items": {
+            "$ref": "#/definitions/JitNetworkAccessPolicyVirtualMachine"
+          }
+        },
+        "requests": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/JitNetworkAccessRequest"
+          }
+        },
+        "provisioningState": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Gets the provisioning state of the Just-in-Time policy."
+        }
+      },
+      "required": [
+        "virtualMachines"
+      ]
+    },
+    "JitNetworkAccessPolicyVirtualMachine": {
+      "type": "object",
+      "required": [
+        "id",
+        "ports"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Resource ID of the virtual machine that is linked to this policy"
+        },
+        "ports": {
+          "type": "array",
+          "description": "Port configurations for the virtual machine",
+          "items": {
+            "$ref": "#/definitions/JitNetworkAccessPortRule"
+          }
+        },
+        "publicIpAddress": {
+          "type": "string",
+          "description": "Public IP address of the Azure Firewall that is linked to this policy, if applicable"
+        }
+      }
+    },
+    "JitNetworkAccessPortRule": {
+      "type": "object",
+      "properties": {
+        "number": {
+          "$ref": "#/definitions/PortNumber"
+        },
+        "protocol": {
+          "type": "string",
+          "enum": [
+            "TCP",
+            "UDP",
+            "*"
+          ],
+          "x-ms-enum": {
+            "name": "protocol",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "TCP"
+              },
+              {
+                "value": "UDP"
+              },
+              {
+                "value": "*",
+                "name": "All"
+              }
+            ]
+          }
+        },
+        "allowedSourceAddressPrefix": {
+          "type": "string",
+          "description": "Mutually exclusive with the \"allowedSourceAddressPrefixes\" parameter. Should be an IP address or CIDR, for example \"192.168.0.3\" or \"192.168.0.0/16\"."
+        },
+        "allowedSourceAddressPrefixes": {
+          "type": "array",
+          "description": "Mutually exclusive with the \"allowedSourceAddressPrefix\" parameter.",
+          "items": {
+            "type": "string",
+            "description": "IP address or CIDR, for example \"192.168.0.3\" or \"192.168.0.0/16\"."
+          }
+        },
+        "maxRequestAccessDuration": {
+          "type": "string",
+          "description": "Maximum duration requests can be made for. In ISO 8601 duration format. Minimum 5 minutes, maximum 1 day"
+        }
+      },
+      "required": [
+        "maxRequestAccessDuration",
+        "number",
+        "protocol"
+      ]
+    },
+    "JitNetworkAccessRequest": {
+      "type": "object",
+      "properties": {
+        "virtualMachines": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/JitNetworkAccessRequestVirtualMachine"
+          }
+        },
+        "startTimeUtc": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The start time of the request in UTC"
+        },
+        "requestor": {
+          "type": "string",
+          "description": "The identity of the person who made the request"
+        },
+        "justification": {
+          "type": "string",
+          "description": "The justification for making the initiate request"
+        }
+      },
+      "required": [
+        "requestor",
+        "startTimeUtc",
+        "virtualMachines"
+      ]
+    },
+    "JitNetworkAccessRequestVirtualMachine": {
+      "type": "object",
+      "required": [
+        "id",
+        "ports"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Resource ID of the virtual machine that is linked to this policy"
+        },
+        "ports": {
+          "type": "array",
+          "description": "The ports that were opened for the virtual machine",
+          "items": {
+            "$ref": "#/definitions/JitNetworkAccessRequestPort"
+          }
+        }
+      }
+    },
+    "JitNetworkAccessRequestPort": {
+      "type": "object",
+      "properties": {
+        "number": {
+          "$ref": "#/definitions/PortNumber"
+        },
+        "allowedSourceAddressPrefix": {
+          "type": "string",
+          "description": "Mutually exclusive with the \"allowedSourceAddressPrefixes\" parameter. Should be an IP address or CIDR, for example \"192.168.0.3\" or \"192.168.0.0/16\"."
+        },
+        "allowedSourceAddressPrefixes": {
+          "type": "array",
+          "description": "Mutually exclusive with the \"allowedSourceAddressPrefix\" parameter.",
+          "items": {
+            "description": "IP address or CIDR, for example \"192.168.0.3\" or \"192.168.0.0/16\".",
+            "type": "string"
+          }
+        },
+        "endTimeUtc": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The date & time at which the request ends in UTC"
+        },
+        "status": {
+          "type": "string",
+          "description": "The status of the port",
+          "enum": [
+            "Revoked",
+            "Initiated"
+          ],
+          "x-ms-enum": {
+            "name": "status",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "Revoked"
+              },
+              {
+                "value": "Initiated"
+              }
+            ]
+          }
+        },
+        "statusReason": {
+          "type": "string",
+          "description": "A description of why the `status` has its value",
+          "enum": [
+            "Expired",
+            "UserRequested",
+            "NewerRequestInitiated"
+          ],
+          "x-ms-enum": {
+            "name": "statusReason",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "Expired"
+              },
+              {
+                "value": "UserRequested"
+              },
+              {
+                "value": "NewerRequestInitiated"
+              }
+            ]
+          }
+        },
+        "mappedPort": {
+          "type": "integer",
+          "description": "The port which is mapped to this port's `number` in the Azure Firewall, if applicable"
+        }
+      },
+      "required": [
+        "endTimeUtc",
+        "number",
+        "status",
+        "statusReason"
+      ]
+    },
+    "JitNetworkAccessPolicyInitiateRequest": {
+      "type": "object",
+      "properties": {
+        "virtualMachines": {
+          "type": "array",
+          "description": "A list of virtual machines & ports to open access for",
+          "items": {
+            "$ref": "#/definitions/JitNetworkAccessPolicyInitiateVirtualMachine"
+          }
+        },
+        "justification": {
+          "type": "string",
+          "description": "The justification for making the initiate request"
+        }
+      },
+      "required": [
+        "virtualMachines"
+      ]
+    },
+    "JitNetworkAccessPolicyInitiateVirtualMachine": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Resource ID of the virtual machine that is linked to this policy"
+        },
+        "ports": {
+          "type": "array",
+          "description": "The ports to open for the resource with the `id`",
+          "items": {
+            "$ref": "#/definitions/JitNetworkAccessPolicyInitiatePort"
+          }
+        }
+      },
+      "required": [
+        "id",
+        "ports"
+      ]
+    },
+    "JitNetworkAccessPolicyInitiatePort": {
+      "type": "object",
+      "properties": {
+        "number": {
+          "$ref": "#/definitions/PortNumber"
+        },
+        "allowedSourceAddressPrefix": {
+          "type": "string",
+          "description": "Source of the allowed traffic. If omitted, the request will be for the source IP address of the initiate request."
+        },
+        "endTimeUtc": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The time to close the request in UTC"
+        }
+      },
+      "required": [
+        "endTimeUtc",
+        "number"
+      ]
+    },
+    "PortNumber": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 65535
+    }
+  },
+  "parameters": {
+    "JitNetworkAccessPolicyName": {
+      "name": "jitNetworkAccessPolicyName",
+      "type": "string",
+      "in": "path",
+      "required": true,
+      "description": "Name of a Just-in-Time access configuration policy.",
+      "x-ms-parameter-location": "method"
+    },
+    "JitNetworkAccessPolicyInitiateType": {
+      "name": "jitNetworkAccessPolicyInitiateType",
+      "type": "string",
+      "in": "path",
+      "required": true,
+      "description": "Type of the action to do on the Just-in-Time access policy.",
+      "enum": [
+        "initiate"
+      ],
+      "x-ms-parameter-location": "method"
+    },
+    "JitNetworkAccessPolicyInitiateRequest": {
+      "name": "body",
+      "in": "body",
+      "required": true,
+      "schema": {
+        "$ref": "#/definitions/JitNetworkAccessPolicyInitiateRequest"
+      },
+      "x-ms-parameter-location": "method"
+    },
+    "JitNetworkAccessPolicy": {
+      "name": "body",
+      "in": "body",
+      "required": true,
+      "schema": {
+        "$ref": "#/definitions/JitNetworkAccessPolicy"
+      },
+      "x-ms-parameter-location": "method"
+    }
+  }
+}
diff --git a/specification/security/resource-manager/readme.md b/specification/security/resource-manager/readme.md
index 42dbf0f1c413..f91a045107ec 100644
--- a/specification/security/resource-manager/readme.md
+++ b/specification/security/resource-manager/readme.md
@@ -141,7 +141,6 @@ input-file:
 - Microsoft.Security/stable/2019-08-01/iotSecuritySolutionAnalytics.json
 - Microsoft.Security/preview/2015-06-01-preview/discoveredSecuritySolutions.json
 - Microsoft.Security/preview/2015-06-01-preview/externalSecuritySolutions.json
-- Microsoft.Security/preview/2015-06-01-preview/jitNetworkAccessPolicies.json
 - Microsoft.Security/preview/2015-06-01-preview/applicationWhitelistings.json
 - Microsoft.Security/preview/2015-06-01-preview/locations.json
 - Microsoft.Security/preview/2015-06-01-preview/operations.json
@@ -160,6 +159,7 @@ input-file:
 - Microsoft.Security/stable/2020-01-01/adaptiveNetworkHardenings.json
 - Microsoft.Security/stable/2020-01-01/allowedConnections.json
 - Microsoft.Security/stable/2020-01-01/topologies.json
+- Microsoft.Security/stable/2020-01-01/jitNetworkAccessPolicies.json
 
 # Needed when there is more than one input file
 override-info:
@@ -375,6 +375,7 @@ input-file:
   - $(this-folder)/Microsoft.Security/stable/2020-01-01/adaptiveNetworkHardenings.json
   - $(this-folder)/Microsoft.Security/stable/2020-01-01/allowedConnections.json
   - $(this-folder)/Microsoft.Security/stable/2020-01-01/topologies.json
+  - $(this-folder)/Microsoft.Security/stable/2020-01-01/jitNetworkAccessPolicies.json
   - $(this-folder)/Microsoft.Security/preview/2019-01-01-preview/assessmentMetadata.json
   - $(this-folder)/Microsoft.Security/preview/2019-01-01-preview/assessments.json
 
diff --git a/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/SecurityInsights.json b/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/SecurityInsights.json
index adb90fac2311..b350e297b473 100644
--- a/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/SecurityInsights.json
+++ b/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/SecurityInsights.json
@@ -6087,6 +6087,38 @@
             ]
           }
         },
+        "classificationReason": {
+          "description": "The classification reason the incident was closed with",
+          "enum": [
+            "SuspiciousActivity",
+            "SuspiciousButExpected",
+            "IncorrectAlertLogic",
+            "InaccurateData"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "modelAsString": true,
+            "name": "IncidentClassificationReason",
+            "values": [
+              {
+                "description": "Classification reason was suspicious activity",
+                "value": "SuspiciousActivity"
+              },
+              {
+                "description": "Classification reason was suspicious but expected",
+                "value": "SuspiciousButExpected"
+              },
+              {
+                "description": "Classification reason was incorrect alert logic",
+                "value": "IncorrectAlertLogic"
+              },
+              {
+                "description": "Classification reason was inaccurate data",
+                "value": "InaccurateData"
+              }
+            ]
+          }
+        },
         "createdTimeUtc": {
           "description": "The time the incident was created",
           "format": "date-time",
diff --git a/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/CreateIncident.json b/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/CreateIncident.json
index 526b48d3be6a..04bd0eff45d4 100644
--- a/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/CreateIncident.json
+++ b/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/CreateIncident.json
@@ -18,6 +18,7 @@
         },
         "severity": "High",
         "classification": "FalsePositive",
+        "classificationReason": "IncorrectAlertLogic",
         "status": "Closed"
       }
     }
@@ -44,6 +45,7 @@
           },
           "severity": "High",
           "classification": "FalsePositive",
+          "classificationReason": "IncorrectAlertLogic",
           "status": "Closed",
           "incidentNumber": 3177,
           "labels": [],
@@ -78,6 +80,7 @@
           },
           "severity": "High",
           "classification": "FalsePositive",
+          "classificationReason": "IncorrectAlertLogic",
           "status": "Closed",
           "incidentNumber": 3177,
           "labels": [],
diff --git a/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/GetIncidentById.json b/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/GetIncidentById.json
index 98ce12d79286..8790d3c57762 100644
--- a/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/GetIncidentById.json
+++ b/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/GetIncidentById.json
@@ -29,6 +29,7 @@
           },
           "severity": "High",
           "classification": "FalsePositive",
+          "classificationReason": "InaccurateData",
           "status": "Closed",
           "incidentNumber": 3177,
           "labels": [],
diff --git a/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/GetIncidents.json b/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/GetIncidents.json
index 1933c0febc34..7c2900fd13d0 100644
--- a/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/GetIncidents.json
+++ b/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/GetIncidents.json
@@ -32,6 +32,7 @@
               },
               "severity": "High",
               "classification": "FalsePositive",
+              "classificationReason": "IncorrectAlertLogic",
               "status": "Closed",
               "incidentNumber": 3177,
               "labels": [],
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/preview/2019-06-01-preview/cluster.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/preview/2019-06-01-preview/cluster.json
index 572e6ed4a7bb..85538d5381ff 100644
--- a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/preview/2019-06-01-preview/cluster.json
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/preview/2019-06-01-preview/cluster.json
@@ -1112,7 +1112,7 @@
         },
         "protectedAccountKeyName2": {
           "type": "string",
-          "description": "The secondary protected diagnostics storage key name."
+          "description": "The secondary protected diagnostics storage key name. If one of the storage account keys is rotated the cluster will fallback to using the other."
         },
         "blobEndpoint": {
           "type": "string",
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/preview/2019-06-01-preview/examples/ClusterPutOperation_example_max.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/preview/2019-06-01-preview/examples/ClusterPutOperation_example_max.json
index 584bca876090..561568936819 100644
--- a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/preview/2019-06-01-preview/examples/ClusterPutOperation_example_max.json
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/preview/2019-06-01-preview/examples/ClusterPutOperation_example_max.json
@@ -5,10 +5,7 @@
     "clusterName": "myCluster",
     "api-version": "2019-06-01-preview",
     "parameters": {
-      "type": "Microsoft.ServiceFabric/clusters",
       "location": "eastus",
-      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster",
-      "name": "myCluster",
       "tags": {},
       "properties": {
         "clusterCodeVersion": "6.5.639.9590",
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/preview/2019-06-01-preview/examples/ClusterPutOperation_example_min.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/preview/2019-06-01-preview/examples/ClusterPutOperation_example_min.json
index 042817adc1ec..f4f5950f61f7 100644
--- a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/preview/2019-06-01-preview/examples/ClusterPutOperation_example_min.json
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/preview/2019-06-01-preview/examples/ClusterPutOperation_example_min.json
@@ -5,10 +5,7 @@
     "clusterName": "myCluster",
     "api-version": "2019-06-01-preview",
     "parameters": {
-      "type": "Microsoft.ServiceFabric/clusters",
       "location": "eastus",
-      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster",
-      "name": "myCluster",
       "tags": {},
       "properties": {
         "managementEndpoint": "http://myCluster.eastus.cloudapp.azure.com:19080",
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/application.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/application.json
new file mode 100644
index 000000000000..07ab2823bb8d
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/application.json
@@ -0,0 +1,2339 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ServiceFabricManagementClient",
+    "description": "Azure Service Fabric Resource Provider API Client",
+    "version": "2020-03-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "description": "Azure Active Directory OAuth2 Flow",
+      "flow": "implicit",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      },
+      "type": "oauth2"
+    }
+  },
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "paths": {
+    "/providers/Microsoft.ServiceFabric/operations": {
+      "get": {
+        "tags": [
+          "Operations"
+        ],
+        "summary": "Lists all of the available Service Fabric resource provider API operations.",
+        "description": "Get the list of available Service Fabric resource provider API operations.",
+        "operationId": "Operations_List",
+        "parameters": [
+          {
+            "name": "api-version",
+            "in": "query",
+            "description": "The version of the Service Fabric resource provider API",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/OperationListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabric/clusters/{clusterName}/applicationTypes/{applicationTypeName}": {
+      "get": {
+        "tags": [
+          "ApplicationType"
+        ],
+        "operationId": "ApplicationTypes_Get",
+        "summary": "Gets a Service Fabric application type name resource.",
+        "description": "Get a Service Fabric application type name resource created or in the process of being created in the Service Fabric cluster resource.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/applicationTypeName"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "x-ms-examples": {
+          "Get an application type": {
+            "$ref": "./examples/ApplicationTypeNameGetOperation_example.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationTypeResource"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "ApplicationType"
+        ],
+        "operationId": "ApplicationTypes_CreateOrUpdate",
+        "summary": "Creates or updates a Service Fabric application type name resource.",
+        "description": "Create or update a Service Fabric application type name resource with the specified name.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/applicationTypeName"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "description": "The application type name resource.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ApplicationTypeResource"
+            },
+            "x-ms-parameter-location": "method"
+          }
+        ],
+        "x-ms-examples": {
+          "Put an application type": {
+            "$ref": "./examples/ApplicationTypeNamePutOperation_example.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationTypeResource"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ApplicationType"
+        ],
+        "operationId": "ApplicationTypes_Delete",
+        "summary": "Deletes a Service Fabric application type name resource.",
+        "description": "Delete a Service Fabric application type name resource with the specified name.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/applicationTypeName"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "x-ms-examples": {
+          "Delete an application type": {
+            "$ref": "./examples/ApplicationTypeNameDeleteOperation_example.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "responses": {
+          "202": {
+            "description": "The request was accepted and the operation will complete asynchronously."
+          },
+          "204": {
+            "description": "The resource was not found."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabric/clusters/{clusterName}/applicationTypes": {
+      "get": {
+        "tags": [
+          "ApplicationType"
+        ],
+        "operationId": "ApplicationTypes_List",
+        "summary": "Gets the list of application type name resources created in the specified Service Fabric cluster resource.",
+        "description": "Gets all application type name resources created or in the process of being created in the Service Fabric cluster resource.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "x-ms-examples": {
+          "Get a list of application type name resources": {
+            "$ref": "./examples/ApplicationTypeNameListOperation_example.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationTypeResourceList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabric/clusters/{clusterName}/applicationTypes/{applicationTypeName}/versions/{version}": {
+      "get": {
+        "tags": [
+          "ApplicationTypeVersion"
+        ],
+        "operationId": "ApplicationTypeVersions_Get",
+        "summary": "Gets a Service Fabric application type version resource.",
+        "description": "Get a Service Fabric application type version resource created or in the process of being created in the Service Fabric application type name resource.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/applicationTypeName"
+          },
+          {
+            "$ref": "#/parameters/version"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "x-ms-examples": {
+          "Get an application type version": {
+            "$ref": "./examples/ApplicationTypeVersionGetOperation_example.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationTypeVersionResource"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "ApplicationTypeVersion"
+        ],
+        "operationId": "ApplicationTypeVersions_CreateOrUpdate",
+        "summary": "Creates or updates a Service Fabric application type version resource.",
+        "description": "Create or update a Service Fabric application type version resource with the specified name.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/applicationTypeName"
+          },
+          {
+            "$ref": "#/parameters/version"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "description": "The application type version resource.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ApplicationTypeVersionResource"
+            },
+            "x-ms-parameter-location": "method"
+          }
+        ],
+        "x-ms-examples": {
+          "Put an application type version": {
+            "$ref": "./examples/ApplicationTypeVersionPutOperation_example.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "responses": {
+          "202": {
+            "description": "The request was accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationTypeVersionResource"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ApplicationTypeVersion"
+        ],
+        "operationId": "ApplicationTypeVersions_Delete",
+        "summary": "Deletes a Service Fabric application type version resource.",
+        "description": "Delete a Service Fabric application type version resource with the specified name.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/applicationTypeName"
+          },
+          {
+            "$ref": "#/parameters/version"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "x-ms-examples": {
+          "Delete an application type version": {
+            "$ref": "./examples/ApplicationTypeVersionDeleteOperation_example.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "responses": {
+          "202": {
+            "description": "The request was accepted and the operation will complete asynchronously."
+          },
+          "204": {
+            "description": "The resource was not found."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabric/clusters/{clusterName}/applicationTypes/{applicationTypeName}/versions": {
+      "get": {
+        "tags": [
+          "ApplicationTypeVersion"
+        ],
+        "operationId": "ApplicationTypeVersions_List",
+        "summary": "Gets the list of application type version resources created in the specified Service Fabric application type name resource.",
+        "description": "Gets all application type version resources created or in the process of being created in the Service Fabric application type name resource.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/applicationTypeName"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "x-ms-examples": {
+          "Get a list of application type version resources": {
+            "$ref": "./examples/ApplicationTypeVersionListOperation_example.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationTypeVersionResourceList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabric/clusters/{clusterName}/applications/{applicationName}": {
+      "get": {
+        "tags": [
+          "Application"
+        ],
+        "operationId": "Applications_Get",
+        "summary": "Gets a Service Fabric application resource.",
+        "description": "Get a Service Fabric application resource created or in the process of being created in the Service Fabric cluster resource.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/applicationName"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "x-ms-examples": {
+          "Get an application": {
+            "$ref": "./examples/ApplicationGetOperation_example.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationResource"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Application"
+        ],
+        "operationId": "Applications_CreateOrUpdate",
+        "summary": "Creates or updates a Service Fabric application resource.",
+        "description": "Create or update a Service Fabric application resource with the specified name.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/applicationName"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "description": "The application resource.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ApplicationResource"
+            },
+            "x-ms-parameter-location": "method"
+          }
+        ],
+        "x-ms-examples": {
+          "Put an application with minimum parameters": {
+            "$ref": "./examples/ApplicationPutOperation_example_min.json"
+          },
+          "Put an application with maximum parameters": {
+            "$ref": "./examples/ApplicationPutOperation_example_max.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "responses": {
+          "202": {
+            "description": "The request was accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationResource"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "Application"
+        ],
+        "operationId": "Applications_Update",
+        "summary": "Updates a Service Fabric application resource.",
+        "description": "Update a Service Fabric application resource with the specified name.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/applicationName"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "description": "The application resource for patch operations.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ApplicationResourceUpdate"
+            },
+            "x-ms-parameter-location": "method"
+          }
+        ],
+        "x-ms-examples": {
+          "Patch an application": {
+            "$ref": "./examples/ApplicationPatchOperation_example.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "responses": {
+          "202": {
+            "description": "The request was accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationResource"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Application"
+        ],
+        "operationId": "Applications_Delete",
+        "summary": "Deletes a Service Fabric application resource.",
+        "description": "Delete a Service Fabric application resource with the specified name.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/applicationName"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "x-ms-examples": {
+          "Delete an application": {
+            "$ref": "./examples/ApplicationDeleteOperation_example.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "responses": {
+          "202": {
+            "description": "The request was accepted and the operation will complete asynchronously."
+          },
+          "204": {
+            "description": "The resource was not found."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabric/clusters/{clusterName}/applications": {
+      "get": {
+        "tags": [
+          "Application"
+        ],
+        "operationId": "Applications_List",
+        "summary": "Gets the list of application resources created in the specified Service Fabric cluster resource.",
+        "description": "Gets all application resources created or in the process of being created in the Service Fabric cluster resource.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "x-ms-examples": {
+          "Get a list of application resources": {
+            "$ref": "./examples/ApplicationListOperation_example.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationResourceList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabric/clusters/{clusterName}/applications/{applicationName}/services/{serviceName}": {
+      "get": {
+        "tags": [
+          "Service"
+        ],
+        "operationId": "Services_Get",
+        "summary": "Gets a Service Fabric service resource.",
+        "description": "Get a Service Fabric service resource created or in the process of being created in the Service Fabric application resource.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/applicationName"
+          },
+          {
+            "$ref": "#/parameters/serviceName"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "x-ms-examples": {
+          "Get a service": {
+            "$ref": "./examples/ServiceGetOperation_example.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ServiceResource"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Service"
+        ],
+        "operationId": "Services_CreateOrUpdate",
+        "summary": "Creates or updates a Service Fabric service resource.",
+        "description": "Create or update a Service Fabric service resource with the specified name.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/applicationName"
+          },
+          {
+            "$ref": "#/parameters/serviceName"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "description": "The service resource.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ServiceResource"
+            },
+            "x-ms-parameter-location": "method"
+          }
+        ],
+        "x-ms-examples": {
+          "Put a service with minimum parameters": {
+            "$ref": "./examples/ServicePutOperation_example_min.json"
+          },
+          "Put a service with maximum parameters": {
+            "$ref": "./examples/ServicePutOperation_example_max.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "responses": {
+          "202": {
+            "description": "The request was accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/ServiceResource"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "Service"
+        ],
+        "operationId": "Services_Update",
+        "summary": "Updates a Service Fabric service resource.",
+        "description": "Update a Service Fabric service resource with the specified name.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/applicationName"
+          },
+          {
+            "$ref": "#/parameters/serviceName"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "description": "The service resource for patch operations.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ServiceResourceUpdate"
+            },
+            "x-ms-parameter-location": "method"
+          }
+        ],
+        "x-ms-examples": {
+          "Patch a service": {
+            "$ref": "./examples/ServicePatchOperation_example.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "responses": {
+          "202": {
+            "description": "The request was accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/ServiceResource"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Service"
+        ],
+        "operationId": "Services_Delete",
+        "summary": "Deletes a Service Fabric service resource.",
+        "description": "Delete a Service Fabric service resource with the specified name.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/applicationName"
+          },
+          {
+            "$ref": "#/parameters/serviceName"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "x-ms-examples": {
+          "Delete a service": {
+            "$ref": "./examples/ServiceDeleteOperation_example.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "responses": {
+          "202": {
+            "description": "The request was accepted and the operation will complete asynchronously."
+          },
+          "204": {
+            "description": "The resource was not found."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabric/clusters/{clusterName}/applications/{applicationName}/services": {
+      "get": {
+        "tags": [
+          "Service"
+        ],
+        "operationId": "Services_List",
+        "summary": "Gets the list of service resources created in the specified Service Fabric application resource.",
+        "description": "Gets all service resources created or in the process of being created in the Service Fabric application resource.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/applicationName"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "x-ms-examples": {
+          "Get a list of service resources": {
+            "$ref": "./examples/ServiceListOperation_example.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ServiceResourceList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "ApplicationMetricDescription": {
+      "type": "object",
+      "description": "Describes capacity information for a custom resource balancing metric. This can be used to limit the total consumption of this metric by the services of this application.\n",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The name of the metric."
+        },
+        "maximumCapacity": {
+          "type": "integer",
+          "format": "int64",
+          "description": "The maximum node capacity for Service Fabric application.\nThis is the maximum Load for an instance of this application on a single node. Even if the capacity of node is greater than this value, Service Fabric will limit the total load of services within the application on each node to this value.\nIf set to zero, capacity for this metric is unlimited on each node.\nWhen creating a new application with application capacity defined, the product of MaximumNodes and this value must always be smaller than or equal to TotalApplicationCapacity.\nWhen updating existing application with application capacity, the product of MaximumNodes and this value must always be smaller than or equal to TotalApplicationCapacity.\n"
+        },
+        "reservationCapacity": {
+          "type": "integer",
+          "format": "int64",
+          "description": "The node reservation capacity for Service Fabric application.\nThis is the amount of load which is reserved on nodes which have instances of this application.\nIf MinimumNodes is specified, then the product of these values will be the capacity reserved in the cluster for the application.\nIf set to zero, no capacity is reserved for this metric.\nWhen setting application capacity or when updating application capacity; this value must be smaller than or equal to MaximumCapacity for each metric.\n"
+        },
+        "totalApplicationCapacity": {
+          "description": "The total metric capacity for Service Fabric application.\nThis is the total metric capacity for this application in the cluster. Service Fabric will try to limit the sum of loads of services within the application to this value.\nWhen creating a new application with application capacity defined, the product of MaximumNodes and MaximumCapacity must always be smaller than or equal to this value.\n",
+          "type": "integer",
+          "format": "int64"
+        }
+      }
+    },
+    "ApplicationMetricDescriptionList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ApplicationMetricDescription"
+      },
+      "description": "List of application capacity metric description."
+    },
+    "ApplicationParameterList": {
+      "type": "object",
+      "description": "List of application parameters with overridden values from their default values specified in the application manifest.",
+      "additionalProperties": {
+        "type": "string"
+      }
+    },
+    "ApplicationResource": {
+      "description": "The application resource.",
+      "properties": {
+        "identity": {
+          "$ref": "#/definitions/ManagedIdentity",
+          "description": "Describes the managed identities for an Azure resource."
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ApplicationResourceProperties",
+          "description": "The application resource properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ProxyResource"
+        }
+      ]
+    },
+    "ApplicationResourceList": {
+      "description": "The list of application resources.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ApplicationResource"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of application list results if there are any.",
+          "readOnly": true
+        }
+      }
+    },
+    "ApplicationResourceProperties": {
+      "description": "The application resource properties.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApplicationResourceUpdateProperties"
+        }
+      ],
+      "properties": {
+        "provisioningState": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The current deployment or provisioning state, which only appears in the response"
+        },
+        "typeName": {
+          "$ref": "#/definitions/ApplicationTypeName",
+          "description": "The application type name as defined in the application manifest."
+        }
+      }
+    },
+    "ApplicationResourceUpdate": {
+      "description": "The application resource for patch operations.",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ApplicationResourceUpdateProperties",
+          "description": "The application resource properties for patch operations."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ProxyResource"
+        }
+      ]
+    },
+    "ApplicationResourceUpdateProperties": {
+      "description": "The application resource properties for patch operations.",
+      "properties": {
+        "typeVersion": {
+          "$ref": "#/definitions/ApplicationTypeVersion",
+          "description": "The version of the application type as defined in the application manifest."
+        },
+        "parameters": {
+          "$ref": "#/definitions/ApplicationParameterList",
+          "description": "List of application parameters with overridden values from their default values specified in the application manifest."
+        },
+        "upgradePolicy": {
+          "$ref": "#/definitions/ApplicationUpgradePolicy",
+          "description": "Describes the policy for a monitored application upgrade."
+        },
+        "minimumNodes": {
+          "type": "integer",
+          "format": "int64",
+          "description": "The minimum number of nodes where Service Fabric will reserve capacity for this application. Note that this does not mean that the services of this application will be placed on all of those nodes. If this property is set to zero, no capacity will be reserved. The value of this property cannot be more than the value of the MaximumNodes property.",
+          "minimum": 0
+        },
+        "maximumNodes": {
+          "type": "integer",
+          "format": "int64",
+          "description": "The maximum number of nodes where Service Fabric will reserve capacity for this application. Note that this does not mean that the services of this application will be placed on all of those nodes. By default, the value of this property is zero and it means that the services can be placed on any node.",
+          "minimum": 0,
+          "default": 0
+        },
+        "removeApplicationCapacity": {
+          "type": "boolean",
+          "description": "Remove the current application capacity settings."
+        },
+        "metrics": {
+          "$ref": "#/definitions/ApplicationMetricDescriptionList",
+          "description": "List of application capacity metric description."
+        },
+        "managedIdentities": {
+          "description": "List of user assigned identities for the application, each mapped to a friendly name.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ApplicationUserAssignedIdentity"
+          }
+        }
+      }
+    },
+    "ApplicationTypeName": {
+      "type": "string",
+      "description": "The application type name as defined in the application manifest."
+    },
+    "ApplicationTypeParameterList": {
+      "type": "object",
+      "description": "List of application type parameters that can be overridden when creating or updating the application.",
+      "additionalProperties": {
+        "type": "string"
+      }
+    },
+    "ApplicationTypeResource": {
+      "description": "The application type name resource",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ApplicationTypeResourceProperties",
+          "description": "The application type name properties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ProxyResource"
+        }
+      ]
+    },
+    "ApplicationTypeResourceList": {
+      "description": "The list of application type names.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ApplicationTypeResource"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of application type list results if there are any.",
+          "readOnly": true
+        }
+      }
+    },
+    "ApplicationTypeResourceProperties": {
+      "description": "The application type name properties",
+      "properties": {
+        "provisioningState": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The current deployment or provisioning state, which only appears in the response."
+        }
+      }
+    },
+    "ApplicationTypeVersion": {
+      "type": "string",
+      "description": "The version of the application type as defined in the application manifest."
+    },
+    "ApplicationTypeVersionResource": {
+      "description": "An application type version resource for the specified application type name resource.",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ApplicationTypeVersionResourceProperties",
+          "description": "The properties of the application type version resource."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ProxyResource"
+        }
+      ]
+    },
+    "ApplicationTypeVersionResourceList": {
+      "description": "The list of application type version resources for the specified application type name resource.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ApplicationTypeVersionResource"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of application type version list results if there are any.",
+          "readOnly": true
+        }
+      }
+    },
+    "ApplicationTypeVersionResourceProperties": {
+      "description": "The properties of the application type version resource.",
+      "required": [
+        "appPackageUrl"
+      ],
+      "properties": {
+        "provisioningState": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The current deployment or provisioning state, which only appears in the response"
+        },
+        "appPackageUrl": {
+          "type": "string",
+          "description": "The URL to the application package"
+        },
+        "defaultParameterList": {
+          "readOnly": true,
+          "$ref": "#/definitions/ApplicationTypeParameterList",
+          "description": "List of application type parameters that can be overridden when creating or updating the application."
+        }
+      }
+    },
+    "ApplicationUpgradePolicy": {
+      "description": "Describes the policy for a monitored application upgrade.",
+      "properties": {
+        "upgradeReplicaSetCheckTimeout": {
+          "type": "string",
+          "description": "The maximum amount of time to block processing of an upgrade domain and prevent loss of availability when there are unexpected issues. When this timeout expires, processing of the upgrade domain will proceed regardless of availability loss issues. The timeout is reset at the start of each upgrade domain. Valid values are between 0 and 42949672925 inclusive. (unsigned 32-bit integer)."
+        },
+        "forceRestart": {
+          "$ref": "#/definitions/ForceRestart",
+          "description": "If true, then processes are forcefully restarted during upgrade even when the code version has not changed (the upgrade only changes configuration or data)."
+        },
+        "rollingUpgradeMonitoringPolicy": {
+          "$ref": "#/definitions/ArmRollingUpgradeMonitoringPolicy",
+          "description": "The policy used for monitoring the application upgrade"
+        },
+        "applicationHealthPolicy": {
+          "$ref": "#/definitions/ArmApplicationHealthPolicy",
+          "description": "Defines a health policy used to evaluate the health of an application or one of its children entities.\n"
+        },
+        "upgradeMode": {
+          "$ref": "#/definitions/RollingUpgradeMode",
+          "description": "The mode used to monitor health during a rolling upgrade. The values are UnmonitoredAuto, UnmonitoredManual, and Monitored."
+        }
+      }
+    },
+    "ApplicationUserAssignedIdentity": {
+      "required": [
+        "name",
+        "principalId"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The friendly name of user assigned identity."
+        },
+        "principalId": {
+          "type": "string",
+          "description": "The principal id of user assigned identity."
+        }
+      }
+    },
+    "ArmApplicationHealthPolicy": {
+      "type": "object",
+      "description": "Defines a health policy used to evaluate the health of an application or one of its children entities.\n",
+      "properties": {
+        "considerWarningAsError": {
+          "type": "boolean",
+          "description": "Indicates whether warnings are treated with the same severity as errors.",
+          "default": false
+        },
+        "maxPercentUnhealthyDeployedApplications": {
+          "type": "integer",
+          "description": "The maximum allowed percentage of unhealthy deployed applications. Allowed values are Byte values from zero to 100.\nThe percentage represents the maximum tolerated percentage of deployed applications that can be unhealthy before the application is considered in error.\nThis is calculated by dividing the number of unhealthy deployed applications over the number of nodes where the application is currently deployed on in the cluster.\nThe computation rounds up to tolerate one failure on small numbers of nodes. Default percentage is zero.\n",
+          "default": 0
+        },
+        "defaultServiceTypeHealthPolicy": {
+          "$ref": "#/definitions/ArmServiceTypeHealthPolicy",
+          "description": "The health policy used by default to evaluate the health of a service type."
+        },
+        "serviceTypeHealthPolicyMap": {
+          "$ref": "#/definitions/ArmServiceTypeHealthPolicyMap",
+          "description": "The map with service type health policy per service type name. The map is empty by default."
+        }
+      }
+    },
+    "ArmRollingUpgradeMonitoringPolicy": {
+      "description": "The policy used for monitoring the application upgrade",
+      "properties": {
+        "failureAction": {
+          "type": "string",
+          "description": "The activation Mode of the service package",
+          "enum": [
+            "Rollback",
+            "Manual"
+          ],
+          "x-ms-enum": {
+            "name": "ArmUpgradeFailureAction",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "Rollback",
+                "description": "Indicates that a rollback of the upgrade will be performed by Service Fabric if the upgrade fails."
+              },
+              {
+                "value": "Manual",
+                "description": "Indicates that a manual repair will need to be performed by the administrator if the upgrade fails. Service Fabric will not proceed to the next upgrade domain automatically."
+              }
+            ]
+          }
+        },
+        "healthCheckWaitDuration": {
+          "$ref": "#/definitions/HealthCheckWaitDuration",
+          "description": "The amount of time to wait after completing an upgrade domain before applying health policies. It is first interpreted as a string representing an ISO 8601 duration. If that fails, then it is interpreted as a number representing the total number of milliseconds."
+        },
+        "healthCheckStableDuration": {
+          "$ref": "#/definitions/HealthCheckStableDuration",
+          "description": "The amount of time that the application or cluster must remain healthy before the upgrade proceeds to the next upgrade domain. It is first interpreted as a string representing an ISO 8601 duration. If that fails, then it is interpreted as a number representing the total number of milliseconds."
+        },
+        "healthCheckRetryTimeout": {
+          "$ref": "#/definitions/HealthCheckRetryTimeout",
+          "description": "The amount of time to retry health evaluation when the application or cluster is unhealthy before FailureAction is executed. It is first interpreted as a string representing an ISO 8601 duration. If that fails, then it is interpreted as a number representing the total number of milliseconds."
+        },
+        "upgradeTimeout": {
+          "$ref": "#/definitions/UpgradeTimeout",
+          "description": "The amount of time the overall upgrade has to complete before FailureAction is executed. It is first interpreted as a string representing an ISO 8601 duration. If that fails, then it is interpreted as a number representing the total number of milliseconds."
+        },
+        "upgradeDomainTimeout": {
+          "$ref": "#/definitions/UpgradeDomainTimeout",
+          "description": "The amount of time each upgrade domain has to complete before FailureAction is executed. It is first interpreted as a string representing an ISO 8601 duration. If that fails, then it is interpreted as a number representing the total number of milliseconds."
+        }
+      }
+    },
+    "ArmServiceTypeHealthPolicy": {
+      "type": "object",
+      "description": "Represents the health policy used to evaluate the health of services belonging to a service type.\n",
+      "properties": {
+        "maxPercentUnhealthyServices": {
+          "type": "integer",
+          "description": "The maximum percentage of services allowed to be unhealthy before your application is considered in error.\n",
+          "default": 0,
+          "minimum": 0,
+          "maximum": 100
+        },
+        "maxPercentUnhealthyPartitionsPerService": {
+          "type": "integer",
+          "description": "The maximum percentage of partitions per service allowed to be unhealthy before your application is considered in error.\n",
+          "default": 0,
+          "minimum": 0,
+          "maximum": 100
+        },
+        "maxPercentUnhealthyReplicasPerPartition": {
+          "type": "integer",
+          "description": "The maximum percentage of replicas per partition allowed to be unhealthy before your application is considered in error.\n",
+          "default": 0,
+          "minimum": 0,
+          "maximum": 100
+        }
+      }
+    },
+    "ArmServiceTypeHealthPolicyMap": {
+      "type": "object",
+      "description": "Defines a ServiceTypeHealthPolicy per service type name.\n\nThe entries in the map replace the default service type health policy for each specified service type.\nFor example, in an application that contains both a stateless gateway service type and a stateful engine service type, the health policies for the stateless and stateful services can be configured differently.\nWith policy per service type, there's more granular control of the health of the service.\n\nIf no policy is specified for a service type name, the DefaultServiceTypeHealthPolicy is used for evaluation.\n",
+      "additionalProperties": {
+        "$ref": "#/definitions/ArmServiceTypeHealthPolicy"
+      }
+    },
+    "AvailableOperationDisplay": {
+      "properties": {
+        "provider": {
+          "type": "string",
+          "description": "The name of the provider."
+        },
+        "resource": {
+          "type": "string",
+          "description": "The resource on which the operation is performed"
+        },
+        "operation": {
+          "type": "string",
+          "description": "The operation that can be performed."
+        },
+        "description": {
+          "type": "string",
+          "description": "Operation description"
+        }
+      },
+      "description": "Operation supported by the Service Fabric resource provider"
+    },
+    "CorrelationSchemeList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ServiceCorrelationDescription"
+      },
+      "description": "A list that describes the correlation of the service with other services."
+    },
+    "ForceRestart": {
+      "type": "boolean",
+      "description": "If true, then processes are forcefully restarted during upgrade even when the code version has not changed (the upgrade only changes configuration or data).",
+      "default": false
+    },
+    "HealthCheckRetryTimeout": {
+      "type": "string",
+      "description": "The amount of time to retry health evaluation when the application or cluster is unhealthy before FailureAction is executed. It is first interpreted as a string representing an ISO 8601 duration. If that fails, then it is interpreted as a number representing the total number of milliseconds.",
+      "default": "PT0H10M0S"
+    },
+    "HealthCheckStableDuration": {
+      "type": "string",
+      "description": "The amount of time that the application or cluster must remain healthy before the upgrade proceeds to the next upgrade domain. It is first interpreted as a string representing an ISO 8601 duration. If that fails, then it is interpreted as a number representing the total number of milliseconds.",
+      "default": "PT0H2M0S"
+    },
+    "HealthCheckWaitDuration": {
+      "type": "string",
+      "description": "The amount of time to wait after completing an upgrade domain before applying health policies. It is first interpreted as a string representing an ISO 8601 duration. If that fails, then it is interpreted as a number representing the total number of milliseconds.",
+      "default": "0"
+    },
+    "ManagedIdentity": {
+      "description": "Describes the managed identities for an Azure resource.",
+      "properties": {
+        "principalId": {
+          "type": "string",
+          "readOnly": true,
+          "description": "The principal id of the managed identity. This property will only be provided for a system assigned identity."
+        },
+        "tenantId": {
+          "type": "string",
+          "readOnly": true,
+          "description": "The tenant id of the managed identity. This property will only be provided for a system assigned identity."
+        },
+        "type": {
+          "$ref": "#/definitions/ManagedIdentityType",
+          "description": "The type of managed identity for the resource."
+        },
+        "userAssignedIdentities": {
+          "$ref": "#/definitions/UserAssignedIdentityMap",
+          "description": "The list of user identities associated with the resource. The user identity dictionary key references will be ARM resource ids in the form:\n'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.\n"
+        }
+      }
+    },
+    "ManagedIdentityType": {
+      "type": "string",
+      "description": "The type of managed identity for the resource.",
+      "enum": [
+        "SystemAssigned",
+        "UserAssigned",
+        "SystemAssigned, UserAssigned",
+        "None"
+      ],
+      "x-ms-enum": {
+        "name": "ManagedIdentityType",
+        "modelAsString": false,
+        "values": [
+          {
+            "value": "SystemAssigned",
+            "description": "Indicates that system assigned identity is associated with the resource."
+          },
+          {
+            "value": "UserAssigned",
+            "description": "Indicates that user assigned identity is associated with the resource."
+          },
+          {
+            "value": "SystemAssigned, UserAssigned",
+            "description": "Indicates that both system assigned and user assigned identity are associated with the resource."
+          },
+          {
+            "value": "None",
+            "description": "Indicates that no identity is associated with the resource."
+          }
+        ]
+      }
+    },
+    "MoveCost": {
+      "type": "string",
+      "description": "Specifies the move cost for the service.",
+      "enum": [
+        "Zero",
+        "Low",
+        "Medium",
+        "High"
+      ],
+      "x-ms-enum": {
+        "name": "MoveCost",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Zero",
+            "description": "Zero move cost. This value is zero."
+          },
+          {
+            "value": "Low",
+            "description": "Specifies the move cost of the service as Low. The value is 1."
+          },
+          {
+            "value": "Medium",
+            "description": "Specifies the move cost of the service as Medium. The value is 2."
+          },
+          {
+            "value": "High",
+            "description": "Specifies the move cost of the service as High. The value is 3."
+          }
+        ]
+      }
+    },
+    "NamedPartitionSchemeDescription": {
+      "description": "Describes the named partition scheme of the service.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionSchemeDescription"
+        },
+        {
+          "type": "object",
+          "description": "NamedPartitionSchemeDescription"
+        }
+      ],
+      "x-ms-discriminator-value": "Named",
+      "required": [
+        "count",
+        "names"
+      ],
+      "properties": {
+        "count": {
+          "type": "integer",
+          "description": "The number of partitions."
+        },
+        "names": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Array of size specified by the ‘count’ parameter, for the names of the partitions."
+        }
+      }
+    },
+    "OperationListResult": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "description": "List of operations supported by the Service Fabric resource provider.",
+          "items": {
+            "$ref": "#/definitions/OperationResult"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of operation list results if there are any.",
+          "readOnly": true
+        }
+      },
+      "description": "Describes the result of the request to list Service Fabric resource provider operations."
+    },
+    "OperationResult": {
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The name of the operation."
+        },
+        "display": {
+          "$ref": "#/definitions/AvailableOperationDisplay",
+          "description": "The object that represents the operation."
+        },
+        "origin": {
+          "type": "string",
+          "description": "Origin result"
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "The URL to use for getting the next set of results."
+        }
+      },
+      "description": "Available operation list result"
+    },
+    "PartitionScheme": {
+      "type": "string",
+      "description": "Enumerates the ways that a service can be partitioned.",
+      "enum": [
+        "Invalid",
+        "Singleton",
+        "UniformInt64Range",
+        "Named"
+      ],
+      "x-ms-enum": {
+        "name": "PartitionScheme",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the partition kind is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "Singleton",
+            "description": "Indicates that the partition is based on string names, and is a SingletonPartitionSchemeDescription object, The value is 1."
+          },
+          {
+            "value": "UniformInt64Range",
+            "description": "Indicates that the partition is based on Int64 key ranges, and is a UniformInt64RangePartitionSchemeDescription object. The value is 2."
+          },
+          {
+            "value": "Named",
+            "description": "Indicates that the partition is based on string names, and is a NamedPartitionSchemeDescription object. The value is 3"
+          }
+        ]
+      }
+    },
+    "PartitionSchemeDescription": {
+      "type": "object",
+      "discriminator": "partitionScheme",
+      "description": "Describes how the service is partitioned.",
+      "required": [
+        "partitionScheme"
+      ],
+      "properties": {
+        "partitionScheme": {
+          "$ref": "#/definitions/PartitionScheme",
+          "description": "Specifies how the service is partitioned."
+        }
+      }
+    },
+    "ProxyResource": {
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Azure resource identifier.",
+          "readOnly": true
+        },
+        "name": {
+          "type": "string",
+          "description": "Azure resource name.",
+          "readOnly": true
+        },
+        "type": {
+          "type": "string",
+          "description": "Azure resource type.",
+          "readOnly": true
+        },
+        "location": {
+          "type": "string",
+          "description": "It will be deprecated in New API, resource location depends on the parent resource.",
+          "x-ms-mutability": [
+            "create",
+            "read"
+          ]
+        },
+        "tags": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Azure resource tags.",
+          "x-ms-mutability": [
+            "create",
+            "read"
+          ]
+        },
+        "etag": {
+          "type": "string",
+          "description": "Azure resource etag.",
+          "readOnly": true
+        }
+      },
+      "description": "The resource model definition for proxy-only resource.",
+      "x-ms-azure-resource": true
+    },
+    "RollingUpgradeMode": {
+      "type": "string",
+      "description": "The mode used to monitor health during a rolling upgrade. The values are UnmonitoredAuto, UnmonitoredManual, and Monitored.",
+      "enum": [
+        "Invalid",
+        "UnmonitoredAuto",
+        "UnmonitoredManual",
+        "Monitored"
+      ],
+      "default": "Monitored",
+      "x-ms-enum": {
+        "name": "RollingUpgradeMode",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the upgrade mode is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "UnmonitoredAuto",
+            "description": "The upgrade will proceed automatically without performing any health monitoring. The value is 1"
+          },
+          {
+            "value": "UnmonitoredManual",
+            "description": "The upgrade will stop after completing each upgrade domain, giving the opportunity to manually monitor health before proceeding. The value is 2"
+          },
+          {
+            "value": "Monitored",
+            "description": "The upgrade will stop after completing each upgrade domain and automatically monitor health before proceeding. The value is 3"
+          }
+        ]
+      }
+    },
+    "ServiceCorrelationDescription": {
+      "type": "object",
+      "description": "Creates a particular correlation between services.",
+      "required": [
+        "scheme",
+        "serviceName"
+      ],
+      "properties": {
+        "scheme": {
+          "$ref": "#/definitions/ServiceCorrelationScheme",
+          "description": "The ServiceCorrelationScheme which describes the relationship between this service and the service specified via ServiceName."
+        },
+        "serviceName": {
+          "$ref": "#/definitions/ServiceName",
+          "description": "The name of the service that the correlation relationship is established with."
+        }
+      }
+    },
+    "ServiceCorrelationScheme": {
+      "type": "string",
+      "description": "The service correlation scheme.",
+      "enum": [
+        "Invalid",
+        "Affinity",
+        "AlignedAffinity",
+        "NonAlignedAffinity"
+      ],
+      "x-ms-enum": {
+        "name": "ServiceCorrelationScheme",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "An invalid correlation scheme. Cannot be used. The value is zero."
+          },
+          {
+            "value": "Affinity",
+            "description": "Indicates that this service has an affinity relationship with another service. Provided for backwards compatibility, consider preferring the Aligned or NonAlignedAffinity options. The value is 1."
+          },
+          {
+            "value": "AlignedAffinity",
+            "description": "Aligned affinity ensures that the primaries of the partitions of the affinitized services are collocated on the same nodes. This is the default and is the same as selecting the Affinity scheme. The value is 2."
+          },
+          {
+            "value": "NonAlignedAffinity",
+            "description": "Non-Aligned affinity guarantees that all replicas of each service will be placed on the same nodes. Unlike Aligned Affinity, this does not guarantee that replicas of particular role will be collocated. The value is 3."
+          }
+        ]
+      }
+    },
+    "ServiceKind": {
+      "type": "string",
+      "description": "The kind of service (Stateless or Stateful).",
+      "enum": [
+        "Invalid",
+        "Stateless",
+        "Stateful"
+      ],
+      "x-ms-enum": {
+        "name": "ServiceKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the service kind is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "Stateless",
+            "description": "Does not use Service Fabric to make its state highly available or reliable. The value is 1."
+          },
+          {
+            "value": "Stateful",
+            "description": "Uses Service Fabric to make its state or part of its state highly available and reliable. The value is 2."
+          }
+        ]
+      }
+    },
+    "ServiceLoadMetricDescription": {
+      "type": "object",
+      "description": "Specifies a metric to load balance a service during runtime.",
+      "required": [
+        "name"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The name of the metric. If the service chooses to report load during runtime, the load metric name should match the name that is specified in Name exactly. Note that metric names are case sensitive."
+        },
+        "weight": {
+          "$ref": "#/definitions/ServiceLoadMetricWeight",
+          "description": "The service load metric relative weight, compared to other metrics configured for this service, as a number."
+        },
+        "primaryDefaultLoad": {
+          "type": "integer",
+          "description": "Used only for Stateful services. The default amount of load, as a number, that this service creates for this metric when it is a Primary replica."
+        },
+        "secondaryDefaultLoad": {
+          "type": "integer",
+          "description": "Used only for Stateful services. The default amount of load, as a number, that this service creates for this metric when it is a Secondary replica."
+        },
+        "defaultLoad": {
+          "type": "integer",
+          "description": "Used only for Stateless services. The default amount of load, as a number, that this service creates for this metric."
+        }
+      }
+    },
+    "ServiceLoadMetricsList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ServiceLoadMetricDescription"
+      },
+      "description": "The service load metrics is given as an array of ServiceLoadMetricDescription objects."
+    },
+    "ServiceLoadMetricWeight": {
+      "type": "string",
+      "description": "Determines the metric weight relative to the other metrics that are configured for this service. During runtime, if two metrics end up in conflict, the Cluster Resource Manager prefers the metric with the higher weight.",
+      "enum": [
+        "Zero",
+        "Low",
+        "Medium",
+        "High"
+      ],
+      "x-ms-enum": {
+        "name": "ServiceLoadMetricWeight",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Zero",
+            "description": "Disables resource balancing for this metric. This value is zero."
+          },
+          {
+            "value": "Low",
+            "description": "Specifies the metric weight of the service load as Low. The value is 1."
+          },
+          {
+            "value": "Medium",
+            "description": "Specifies the metric weight of the service load as Medium. The value is 2."
+          },
+          {
+            "value": "High",
+            "description": "Specifies the metric weight of the service load as High. The value is 3."
+          }
+        ]
+      }
+    },
+    "ServiceName": {
+      "type": "string",
+      "description": "The full name of the service with 'fabric:' URI scheme."
+    },
+    "ServicePlacementPoliciesList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ServicePlacementPolicyDescription"
+      },
+      "description": "A list that describes the correlation of the service with other services."
+    },
+    "ServicePlacementPolicyDescription": {
+      "type": "object",
+      "discriminator": "type",
+      "description": "Describes the policy to be used for placement of a Service Fabric service.",
+      "required": [
+        "type"
+      ],
+      "properties": {
+        "type": {
+          "$ref": "#/definitions/ServicePlacementPolicyType",
+          "description": "The type of placement policy for a service fabric service. Following are the possible values."
+        }
+      }
+    },
+    "ServicePlacementPolicyType": {
+      "type": "string",
+      "description": "The type of placement policy for a service fabric service. Following are the possible values.",
+      "enum": [
+        "Invalid",
+        "InvalidDomain",
+        "RequiredDomain",
+        "PreferredPrimaryDomain",
+        "RequiredDomainDistribution",
+        "NonPartiallyPlaceService"
+      ],
+      "x-ms-enum": {
+        "name": "ServicePlacementPolicyType",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the type of the placement policy is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "InvalidDomain",
+            "description": "Indicates that the ServicePlacementPolicyDescription is of type ServicePlacementInvalidDomainPolicyDescription, which indicates that a particular fault or upgrade domain cannot be used for placement of this service. The value is 1."
+          },
+          {
+            "value": "RequiredDomain",
+            "description": "Indicates that the ServicePlacementPolicyDescription is of type ServicePlacementRequireDomainDistributionPolicyDescription indicating that the replicas of the service must be placed in a specific domain. The value is 2."
+          },
+          {
+            "value": "PreferredPrimaryDomain",
+            "description": "Indicates that the ServicePlacementPolicyDescription is of type ServicePlacementPreferPrimaryDomainPolicyDescription, which indicates that if possible the Primary replica for the partitions of the service should be located in a particular domain as an optimization. The value is 3."
+          },
+          {
+            "value": "RequiredDomainDistribution",
+            "description": "Indicates that the ServicePlacementPolicyDescription is of type ServicePlacementRequireDomainDistributionPolicyDescription, indicating that the system will disallow placement of any two replicas from the same partition in the same domain at any time. The value is 4."
+          },
+          {
+            "value": "NonPartiallyPlaceService",
+            "description": "Indicates that the ServicePlacementPolicyDescription is of type ServicePlacementNonPartiallyPlaceServicePolicyDescription, which indicates that if possible all replicas of a particular partition of the service should be placed atomically. The value is 5."
+          }
+        ]
+      }
+    },
+    "ServiceResource": {
+      "description": "The service resource.",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ServiceResourceProperties",
+          "description": "The service resource properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ProxyResource"
+        }
+      ]
+    },
+    "ServiceResourceList": {
+      "description": "The list of service resources.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ServiceResource"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of service list results if there are any.",
+          "readOnly": true
+        }
+      }
+    },
+    "ServiceResourceProperties": {
+      "description": "The service resource properties.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServiceResourcePropertiesBase"
+        }
+      ],
+      "required": [
+        "serviceKind"
+      ],
+      "discriminator": "serviceKind",
+      "properties": {
+        "provisioningState": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The current deployment or provisioning state, which only appears in the response"
+        },
+        "serviceKind": {
+          "$ref": "#/definitions/ServiceKind",
+          "description": "The kind of service (Stateless or Stateful)."
+        },
+        "serviceTypeName": {
+          "type": "string",
+          "description": "The name of the service type"
+        },
+        "partitionDescription": {
+          "$ref": "#/definitions/PartitionSchemeDescription",
+          "description": "Describes how the service is partitioned."
+        },
+        "servicePackageActivationMode": {
+          "type": "string",
+          "description": "The activation Mode of the service package",
+          "enum": [
+            "SharedProcess",
+            "ExclusiveProcess"
+          ],
+          "x-ms-enum": {
+            "name": "ArmServicePackageActivationMode",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "SharedProcess",
+                "description": "Indicates the application package activation mode will use shared process."
+              },
+              {
+                "value": "ExclusiveProcess",
+                "description": "Indicates the application package activation mode will use exclusive process."
+              }
+            ]
+          }
+        }
+      }
+    },
+    "ServiceResourcePropertiesBase": {
+      "description": "The common service resource properties.",
+      "properties": {
+        "placementConstraints": {
+          "type": "string",
+          "description": "The placement constraints as a string. Placement constraints are boolean expressions on node properties and allow for restricting a service to particular nodes based on the service requirements. For example, to place a service on nodes where NodeType is blue specify the following: \"NodeColor == blue)\"."
+        },
+        "correlationScheme": {
+          "$ref": "#/definitions/CorrelationSchemeList",
+          "description": "A list that describes the correlation of the service with other services."
+        },
+        "serviceLoadMetrics": {
+          "$ref": "#/definitions/ServiceLoadMetricsList",
+          "description": "The service load metrics is given as an array of ServiceLoadMetricDescription objects."
+        },
+        "servicePlacementPolicies": {
+          "$ref": "#/definitions/ServicePlacementPoliciesList",
+          "description": "A list that describes the correlation of the service with other services."
+        },
+        "defaultMoveCost": {
+          "$ref": "#/definitions/MoveCost",
+          "description": "Specifies the move cost for the service."
+        }
+      }
+    },
+    "ServiceResourceUpdate": {
+      "description": "The service resource for patch operations.",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ServiceResourceUpdateProperties",
+          "description": "The service resource properties for patch operations."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ProxyResource"
+        }
+      ]
+    },
+    "ServiceResourceUpdateProperties": {
+      "description": "The service resource properties for patch operations.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServiceResourcePropertiesBase"
+        }
+      ],
+      "required": [
+        "serviceKind"
+      ],
+      "discriminator": "serviceKind",
+      "properties": {
+        "serviceKind": {
+          "$ref": "#/definitions/ServiceKind",
+          "description": "The kind of service (Stateless or Stateful)."
+        }
+      }
+    },
+    "SingletonPartitionSchemeDescription": {
+      "description": "Describes the partition scheme of a singleton-partitioned, or non-partitioned service.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionSchemeDescription"
+        },
+        {
+          "type": "object",
+          "description": "SingletonPartitionSchemeDescription"
+        }
+      ],
+      "x-ms-discriminator-value": "Singleton"
+    },
+    "StatefulServiceProperties": {
+      "description": "The properties of a stateful service resource.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServiceResourceProperties"
+        }
+      ],
+      "x-ms-discriminator-value": "Stateful",
+      "properties": {
+        "hasPersistedState": {
+          "type": "boolean",
+          "description": "A flag indicating whether this is a persistent service which stores states on the local disk. If it is then the value of this property is true, if not it is false."
+        },
+        "targetReplicaSetSize": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "The target replica set size as a number."
+        },
+        "minReplicaSetSize": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "The minimum replica set size as a number."
+        },
+        "replicaRestartWaitDuration": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The duration between when a replica goes down and when a new replica is created, represented in ISO 8601 format (hh:mm:ss.s)."
+        },
+        "quorumLossWaitDuration": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The maximum duration for which a partition is allowed to be in a state of quorum loss, represented in ISO 8601 format (hh:mm:ss.s)."
+        },
+        "standByReplicaKeepDuration": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The definition on how long StandBy replicas should be maintained before being removed, represented in ISO 8601 format (hh:mm:ss.s)."
+        }
+      }
+    },
+    "StatefulServiceUpdateProperties": {
+      "description": "The properties of a stateful service resource for patch operations.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServiceResourceUpdateProperties"
+        }
+      ],
+      "x-ms-discriminator-value": "Stateful",
+      "properties": {
+        "targetReplicaSetSize": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "The target replica set size as a number."
+        },
+        "minReplicaSetSize": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "The minimum replica set size as a number."
+        },
+        "replicaRestartWaitDuration": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The duration between when a replica goes down and when a new replica is created, represented in ISO 8601 format (hh:mm:ss.s)."
+        },
+        "quorumLossWaitDuration": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The maximum duration for which a partition is allowed to be in a state of quorum loss, represented in ISO 8601 format (hh:mm:ss.s)."
+        },
+        "standByReplicaKeepDuration": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The definition on how long StandBy replicas should be maintained before being removed, represented in ISO 8601 format (hh:mm:ss.s)."
+        }
+      }
+    },
+    "StatelessServiceProperties": {
+      "description": "The properties of a stateless service resource.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServiceResourceProperties"
+        }
+      ],
+      "x-ms-discriminator-value": "Stateless",
+      "properties": {
+        "instanceCount": {
+          "type": "integer",
+          "minimum": -1,
+          "description": "The instance count."
+        }
+      }
+    },
+    "StatelessServiceUpdateProperties": {
+      "description": "The properties of a stateless service resource for patch operations.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServiceResourceUpdateProperties"
+        }
+      ],
+      "x-ms-discriminator-value": "Stateless",
+      "properties": {
+        "instanceCount": {
+          "type": "integer",
+          "minimum": -1,
+          "description": "The instance count."
+        }
+      }
+    },
+    "UserAssignedIdentity": {
+      "properties": {
+        "principalId": {
+          "type": "string",
+          "readOnly": true,
+          "description": "The principal id of user assigned identity."
+        },
+        "clientId": {
+          "type": "string",
+          "readOnly": true,
+          "description": "The client id of user assigned identity."
+        }
+      }
+    },
+    "UserAssignedIdentityMap": {
+      "type": "object",
+      "description": "The list of user identities associated with the resource. The user identity dictionary key references will be ARM resource ids in the form:\n'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.\n",
+      "additionalProperties": {
+        "$ref": "#/definitions/UserAssignedIdentity"
+      }
+    },
+    "UniformInt64RangePartitionSchemeDescription": {
+      "description": "Describes a partitioning scheme where an integer range is allocated evenly across a number of partitions.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionSchemeDescription"
+        },
+        {
+          "type": "object",
+          "description": "UniformInt64RangePartitionSchemeDescription"
+        }
+      ],
+      "x-ms-discriminator-value": "UniformInt64Range",
+      "required": [
+        "count",
+        "lowKey",
+        "highKey"
+      ],
+      "properties": {
+        "count": {
+          "type": "integer",
+          "description": "The number of partitions."
+        },
+        "lowKey": {
+          "type": "string",
+          "description": "String indicating the lower bound of the partition key range that\nshould be split between the partition ‘count’\n"
+        },
+        "highKey": {
+          "type": "string",
+          "description": "String indicating the upper bound of the partition key range that\nshould be split between the partition ‘count’\n"
+        }
+      }
+    },
+    "UpgradeDomainTimeout": {
+      "type": "string",
+      "description": "The amount of time each upgrade domain has to complete before FailureAction is executed. It is first interpreted as a string representing an ISO 8601 duration. If that fails, then it is interpreted as a number representing the total number of milliseconds.",
+      "default": "P10675199DT02H48M05.4775807S"
+    },
+    "UpgradeTimeout": {
+      "type": "string",
+      "description": "The amount of time the overall upgrade has to complete before FailureAction is executed. It is first interpreted as a string representing an ISO 8601 duration. If that fails, then it is interpreted as a number representing the total number of milliseconds.",
+      "default": "P10675199DT02H48M05.4775807S"
+    },
+    "ErrorModel": {
+      "properties": {
+        "error": {
+          "$ref": "#/definitions/ErrorModelError",
+          "description": "The error details."
+        }
+      },
+      "description": "The structure of the error."
+    },
+    "ErrorModelError": {
+      "properties": {
+        "code": {
+          "type": "string",
+          "description": "The error code."
+        },
+        "message": {
+          "type": "string",
+          "description": "The error message."
+        }
+      },
+      "description": "The error details."
+    }
+  },
+  "parameters": {
+    "api-version": {
+      "name": "api-version",
+      "in": "query",
+      "description": "The version of the Service Fabric resource provider API. This is a required parameter and it's value must be \"2020-03-01\" for this specification.",
+      "required": true,
+      "type": "string",
+      "enum": [
+        "2020-03-01"
+      ],
+      "default": "2020-03-01",
+      "x-ms-parameter-location": "client"
+    },
+    "applicationName": {
+      "name": "applicationName",
+      "in": "path",
+      "description": "The name of the application resource.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "applicationTypeName": {
+      "name": "applicationTypeName",
+      "in": "path",
+      "description": "The name of the application type name resource.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "clusterNameParameter": {
+      "name": "clusterName",
+      "in": "path",
+      "description": "The name of the cluster resource.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "resourceGroupNameParameter": {
+      "name": "resourceGroupName",
+      "in": "path",
+      "description": "The name of the resource group.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "serviceName": {
+      "name": "serviceName",
+      "in": "path",
+      "description": "The name of the service resource in the format of {applicationName}~{serviceName}.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "subscriptionId": {
+      "name": "subscriptionId",
+      "in": "path",
+      "description": "The customer subscription identifier.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "client"
+    },
+    "version": {
+      "name": "version",
+      "in": "path",
+      "description": "The application type version.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/cluster.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/cluster.json
new file mode 100644
index 000000000000..687093eee790
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/cluster.json
@@ -0,0 +1,1538 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ServiceFabricManagementClient",
+    "description": "Azure Service Fabric Resource Provider API Client",
+    "version": "2020-03-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "description": "Azure Active Directory OAuth2 Flow",
+      "flow": "implicit",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      },
+      "type": "oauth2"
+    }
+  },
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabric/clusters/{clusterName}": {
+      "get": {
+        "tags": [
+          "Cluster"
+        ],
+        "operationId": "Clusters_Get",
+        "summary": "Gets a Service Fabric cluster resource.",
+        "description": "Get a Service Fabric cluster resource created or in the process of being created in the specified resource group.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          }
+        ],
+        "x-ms-examples": {
+          "Get a cluster": {
+            "$ref": "./examples/ClusterGetOperation_example.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/Cluster"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Cluster"
+        ],
+        "operationId": "Clusters_CreateOrUpdate",
+        "summary": "Creates or updates a Service Fabric cluster resource.",
+        "description": "Create or update a Service Fabric cluster resource with the specified name.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "description": "The cluster resource.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/Cluster"
+            },
+            "x-ms-parameter-location": "method"
+          }
+        ],
+        "x-ms-examples": {
+          "Put a cluster with minimum parameters": {
+            "$ref": "./examples/ClusterPutOperation_example_min.json"
+          },
+          "Put a cluster with maximum parameters": {
+            "$ref": "./examples/ClusterPutOperation_example_max.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/Cluster"
+            }
+          },
+          "202": {
+            "description": "The request was accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/Cluster"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "Cluster"
+        ],
+        "operationId": "Clusters_Update",
+        "summary": "Updates the configuration of a Service Fabric cluster resource.",
+        "description": "Update the configuration of a Service Fabric cluster resource with the specified name.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "description": "The parameters which contains the property value and property name which used to update the cluster configuration.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ClusterUpdateParameters"
+            },
+            "x-ms-parameter-location": "method"
+          }
+        ],
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Patch a cluster": {
+            "$ref": "./examples/ClusterPatchOperation_example.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/Cluster"
+            }
+          },
+          "202": {
+            "description": "The request was accepted and the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/Cluster"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Cluster"
+        ],
+        "operationId": "Clusters_Delete",
+        "summary": "Deletes a Service Fabric cluster resource.",
+        "description": "Delete a Service Fabric cluster resource with the specified name.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/clusterNameParameter"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          }
+        ],
+        "x-ms-examples": {
+          "Delete a cluster": {
+            "$ref": "./examples/ClusterDeleteOperation_example.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully."
+          },
+          "204": {
+            "description": "The resource was not found."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceFabric/clusters": {
+      "get": {
+        "operationId": "Clusters_ListByResourceGroup",
+        "summary": "Gets the list of Service Fabric cluster resources created in the specified resource group.",
+        "description": "Gets all Service Fabric cluster resources created or in the process of being created in the resource group.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/resourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          }
+        ],
+        "tags": [
+          "Cluster"
+        ],
+        "x-ms-examples": {
+          "List cluster by resource group": {
+            "$ref": "./examples/ClusterListByResourceGroupOperation_example.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ClusterListResult"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.ServiceFabric/clusters": {
+      "get": {
+        "operationId": "Clusters_List",
+        "summary": "Gets the list of Service Fabric cluster resources created in the specified subscription.",
+        "description": "Gets all Service Fabric cluster resources created or in the process of being created in the subscription.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          }
+        ],
+        "tags": [
+          "Cluster"
+        ],
+        "x-ms-examples": {
+          "List clusters": {
+            "$ref": "./examples/ClusterListOperation_example.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ClusterListResult"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.ServiceFabric/locations/{location}/clusterVersions/{clusterVersion}": {
+      "get": {
+        "operationId": "ClusterVersions_Get",
+        "summary": "Gets information about a Service Fabric cluster code version available in the specified location.",
+        "description": "Gets information about an available Service Fabric cluster code version.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/locationForClusterCodeVersions"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/clusterVersion"
+          }
+        ],
+        "x-ms-examples": {
+          "Get cluster version": {
+            "$ref": "./examples/ClusterVersionsGet_example.json"
+          }
+        },
+        "tags": [
+          "ClusterVersion"
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ClusterCodeVersionsListResult"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.ServiceFabric/locations/{location}/environments/{environment}/clusterVersions/{clusterVersion}": {
+      "get": {
+        "operationId": "ClusterVersions_GetByEnvironment",
+        "summary": "Gets information about a Service Fabric cluster code version available for the specified environment.",
+        "description": "Gets information about an available Service Fabric cluster code version by environment.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/locationForClusterCodeVersions"
+          },
+          {
+            "$ref": "#/parameters/environment"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/clusterVersion"
+          }
+        ],
+        "x-ms-examples": {
+          "Get cluster version by environment": {
+            "$ref": "./examples/ClusterVersionsGetByEnvironment_example.json"
+          }
+        },
+        "tags": [
+          "ClusterVersion"
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ClusterCodeVersionsListResult"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.ServiceFabric/locations/{location}/clusterVersions": {
+      "get": {
+        "operationId": "ClusterVersions_List",
+        "summary": "Gets the list of Service Fabric cluster code versions available for the specified location.",
+        "description": "Gets all available code versions for Service Fabric cluster resources by location.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/locationForClusterCodeVersions"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          }
+        ],
+        "x-ms-examples": {
+          "List cluster versions": {
+            "$ref": "./examples/ClusterVersionsList_example.json"
+          }
+        },
+        "tags": [
+          "ClusterVersion"
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ClusterCodeVersionsListResult"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.ServiceFabric/locations/{location}/environments/{environment}/clusterVersions": {
+      "get": {
+        "operationId": "ClusterVersions_ListByEnvironment",
+        "summary": "Gets the list of Service Fabric cluster code versions available for the specified environment.",
+        "description": "Gets all available code versions for Service Fabric cluster resources by environment.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/locationForClusterCodeVersions"
+          },
+          {
+            "$ref": "#/parameters/environment"
+          },
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          }
+        ],
+        "x-ms-examples": {
+          "List cluster versions by environment": {
+            "$ref": "./examples/ClusterVersionsListByEnvironment.json"
+          }
+        },
+        "tags": [
+          "ClusterVersion"
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ClusterCodeVersionsListResult"
+            }
+          }
+        }
+      }
+    },
+    "/providers/Microsoft.ServiceFabric/operations": {
+      "get": {
+        "tags": [
+          "Operations"
+        ],
+        "summary": "Lists all of the available Service Fabric resource provider API operations.",
+        "description": "Get the list of available Service Fabric resource provider API operations.",
+        "operationId": "Operations_List",
+        "parameters": [
+          {
+            "name": "api-version",
+            "in": "query",
+            "description": "The version of the Service Fabric resource provider API",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/OperationListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorModel"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    }
+  },
+  "definitions": {
+    "AddOnFeatures": {
+      "type": "string",
+      "description": "Available cluster add-on features",
+      "enum": [
+        "RepairManager",
+        "DnsService",
+        "BackupRestoreService",
+        "ResourceMonitorService"
+      ]
+    },
+    "ApplicationDeltaHealthPolicy": {
+      "type": "object",
+      "description": "Defines a delta health policy used to evaluate the health of an application or one of its child entities when upgrading the cluster.\n",
+      "properties": {
+        "defaultServiceTypeDeltaHealthPolicy": {
+          "$ref": "#/definitions/ServiceTypeDeltaHealthPolicy",
+          "description": "The delta health policy used by default to evaluate the health of a service type when upgrading the cluster."
+        },
+        "serviceTypeDeltaHealthPolicies": {
+          "$ref": "#/definitions/ServiceTypeDeltaHealthPolicyMap",
+          "description": "The map with service type delta health policy per service type name. The map is empty by default."
+        }
+      }
+    },
+    "ApplicationDeltaHealthPolicyMap": {
+      "type": "object",
+      "description": "Defines a map that contains specific application delta health policies for different applications.\nEach entry specifies as key the application name and as value an ApplicationDeltaHealthPolicy used to evaluate the application health when upgrading the cluster.\nThe application name should include the 'fabric:' URI scheme.\nThe map is empty by default.\n",
+      "additionalProperties": {
+        "$ref": "#/definitions/ApplicationDeltaHealthPolicy"
+      }
+    },
+    "ApplicationHealthPolicy": {
+      "type": "object",
+      "description": "Defines a health policy used to evaluate the health of an application or one of its children entities.\n",
+      "properties": {
+        "defaultServiceTypeHealthPolicy": {
+          "$ref": "#/definitions/ServiceTypeHealthPolicy",
+          "description": "The health policy used by default to evaluate the health of a service type."
+        },
+        "serviceTypeHealthPolicies": {
+          "$ref": "#/definitions/ServiceTypeHealthPolicyMap",
+          "description": "The map with service type health policy per service type name. The map is empty by default."
+        }
+      }
+    },
+    "ApplicationHealthPolicyMap": {
+      "type": "object",
+      "description": "Defines a map that contains specific application health policies for different applications.\nEach entry specifies as key the application name and as value an ApplicationHealthPolicy used to evaluate the application health.\nThe application name should include the 'fabric:' URI scheme.\nThe map is empty by default.\n",
+      "additionalProperties": {
+        "$ref": "#/definitions/ApplicationHealthPolicy"
+      }
+    },
+    "AvailableOperationDisplay": {
+      "properties": {
+        "provider": {
+          "type": "string",
+          "description": "The name of the provider."
+        },
+        "resource": {
+          "type": "string",
+          "description": "The resource on which the operation is performed"
+        },
+        "operation": {
+          "type": "string",
+          "description": "The operation that can be performed."
+        },
+        "description": {
+          "type": "string",
+          "description": "Operation description"
+        }
+      },
+      "description": "Operation supported by the Service Fabric resource provider"
+    },
+    "AzureActiveDirectory": {
+      "properties": {
+        "tenantId": {
+          "type": "string",
+          "description": "Azure active directory tenant id."
+        },
+        "clusterApplication": {
+          "type": "string",
+          "description": "Azure active directory cluster application id."
+        },
+        "clientApplication": {
+          "type": "string",
+          "description": "Azure active directory client application id."
+        }
+      },
+      "description": "The settings to enable AAD authentication on the cluster."
+    },
+    "CertificateDescription": {
+      "required": [
+        "thumbprint"
+      ],
+      "properties": {
+        "thumbprint": {
+          "type": "string",
+          "description": "Thumbprint of the primary certificate."
+        },
+        "thumbprintSecondary": {
+          "type": "string",
+          "description": "Thumbprint of the secondary certificate."
+        },
+        "x509StoreName": {
+          "$ref": "#/definitions/StoreName",
+          "description": "The local certificate store location."
+        }
+      },
+      "description": "Describes the certificate details."
+    },
+    "ClientCertificateCommonName": {
+      "required": [
+        "certificateCommonName",
+        "isAdmin",
+        "certificateIssuerThumbprint"
+      ],
+      "properties": {
+        "isAdmin": {
+          "type": "boolean",
+          "description": "Indicates if the client certificate has admin access to the cluster. Non admin clients can perform only read only operations on the cluster."
+        },
+        "certificateCommonName": {
+          "type": "string",
+          "description": "The common name of the client certificate."
+        },
+        "certificateIssuerThumbprint": {
+          "type": "string",
+          "description": "The issuer thumbprint of the client certificate."
+        }
+      },
+      "description": "Describes the client certificate details using common name."
+    },
+    "ClientCertificateThumbprint": {
+      "required": [
+        "certificateThumbprint",
+        "isAdmin"
+      ],
+      "properties": {
+        "isAdmin": {
+          "type": "boolean",
+          "description": "Indicates if the client certificate has admin access to the cluster. Non admin clients can perform only read only operations on the cluster."
+        },
+        "certificateThumbprint": {
+          "type": "string",
+          "description": "The thumbprint of the client certificate."
+        }
+      },
+      "description": "Describes the client certificate details using thumbprint."
+    },
+    "Cluster": {
+      "type": "object",
+      "description": "The cluster resource\n",
+      "allOf": [
+        {
+          "description": "The cluster resource properties"
+        },
+        {
+          "$ref": "#/definitions/Resource"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "properties": {
+              "x-ms-client-flatten": true,
+              "$ref": "#/definitions/ClusterProperties",
+              "description": "The cluster resource properties"
+            }
+          }
+        }
+      ]
+    },
+    "ClusterCodeVersionsListResult": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ClusterCodeVersionsResult"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "The URL to use for getting the next set of results."
+        }
+      },
+      "description": "The list results of the Service Fabric runtime versions."
+    },
+    "ClusterCodeVersionsResult": {
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "The identification of the result"
+        },
+        "name": {
+          "type": "string",
+          "description": "The name of the result"
+        },
+        "type": {
+          "type": "string",
+          "description": "The result resource type"
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ClusterVersionDetails",
+          "description": "The detail of the Service Fabric runtime version result"
+        }
+      },
+      "description": "The result of the Service Fabric runtime versions"
+    },
+    "ClusterEnvironment": {
+      "type": "string",
+      "description": "Cluster operating system, the default will be Windows",
+      "enum": [
+        "Windows",
+        "Linux"
+      ]
+    },
+    "ClusterHealthPolicy": {
+      "type": "object",
+      "description": "Defines a health policy used to evaluate the health of the cluster or of a cluster node.\n",
+      "properties": {
+        "maxPercentUnhealthyNodes": {
+          "type": "integer",
+          "description": "The maximum allowed percentage of unhealthy nodes before reporting an error. For example, to allow 10% of nodes to be unhealthy, this value would be 10.\n\nThe percentage represents the maximum tolerated percentage of nodes that can be unhealthy before the cluster is considered in error.\nIf the percentage is respected but there is at least one unhealthy node, the health is evaluated as Warning.\nThe percentage is calculated by dividing the number of unhealthy nodes over the total number of nodes in the cluster.\nThe computation rounds up to tolerate one failure on small numbers of nodes. Default percentage is zero.\n\nIn large clusters, some nodes will always be down or out for repairs, so this percentage should be configured to tolerate that.\n",
+          "default": 0,
+          "minimum": 0,
+          "maximum": 100
+        },
+        "maxPercentUnhealthyApplications": {
+          "type": "integer",
+          "description": "The maximum allowed percentage of unhealthy applications before reporting an error. For example, to allow 10% of applications to be unhealthy, this value would be 10.\n\nThe percentage represents the maximum tolerated percentage of applications that can be unhealthy before the cluster is considered in error.\nIf the percentage is respected but there is at least one unhealthy application, the health is evaluated as Warning.\nThis is calculated by dividing the number of unhealthy applications over the total number of application instances in the cluster, excluding applications of application types that are included in the ApplicationTypeHealthPolicyMap.\nThe computation rounds up to tolerate one failure on small numbers of applications. Default percentage is zero.\n",
+          "default": 0,
+          "minimum": 0,
+          "maximum": 100
+        },
+        "applicationHealthPolicies": {
+          "$ref": "#/definitions/ApplicationHealthPolicyMap",
+          "description": "Defines the application health policy map used to evaluate the health of an application or one of its children entities."
+        }
+      }
+    },
+    "ClusterListResult": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Cluster"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "The URL to use for getting the next set of results."
+        }
+      },
+      "description": "Cluster list results"
+    },
+    "ClusterProperties": {
+      "required": [
+        "managementEndpoint",
+        "nodeTypes"
+      ],
+      "properties": {
+        "addOnFeatures": {
+          "type": "array",
+          "description": "The list of add-on features to enable in the cluster.",
+          "items": {
+            "$ref": "#/definitions/AddOnFeatures"
+          }
+        },
+        "availableClusterVersions": {
+          "type": "array",
+          "description": "The Service Fabric runtime versions available for this cluster.",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/ClusterVersionDetails"
+          }
+        },
+        "azureActiveDirectory": {
+          "$ref": "#/definitions/AzureActiveDirectory",
+          "description": "The AAD authentication settings of the cluster."
+        },
+        "certificate": {
+          "$ref": "#/definitions/CertificateDescription",
+          "description": "The certificate to use for securing the cluster. The certificate provided will be used for node to node security within the cluster, SSL certificate for cluster management endpoint and default admin client."
+        },
+        "certificateCommonNames": {
+          "$ref": "#/definitions/ServerCertificateCommonNames",
+          "description": "Describes a list of server certificates referenced by common name that are used to secure the cluster."
+        },
+        "clientCertificateCommonNames": {
+          "type": "array",
+          "description": "The list of client certificates referenced by common name that are allowed to manage the cluster.",
+          "items": {
+            "$ref": "#/definitions/ClientCertificateCommonName"
+          }
+        },
+        "clientCertificateThumbprints": {
+          "type": "array",
+          "description": "The list of client certificates referenced by thumbprint that are allowed to manage the cluster.",
+          "items": {
+            "$ref": "#/definitions/ClientCertificateThumbprint"
+          }
+        },
+        "clusterCodeVersion": {
+          "type": "string",
+          "description": "The Service Fabric runtime version of the cluster. This property can only by set the user when **upgradeMode** is set to 'Manual'. To get list of available Service Fabric versions for new clusters use [ClusterVersion API](./ClusterVersion.md). To get the list of available version for existing clusters use **availableClusterVersions**."
+        },
+        "clusterEndpoint": {
+          "type": "string",
+          "description": "The Azure Resource Provider endpoint. A system service in the cluster connects to this  endpoint.",
+          "readOnly": true
+        },
+        "clusterId": {
+          "type": "string",
+          "description": "A service generated unique identifier for the cluster resource.",
+          "readOnly": true
+        },
+        "clusterState": {
+          "readOnly": true,
+          "$ref": "#/definitions/ClusterState",
+          "description": "The current state of the cluster.\n\n  - WaitingForNodes - Indicates that the cluster resource is created and the resource provider is waiting for Service Fabric VM extension to boot up and report to it.\n  - Deploying - Indicates that the Service Fabric runtime is being installed on the VMs. Cluster resource will be in this state until the cluster boots up and system services are up.\n  - BaselineUpgrade - Indicates that the cluster is upgrading to establishes the cluster version. This upgrade is automatically initiated when the cluster boots up for the first time.\n  - UpdatingUserConfiguration - Indicates that the cluster is being upgraded with the user provided configuration.\n  - UpdatingUserCertificate - Indicates that the cluster is being upgraded with the user provided certificate.\n  - UpdatingInfrastructure - Indicates that the cluster is being upgraded with the latest Service Fabric runtime version. This happens only when the **upgradeMode** is set to 'Automatic'.\n  - EnforcingClusterVersion - Indicates that cluster is on a different version than expected and the cluster is being upgraded to the expected version.\n  - UpgradeServiceUnreachable - Indicates that the system service in the cluster is no longer polling the Resource Provider. Clusters in this state cannot be managed by the Resource Provider.\n  - AutoScale - Indicates that the ReliabilityLevel of the cluster is being adjusted.\n  - Ready - Indicates that the cluster is in a stable state.\n"
+        },
+        "diagnosticsStorageAccountConfig": {
+          "$ref": "#/definitions/DiagnosticsStorageAccountConfig",
+          "description": "The storage account information for storing Service Fabric diagnostic logs."
+        },
+        "eventStoreServiceEnabled": {
+          "type": "boolean",
+          "description": "Indicates if the event store service is enabled."
+        },
+        "fabricSettings": {
+          "type": "array",
+          "description": "The list of custom fabric settings to configure the cluster.",
+          "items": {
+            "$ref": "#/definitions/SettingsSectionDescription"
+          }
+        },
+        "managementEndpoint": {
+          "type": "string",
+          "description": "The http management endpoint of the cluster."
+        },
+        "nodeTypes": {
+          "type": "array",
+          "description": "The list of node types in the cluster.",
+          "items": {
+            "$ref": "#/definitions/NodeTypeDescription"
+          }
+        },
+        "provisioningState": {
+          "type": "string",
+          "description": "The provisioning state of the cluster resource.",
+          "readOnly": true,
+          "enum": [
+            "Updating",
+            "Succeeded",
+            "Failed",
+            "Canceled"
+          ],
+          "x-ms-enum": {
+            "name": "ProvisioningState",
+            "modelAsString": true
+          }
+        },
+        "reliabilityLevel": {
+          "$ref": "#/definitions/ReliabilityLevel",
+          "description": "The reliability level sets the replica set size of system services. Learn about [ReliabilityLevel](https://docs.microsoft.com/azure/service-fabric/service-fabric-cluster-capacity).\n\n  - None - Run the System services with a target replica set count of 1. This should only be used for test clusters.\n  - Bronze - Run the System services with a target replica set count of 3. This should only be used for test clusters.\n  - Silver - Run the System services with a target replica set count of 5.\n  - Gold - Run the System services with a target replica set count of 7.\n  - Platinum - Run the System services with a target replica set count of 9.\n"
+        },
+        "reverseProxyCertificate": {
+          "$ref": "#/definitions/CertificateDescription",
+          "description": "The server certificate used by reverse proxy."
+        },
+        "reverseProxyCertificateCommonNames": {
+          "$ref": "#/definitions/ServerCertificateCommonNames",
+          "description": "Describes a list of server certificates referenced by common name that are used to secure the cluster."
+        },
+        "upgradeDescription": {
+          "$ref": "#/definitions/ClusterUpgradePolicy",
+          "description": "The policy to use when upgrading the cluster."
+        },
+        "upgradeMode": {
+          "$ref": "#/definitions/UpgradeMode",
+          "description": "The upgrade mode of the cluster when new Service Fabric runtime version is available.\n\n  - Automatic - The cluster will be automatically upgraded to the latest Service Fabric runtime version as soon as it is available.\n  - Manual - The cluster will not be automatically upgraded to the latest Service Fabric runtime version. The cluster is upgraded by setting the **clusterCodeVersion** property in the cluster resource.\n"
+        },
+        "vmImage": {
+          "type": "string",
+          "description": "The VM image VMSS has been configured with. Generic names such as Windows or Linux can be used."
+        }
+      },
+      "description": "Describes the cluster resource properties."
+    },
+    "ClusterPropertiesUpdateParameters": {
+      "properties": {
+        "addOnFeatures": {
+          "type": "array",
+          "description": "The list of add-on features to enable in the cluster.",
+          "items": {
+            "$ref": "#/definitions/AddOnFeatures"
+          }
+        },
+        "certificate": {
+          "$ref": "#/definitions/CertificateDescription",
+          "description": "The certificate to use for securing the cluster. The certificate provided will be used for  node to node security within the cluster, SSL certificate for cluster management endpoint and default  admin client."
+        },
+        "certificateCommonNames": {
+          "$ref": "#/definitions/ServerCertificateCommonNames",
+          "description": "Describes a list of server certificates referenced by common name that are used to secure the cluster."
+        },
+        "clientCertificateCommonNames": {
+          "type": "array",
+          "description": "The list of client certificates referenced by common name that are allowed to manage the cluster. This will overwrite the existing list.",
+          "items": {
+            "$ref": "#/definitions/ClientCertificateCommonName"
+          }
+        },
+        "clientCertificateThumbprints": {
+          "type": "array",
+          "description": "The list of client certificates referenced by thumbprint that are allowed to manage the cluster. This will overwrite the existing list.",
+          "items": {
+            "$ref": "#/definitions/ClientCertificateThumbprint"
+          }
+        },
+        "clusterCodeVersion": {
+          "type": "string",
+          "description": "The Service Fabric runtime version of the cluster. This property can only by set the user when **upgradeMode** is set to 'Manual'. To get list of available Service Fabric versions for new clusters use [ClusterVersion API](./ClusterVersion.md). To get the list of available version for existing clusters use **availableClusterVersions**."
+        },
+        "eventStoreServiceEnabled": {
+          "type": "boolean",
+          "description": "Indicates if the event store service is enabled."
+        },
+        "fabricSettings": {
+          "type": "array",
+          "description": "The list of custom fabric settings to configure the cluster. This will overwrite the existing list.",
+          "items": {
+            "$ref": "#/definitions/SettingsSectionDescription"
+          }
+        },
+        "nodeTypes": {
+          "type": "array",
+          "description": "The list of node types in the cluster. This will overwrite the existing list.",
+          "items": {
+            "$ref": "#/definitions/NodeTypeDescription"
+          }
+        },
+        "reliabilityLevel": {
+          "$ref": "#/definitions/ReliabilityLevel",
+          "description": "The reliability level sets the replica set size of system services. Learn about [ReliabilityLevel](https://docs.microsoft.com/azure/service-fabric/service-fabric-cluster-capacity).\n\n  - None - Run the System services with a target replica set count of 1. This should only be used for test clusters.\n  - Bronze - Run the System services with a target replica set count of 3. This should only be used for test clusters.\n  - Silver - Run the System services with a target replica set count of 5.\n  - Gold - Run the System services with a target replica set count of 7.\n  - Platinum - Run the System services with a target replica set count of 9.\n"
+        },
+        "reverseProxyCertificate": {
+          "$ref": "#/definitions/CertificateDescription",
+          "description": "The server certificate used by reverse proxy."
+        },
+        "upgradeDescription": {
+          "$ref": "#/definitions/ClusterUpgradePolicy",
+          "description": "The policy to use when upgrading the cluster."
+        },
+        "upgradeMode": {
+          "$ref": "#/definitions/UpgradeMode",
+          "description": "The upgrade mode of the cluster when new Service Fabric runtime version is available.\n\n  - Automatic - The cluster will be automatically upgraded to the latest Service Fabric runtime version as soon as it is available.\n  - Manual - The cluster will not be automatically upgraded to the latest Service Fabric runtime version. The cluster is upgraded by setting the **clusterCodeVersion** property in the cluster resource.\n"
+        }
+      },
+      "description": "Describes the cluster resource properties that can be updated during PATCH operation."
+    },
+    "ClusterState": {
+      "type": "string",
+      "description": "The current state of the cluster.\n\n  - WaitingForNodes - Indicates that the cluster resource is created and the resource provider is waiting for Service Fabric VM extension to boot up and report to it.\n  - Deploying - Indicates that the Service Fabric runtime is being installed on the VMs. Cluster resource will be in this state until the cluster boots up and system services are up.\n  - BaselineUpgrade - Indicates that the cluster is upgrading to establishes the cluster version. This upgrade is automatically initiated when the cluster boots up for the first time.\n  - UpdatingUserConfiguration - Indicates that the cluster is being upgraded with the user provided configuration.\n  - UpdatingUserCertificate - Indicates that the cluster is being upgraded with the user provided certificate.\n  - UpdatingInfrastructure - Indicates that the cluster is being upgraded with the latest Service Fabric runtime version. This happens only when the **upgradeMode** is set to 'Automatic'.\n  - EnforcingClusterVersion - Indicates that cluster is on a different version than expected and the cluster is being upgraded to the expected version.\n  - UpgradeServiceUnreachable - Indicates that the system service in the cluster is no longer polling the Resource Provider. Clusters in this state cannot be managed by the Resource Provider.\n  - AutoScale - Indicates that the ReliabilityLevel of the cluster is being adjusted.\n  - Ready - Indicates that the cluster is in a stable state.\n",
+      "enum": [
+        "WaitingForNodes",
+        "Deploying",
+        "BaselineUpgrade",
+        "UpdatingUserConfiguration",
+        "UpdatingUserCertificate",
+        "UpdatingInfrastructure",
+        "EnforcingClusterVersion",
+        "UpgradeServiceUnreachable",
+        "AutoScale",
+        "Ready"
+      ]
+    },
+    "ClusterUpdateParameters": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ClusterPropertiesUpdateParameters",
+          "description": "Describes the cluster resource properties that can be updated during PATCH operation."
+        },
+        "tags": {
+          "type": "object",
+          "description": "Cluster update parameters",
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      },
+      "description": "Cluster update request"
+    },
+    "ClusterUpgradeDeltaHealthPolicy": {
+      "description": "Describes the delta health policies for the cluster upgrade.",
+      "required": [
+        "maxPercentDeltaUnhealthyApplications",
+        "maxPercentDeltaUnhealthyNodes",
+        "maxPercentUpgradeDomainDeltaUnhealthyNodes"
+      ],
+      "properties": {
+        "maxPercentDeltaUnhealthyNodes": {
+          "type": "integer",
+          "description": "The maximum allowed percentage of nodes health degradation allowed during cluster upgrades.\nThe delta is measured between the state of the nodes at the beginning of upgrade and the state of the nodes at the time of the health evaluation.\nThe check is performed after every upgrade domain upgrade completion to make sure the global state of the cluster is within tolerated limits.\n",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "maxPercentUpgradeDomainDeltaUnhealthyNodes": {
+          "type": "integer",
+          "description": "The maximum allowed percentage of upgrade domain nodes health degradation allowed during cluster upgrades.\nThe delta is measured between the state of the upgrade domain nodes at the beginning of upgrade and the state of the upgrade domain nodes at the time of the health evaluation.\nThe check is performed after every upgrade domain upgrade completion for all completed upgrade domains to make sure the state of the upgrade domains is within tolerated limits.\n",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "maxPercentDeltaUnhealthyApplications": {
+          "type": "integer",
+          "description": "The maximum allowed percentage of applications health degradation allowed during cluster upgrades.\nThe delta is measured between the state of the applications at the beginning of upgrade and the state of the applications at the time of the health evaluation.\nThe check is performed after every upgrade domain upgrade completion to make sure the global state of the cluster is within tolerated limits. System services are not included in this.\n",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "applicationDeltaHealthPolicies": {
+          "$ref": "#/definitions/ApplicationDeltaHealthPolicyMap",
+          "description": "Defines the application delta health policy map used to evaluate the health of an application or one of its child entities when upgrading the cluster."
+        }
+      }
+    },
+    "ClusterUpgradePolicy": {
+      "required": [
+        "healthCheckRetryTimeout",
+        "healthCheckStableDuration",
+        "healthCheckWaitDuration",
+        "healthPolicy",
+        "upgradeDomainTimeout",
+        "upgradeReplicaSetCheckTimeout",
+        "upgradeTimeout"
+      ],
+      "properties": {
+        "forceRestart": {
+          "type": "boolean",
+          "description": "If true, then processes are forcefully restarted during upgrade even when the code version has not changed (the upgrade only changes configuration or data)."
+        },
+        "upgradeReplicaSetCheckTimeout": {
+          "type": "string",
+          "description": "The maximum amount of time to block processing of an upgrade domain and prevent loss of availability when there are unexpected issues. When this timeout expires, processing of the upgrade domain will proceed regardless of availability loss issues. The timeout is reset at the start of each upgrade domain. The timeout can be in either hh:mm:ss or in d.hh:mm:ss.ms format."
+        },
+        "healthCheckWaitDuration": {
+          "type": "string",
+          "description": "The length of time to wait after completing an upgrade domain before performing health checks. The duration can be in either hh:mm:ss or in d.hh:mm:ss.ms format."
+        },
+        "healthCheckStableDuration": {
+          "type": "string",
+          "description": "The amount of time that the application or cluster must remain healthy before the upgrade proceeds to the next upgrade domain. The duration can be in either hh:mm:ss or in d.hh:mm:ss.ms format."
+        },
+        "healthCheckRetryTimeout": {
+          "type": "string",
+          "description": "The amount of time to retry health evaluation when the application or cluster is unhealthy before the upgrade rolls back. The timeout can be in either hh:mm:ss or in d.hh:mm:ss.ms format."
+        },
+        "upgradeTimeout": {
+          "type": "string",
+          "description": "The amount of time the overall upgrade has to complete before the upgrade rolls back. The timeout can be in either hh:mm:ss or in d.hh:mm:ss.ms format."
+        },
+        "upgradeDomainTimeout": {
+          "type": "string",
+          "description": "The amount of time each upgrade domain has to complete before the upgrade rolls back. The timeout can be in either hh:mm:ss or in d.hh:mm:ss.ms format."
+        },
+        "healthPolicy": {
+          "$ref": "#/definitions/ClusterHealthPolicy",
+          "description": "The cluster health policy used when upgrading the cluster."
+        },
+        "deltaHealthPolicy": {
+          "$ref": "#/definitions/ClusterUpgradeDeltaHealthPolicy",
+          "description": "The cluster delta health policy used when upgrading the cluster."
+        }
+      },
+      "description": "Describes the policy used when upgrading the cluster."
+    },
+    "ClusterVersionDetails": {
+      "properties": {
+        "codeVersion": {
+          "type": "string",
+          "description": "The Service Fabric runtime version of the cluster."
+        },
+        "supportExpiryUtc": {
+          "type": "string",
+          "description": "The date of expiry of support of the version."
+        },
+        "environment": {
+          "$ref": "#/definitions/ClusterEnvironment",
+          "description": "Indicates if this version is for Windows or Linux operating system."
+        }
+      },
+      "description": "The detail of the Service Fabric runtime version result"
+    },
+    "DiagnosticsStorageAccountConfig": {
+      "required": [
+        "blobEndpoint",
+        "protectedAccountKeyName",
+        "queueEndpoint",
+        "storageAccountName",
+        "tableEndpoint"
+      ],
+      "properties": {
+        "storageAccountName": {
+          "type": "string",
+          "description": "The Azure storage account name."
+        },
+        "protectedAccountKeyName": {
+          "type": "string",
+          "description": "The protected diagnostics storage key name."
+        },
+        "protectedAccountKeyName2": {
+          "type": "string",
+          "description": "The secondary protected diagnostics storage key name."
+        },
+        "blobEndpoint": {
+          "type": "string",
+          "description": "The blob endpoint of the azure storage account."
+        },
+        "queueEndpoint": {
+          "type": "string",
+          "description": "The queue endpoint of the azure storage account."
+        },
+        "tableEndpoint": {
+          "type": "string",
+          "description": "The table endpoint of the azure storage account."
+        }
+      },
+      "description": "The storage account information for storing Service Fabric diagnostic logs."
+    },
+    "DurabilityLevel": {
+      "type": "string",
+      "description": "The durability level of the node type. Learn about [DurabilityLevel](https://docs.microsoft.com/azure/service-fabric/service-fabric-cluster-capacity).\n\n  - Bronze - No privileges. This is the default.\n  - Silver - The infrastructure jobs can be paused for a duration of 10 minutes per UD.\n  - Gold - The infrastructure jobs can be paused for a duration of 2 hours per UD. Gold durability can be enabled only on full node VM skus like D15_V2, G5 etc.\n",
+      "enum": [
+        "Bronze",
+        "Silver",
+        "Gold"
+      ]
+    },
+    "EndpointRangeDescription": {
+      "required": [
+        "endPort",
+        "startPort"
+      ],
+      "properties": {
+        "startPort": {
+          "type": "integer",
+          "description": "Starting port of a range of ports"
+        },
+        "endPort": {
+          "type": "integer",
+          "description": "End port of a range of ports"
+        }
+      },
+      "description": "Port range details"
+    },
+    "NodeTypeDescription": {
+      "required": [
+        "clientConnectionEndpointPort",
+        "httpGatewayEndpointPort",
+        "isPrimary",
+        "name",
+        "vmInstanceCount"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The name of the node type."
+        },
+        "placementProperties": {
+          "type": "object",
+          "description": "The placement tags applied to nodes in the node type, which can be used to indicate where certain services (workload) should run.",
+          "additionalProperties": {
+            "type": "string",
+            "description": "Placement tag value"
+          }
+        },
+        "capacities": {
+          "type": "object",
+          "description": "The capacity tags applied to the nodes in the node type, the cluster resource manager uses these tags to understand how much resource a node has.",
+          "additionalProperties": {
+            "type": "string",
+            "description": "Capacity tag value"
+          }
+        },
+        "clientConnectionEndpointPort": {
+          "type": "integer",
+          "description": "The TCP cluster management endpoint port."
+        },
+        "httpGatewayEndpointPort": {
+          "type": "integer",
+          "description": "The HTTP cluster management endpoint port."
+        },
+        "durabilityLevel": {
+          "$ref": "#/definitions/DurabilityLevel",
+          "description": "The durability level of the node type. Learn about [DurabilityLevel](https://docs.microsoft.com/azure/service-fabric/service-fabric-cluster-capacity).\n\n  - Bronze - No privileges. This is the default.\n  - Silver - The infrastructure jobs can be paused for a duration of 10 minutes per UD.\n  - Gold - The infrastructure jobs can be paused for a duration of 2 hours per UD. Gold durability can be enabled only on full node VM skus like D15_V2, G5 etc.\n"
+        },
+        "applicationPorts": {
+          "$ref": "#/definitions/EndpointRangeDescription",
+          "description": "The range of ports from which cluster assigned port to Service Fabric applications."
+        },
+        "ephemeralPorts": {
+          "$ref": "#/definitions/EndpointRangeDescription",
+          "description": "The range of ephemeral ports that nodes in this node type should be configured with."
+        },
+        "isPrimary": {
+          "type": "boolean",
+          "description": "The node type on which system services will run. Only one node type should be marked as primary. Primary node type cannot be deleted or changed for existing clusters."
+        },
+        "vmInstanceCount": {
+          "type": "integer",
+          "description": "The number of nodes in the node type. This count should match the capacity property in the corresponding VirtualMachineScaleSet resource.",
+          "minimum": 1,
+          "maximum": 2147483647
+        },
+        "reverseProxyEndpointPort": {
+          "type": "integer",
+          "description": "The endpoint used by reverse proxy."
+        }
+      },
+      "description": "Describes a node type in the cluster, each node type represents sub set of nodes in the cluster."
+    },
+    "OperationListResult": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "description": "List of operations supported by the Service Fabric resource provider.",
+          "items": {
+            "$ref": "#/definitions/OperationResult"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of operation list results if there are any.",
+          "readOnly": true
+        }
+      },
+      "description": "Describes the result of the request to list Service Fabric resource provider operations."
+    },
+    "OperationResult": {
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The name of the operation."
+        },
+        "display": {
+          "$ref": "#/definitions/AvailableOperationDisplay",
+          "description": "The object that represents the operation."
+        },
+        "origin": {
+          "type": "string",
+          "description": "Origin result"
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "The URL to use for getting the next set of results."
+        }
+      },
+      "description": "Available operation list result"
+    },
+    "ReliabilityLevel": {
+      "type": "string",
+      "description": "The reliability level sets the replica set size of system services. Learn about [ReliabilityLevel](https://docs.microsoft.com/azure/service-fabric/service-fabric-cluster-capacity).\n\n  - None - Run the System services with a target replica set count of 1. This should only be used for test clusters.\n  - Bronze - Run the System services with a target replica set count of 3. This should only be used for test clusters.\n  - Silver - Run the System services with a target replica set count of 5.\n  - Gold - Run the System services with a target replica set count of 7.\n  - Platinum - Run the System services with a target replica set count of 9.\n",
+      "enum": [
+        "None",
+        "Bronze",
+        "Silver",
+        "Gold",
+        "Platinum"
+      ]
+    },
+    "Resource": {
+      "required": [
+        "location"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Azure resource identifier.",
+          "readOnly": true
+        },
+        "name": {
+          "type": "string",
+          "description": "Azure resource name.",
+          "readOnly": true
+        },
+        "type": {
+          "type": "string",
+          "description": "Azure resource type.",
+          "readOnly": true
+        },
+        "location": {
+          "type": "string",
+          "description": "Azure resource location.",
+          "x-ms-mutability": [
+            "create",
+            "read"
+          ]
+        },
+        "tags": {
+          "type": "object",
+          "description": "Azure resource tags.",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "etag": {
+          "type": "string",
+          "description": "Azure resource etag.",
+          "readOnly": true
+        }
+      },
+      "description": "The resource model definition.",
+      "x-ms-azure-resource": true
+    },
+    "ServerCertificateCommonName": {
+      "description": "Describes the server certificate details using common name.",
+      "required": [
+        "certificateCommonName",
+        "certificateIssuerThumbprint"
+      ],
+      "properties": {
+        "certificateCommonName": {
+          "type": "string",
+          "description": "The common name of the server certificate."
+        },
+        "certificateIssuerThumbprint": {
+          "type": "string",
+          "description": "The issuer thumbprint of the server certificate."
+        }
+      }
+    },
+    "ServerCertificateCommonNames": {
+      "description": "Describes a list of server certificates referenced by common name that are used to secure the cluster.",
+      "properties": {
+        "commonNames": {
+          "type": "array",
+          "description": "The list of server certificates referenced by common name that are used to secure the cluster.",
+          "items": {
+            "$ref": "#/definitions/ServerCertificateCommonName"
+          }
+        },
+        "x509StoreName": {
+          "$ref": "#/definitions/StoreName",
+          "description": "The local certificate store location."
+        }
+      }
+    },
+    "ServiceTypeDeltaHealthPolicy": {
+      "type": "object",
+      "description": "Represents the delta health policy used to evaluate the health of services belonging to a service type when upgrading the cluster.\n",
+      "properties": {
+        "maxPercentDeltaUnhealthyServices": {
+          "type": "integer",
+          "description": "The maximum allowed percentage of services health degradation allowed during cluster upgrades.\nThe delta is measured between the state of the services at the beginning of upgrade and the state of the services at the time of the health evaluation.\nThe check is performed after every upgrade domain upgrade completion to make sure the global state of the cluster is within tolerated limits.\n",
+          "default": 0,
+          "minimum": 0,
+          "maximum": 100
+        }
+      }
+    },
+    "ServiceTypeDeltaHealthPolicyMap": {
+      "type": "object",
+      "description": "Defines a map that contains specific delta health policies for different service types.\nEach entry specifies as key the service type name and as value a ServiceTypeDeltaHealthPolicy used to evaluate the service health when upgrading the cluster.\nThe map is empty by default.\n",
+      "additionalProperties": {
+        "$ref": "#/definitions/ServiceTypeDeltaHealthPolicy"
+      }
+    },
+    "SettingsParameterDescription": {
+      "required": [
+        "name",
+        "value"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The parameter name of fabric setting."
+        },
+        "value": {
+          "type": "string",
+          "description": "The parameter value of fabric setting."
+        }
+      },
+      "description": "Describes a parameter in fabric settings of the cluster."
+    },
+    "SettingsSectionDescription": {
+      "required": [
+        "name",
+        "parameters"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The section name of the fabric settings."
+        },
+        "parameters": {
+          "type": "array",
+          "description": "The collection of parameters in the section.",
+          "items": {
+            "$ref": "#/definitions/SettingsParameterDescription"
+          }
+        }
+      },
+      "description": "Describes a section in the fabric settings of the cluster."
+    },
+    "StoreName": {
+      "type": "string",
+      "description": "The local certificate store location.",
+      "enum": [
+        "AddressBook",
+        "AuthRoot",
+        "CertificateAuthority",
+        "Disallowed",
+        "My",
+        "Root",
+        "TrustedPeople",
+        "TrustedPublisher"
+      ]
+    },
+    "UpgradeMode": {
+      "type": "string",
+      "description": "The upgrade mode of the cluster when new Service Fabric runtime version is available.\n\n  - Automatic - The cluster will be automatically upgraded to the latest Service Fabric runtime version as soon as it is available.\n  - Manual - The cluster will not be automatically upgraded to the latest Service Fabric runtime version. The cluster is upgraded by setting the **clusterCodeVersion** property in the cluster resource.\n",
+      "enum": [
+        "Automatic",
+        "Manual"
+      ]
+    },
+    "ErrorModel": {
+      "properties": {
+        "error": {
+          "$ref": "#/definitions/ErrorModelError",
+          "description": "The error details."
+        }
+      },
+      "description": "The structure of the error."
+    },
+    "ErrorModelError": {
+      "properties": {
+        "code": {
+          "type": "string",
+          "description": "The error code."
+        },
+        "message": {
+          "type": "string",
+          "description": "The error message."
+        }
+      },
+      "description": "The error details."
+    },
+    "ServiceTypeHealthPolicy": {
+      "type": "object",
+      "description": "Represents the health policy used to evaluate the health of services belonging to a service type.\n",
+      "properties": {
+        "maxPercentUnhealthyServices": {
+          "type": "integer",
+          "description": "The maximum percentage of services allowed to be unhealthy before your application is considered in error.\n",
+          "default": 0,
+          "minimum": 0,
+          "maximum": 100
+        }
+      }
+    },
+    "ServiceTypeHealthPolicyMap": {
+      "type": "object",
+      "description": "Defines a ServiceTypeHealthPolicy per service type name.\n\nThe entries in the map replace the default service type health policy for each specified service type.\nFor example, in an application that contains both a stateless gateway service type and a stateful engine service type, the health policies for the stateless and stateful services can be configured differently.\nWith policy per service type, there's more granular control of the health of the service.\n\nIf no policy is specified for a service type name, the DefaultServiceTypeHealthPolicy is used for evaluation.\n",
+      "additionalProperties": {
+        "$ref": "#/definitions/ServiceTypeHealthPolicy"
+      }
+    }
+  },
+  "parameters": {
+    "api-version": {
+      "name": "api-version",
+      "in": "query",
+      "description": "The version of the Service Fabric resource provider API. This is a required parameter and it's value must be \"2020-03-01\" for this specification.",
+      "required": true,
+      "type": "string",
+      "enum": [
+        "2020-03-01"
+      ],
+      "default": "2020-03-01",
+      "x-ms-parameter-location": "client"
+    },
+    "clusterNameParameter": {
+      "name": "clusterName",
+      "in": "path",
+      "description": "The name of the cluster resource.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "clusterVersion": {
+      "name": "clusterVersion",
+      "in": "path",
+      "description": "The cluster code version.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "environment": {
+      "name": "environment",
+      "in": "path",
+      "description": "The operating system of the cluster. The default means all.",
+      "required": true,
+      "type": "string",
+      "enum": [
+        "Windows",
+        "Linux"
+      ],
+      "x-ms-parameter-location": "method"
+    },
+    "locationForClusterCodeVersions": {
+      "name": "location",
+      "in": "path",
+      "description": "The location for the cluster code versions. This is different from cluster location.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "resourceGroupNameParameter": {
+      "name": "resourceGroupName",
+      "in": "path",
+      "description": "The name of the resource group.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "subscriptionId": {
+      "name": "subscriptionId",
+      "in": "path",
+      "description": "The customer subscription identifier.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "client"
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationDeleteOperation_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationDeleteOperation_example.json
new file mode 100644
index 000000000000..f9fe1895f7d3
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationDeleteOperation_example.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "applicationName": "myApp",
+    "api-version": "2020-03-01"
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Retry-After": "10",
+        "Location": "http://10.91.140.224/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/operationResults/76053752-a423-4a80-b283-1dad1ba5f314?api-version=2020-03-01"
+      }
+    },
+    "204": {}
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationGetOperation_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationGetOperation_example.json
new file mode 100644
index 000000000000..3950f60d19e5
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationGetOperation_example.json
@@ -0,0 +1,63 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "applicationName": "myApp",
+    "api-version": "2020-03-01"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "type": "applications",
+        "location": "eastus",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster/applications/myApp",
+        "name": "myCluster",
+        "tags": {},
+        "etag": "W/\"636462502180261859\"",
+        "properties": {
+          "provisioningState": "Updating",
+          "typeName": "myAppType",
+          "typeVersion": "1.0",
+          "parameters": {
+            "param1": "value1"
+          },
+          "upgradePolicy": {
+            "upgradeMode": "Monitored",
+            "applicationHealthPolicy": {
+              "considerWarningAsError": true,
+              "maxPercentUnhealthyDeployedApplications": 0,
+              "defaultServiceTypeHealthPolicy": {
+                "maxPercentUnhealthyServices": 0,
+                "maxPercentUnhealthyPartitionsPerService": 0,
+                "maxPercentUnhealthyReplicasPerPartition": 0
+              }
+            },
+            "rollingUpgradeMonitoringPolicy": {
+              "failureAction": "Rollback",
+              "healthCheckRetryTimeout": "00:10:00",
+              "healthCheckWaitDuration": "00:02:00",
+              "healthCheckStableDuration": "00:05:00",
+              "upgradeDomainTimeout": "1.06:00:00",
+              "upgradeTimeout": "01:00:00"
+            },
+            "upgradeReplicaSetCheckTimeout": "01:00:00",
+            "forceRestart": false
+          },
+          "maximumNodes": 3,
+          "minimumNodes": 1,
+          "removeApplicationCapacity": false,
+          "metrics": [
+            {
+              "name": "metric1",
+              "reservationCapacity": 1,
+              "maximumCapacity": 3,
+              "totalApplicationCapacity": 5
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationListOperation_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationListOperation_example.json
new file mode 100644
index 000000000000..97910a392dcd
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationListOperation_example.json
@@ -0,0 +1,40 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "api-version": "2020-03-01"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "value": [
+          {
+            "type": "applications",
+            "location": "eastus",
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster/applications/myApp",
+            "name": "myCluster",
+            "tags": {},
+            "etag": "W/\"636462502180261858\"",
+            "properties": {
+              "provisioningState": "Updating",
+              "typeName": "myAppType",
+              "typeVersion": "1.0",
+              "removeApplicationCapacity": false,
+              "metrics": [
+                {
+                  "name": "metric1",
+                  "reservationCapacity": 1,
+                  "maximumCapacity": 3,
+                  "totalApplicationCapacity": 5
+                }
+              ]
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationPatchOperation_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationPatchOperation_example.json
new file mode 100644
index 000000000000..01dfe131e68f
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationPatchOperation_example.json
@@ -0,0 +1,53 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "applicationName": "myApp",
+    "api-version": "2020-03-01",
+    "parameters": {
+      "properties": {
+        "typeVersion": "1.0",
+        "removeApplicationCapacity": false,
+        "metrics": [
+          {
+            "name": "metric1",
+            "reservationCapacity": 1,
+            "maximumCapacity": 3,
+            "totalApplicationCapacity": 5
+          }
+        ]
+      }
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Retry-After": "10",
+        "Location": "http://10.91.140.224/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/operationResults/a553eb63-c332-40df-8ace-eb8d34a9b298?api-version=2020-03-01"
+      },
+      "body": {
+        "type": "applications",
+        "location": "eastus",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster/applications/myApp",
+        "name": "myCluster",
+        "tags": {},
+        "etag": "W/\"636462502180261858\"",
+        "properties": {
+          "provisioningState": "Updating",
+          "typeName": "myAppType",
+          "typeVersion": "1.0",
+          "removeApplicationCapacity": false,
+          "metrics": [
+            {
+              "name": "metric1",
+              "reservationCapacity": 1,
+              "maximumCapacity": 3,
+              "totalApplicationCapacity": 5
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationPutOperation_example_max.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationPutOperation_example_max.json
new file mode 100644
index 000000000000..390964d6a2ae
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationPutOperation_example_max.json
@@ -0,0 +1,108 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "applicationName": "myApp",
+    "api-version": "2020-03-01",
+    "parameters": {
+      "properties": {
+        "typeName": "myAppType",
+        "typeVersion": "1.0",
+        "parameters": {
+          "param1": "value1"
+        },
+        "upgradePolicy": {
+          "upgradeMode": "Monitored",
+          "applicationHealthPolicy": {
+            "considerWarningAsError": true,
+            "maxPercentUnhealthyDeployedApplications": 0,
+            "defaultServiceTypeHealthPolicy": {
+              "maxPercentUnhealthyServices": 0,
+              "maxPercentUnhealthyPartitionsPerService": 0,
+              "maxPercentUnhealthyReplicasPerPartition": 0
+            }
+          },
+          "rollingUpgradeMonitoringPolicy": {
+            "failureAction": "Rollback",
+            "healthCheckRetryTimeout": "00:10:00",
+            "healthCheckWaitDuration": "00:02:00",
+            "healthCheckStableDuration": "00:05:00",
+            "upgradeDomainTimeout": "1.06:00:00",
+            "upgradeTimeout": "01:00:00"
+          },
+          "upgradeReplicaSetCheckTimeout": "01:00:00",
+          "forceRestart": false
+        },
+        "maximumNodes": 3,
+        "minimumNodes": 1,
+        "removeApplicationCapacity": false,
+        "metrics": [
+          {
+            "name": "metric1",
+            "reservationCapacity": 1,
+            "maximumCapacity": 3,
+            "totalApplicationCapacity": 5
+          }
+        ]
+      }
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Retry-After": "10",
+        "Location": "http://10.91.140.224/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/operationResults/9c2ce367-47ea-43de-b69e-c5a423da4557?api-version=2020-03-01"
+      },
+      "body": {
+        "type": "applications",
+        "location": "eastus",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster/applications/myApp",
+        "name": "myCluster",
+        "tags": {},
+        "etag": "W/\"636462502180261859\"",
+        "properties": {
+          "provisioningState": "Updating",
+          "typeName": "myAppType",
+          "typeVersion": "1.0",
+          "parameters": {
+            "param1": "value1"
+          },
+          "upgradePolicy": {
+            "upgradeMode": "Monitored",
+            "applicationHealthPolicy": {
+              "considerWarningAsError": true,
+              "maxPercentUnhealthyDeployedApplications": 0,
+              "defaultServiceTypeHealthPolicy": {
+                "maxPercentUnhealthyServices": 0,
+                "maxPercentUnhealthyPartitionsPerService": 0,
+                "maxPercentUnhealthyReplicasPerPartition": 0
+              }
+            },
+            "rollingUpgradeMonitoringPolicy": {
+              "failureAction": "Rollback",
+              "healthCheckRetryTimeout": "00:10:00",
+              "healthCheckWaitDuration": "00:02:00",
+              "healthCheckStableDuration": "00:05:00",
+              "upgradeDomainTimeout": "1.06:00:00",
+              "upgradeTimeout": "01:00:00"
+            },
+            "upgradeReplicaSetCheckTimeout": "01:00:00",
+            "forceRestart": false
+          },
+          "maximumNodes": 3,
+          "minimumNodes": 1,
+          "removeApplicationCapacity": false,
+          "metrics": [
+            {
+              "name": "metric1",
+              "reservationCapacity": 1,
+              "maximumCapacity": 3,
+              "totalApplicationCapacity": 5
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationPutOperation_example_min.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationPutOperation_example_min.json
new file mode 100644
index 000000000000..241bbdee8bc8
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationPutOperation_example_min.json
@@ -0,0 +1,38 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "applicationName": "myApp",
+    "api-version": "2020-03-01",
+    "parameters": {
+      "properties": {
+        "typeName": "myAppType",
+        "typeVersion": "1.0",
+        "removeApplicationCapacity": false
+      }
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Retry-After": "10",
+        "Location": "http://10.91.140.224/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/operationResults/5dce62ce-439b-47af-81d8-99ab14708e91?api-version=2020-03-01"
+      },
+      "body": {
+        "type": "applications",
+        "location": "eastus",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster/applications/myApp",
+        "name": "myCluster",
+        "tags": {},
+        "etag": "W/\"636462502180261857\"",
+        "properties": {
+          "provisioningState": "Updating",
+          "typeName": "myAppType",
+          "typeVersion": "1.0",
+          "removeApplicationCapacity": false
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeNameDeleteOperation_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeNameDeleteOperation_example.json
new file mode 100644
index 000000000000..3a7741b968a3
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeNameDeleteOperation_example.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "applicationTypeName": "myAppType",
+    "api-version": "2020-03-01"
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Retry-After": "10",
+        "Location": "http://10.91.140.224/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/operationResults/6a367b2d-9f60-4941-b886-e348ddcb4127?api-version=2020-03-01"
+      }
+    },
+    "204": {}
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeNameGetOperation_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeNameGetOperation_example.json
new file mode 100644
index 000000000000..4c78cda55b3a
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeNameGetOperation_example.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "applicationTypeName": "myAppType",
+    "api-version": "2020-03-01"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "type": "applicationTypes",
+        "location": "eastus",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster/applicationTypes/myAppType",
+        "name": "myCluster",
+        "tags": {},
+        "etag": "W/\"636462502174844831\"",
+        "properties": {
+          "provisioningState": "Succeeded"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeNameListOperation_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeNameListOperation_example.json
new file mode 100644
index 000000000000..3ff9da2cae93
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeNameListOperation_example.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "api-version": "2020-03-01"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "value": [
+          {
+            "type": "applicationTypes",
+            "location": "eastus",
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster/applicationTypes/myAppType",
+            "name": "myCluster",
+            "tags": {},
+            "etag": "W/\"636462502174844831\"",
+            "properties": {
+              "provisioningState": "Succeeded"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeNamePutOperation_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeNamePutOperation_example.json
new file mode 100644
index 000000000000..aecb281a0284
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeNamePutOperation_example.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "applicationTypeName": "myAppType",
+    "api-version": "2020-03-01",
+    "parameters": {}
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "type": "applicationTypes",
+        "location": "eastus",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster/applicationTypes/myAppType",
+        "name": "myCluster",
+        "tags": {},
+        "etag": "W/\"636462502174844831\"",
+        "properties": {
+          "provisioningState": "Succeeded"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeVersionDeleteOperation_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeVersionDeleteOperation_example.json
new file mode 100644
index 000000000000..7d5a4386c350
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeVersionDeleteOperation_example.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "applicationTypeName": "myAppType",
+    "version": "1.0",
+    "api-version": "2020-03-01"
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Retry-After": "10",
+        "Location": "http://10.91.140.224/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/operationResults/28e62369-ed8c-4aba-8c05-ab7d6238cc3d?api-version=2020-03-01"
+      }
+    },
+    "204": {}
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeVersionGetOperation_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeVersionGetOperation_example.json
new file mode 100644
index 000000000000..ebbacb17aae4
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeVersionGetOperation_example.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "applicationTypeName": "myAppType",
+    "version": "1.0",
+    "api-version": "2020-03-01"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "type": "versions",
+        "location": "eastus",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster/applicationTypes/myAppType/versions/1.0",
+        "name": "myCluster",
+        "tags": {},
+        "etag": "W/\"636462502176040417\"",
+        "properties": {
+          "provisioningState": "Updating",
+          "appPackageUrl": "http://fakelink.test.com/MyAppType",
+          "defaultParameterList": {}
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeVersionListOperation_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeVersionListOperation_example.json
new file mode 100644
index 000000000000..774dd0c20c33
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeVersionListOperation_example.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "applicationTypeName": "myAppType",
+    "api-version": "2020-03-01"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "value": [
+          {
+            "type": "versions",
+            "location": "eastus",
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster/applicationTypes/myAppType/versions/1.0",
+            "name": "myCluster",
+            "tags": {},
+            "etag": "W/\"636462502176040417\"",
+            "properties": {
+              "provisioningState": "Updating",
+              "appPackageUrl": "http://fakelink.test.com/MyAppType",
+              "defaultParameterList": {}
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeVersionPutOperation_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeVersionPutOperation_example.json
new file mode 100644
index 000000000000..5ee69832e1a4
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ApplicationTypeVersionPutOperation_example.json
@@ -0,0 +1,36 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "applicationTypeName": "myAppType",
+    "version": "1.0",
+    "api-version": "2020-03-01",
+    "parameters": {
+      "properties": {
+        "appPackageUrl": "http://fakelink.test.com/MyAppType"
+      }
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Retry-After": "10",
+        "Location": "http://10.91.140.224/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/operationResults/e2413c7e-d51b-40ac-8155-bc85bf8ae856?api-version=2020-03-01"
+      },
+      "body": {
+        "type": "versions",
+        "location": "eastus",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster/applicationTypes/myAppType/versions/1.0",
+        "name": "myCluster",
+        "tags": {},
+        "etag": "W/\"636462502176040417\"",
+        "properties": {
+          "provisioningState": "Updating",
+          "appPackageUrl": "http://fakelink.test.com/MyAppType",
+          "defaultParameterList": {}
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterDeleteOperation_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterDeleteOperation_example.json
new file mode 100644
index 000000000000..faa8264ce040
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterDeleteOperation_example.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "api-version": "2020-03-01"
+  },
+  "responses": {
+    "200": {
+      "headers": {}
+    },
+    "204": {}
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterGetOperation_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterGetOperation_example.json
new file mode 100644
index 000000000000..efe58557d860
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterGetOperation_example.json
@@ -0,0 +1,159 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "api-version": "2020-03-01"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "type": "Microsoft.ServiceFabric/clusters",
+        "location": "eastus",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster",
+        "name": "myCluster",
+        "tags": {},
+        "etag": "W/\"636462502169240745\"",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "clusterId": "92584666-9889-4ae8-8d02-91902923d37f",
+          "clusterCodeVersion": "6.1.480.9494",
+          "clusterState": "WaitingForNodes",
+          "managementEndpoint": "https://myCluster.eastus.cloudapp.azure.com:19080",
+          "clusterEndpoint": "https://eastus.servicefabric.azure.com",
+          "certificateCommonNames": {
+            "commonNames": [
+              {
+                "certificateCommonName": "abc.com",
+                "certificateIssuerThumbprint": "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
+              }
+            ],
+            "x509StoreName": "My"
+          },
+          "clientCertificateThumbprints": [
+            {
+              "isAdmin": true,
+              "certificateThumbprint": "5F3660C715EBBDA31DB1FFDCF508302348DE8E7A"
+            }
+          ],
+          "clientCertificateCommonNames": [
+            {
+              "isAdmin": true,
+              "certificateCommonName": "abc.com",
+              "certificateIssuerThumbprint": "5F3660C715EBBDA31DB1FFDCF508302348DE8E7A"
+            }
+          ],
+          "fabricSettings": [
+            {
+              "name": "UpgradeService",
+              "parameters": [
+                {
+                  "name": "AppPollIntervalInSeconds",
+                  "value": "60"
+                }
+              ]
+            }
+          ],
+          "upgradeDescription": {
+            "forceRestart": false,
+            "upgradeReplicaSetCheckTimeout": "00:10:00",
+            "healthCheckWaitDuration": "00:00:30",
+            "healthCheckStableDuration": "00:00:30",
+            "healthCheckRetryTimeout": "00:05:00",
+            "upgradeTimeout": "01:00:00",
+            "upgradeDomainTimeout": "00:15:00",
+            "healthPolicy": {
+              "maxPercentUnhealthyNodes": 0,
+              "maxPercentUnhealthyApplications": 0,
+              "applicationHealthPolicies": {
+                "fabric:/myApp1": {
+                  "defaultServiceTypeHealthPolicy": {
+                    "maxPercentUnhealthyServices": 0
+                  },
+                  "serviceTypeHealthPolicies": {
+                    "myServiceType1": {
+                      "maxPercentUnhealthyServices": 100
+                    }
+                  }
+                }
+              }
+            },
+            "deltaHealthPolicy": {
+              "maxPercentDeltaUnhealthyNodes": 0,
+              "maxPercentUpgradeDomainDeltaUnhealthyNodes": 0,
+              "maxPercentDeltaUnhealthyApplications": 0,
+              "applicationDeltaHealthPolicies": {
+                "fabric:/myApp1": {
+                  "defaultServiceTypeDeltaHealthPolicy": {
+                    "maxPercentDeltaUnhealthyServices": 0
+                  },
+                  "serviceTypeDeltaHealthPolicies": {
+                    "myServiceType1": {
+                      "maxPercentDeltaUnhealthyServices": 0
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "diagnosticsStorageAccountConfig": {
+            "storageAccountName": "diag",
+            "protectedAccountKeyName": "StorageAccountKey1",
+            "blobEndpoint": "https://diag.blob.core.windows.net/",
+            "queueEndpoint": "https://diag.queue.core.windows.net/",
+            "tableEndpoint": "https://diag.table.core.windows.net/"
+          },
+          "nodeTypes": [
+            {
+              "name": "nt1vm",
+              "clientConnectionEndpointPort": 19000,
+              "httpGatewayEndpointPort": 19007,
+              "applicationPorts": {
+                "startPort": 20000,
+                "endPort": 30000
+              },
+              "ephemeralPorts": {
+                "startPort": 49000,
+                "endPort": 64000
+              },
+              "isPrimary": true,
+              "vmInstanceCount": 5,
+              "durabilityLevel": "Bronze"
+            }
+          ],
+          "vmImage": "Windows",
+          "azureActiveDirectory": {
+            "tenantId": "6abcc6a0-8666-43f1-87b8-172cf86a9f9c",
+            "clusterApplication": "5886372e-7bf4-4878-a497-8098aba608ae",
+            "clientApplication": "d151ad89-4bce-4ae8-b3d1-1dc79679fa75"
+          },
+          "reliabilityLevel": "Silver",
+          "reverseProxyCertificateCommonNames": {
+            "commonNames": [
+              {
+                "certificateCommonName": "abc.com",
+                "certificateIssuerThumbprint": "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
+              }
+            ],
+            "x509StoreName": "My"
+          },
+          "upgradeMode": "Manual",
+          "availableClusterVersions": [
+            {
+              "codeVersion": "6.1.480.9494",
+              "supportExpiryUtc": "2018-06-15T23:59:59.9999999",
+              "environment": "Windows"
+            }
+          ],
+          "addOnFeatures": [
+            "RepairManager",
+            "DnsService",
+            "BackupRestoreService",
+            "ResourceMonitorService"
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterListByResourceGroupOperation_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterListByResourceGroupOperation_example.json
new file mode 100644
index 000000000000..9ea1ea5a3f7b
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterListByResourceGroupOperation_example.json
@@ -0,0 +1,248 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "api-version": "2020-03-01"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "value": [
+          {
+            "type": "Microsoft.ServiceFabric/clusters",
+            "location": "eastus",
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster",
+            "name": "myCluster",
+            "tags": {},
+            "etag": "W/\"636462502169240745\"",
+            "properties": {
+              "provisioningState": "Succeeded",
+              "clusterId": "92584666-9889-4ae8-8d02-91902923d37f",
+              "clusterCodeVersion": "6.1.480.9494",
+              "clusterState": "WaitingForNodes",
+              "managementEndpoint": "https://myCluster.eastus.cloudapp.azure.com:19080",
+              "clusterEndpoint": "https://eastus.servicefabric.azure.com",
+              "certificateCommonNames": {
+                "commonNames": [
+                  {
+                    "certificateCommonName": "abc.com",
+                    "certificateIssuerThumbprint": "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
+                  }
+                ],
+                "x509StoreName": "My"
+              },
+              "clientCertificateThumbprints": [
+                {
+                  "isAdmin": false,
+                  "certificateThumbprint": "5F3660C715EBBDA31DB1FFDCF508302348DE8E7A"
+                }
+              ],
+              "clientCertificateCommonNames": [
+                {
+                  "isAdmin": true,
+                  "certificateCommonName": "abc.com",
+                  "certificateIssuerThumbprint": "5F3660C715EBBDA31DB1FFDCF508302348DE8E7A"
+                }
+              ],
+              "fabricSettings": [
+                {
+                  "name": "UpgradeService",
+                  "parameters": [
+                    {
+                      "name": "AppPollIntervalInSeconds",
+                      "value": "60"
+                    }
+                  ]
+                }
+              ],
+              "upgradeDescription": {
+                "forceRestart": false,
+                "upgradeReplicaSetCheckTimeout": "00:10:00",
+                "healthCheckWaitDuration": "00:00:30",
+                "healthCheckStableDuration": "00:00:30",
+                "healthCheckRetryTimeout": "00:05:00",
+                "upgradeTimeout": "01:00:00",
+                "upgradeDomainTimeout": "00:15:00",
+                "healthPolicy": {
+                  "maxPercentUnhealthyNodes": 0,
+                  "maxPercentUnhealthyApplications": 0,
+                  "applicationHealthPolicies": {
+                    "fabric:/myApp1": {
+                      "defaultServiceTypeHealthPolicy": {
+                        "maxPercentUnhealthyServices": 0
+                      },
+                      "serviceTypeHealthPolicies": {
+                        "myServiceType1": {
+                          "maxPercentUnhealthyServices": 100
+                        }
+                      }
+                    }
+                  }
+                },
+                "deltaHealthPolicy": {
+                  "maxPercentDeltaUnhealthyNodes": 0,
+                  "maxPercentUpgradeDomainDeltaUnhealthyNodes": 0,
+                  "maxPercentDeltaUnhealthyApplications": 0,
+                  "applicationDeltaHealthPolicies": {
+                    "fabric:/myApp1": {
+                      "defaultServiceTypeDeltaHealthPolicy": {
+                        "maxPercentDeltaUnhealthyServices": 0
+                      },
+                      "serviceTypeDeltaHealthPolicies": {
+                        "myServiceType1": {
+                          "maxPercentDeltaUnhealthyServices": 0
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "diagnosticsStorageAccountConfig": {
+                "storageAccountName": "diag",
+                "protectedAccountKeyName": "StorageAccountKey1",
+                "blobEndpoint": "https://diag.blob.core.windows.net/",
+                "queueEndpoint": "https://diag.queue.core.windows.net/",
+                "tableEndpoint": "https://diag.table.core.windows.net/"
+              },
+              "nodeTypes": [
+                {
+                  "name": "nt1vm",
+                  "clientConnectionEndpointPort": 19000,
+                  "httpGatewayEndpointPort": 19007,
+                  "applicationPorts": {
+                    "startPort": 20000,
+                    "endPort": 30000
+                  },
+                  "ephemeralPorts": {
+                    "startPort": 49000,
+                    "endPort": 64000
+                  },
+                  "isPrimary": true,
+                  "vmInstanceCount": 5,
+                  "durabilityLevel": "Bronze"
+                }
+              ],
+              "vmImage": "Windows",
+              "azureActiveDirectory": {
+                "tenantId": "6abcc6a0-8666-43f1-87b8-172cf86a9f9c",
+                "clusterApplication": "5886372e-7bf4-4878-a497-8098aba608ae",
+                "clientApplication": "d151ad89-4bce-4ae8-b3d1-1dc79679fa75"
+              },
+              "reliabilityLevel": "Silver",
+              "reverseProxyCertificateCommonNames": {
+                "commonNames": [
+                  {
+                    "certificateCommonName": "abc.com",
+                    "certificateIssuerThumbprint": "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
+                  }
+                ],
+                "x509StoreName": "My"
+              },
+              "upgradeMode": "Manual",
+              "availableClusterVersions": [
+                {
+                  "codeVersion": "6.1.480.9494",
+                  "supportExpiryUtc": "2018-06-15T23:59:59.9999999",
+                  "environment": "Windows"
+                }
+              ],
+              "addOnFeatures": [
+                "RepairManager",
+                "DnsService",
+                "BackupRestoreService",
+                "ResourceMonitorService"
+              ]
+            }
+          },
+          {
+            "type": "Microsoft.ServiceFabric/clusters",
+            "location": "eastus",
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster2",
+            "name": "myCluster2",
+            "tags": {},
+            "etag": "W/\"636462502164040075\"",
+            "properties": {
+              "provisioningState": "Succeeded",
+              "clusterId": "2747e469-b24e-4039-8a0a-46151419523f",
+              "clusterCodeVersion": "6.1.187.1",
+              "clusterState": "WaitingForNodes",
+              "managementEndpoint": "http://myCluster2.eastus.cloudapp.azure.com:19080",
+              "clusterEndpoint": "https://eastus.servicefabric.azure.com",
+              "clientCertificateThumbprints": [],
+              "clientCertificateCommonNames": [],
+              "fabricSettings": [
+                {
+                  "name": "UpgradeService",
+                  "parameters": [
+                    {
+                      "name": "AppPollIntervalInSeconds",
+                      "value": "60"
+                    }
+                  ]
+                }
+              ],
+              "upgradeDescription": {
+                "forceRestart": false,
+                "upgradeReplicaSetCheckTimeout": "00:10:00",
+                "healthCheckWaitDuration": "00:00:30",
+                "healthCheckStableDuration": "00:00:30",
+                "healthCheckRetryTimeout": "00:05:00",
+                "upgradeTimeout": "01:00:00",
+                "upgradeDomainTimeout": "00:15:00",
+                "healthPolicy": {
+                  "maxPercentUnhealthyNodes": 0,
+                  "maxPercentUnhealthyApplications": 0
+                },
+                "deltaHealthPolicy": {
+                  "maxPercentDeltaUnhealthyNodes": 0,
+                  "maxPercentUpgradeDomainDeltaUnhealthyNodes": 0,
+                  "maxPercentDeltaUnhealthyApplications": 0
+                }
+              },
+              "diagnosticsStorageAccountConfig": {
+                "storageAccountName": "diag",
+                "protectedAccountKeyName": "StorageAccountKey1",
+                "blobEndpoint": "https://diag.blob.core.windows.net/",
+                "queueEndpoint": "https://diag.queue.core.windows.net/",
+                "tableEndpoint": "https://diag.table.core.windows.net/"
+              },
+              "nodeTypes": [
+                {
+                  "name": "nt1vm",
+                  "clientConnectionEndpointPort": 19000,
+                  "httpGatewayEndpointPort": 19007,
+                  "applicationPorts": {
+                    "startPort": 20000,
+                    "endPort": 30000
+                  },
+                  "ephemeralPorts": {
+                    "startPort": 49000,
+                    "endPort": 64000
+                  },
+                  "isPrimary": true,
+                  "vmInstanceCount": 5,
+                  "durabilityLevel": "Bronze"
+                }
+              ],
+              "vmImage": "Ubuntu",
+              "reliabilityLevel": "Silver",
+              "upgradeMode": "Manual",
+              "availableClusterVersions": [
+                {
+                  "codeVersion": "6.1.187.1",
+                  "supportExpiryUtc": "2018-06-15T23:59:59.9999999",
+                  "environment": "Linux"
+                }
+              ],
+              "addOnFeatures": [
+                "RepairManager"
+              ]
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterListOperation_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterListOperation_example.json
new file mode 100644
index 000000000000..2029a1f6fea2
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterListOperation_example.json
@@ -0,0 +1,247 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "api-version": "2020-03-01"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "value": [
+          {
+            "type": "Microsoft.ServiceFabric/clusters",
+            "location": "eastus",
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster",
+            "name": "myCluster",
+            "tags": {},
+            "etag": "W/\"636462502169240745\"",
+            "properties": {
+              "provisioningState": "Succeeded",
+              "clusterId": "92584666-9889-4ae8-8d02-91902923d37f",
+              "clusterCodeVersion": "6.1.480.9494",
+              "clusterState": "WaitingForNodes",
+              "managementEndpoint": "https://myCluster.eastus.cloudapp.azure.com:19080",
+              "clusterEndpoint": "https://eastus.servicefabric.azure.com",
+              "certificateCommonNames": {
+                "commonNames": [
+                  {
+                    "certificateCommonName": "abc.com",
+                    "certificateIssuerThumbprint": "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
+                  }
+                ],
+                "x509StoreName": "My"
+              },
+              "clientCertificateThumbprints": [
+                {
+                  "isAdmin": false,
+                  "certificateThumbprint": "5F3660C715EBBDA31DB1FFDCF508302348DE8E7A"
+                }
+              ],
+              "clientCertificateCommonNames": [
+                {
+                  "isAdmin": true,
+                  "certificateCommonName": "abc.com",
+                  "certificateIssuerThumbprint": "5F3660C715EBBDA31DB1FFDCF508302348DE8E7A"
+                }
+              ],
+              "fabricSettings": [
+                {
+                  "name": "UpgradeService",
+                  "parameters": [
+                    {
+                      "name": "AppPollIntervalInSeconds",
+                      "value": "60"
+                    }
+                  ]
+                }
+              ],
+              "upgradeDescription": {
+                "forceRestart": false,
+                "upgradeReplicaSetCheckTimeout": "00:10:00",
+                "healthCheckWaitDuration": "00:00:30",
+                "healthCheckStableDuration": "00:00:30",
+                "healthCheckRetryTimeout": "00:05:00",
+                "upgradeTimeout": "01:00:00",
+                "upgradeDomainTimeout": "00:15:00",
+                "healthPolicy": {
+                  "maxPercentUnhealthyNodes": 0,
+                  "maxPercentUnhealthyApplications": 0,
+                  "applicationHealthPolicies": {
+                    "fabric:/myApp1": {
+                      "defaultServiceTypeHealthPolicy": {
+                        "maxPercentUnhealthyServices": 0
+                      },
+                      "serviceTypeHealthPolicies": {
+                        "myServiceType1": {
+                          "maxPercentUnhealthyServices": 100
+                        }
+                      }
+                    }
+                  }
+                },
+                "deltaHealthPolicy": {
+                  "maxPercentDeltaUnhealthyNodes": 0,
+                  "maxPercentUpgradeDomainDeltaUnhealthyNodes": 0,
+                  "maxPercentDeltaUnhealthyApplications": 0,
+                  "applicationDeltaHealthPolicies": {
+                    "fabric:/myApp1": {
+                      "defaultServiceTypeDeltaHealthPolicy": {
+                        "maxPercentDeltaUnhealthyServices": 0
+                      },
+                      "serviceTypeDeltaHealthPolicies": {
+                        "myServiceType1": {
+                          "maxPercentDeltaUnhealthyServices": 0
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "diagnosticsStorageAccountConfig": {
+                "storageAccountName": "diag",
+                "protectedAccountKeyName": "StorageAccountKey1",
+                "blobEndpoint": "https://diag.blob.core.windows.net/",
+                "queueEndpoint": "https://diag.queue.core.windows.net/",
+                "tableEndpoint": "https://diag.table.core.windows.net/"
+              },
+              "nodeTypes": [
+                {
+                  "name": "nt1vm",
+                  "clientConnectionEndpointPort": 19000,
+                  "httpGatewayEndpointPort": 19007,
+                  "applicationPorts": {
+                    "startPort": 20000,
+                    "endPort": 30000
+                  },
+                  "ephemeralPorts": {
+                    "startPort": 49000,
+                    "endPort": 64000
+                  },
+                  "isPrimary": true,
+                  "vmInstanceCount": 5,
+                  "durabilityLevel": "Bronze"
+                }
+              ],
+              "vmImage": "Windows",
+              "azureActiveDirectory": {
+                "tenantId": "6abcc6a0-8666-43f1-87b8-172cf86a9f9c",
+                "clusterApplication": "5886372e-7bf4-4878-a497-8098aba608ae",
+                "clientApplication": "d151ad89-4bce-4ae8-b3d1-1dc79679fa75"
+              },
+              "reliabilityLevel": "Silver",
+              "reverseProxyCertificateCommonNames": {
+                "commonNames": [
+                  {
+                    "certificateCommonName": "abc.com",
+                    "certificateIssuerThumbprint": "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
+                  }
+                ],
+                "x509StoreName": "My"
+              },
+              "upgradeMode": "Manual",
+              "availableClusterVersions": [
+                {
+                  "codeVersion": "6.1.480.9494",
+                  "supportExpiryUtc": "2018-06-15T23:59:59.9999999",
+                  "environment": "Windows"
+                }
+              ],
+              "addOnFeatures": [
+                "RepairManager",
+                "DnsService",
+                "BackupRestoreService",
+                "ResourceMonitorService"
+              ]
+            }
+          },
+          {
+            "type": "Microsoft.ServiceFabric/clusters",
+            "location": "eastus",
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster2",
+            "name": "myCluster2",
+            "tags": {},
+            "etag": "W/\"636462502164040075\"",
+            "properties": {
+              "provisioningState": "Succeeded",
+              "clusterId": "2747e469-b24e-4039-8a0a-46151419523f",
+              "clusterCodeVersion": "6.1.187.1",
+              "clusterState": "WaitingForNodes",
+              "managementEndpoint": "http://myCluster2.eastus.cloudapp.azure.com:19080",
+              "clusterEndpoint": "https://eastus.servicefabric.azure.com",
+              "clientCertificateThumbprints": [],
+              "clientCertificateCommonNames": [],
+              "fabricSettings": [
+                {
+                  "name": "UpgradeService",
+                  "parameters": [
+                    {
+                      "name": "AppPollIntervalInSeconds",
+                      "value": "60"
+                    }
+                  ]
+                }
+              ],
+              "upgradeDescription": {
+                "forceRestart": false,
+                "upgradeReplicaSetCheckTimeout": "00:10:00",
+                "healthCheckWaitDuration": "00:00:30",
+                "healthCheckStableDuration": "00:00:30",
+                "healthCheckRetryTimeout": "00:05:00",
+                "upgradeTimeout": "01:00:00",
+                "upgradeDomainTimeout": "00:15:00",
+                "healthPolicy": {
+                  "maxPercentUnhealthyNodes": 0,
+                  "maxPercentUnhealthyApplications": 0
+                },
+                "deltaHealthPolicy": {
+                  "maxPercentDeltaUnhealthyNodes": 0,
+                  "maxPercentUpgradeDomainDeltaUnhealthyNodes": 0,
+                  "maxPercentDeltaUnhealthyApplications": 0
+                }
+              },
+              "diagnosticsStorageAccountConfig": {
+                "storageAccountName": "diag",
+                "protectedAccountKeyName": "StorageAccountKey1",
+                "blobEndpoint": "https://diag.blob.core.windows.net/",
+                "queueEndpoint": "https://diag.queue.core.windows.net/",
+                "tableEndpoint": "https://diag.table.core.windows.net/"
+              },
+              "nodeTypes": [
+                {
+                  "name": "nt1vm",
+                  "clientConnectionEndpointPort": 19000,
+                  "httpGatewayEndpointPort": 19007,
+                  "applicationPorts": {
+                    "startPort": 20000,
+                    "endPort": 30000
+                  },
+                  "ephemeralPorts": {
+                    "startPort": 49000,
+                    "endPort": 64000
+                  },
+                  "isPrimary": true,
+                  "vmInstanceCount": 5,
+                  "durabilityLevel": "Bronze"
+                }
+              ],
+              "vmImage": "Ubuntu",
+              "reliabilityLevel": "Silver",
+              "upgradeMode": "Manual",
+              "availableClusterVersions": [
+                {
+                  "codeVersion": "6.1.187.1",
+                  "supportExpiryUtc": "2018-06-15T23:59:59.9999999",
+                  "environment": "Linux"
+                }
+              ],
+              "addOnFeatures": [
+                "RepairManager"
+              ]
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterPatchOperation_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterPatchOperation_example.json
new file mode 100644
index 000000000000..9433d4fa7970
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterPatchOperation_example.json
@@ -0,0 +1,284 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "api-version": "2020-03-01",
+    "parameters": {
+      "tags": {
+        "a": "b"
+      },
+      "properties": {
+        "nodeTypes": [
+          {
+            "name": "nt1vm",
+            "clientConnectionEndpointPort": 19000,
+            "httpGatewayEndpointPort": 19007,
+            "applicationPorts": {
+              "startPort": 20000,
+              "endPort": 30000
+            },
+            "ephemeralPorts": {
+              "startPort": 49000,
+              "endPort": 64000
+            },
+            "isPrimary": true,
+            "vmInstanceCount": 5,
+            "durabilityLevel": "Bronze"
+          },
+          {
+            "name": "testnt1",
+            "clientConnectionEndpointPort": 0,
+            "httpGatewayEndpointPort": 0,
+            "applicationPorts": {
+              "startPort": 1000,
+              "endPort": 2000
+            },
+            "ephemeralPorts": {
+              "startPort": 3000,
+              "endPort": 4000
+            },
+            "isPrimary": false,
+            "vmInstanceCount": 3,
+            "durabilityLevel": "Bronze"
+          }
+        ],
+        "reliabilityLevel": "Bronze",
+        "upgradeMode": "Automatic",
+        "eventStoreServiceEnabled": true
+      }
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Retry-After": "10",
+        "Location": "http://10.91.140.224/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/operationResults/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2020-03-01"
+      },
+      "body": {
+        "type": "Microsoft.ServiceFabric/clusters",
+        "location": "eastus",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster",
+        "name": "myCluster",
+        "tags": {
+          "a": "b"
+        },
+        "etag": "W/\"636462502169240744\"",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "clusterId": "92584666-9889-4ae8-8d02-91902923d37f",
+          "clusterCodeVersion": "6.1.480.9494",
+          "clusterState": "WaitingForNodes",
+          "managementEndpoint": "http://myCluster.eastus.cloudapp.azure.com:19080",
+          "clusterEndpoint": "https://eastus.servicefabric.azure.com",
+          "certificateCommonNames": {
+            "commonNames": [
+              {
+                "certificateCommonName": "abc.com",
+                "certificateIssuerThumbprint": "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
+              }
+            ],
+            "x509StoreName": "My"
+          },
+          "clientCertificateThumbprints": [],
+          "clientCertificateCommonNames": [],
+          "eventStoreServiceEnabled": true,
+          "fabricSettings": [
+            {
+              "name": "UpgradeService",
+              "parameters": [
+                {
+                  "name": "AppPollIntervalInSeconds",
+                  "value": "60"
+                }
+              ]
+            }
+          ],
+          "upgradeDescription": {
+            "forceRestart": false,
+            "upgradeReplicaSetCheckTimeout": "00:10:00",
+            "healthCheckWaitDuration": "00:00:30",
+            "healthCheckStableDuration": "00:00:30",
+            "healthCheckRetryTimeout": "00:05:00",
+            "upgradeTimeout": "01:00:00",
+            "upgradeDomainTimeout": "00:15:00",
+            "healthPolicy": {
+              "maxPercentUnhealthyNodes": 0,
+              "maxPercentUnhealthyApplications": 0
+            },
+            "deltaHealthPolicy": {
+              "maxPercentDeltaUnhealthyNodes": 0,
+              "maxPercentUpgradeDomainDeltaUnhealthyNodes": 0,
+              "maxPercentDeltaUnhealthyApplications": 0
+            }
+          },
+          "diagnosticsStorageAccountConfig": {
+            "storageAccountName": "diag",
+            "protectedAccountKeyName": "StorageAccountKey1",
+            "blobEndpoint": "https://diag.blob.core.windows.net/",
+            "queueEndpoint": "https://diag.queue.core.windows.net/",
+            "tableEndpoint": "https://diag.table.core.windows.net/"
+          },
+          "nodeTypes": [
+            {
+              "name": "nt1vm",
+              "clientConnectionEndpointPort": 19000,
+              "httpGatewayEndpointPort": 19007,
+              "applicationPorts": {
+                "startPort": 20000,
+                "endPort": 30000
+              },
+              "ephemeralPorts": {
+                "startPort": 49000,
+                "endPort": 64000
+              },
+              "isPrimary": true,
+              "vmInstanceCount": 5,
+              "durabilityLevel": "Bronze"
+            },
+            {
+              "name": "testnt1",
+              "clientConnectionEndpointPort": 0,
+              "httpGatewayEndpointPort": 0,
+              "applicationPorts": {
+                "startPort": 1000,
+                "endPort": 2000
+              },
+              "ephemeralPorts": {
+                "startPort": 3000,
+                "endPort": 4000
+              },
+              "isPrimary": false,
+              "vmInstanceCount": 3,
+              "durabilityLevel": "Bronze"
+            }
+          ],
+          "reliabilityLevel": "Bronze",
+          "upgradeMode": "Automatic",
+          "availableClusterVersions": [
+            {
+              "codeVersion": "6.1.480.9494",
+              "supportExpiryUtc": "2018-06-15T23:59:59.9999999",
+              "environment": "Windows"
+            }
+          ]
+        }
+      }
+    },
+    "200": {
+      "headers": {
+        "Retry-After": "10",
+        "Location": "http://10.91.140.224/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/operationResults/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2020-03-01"
+      },
+      "body": {
+        "type": "Microsoft.ServiceFabric/clusters",
+        "location": "eastus",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster",
+        "name": "myCluster",
+        "tags": {
+          "a": "b"
+        },
+        "etag": "W/\"636462502169240744\"",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "clusterId": "92584666-9889-4ae8-8d02-91902923d37f",
+          "clusterCodeVersion": "6.1.480.9494",
+          "clusterState": "WaitingForNodes",
+          "managementEndpoint": "http://myCluster.eastus.cloudapp.azure.com:19080",
+          "clusterEndpoint": "https://eastus.servicefabric.azure.com",
+          "certificateCommonNames": {
+            "commonNames": [
+              {
+                "certificateCommonName": "abc.com",
+                "certificateIssuerThumbprint": "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
+              }
+            ],
+            "x509StoreName": "My"
+          },
+          "clientCertificateThumbprints": [],
+          "clientCertificateCommonNames": [],
+          "eventStoreServiceEnabled": true,
+          "fabricSettings": [
+            {
+              "name": "UpgradeService",
+              "parameters": [
+                {
+                  "name": "AppPollIntervalInSeconds",
+                  "value": "60"
+                }
+              ]
+            }
+          ],
+          "upgradeDescription": {
+            "forceRestart": false,
+            "upgradeReplicaSetCheckTimeout": "00:10:00",
+            "healthCheckWaitDuration": "00:00:30",
+            "healthCheckStableDuration": "00:00:30",
+            "healthCheckRetryTimeout": "00:05:00",
+            "upgradeTimeout": "01:00:00",
+            "upgradeDomainTimeout": "00:15:00",
+            "healthPolicy": {
+              "maxPercentUnhealthyNodes": 0,
+              "maxPercentUnhealthyApplications": 0
+            },
+            "deltaHealthPolicy": {
+              "maxPercentDeltaUnhealthyNodes": 0,
+              "maxPercentUpgradeDomainDeltaUnhealthyNodes": 0,
+              "maxPercentDeltaUnhealthyApplications": 0
+            }
+          },
+          "diagnosticsStorageAccountConfig": {
+            "storageAccountName": "diag",
+            "protectedAccountKeyName": "StorageAccountKey1",
+            "blobEndpoint": "https://diag.blob.core.windows.net/",
+            "queueEndpoint": "https://diag.queue.core.windows.net/",
+            "tableEndpoint": "https://diag.table.core.windows.net/"
+          },
+          "nodeTypes": [
+            {
+              "name": "nt1vm",
+              "clientConnectionEndpointPort": 19000,
+              "httpGatewayEndpointPort": 19007,
+              "applicationPorts": {
+                "startPort": 20000,
+                "endPort": 30000
+              },
+              "ephemeralPorts": {
+                "startPort": 49000,
+                "endPort": 64000
+              },
+              "isPrimary": true,
+              "vmInstanceCount": 5,
+              "durabilityLevel": "Bronze"
+            },
+            {
+              "name": "testnt1",
+              "clientConnectionEndpointPort": 0,
+              "httpGatewayEndpointPort": 0,
+              "applicationPorts": {
+                "startPort": 1000,
+                "endPort": 2000
+              },
+              "ephemeralPorts": {
+                "startPort": 3000,
+                "endPort": 4000
+              },
+              "isPrimary": false,
+              "vmInstanceCount": 3,
+              "durabilityLevel": "Bronze"
+            }
+          ],
+          "reliabilityLevel": "Bronze",
+          "upgradeMode": "Automatic",
+          "availableClusterVersions": [
+            {
+              "codeVersion": "6.1.480.9494",
+              "supportExpiryUtc": "2018-06-15T23:59:59.9999999",
+              "environment": "Windows"
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterPutOperation_example_max.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterPutOperation_example_max.json
new file mode 100644
index 000000000000..1cd8e08242d1
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterPutOperation_example_max.json
@@ -0,0 +1,447 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "api-version": "2020-03-01",
+    "parameters": {
+      "location": "eastus",
+      "properties": {
+        "clusterCodeVersion": "6.5.639.9590",
+        "managementEndpoint": "https://myCluster.eastus.cloudapp.azure.com:19080",
+        "certificateCommonNames": {
+          "commonNames": [
+            {
+              "certificateCommonName": "abc.com",
+              "certificateIssuerThumbprint": "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
+            }
+          ],
+          "x509StoreName": "My"
+        },
+        "clientCertificateThumbprints": [
+          {
+            "isAdmin": true,
+            "certificateThumbprint": "5F3660C715EBBDA31DB1FFDCF508302348DE8E7A"
+          }
+        ],
+        "clientCertificateCommonNames": [
+          {
+            "isAdmin": true,
+            "certificateCommonName": "abc.com",
+            "certificateIssuerThumbprint": "5F3660C715EBBDA31DB1FFDCF508302348DE8E7A"
+          }
+        ],
+        "fabricSettings": [
+          {
+            "name": "UpgradeService",
+            "parameters": [
+              {
+                "name": "AppPollIntervalInSeconds",
+                "value": "60"
+              }
+            ]
+          }
+        ],
+        "upgradeDescription": {
+          "forceRestart": false,
+          "upgradeReplicaSetCheckTimeout": "00:10:00",
+          "healthCheckWaitDuration": "00:00:30",
+          "healthCheckStableDuration": "00:00:30",
+          "healthCheckRetryTimeout": "00:05:00",
+          "upgradeTimeout": "01:00:00",
+          "upgradeDomainTimeout": "00:15:00",
+          "healthPolicy": {
+            "maxPercentUnhealthyNodes": 0,
+            "maxPercentUnhealthyApplications": 0,
+            "applicationHealthPolicies": {
+              "fabric:/myApp1": {
+                "defaultServiceTypeHealthPolicy": {
+                  "maxPercentUnhealthyServices": 0
+                },
+                "serviceTypeHealthPolicies": {
+                  "myServiceType1": {
+                    "maxPercentUnhealthyServices": 100
+                  }
+                }
+              }
+            }
+          },
+          "deltaHealthPolicy": {
+            "maxPercentDeltaUnhealthyNodes": 0,
+            "maxPercentUpgradeDomainDeltaUnhealthyNodes": 0,
+            "maxPercentDeltaUnhealthyApplications": 0,
+            "applicationDeltaHealthPolicies": {
+              "fabric:/myApp1": {
+                "defaultServiceTypeDeltaHealthPolicy": {
+                  "maxPercentDeltaUnhealthyServices": 0
+                },
+                "serviceTypeDeltaHealthPolicies": {
+                  "myServiceType1": {
+                    "maxPercentDeltaUnhealthyServices": 0
+                  }
+                }
+              }
+            }
+          }
+        },
+        "diagnosticsStorageAccountConfig": {
+          "storageAccountName": "diag",
+          "protectedAccountKeyName": "StorageAccountKey1",
+          "blobEndpoint": "https://diag.blob.core.windows.net/",
+          "queueEndpoint": "https://diag.queue.core.windows.net/",
+          "tableEndpoint": "https://diag.table.core.windows.net/"
+        },
+        "nodeTypes": [
+          {
+            "name": "nt1vm",
+            "clientConnectionEndpointPort": 19000,
+            "httpGatewayEndpointPort": 19007,
+            "applicationPorts": {
+              "startPort": 20000,
+              "endPort": 30000
+            },
+            "ephemeralPorts": {
+              "startPort": 49000,
+              "endPort": 64000
+            },
+            "isPrimary": true,
+            "vmInstanceCount": 5,
+            "durabilityLevel": "Bronze"
+          }
+        ],
+        "vmImage": "Windows",
+        "azureActiveDirectory": {
+          "tenantId": "6abcc6a0-8666-43f1-87b8-172cf86a9f9c",
+          "clusterApplication": "5886372e-7bf4-4878-a497-8098aba608ae",
+          "clientApplication": "d151ad89-4bce-4ae8-b3d1-1dc79679fa75"
+        },
+        "reliabilityLevel": "Silver",
+        "reverseProxyCertificateCommonNames": {
+          "commonNames": [
+            {
+              "certificateCommonName": "abc.com",
+              "certificateIssuerThumbprint": "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
+            }
+          ],
+          "x509StoreName": "My"
+        },
+        "upgradeMode": "Manual",
+        "addOnFeatures": [
+          "RepairManager",
+          "DnsService",
+          "BackupRestoreService",
+          "ResourceMonitorService"
+        ],
+        "eventStoreServiceEnabled": true
+      }
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Retry-After": "10",
+        "Location": "http://10.91.140.224/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/operationResults/4b5f6709-bc12-4365-8df3-894984b2a221?api-version=2020-03-01"
+      },
+      "body": {
+        "type": "Microsoft.ServiceFabric/clusters",
+        "location": "eastus",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster",
+        "name": "myCluster",
+        "tags": {},
+        "etag": "W/\"636462502169240745\"",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "clusterId": "92584666-9889-4ae8-8d02-91902923d37f",
+          "clusterCodeVersion": "6.1.480.9494",
+          "clusterState": "WaitingForNodes",
+          "managementEndpoint": "https://myCluster.eastus.cloudapp.azure.com:19080",
+          "clusterEndpoint": "https://eastus.servicefabric.azure.com",
+          "certificateCommonNames": {
+            "commonNames": [
+              {
+                "certificateCommonName": "abc.com",
+                "certificateIssuerThumbprint": "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
+              }
+            ],
+            "x509StoreName": "My"
+          },
+          "clientCertificateThumbprints": [
+            {
+              "isAdmin": false,
+              "certificateThumbprint": "5F3660C715EBBDA31DB1FFDCF508302348DE8E7A"
+            }
+          ],
+          "clientCertificateCommonNames": [
+            {
+              "isAdmin": true,
+              "certificateCommonName": "abc.com",
+              "certificateIssuerThumbprint": "5F3660C715EBBDA31DB1FFDCF508302348DE8E7A"
+            }
+          ],
+          "fabricSettings": [
+            {
+              "name": "UpgradeService",
+              "parameters": [
+                {
+                  "name": "AppPollIntervalInSeconds",
+                  "value": "60"
+                }
+              ]
+            }
+          ],
+          "upgradeDescription": {
+            "forceRestart": true,
+            "upgradeReplicaSetCheckTimeout": "00:10:00",
+            "healthCheckWaitDuration": "00:00:30",
+            "healthCheckStableDuration": "00:00:30",
+            "healthCheckRetryTimeout": "00:05:00",
+            "upgradeTimeout": "00:15:00",
+            "upgradeDomainTimeout": "00:15:00",
+            "healthPolicy": {
+              "maxPercentUnhealthyNodes": 0,
+              "maxPercentUnhealthyApplications": 0,
+              "applicationHealthPolicies": {
+                "fabric:/myApp1": {
+                  "defaultServiceTypeHealthPolicy": {
+                    "maxPercentUnhealthyServices": 0
+                  },
+                  "serviceTypeHealthPolicies": {
+                    "myServiceType1": {
+                      "maxPercentUnhealthyServices": 100
+                    }
+                  }
+                }
+              }
+            },
+            "deltaHealthPolicy": {
+              "maxPercentDeltaUnhealthyNodes": 0,
+              "maxPercentUpgradeDomainDeltaUnhealthyNodes": 0,
+              "maxPercentDeltaUnhealthyApplications": 0,
+              "applicationDeltaHealthPolicies": {
+                "fabric:/myApp1": {
+                  "defaultServiceTypeDeltaHealthPolicy": {
+                    "maxPercentDeltaUnhealthyServices": 0
+                  },
+                  "serviceTypeDeltaHealthPolicies": {
+                    "myServiceType1": {
+                      "maxPercentDeltaUnhealthyServices": 0
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "diagnosticsStorageAccountConfig": {
+            "storageAccountName": "diag",
+            "protectedAccountKeyName": "StorageAccountKey1",
+            "blobEndpoint": "https://diag.blob.core.windows.net/",
+            "queueEndpoint": "https://diag.queue.core.windows.net/",
+            "tableEndpoint": "https://diag.table.core.windows.net/"
+          },
+          "nodeTypes": [
+            {
+              "name": "nt1vm",
+              "clientConnectionEndpointPort": 19000,
+              "httpGatewayEndpointPort": 19007,
+              "applicationPorts": {
+                "startPort": 20000,
+                "endPort": 30000
+              },
+              "ephemeralPorts": {
+                "startPort": 49000,
+                "endPort": 64000
+              },
+              "isPrimary": true,
+              "vmInstanceCount": 5,
+              "durabilityLevel": "Bronze"
+            }
+          ],
+          "vmImage": "Windows",
+          "azureActiveDirectory": {
+            "tenantId": "6abcc6a0-8666-43f1-87b8-172cf86a9f9c",
+            "clusterApplication": "5886372e-7bf4-4878-a497-8098aba608ae",
+            "clientApplication": "d151ad89-4bce-4ae8-b3d1-1dc79679fa75"
+          },
+          "reliabilityLevel": "Silver",
+          "reverseProxyCertificateCommonNames": {
+            "commonNames": [
+              {
+                "certificateCommonName": "abc.com",
+                "certificateIssuerThumbprint": "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
+              }
+            ],
+            "x509StoreName": "My"
+          },
+          "upgradeMode": "Manual",
+          "availableClusterVersions": [
+            {
+              "codeVersion": "6.1.480.9494",
+              "supportExpiryUtc": "2018-06-15T23:59:59.9999999",
+              "environment": "Windows"
+            }
+          ],
+          "addOnFeatures": [
+            "RepairManager",
+            "DnsService",
+            "BackupRestoreService",
+            "ResourceMonitorService"
+          ],
+          "eventStoreServiceEnabled": true
+        }
+      }
+    },
+    "200": {
+      "headers": {
+        "Retry-After": "10",
+        "Location": "http://10.91.140.224/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/operationResults/4b5f6709-bc12-4365-8df3-894984b2a221?api-version=2020-03-01"
+      },
+      "body": {
+        "type": "Microsoft.ServiceFabric/clusters",
+        "location": "eastus",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster",
+        "name": "myCluster",
+        "tags": {},
+        "etag": "W/\"636462502169240745\"",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "clusterId": "92584666-9889-4ae8-8d02-91902923d37f",
+          "clusterCodeVersion": "6.1.480.9494",
+          "clusterState": "WaitingForNodes",
+          "managementEndpoint": "https://myCluster.eastus.cloudapp.azure.com:19080",
+          "clusterEndpoint": "https://eastus.servicefabric.azure.com",
+          "certificateCommonNames": {
+            "commonNames": [
+              {
+                "certificateCommonName": "abc.com",
+                "certificateIssuerThumbprint": "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
+              }
+            ],
+            "x509StoreName": "My"
+          },
+          "clientCertificateThumbprints": [
+            {
+              "isAdmin": false,
+              "certificateThumbprint": "5F3660C715EBBDA31DB1FFDCF508302348DE8E7A"
+            }
+          ],
+          "clientCertificateCommonNames": [
+            {
+              "isAdmin": true,
+              "certificateCommonName": "abc.com",
+              "certificateIssuerThumbprint": "5F3660C715EBBDA31DB1FFDCF508302348DE8E7A"
+            }
+          ],
+          "fabricSettings": [
+            {
+              "name": "UpgradeService",
+              "parameters": [
+                {
+                  "name": "AppPollIntervalInSeconds",
+                  "value": "60"
+                }
+              ]
+            }
+          ],
+          "upgradeDescription": {
+            "forceRestart": true,
+            "upgradeReplicaSetCheckTimeout": "00:10:00",
+            "healthCheckWaitDuration": "00:00:30",
+            "healthCheckStableDuration": "00:00:30",
+            "healthCheckRetryTimeout": "00:05:00",
+            "upgradeTimeout": "00:15:00",
+            "upgradeDomainTimeout": "00:15:00",
+            "healthPolicy": {
+              "maxPercentUnhealthyNodes": 0,
+              "maxPercentUnhealthyApplications": 0,
+              "applicationHealthPolicies": {
+                "fabric:/myApp1": {
+                  "defaultServiceTypeHealthPolicy": {
+                    "maxPercentUnhealthyServices": 0
+                  },
+                  "serviceTypeHealthPolicies": {
+                    "myServiceType1": {
+                      "maxPercentUnhealthyServices": 100
+                    }
+                  }
+                }
+              }
+            },
+            "deltaHealthPolicy": {
+              "maxPercentDeltaUnhealthyNodes": 0,
+              "maxPercentUpgradeDomainDeltaUnhealthyNodes": 0,
+              "maxPercentDeltaUnhealthyApplications": 0,
+              "applicationDeltaHealthPolicies": {
+                "fabric:/myApp1": {
+                  "defaultServiceTypeDeltaHealthPolicy": {
+                    "maxPercentDeltaUnhealthyServices": 0
+                  },
+                  "serviceTypeDeltaHealthPolicies": {
+                    "myServiceType1": {
+                      "maxPercentDeltaUnhealthyServices": 0
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "diagnosticsStorageAccountConfig": {
+            "storageAccountName": "diag",
+            "protectedAccountKeyName": "StorageAccountKey1",
+            "blobEndpoint": "https://diag.blob.core.windows.net/",
+            "queueEndpoint": "https://diag.queue.core.windows.net/",
+            "tableEndpoint": "https://diag.table.core.windows.net/"
+          },
+          "nodeTypes": [
+            {
+              "name": "nt1vm",
+              "clientConnectionEndpointPort": 19000,
+              "httpGatewayEndpointPort": 19007,
+              "applicationPorts": {
+                "startPort": 20000,
+                "endPort": 30000
+              },
+              "ephemeralPorts": {
+                "startPort": 49000,
+                "endPort": 64000
+              },
+              "isPrimary": true,
+              "vmInstanceCount": 5,
+              "durabilityLevel": "Bronze"
+            }
+          ],
+          "vmImage": "Windows",
+          "azureActiveDirectory": {
+            "tenantId": "6abcc6a0-8666-43f1-87b8-172cf86a9f9c",
+            "clusterApplication": "5886372e-7bf4-4878-a497-8098aba608ae",
+            "clientApplication": "d151ad89-4bce-4ae8-b3d1-1dc79679fa75"
+          },
+          "reliabilityLevel": "Silver",
+          "reverseProxyCertificateCommonNames": {
+            "commonNames": [
+              {
+                "certificateCommonName": "abc.com",
+                "certificateIssuerThumbprint": "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
+              }
+            ],
+            "x509StoreName": "My"
+          },
+          "upgradeMode": "Manual",
+          "availableClusterVersions": [
+            {
+              "codeVersion": "6.1.480.9494",
+              "supportExpiryUtc": "2018-06-15T23:59:59.9999999",
+              "environment": "Windows"
+            }
+          ],
+          "addOnFeatures": [
+            "RepairManager",
+            "DnsService",
+            "BackupRestoreService",
+            "ResourceMonitorService"
+          ],
+          "eventStoreServiceEnabled": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterPutOperation_example_min.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterPutOperation_example_min.json
new file mode 100644
index 000000000000..432dd4c4ef0d
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterPutOperation_example_min.json
@@ -0,0 +1,222 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "api-version": "2020-03-01",
+    "parameters": {
+      "location": "eastus",
+      "properties": {
+        "managementEndpoint": "http://myCluster.eastus.cloudapp.azure.com:19080",
+        "fabricSettings": [
+          {
+            "name": "UpgradeService",
+            "parameters": [
+              {
+                "name": "AppPollIntervalInSeconds",
+                "value": "60"
+              }
+            ]
+          }
+        ],
+        "diagnosticsStorageAccountConfig": {
+          "storageAccountName": "diag",
+          "protectedAccountKeyName": "StorageAccountKey1",
+          "blobEndpoint": "https://diag.blob.core.windows.net/",
+          "queueEndpoint": "https://diag.queue.core.windows.net/",
+          "tableEndpoint": "https://diag.table.core.windows.net/"
+        },
+        "nodeTypes": [
+          {
+            "name": "nt1vm",
+            "clientConnectionEndpointPort": 19000,
+            "httpGatewayEndpointPort": 19007,
+            "applicationPorts": {
+              "startPort": 20000,
+              "endPort": 30000
+            },
+            "ephemeralPorts": {
+              "startPort": 49000,
+              "endPort": 64000
+            },
+            "isPrimary": true,
+            "vmInstanceCount": 5,
+            "durabilityLevel": "Bronze"
+          }
+        ],
+        "reliabilityLevel": "Silver",
+        "upgradeMode": "Automatic"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "type": "Microsoft.ServiceFabric/clusters",
+        "location": "eastus",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster",
+        "name": "myCluster",
+        "tags": {},
+        "etag": "W/\"636462502169240743\"",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "clusterId": "92584666-9889-4ae8-8d02-91902923d37f",
+          "clusterCodeVersion": "6.1.480.9494",
+          "clusterState": "WaitingForNodes",
+          "managementEndpoint": "http://myCluster.eastus.cloudapp.azure.com:19080",
+          "clusterEndpoint": "https://eastus.servicefabric.azure.com",
+          "clientCertificateThumbprints": [],
+          "clientCertificateCommonNames": [],
+          "fabricSettings": [
+            {
+              "name": "UpgradeService",
+              "parameters": [
+                {
+                  "name": "AppPollIntervalInSeconds",
+                  "value": "60"
+                }
+              ]
+            }
+          ],
+          "upgradeDescription": {
+            "forceRestart": false,
+            "upgradeReplicaSetCheckTimeout": "10675199.02:48:05.4775807",
+            "healthCheckWaitDuration": "00:05:00",
+            "healthCheckStableDuration": "00:05:00",
+            "healthCheckRetryTimeout": "00:45:00",
+            "upgradeTimeout": "12:00:00",
+            "upgradeDomainTimeout": "02:00:00",
+            "healthPolicy": {
+              "maxPercentUnhealthyNodes": 100,
+              "maxPercentUnhealthyApplications": 100
+            },
+            "deltaHealthPolicy": {
+              "maxPercentDeltaUnhealthyNodes": 0,
+              "maxPercentUpgradeDomainDeltaUnhealthyNodes": 0,
+              "maxPercentDeltaUnhealthyApplications": 0
+            }
+          },
+          "diagnosticsStorageAccountConfig": {
+            "storageAccountName": "diag",
+            "protectedAccountKeyName": "StorageAccountKey1",
+            "blobEndpoint": "https://diag.blob.core.windows.net/",
+            "queueEndpoint": "https://diag.queue.core.windows.net/",
+            "tableEndpoint": "https://diag.table.core.windows.net/"
+          },
+          "nodeTypes": [
+            {
+              "name": "nt1vm",
+              "clientConnectionEndpointPort": 19000,
+              "httpGatewayEndpointPort": 19007,
+              "applicationPorts": {
+                "startPort": 20000,
+                "endPort": 30000
+              },
+              "ephemeralPorts": {
+                "startPort": 49000,
+                "endPort": 64000
+              },
+              "isPrimary": true,
+              "vmInstanceCount": 5,
+              "durabilityLevel": "Bronze"
+            }
+          ],
+          "reliabilityLevel": "Silver",
+          "upgradeMode": "Automatic",
+          "availableClusterVersions": [
+            {
+              "codeVersion": "6.1.480.9494",
+              "supportExpiryUtc": "2018-06-15T23:59:59.9999999",
+              "environment": "Windows"
+            }
+          ]
+        }
+      }
+    },
+    "202": {
+      "headers": {},
+      "body": {
+        "type": "Microsoft.ServiceFabric/clusters",
+        "location": "eastus",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster",
+        "name": "myCluster",
+        "tags": {},
+        "etag": "W/\"636462502169240743\"",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "clusterId": "92584666-9889-4ae8-8d02-91902923d37f",
+          "clusterCodeVersion": "6.1.480.9494",
+          "clusterState": "WaitingForNodes",
+          "managementEndpoint": "http://myCluster.eastus.cloudapp.azure.com:19080",
+          "clusterEndpoint": "https://eastus.servicefabric.azure.com",
+          "clientCertificateThumbprints": [],
+          "clientCertificateCommonNames": [],
+          "fabricSettings": [
+            {
+              "name": "UpgradeService",
+              "parameters": [
+                {
+                  "name": "AppPollIntervalInSeconds",
+                  "value": "60"
+                }
+              ]
+            }
+          ],
+          "upgradeDescription": {
+            "forceRestart": false,
+            "upgradeReplicaSetCheckTimeout": "10675199.02:48:05.4775807",
+            "healthCheckWaitDuration": "00:05:00",
+            "healthCheckStableDuration": "00:05:00",
+            "healthCheckRetryTimeout": "00:45:00",
+            "upgradeTimeout": "12:00:00",
+            "upgradeDomainTimeout": "02:00:00",
+            "healthPolicy": {
+              "maxPercentUnhealthyNodes": 100,
+              "maxPercentUnhealthyApplications": 100
+            },
+            "deltaHealthPolicy": {
+              "maxPercentDeltaUnhealthyNodes": 0,
+              "maxPercentUpgradeDomainDeltaUnhealthyNodes": 0,
+              "maxPercentDeltaUnhealthyApplications": 0
+            }
+          },
+          "diagnosticsStorageAccountConfig": {
+            "storageAccountName": "diag",
+            "protectedAccountKeyName": "StorageAccountKey1",
+            "blobEndpoint": "https://diag.blob.core.windows.net/",
+            "queueEndpoint": "https://diag.queue.core.windows.net/",
+            "tableEndpoint": "https://diag.table.core.windows.net/"
+          },
+          "nodeTypes": [
+            {
+              "name": "nt1vm",
+              "clientConnectionEndpointPort": 19000,
+              "httpGatewayEndpointPort": 19007,
+              "applicationPorts": {
+                "startPort": 20000,
+                "endPort": 30000
+              },
+              "ephemeralPorts": {
+                "startPort": 49000,
+                "endPort": 64000
+              },
+              "isPrimary": true,
+              "vmInstanceCount": 5,
+              "durabilityLevel": "Bronze"
+            }
+          ],
+          "reliabilityLevel": "Silver",
+          "upgradeMode": "Automatic",
+          "availableClusterVersions": [
+            {
+              "codeVersion": "6.1.480.9494",
+              "supportExpiryUtc": "2018-06-15T23:59:59.9999999",
+              "environment": "Windows"
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterVersionsGetByEnvironment_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterVersionsGetByEnvironment_example.json
new file mode 100644
index 000000000000..d035285101be
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterVersionsGetByEnvironment_example.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "location": "eastus",
+    "environment": "Windows",
+    "clusterVersion": "6.1.480.9494",
+    "api-version": "2020-03-01"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "value": [
+          {
+            "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/environments/Windows/clusterVersions/6.1.480.9494",
+            "name": "6.1.480.9494",
+            "type": "Microsoft.ServiceFabric/locations/environments/clusterVersions",
+            "properties": {
+              "codeVersion": "6.1.480.9494",
+              "supportExpiryUtc": "2018-06-15T23:59:59.9999999",
+              "environment": "Windows"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterVersionsGet_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterVersionsGet_example.json
new file mode 100644
index 000000000000..47a35c07e387
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterVersionsGet_example.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "location": "eastus",
+    "clusterVersion": "6.1.480.9494",
+    "api-version": "2020-03-01"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "value": [
+          {
+            "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/environments/Windows/clusterVersions/6.1.480.9494",
+            "name": "6.1.480.9494",
+            "type": "Microsoft.ServiceFabric/locations/environments/clusterVersions",
+            "properties": {
+              "codeVersion": "6.1.480.9494",
+              "supportExpiryUtc": "2018-06-15T23:59:59.9999999",
+              "environment": "Windows"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterVersionsListByEnvironment.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterVersionsListByEnvironment.json
new file mode 100644
index 000000000000..0d476df85801
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterVersionsListByEnvironment.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "location": "eastus",
+    "environment": "Windows",
+    "api-version": "2020-03-01"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "value": [
+          {
+            "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/environments/Windows/clusterVersions/6.1.480.9494",
+            "name": "6.1.480.9494",
+            "type": "Microsoft.ServiceFabric/locations/environments/clusterVersions",
+            "properties": {
+              "codeVersion": "6.1.480.9494",
+              "supportExpiryUtc": "2018-06-15T23:59:59.9999999",
+              "environment": "Windows"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterVersionsList_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterVersionsList_example.json
new file mode 100644
index 000000000000..1ccb0492084b
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ClusterVersionsList_example.json
@@ -0,0 +1,36 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "location": "eastus",
+    "api-version": "2020-03-01"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "value": [
+          {
+            "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/environments/Windows/clusterVersions/6.1.480.9494",
+            "name": "6.1.480.9494",
+            "type": "Microsoft.ServiceFabric/locations/environments/clusterVersions",
+            "properties": {
+              "codeVersion": "6.1.480.9494",
+              "supportExpiryUtc": "2018-06-15T23:59:59.9999999",
+              "environment": "Windows"
+            }
+          },
+          {
+            "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/environments/Linux/clusterVersions/6.1.187.1",
+            "name": "6.1.187.1",
+            "type": "Microsoft.ServiceFabric/locations/environments/clusterVersions",
+            "properties": {
+              "codeVersion": "6.1.187.1",
+              "supportExpiryUtc": "2018-06-15T23:59:59.9999999",
+              "environment": "Linux"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ServiceDeleteOperation_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ServiceDeleteOperation_example.json
new file mode 100644
index 000000000000..d00c48075708
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ServiceDeleteOperation_example.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "applicationName": "myApp",
+    "serviceName": "myService",
+    "api-version": "2020-03-01"
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Retry-After": "10",
+        "Location": "http://10.91.140.224/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/operationResults/41fa5ef9-7f34-4c36-a730-93e0bb757d22?api-version=2020-03-01"
+      }
+    },
+    "204": {}
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ServiceGetOperation_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ServiceGetOperation_example.json
new file mode 100644
index 000000000000..b6a8e6de236b
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ServiceGetOperation_example.json
@@ -0,0 +1,42 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "applicationName": "myApp",
+    "serviceName": "myService",
+    "api-version": "2020-03-01"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "type": "services",
+        "location": "eastus",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster/applications/myApp/services/myService",
+        "name": "myCluster",
+        "tags": {},
+        "etag": "W/\"636462502183671258\"",
+        "properties": {
+          "provisioningState": "Updating",
+          "serviceKind": "Stateless",
+          "placementConstraints": "NodeType==frontend",
+          "serviceTypeName": "myServiceType",
+          "partitionDescription": {
+            "partitionScheme": "Singleton"
+          },
+          "serviceLoadMetrics": [
+            {
+              "name": "metric1",
+              "weight": "Low"
+            }
+          ],
+          "servicePlacementPolicies": [],
+          "defaultMoveCost": "Medium",
+          "instanceCount": 5,
+          "servicePackageActivationMode": "SharedProcess"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ServiceListOperation_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ServiceListOperation_example.json
new file mode 100644
index 000000000000..42185cf1ee7e
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ServiceListOperation_example.json
@@ -0,0 +1,43 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "applicationName": "myApp",
+    "api-version": "2020-03-01"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "value": [
+          {
+            "type": "services",
+            "location": "eastus",
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster/applications/myApp/services/myService",
+            "name": "myCluster",
+            "tags": {},
+            "etag": "W/\"636462502183671257\"",
+            "properties": {
+              "provisioningState": "Updating",
+              "serviceKind": "Stateless",
+              "serviceTypeName": "myServiceType",
+              "partitionDescription": {
+                "partitionScheme": "Singleton"
+              },
+              "serviceLoadMetrics": [
+                {
+                  "name": "metric1",
+                  "weight": "Low"
+                }
+              ],
+              "instanceCount": 1,
+              "servicePackageActivationMode": "SharedProcess"
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ServicePatchOperation_example.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ServicePatchOperation_example.json
new file mode 100644
index 000000000000..0880def22061
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ServicePatchOperation_example.json
@@ -0,0 +1,53 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "applicationName": "myApp",
+    "serviceName": "myService",
+    "api-version": "2020-03-01",
+    "parameters": {
+      "properties": {
+        "serviceKind": "Stateless",
+        "serviceLoadMetrics": [
+          {
+            "name": "metric1",
+            "weight": "Low"
+          }
+        ]
+      }
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Retry-After": "10",
+        "Location": "http://10.91.140.224/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/operationResults/4dde8d8b-b6b2-4c56-99c6-9b83932bb09a?api-version=2020-03-01"
+      },
+      "body": {
+        "type": "services",
+        "location": "eastus",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster/applications/myApp/services/myService",
+        "name": "myCluster",
+        "tags": {},
+        "etag": "W/\"636462502183671257\"",
+        "properties": {
+          "provisioningState": "Updating",
+          "serviceKind": "Stateless",
+          "serviceTypeName": "myServiceType",
+          "partitionDescription": {
+            "partitionScheme": "Singleton"
+          },
+          "serviceLoadMetrics": [
+            {
+              "name": "metric1",
+              "weight": "Low"
+            }
+          ],
+          "instanceCount": 1,
+          "servicePackageActivationMode": "SharedProcess"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ServicePutOperation_example_max.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ServicePutOperation_example_max.json
new file mode 100644
index 000000000000..9e96927e6137
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ServicePutOperation_example_max.json
@@ -0,0 +1,71 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "applicationName": "myApp",
+    "serviceName": "myService",
+    "api-version": "2020-03-01",
+    "parameters": {
+      "properties": {
+        "serviceKind": "Stateless",
+        "placementConstraints": "NodeType==frontend",
+        "serviceTypeName": "myServiceType",
+        "partitionDescription": {
+          "partitionScheme": "Singleton"
+        },
+        "serviceLoadMetrics": [
+          {
+            "name": "metric1",
+            "weight": "Low"
+          }
+        ],
+        "correlationScheme": [
+          {
+            "serviceName": "fabric:/app1/app1~svc1",
+            "scheme": "Affinity"
+          }
+        ],
+        "servicePlacementPolicies": [],
+        "defaultMoveCost": "Medium",
+        "instanceCount": 5,
+        "servicePackageActivationMode": "SharedProcess"
+      }
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Retry-After": "10",
+        "Location": "http://10.91.140.224/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/operationResults/2e633105-aadc-4928-9164-d76b974170a3?api-version=2020-03-01"
+      },
+      "body": {
+        "type": "services",
+        "location": "eastus",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster/applications/myApp/services/myService",
+        "name": "myCluster",
+        "tags": {},
+        "etag": "W/\"636462502183671258\"",
+        "properties": {
+          "provisioningState": "Updating",
+          "serviceKind": "Stateless",
+          "placementConstraints": "NodeType==frontend",
+          "serviceTypeName": "myServiceType",
+          "partitionDescription": {
+            "partitionScheme": "Singleton"
+          },
+          "serviceLoadMetrics": [
+            {
+              "name": "metric1",
+              "weight": "Low"
+            }
+          ],
+          "servicePlacementPolicies": [],
+          "defaultMoveCost": "Medium",
+          "instanceCount": 5,
+          "servicePackageActivationMode": "SharedProcess"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ServicePutOperation_example_min.json b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ServicePutOperation_example_min.json
new file mode 100644
index 000000000000..996bb0e410e9
--- /dev/null
+++ b/specification/servicefabric/resource-manager/Microsoft.ServiceFabric/stable/2020-03-01/examples/ServicePutOperation_example_min.json
@@ -0,0 +1,45 @@
+{
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "resRg",
+    "clusterName": "myCluster",
+    "applicationName": "myApp",
+    "serviceName": "myService",
+    "api-version": "2020-03-01",
+    "parameters": {
+      "properties": {
+        "serviceKind": "Stateless",
+        "serviceTypeName": "myServiceType",
+        "partitionDescription": {
+          "partitionScheme": "Singleton"
+        },
+        "instanceCount": 1
+      }
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Retry-After": "10",
+        "Location": "http://10.91.140.224/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/operationResults/5bc615c3-6c5b-4593-80e1-008f55376ec7?api-version=2020-03-01"
+      },
+      "body": {
+        "type": "services",
+        "location": "eastus",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster/applications/myApp/services/myService",
+        "name": "myCluster",
+        "tags": {},
+        "etag": "W/\"636462502183671256\"",
+        "properties": {
+          "provisioningState": "Updating",
+          "serviceKind": "Stateless",
+          "serviceTypeName": "myServiceType",
+          "partitionDescription": {
+            "partitionScheme": "Singleton"
+          },
+          "instanceCount": 1
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/resource-manager/readme.md b/specification/servicefabric/resource-manager/readme.md
index f958b459e5c3..6e6c5c4ec272 100644
--- a/specification/servicefabric/resource-manager/readme.md
+++ b/specification/servicefabric/resource-manager/readme.md
@@ -28,7 +28,7 @@ These are the global settings for the ServiceFabricManagementClient API.
 title: ServiceFabricManagementClient
 description: Service Fabric Management Client
 openapi-type: arm
-tag: package-2019-06-preview
+tag: package-2020-03
 
 directive:
   - suppress: ListInOperationName
@@ -59,6 +59,17 @@ directive:
     reason: There are open issues (bugs) in the validator affecting some of the examples and since there is no way to selectively disable the validation for a particular example or paths, all of the example validation is being turned off.
 
 ```
+
+### Tag: package-2020-03
+
+These settings apply only when `--tag=package-2020-03` is specified on the command line.
+
+``` yaml $(tag) == 'package-2020-03'
+input-file:
+- Microsoft.ServiceFabric/stable/2020-03-01/cluster.json
+- Microsoft.ServiceFabric/stable/2020-03-01/application.json
+```
+
 ### Tag: package-2019-06-preview
 
 These settings apply only when `--tag=package-2019-06-preview` is specified on the command line.
@@ -184,6 +195,8 @@ require: $(this-folder)/../../../profiles/readme.md
 
 # all the input files across all versions
 input-file:
+  - $(this-folder)/Microsoft.ServiceFabric/stable/2020-03-01/cluster.json
+  - $(this-folder)/Microsoft.ServiceFabric/stable/2020-03-01/application.json
   - $(this-folder)/Microsoft.ServiceFabric/preview/2019-06-01-preview/cluster.json
   - $(this-folder)/Microsoft.ServiceFabric/preview/2019-06-01-preview/application.json
   - $(this-folder)/Microsoft.ServiceFabric/stable/2019-03-01/cluster.json
diff --git a/specification/storage/resource-manager/Microsoft.Storage/stable/2019-06-01/blob.json b/specification/storage/resource-manager/Microsoft.Storage/stable/2019-06-01/blob.json
index f865b407ee2e..042a9c54143a 100644
--- a/specification/storage/resource-manager/Microsoft.Storage/stable/2019-06-01/blob.json
+++ b/specification/storage/resource-manager/Microsoft.Storage/stable/2019-06-01/blob.json
@@ -200,6 +200,9 @@
         "x-ms-examples": {
           "PutContainers": {
             "$ref": "./examples/BlobContainersPut.json"
+          },
+          "PutContainerWithDefaultEncryptionScope": {
+            "$ref": "./examples/BlobContainersPutDefaultEncryptionScope.json"
           }
         },
         "description": "Creates a new container under the specified account as described by request body. The container resource includes metadata and properties for that container. It does not include a list of the blobs contained by the container. ",
@@ -797,6 +800,14 @@
   "definitions": {
     "ContainerProperties": {
       "properties": {
+        "defaultEncryptionScope": {
+          "type": "string",
+          "description": "Default the container to use specified encryption scope for all writes."
+        },
+        "denyEncryptionScopeOverride": {
+          "type": "boolean",
+          "description": "Block override of encryption scope from the container default."
+        },
         "publicAccess": {
           "type": "string",
           "enum": [
diff --git a/specification/storage/resource-manager/Microsoft.Storage/stable/2019-06-01/examples/BlobContainersPutDefaultEncryptionScope.json b/specification/storage/resource-manager/Microsoft.Storage/stable/2019-06-01/examples/BlobContainersPutDefaultEncryptionScope.json
new file mode 100644
index 000000000000..4e84715c8f4b
--- /dev/null
+++ b/specification/storage/resource-manager/Microsoft.Storage/stable/2019-06-01/examples/BlobContainersPutDefaultEncryptionScope.json
@@ -0,0 +1,40 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "res3376",
+    "accountName": "sto328",
+    "containerName": "container6185",
+    "api-version": "2019-06-01",
+    "monitor": "true",
+    "blobContainer": {
+      "properties": {
+        "defaultEncryptionScope": "encryptionscope185",
+        "denyEncryptionScopeOverride": true
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/blobServices/default/containers/container6185",
+        "name": "container6185",
+        "type": "Microsoft.Storage/storageAccounts/blobServices/containers",
+        "properties": {
+          "defaultEncryptionScope": "encryptionscope185",
+          "denyEncryptionScopeOverride": true
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/blobServices/default/containers/container6185",
+        "name": "container6185",
+        "type": "Microsoft.Storage/storageAccounts/blobServices/containers",
+        "properties": {
+          "defaultEncryptionScope": "encryptionscope185",
+          "denyEncryptionScopeOverride": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/support/resource-manager/readme.java.md b/specification/support/resource-manager/readme.java.md
index e89c2c7bd4df..c264f75b43b6 100644
--- a/specification/support/resource-manager/readme.java.md
+++ b/specification/support/resource-manager/readme.java.md
@@ -4,14 +4,14 @@ These settings apply only when `--java` is specified on the command line.
 Please also specify `--azure-libraries-for-java-folder=<path to the root directory of your azure-libraries-for-java clone>`.
 
 ``` yaml $(java)
-java:
-  azure-arm: true
-  fluent: true
-  namespace: com.microsoft.azure.management.support
-  license-header: MICROSOFT_MIT_NO_CODEGEN
-  payload-flattening-threshold: 1
-  output-folder: $(azure-libraries-for-java-folder)/azure-mgmt-support
+azure-arm: true
+fluent: true
+namespace: com.microsoft.azure.management.support
+license-header: MICROSOFT_MIT_NO_CODEGEN
+payload-flattening-threshold: 1
+output-folder: $(azure-libraries-for-java-folder)/azure-mgmt-support
 ```
+
 ### Java multi-api
 
 ``` yaml $(java) && $(multiapi)
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimeNodes_Delete.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimeNodes_Delete.json
new file mode 100644
index 000000000000..3a6aed616b9d
--- /dev/null
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimeNodes_Delete.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "subscriptionId": "12345678-1234-1234-1234-12345678abc",
+    "resourceGroupName": "exampleResourceGroup",
+    "workspaceName": "exampleWorkspace",
+    "integrationRuntimeName": "exampleIntegrationRuntime",
+    "nodeName": "Node_1",
+    "api-version": "2019-06-01-preview"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimeNodes_Get.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimeNodes_Get.json
new file mode 100644
index 000000000000..cd3faab03c45
--- /dev/null
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimeNodes_Get.json
@@ -0,0 +1,42 @@
+{
+  "parameters": {
+    "subscriptionId": "12345678-1234-1234-1234-12345678abc",
+    "resourceGroupName": "exampleResourceGroup",
+    "workspaceName": "exampleWorkspace",
+    "integrationRuntimeName": "exampleIntegrationRuntime",
+    "nodeName": "Node_1",
+    "api-version": "2019-06-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Date": "Fri, 17 Aug 2018 06:31:04 GMT",
+        "X-Content-Type-Options": "nosniff",
+        "x-ms-ratelimit-remaining-subscription-reads": "14999",
+        "x-ms-request-id": "1c8b259a-c6e6-48aa-8121-05b3b3b782aa",
+        "x-ms-correlation-request-id": "1c8b259a-c6e6-48aa-8121-05b3b3b782aa"
+      },
+      "body": {
+        "nodeName": "Node_1",
+        "machineName": "YANZHANG-DT",
+        "hostServiceUri": "https://yanzhang-dt.fareast.corp.microsoft.com:8050/HostServiceRemote.svc/",
+        "status": "Online",
+        "capabilities": {
+          "serviceBusConnected": "True",
+          "httpsPortEnabled": "True",
+          "credentialInSync": "True",
+          "connectedToResourceManager": "True",
+          "nodeEnabled": "True"
+        },
+        "versionStatus": "UpToDate",
+        "version": "3.8.6743.6",
+        "registerTime": "2018-08-17T03:44:55.8012825Z",
+        "lastConnectTime": "2018-08-17T06:30:46.6262976Z",
+        "lastStartTime": "2018-08-17T03:45:30.8499851Z",
+        "lastUpdateResult": "None",
+        "isActiveDispatcher": true,
+        "maxConcurrentJobs": 20
+      }
+    }
+  }
+}
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimeNodes_GetIpAddress.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimeNodes_GetIpAddress.json
new file mode 100644
index 000000000000..0e027623b8df
--- /dev/null
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimeNodes_GetIpAddress.json
@@ -0,0 +1,24 @@
+{
+  "parameters": {
+    "subscriptionId": "12345678-1234-1234-1234-12345678abc",
+    "resourceGroupName": "exampleResourceGroup",
+    "workspaceName": "exampleWorkspace",
+    "integrationRuntimeName": "exampleIntegrationRuntime",
+    "nodeName": "Node_1",
+    "api-version": "2019-06-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Date": "Thu, 14 Jun 2018 15:36:39 GMT",
+        "X-Content-Type-Options": "nosniff",
+        "x-ms-ratelimit-remaining-subscription-writes": "1199",
+        "x-ms-request-id": "f01265af-9f38-44b8-81a1-b67f567ea728",
+        "x-ms-correlation-request-id": "f01265af-9f38-44b8-81a1-b67f567ea728"
+      },
+      "body": {
+        "ipAddress": "**********"
+      }
+    }
+  }
+}
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimeNodes_Update.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimeNodes_Update.json
new file mode 100644
index 000000000000..9f95b676d2e9
--- /dev/null
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimeNodes_Update.json
@@ -0,0 +1,46 @@
+{
+  "parameters": {
+    "subscriptionId": "12345678-1234-1234-1234-12345678abc",
+    "resourceGroupName": "exampleResourceGroup",
+    "workspaceName": "exampleWorkspace",
+    "integrationRuntimeName": "exampleIntegrationRuntime",
+    "nodeName": "Node_1",
+    "updateIntegrationRuntimeNodeRequest": {
+      "concurrentJobsLimit": 2
+    },
+    "api-version": "2019-06-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Date": "Thu, 14 Jun 2018 15:01:00 GMT",
+        "X-Content-Type-Options": "nosniff",
+        "x-ms-ratelimit-remaining-subscription-writes": "1199",
+        "x-ms-request-id": "cf0d05fa-afbe-4fac-aa10-227885658c83",
+        "x-ms-correlation-request-id": "cf0d05fa-afbe-4fac-aa10-227885658c83"
+      },
+      "body": {
+        "nodeName": "Node_1",
+        "machineName": "YANZHANG-DT",
+        "hostServiceUri": "https://yanzhang-dt.fareast.corp.microsoft.com:8050/HostServiceRemote.svc/",
+        "status": "Online",
+        "capabilities": {
+          "serviceBusConnected": "True",
+          "httpsPortEnabled": "True",
+          "credentialInSync": "True",
+          "connectedToResourceManager": "True",
+          "nodeEnabled": "True"
+        },
+        "versionStatus": "UpToDate",
+        "version": "3.8.6730.2",
+        "registerTime": "2018-06-14T14:51:44.9237069Z",
+        "lastConnectTime": "2018-06-14T15:00:35.7544322Z",
+        "lastStartTime": "2018-06-14T14:52:59.8933313Z",
+        "lastUpdateResult": "None",
+        "isActiveDispatcher": true,
+        "concurrentJobsLimit": 2,
+        "maxConcurrentJobs": 56
+      }
+    }
+  }
+}
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimeObjectMetadata_Get.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimeObjectMetadata_Get.json
new file mode 100644
index 000000000000..fafa1dfeca2a
--- /dev/null
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimeObjectMetadata_Get.json
@@ -0,0 +1,432 @@
+{
+  "parameters": {
+    "subscriptionId": "12345678-1234-1234-1234-12345678abc",
+    "resourceGroupName": "exampleResourceGroup",
+    "workspaceName": "exampleWorkspace",
+    "integrationRuntimeName": "testactivityv2",
+    "getMetadataRequest": {
+      "metadataPath": "ssisFolders"
+    },
+    "api-version": "2019-06-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Date": "Mon, 03 Dec 2018 06:24:54 GMT",
+        "X-Content-Type-Options": "nosniff",
+        "x-ms-ratelimit-remaining-subscription-writes": "1198",
+        "x-ms-request-id": "0cbc67c4-60e7-4d49-97d9-e4bc4f9851cd",
+        "x-ms-correlation-request-id": "0cbc67c4-60e7-4d49-97d9-e4bc4f9851cd"
+      },
+      "body": {
+        "value": [
+          {
+            "id": 1,
+            "name": "TestFolder",
+            "description": ""
+          },
+          {
+            "id": 2,
+            "name": "EnvironmentFolder",
+            "description": ""
+          },
+          {
+            "id": 3,
+            "name": "ActivityTest",
+            "description": ""
+          },
+          {
+            "id": 4,
+            "name": "这是文件夹",
+            "description": ""
+          },
+          {
+            "id": 5,
+            "name": "1"
+          },
+          {
+            "id": 6,
+            "name": "2"
+          },
+          {
+            "id": 7,
+            "name": "3"
+          },
+          {
+            "id": 8,
+            "name": "4"
+          },
+          {
+            "id": 9,
+            "name": "5"
+          },
+          {
+            "id": 10,
+            "name": "6"
+          },
+          {
+            "id": 11,
+            "name": "7"
+          },
+          {
+            "id": 12,
+            "name": "8"
+          },
+          {
+            "id": 13,
+            "name": "9"
+          },
+          {
+            "id": 14,
+            "name": "10"
+          },
+          {
+            "id": 15,
+            "name": "11"
+          },
+          {
+            "id": 16,
+            "name": "12"
+          },
+          {
+            "id": 17,
+            "name": "13"
+          },
+          {
+            "id": 18,
+            "name": "14"
+          },
+          {
+            "id": 19,
+            "name": "15"
+          },
+          {
+            "id": 20,
+            "name": "16"
+          },
+          {
+            "id": 21,
+            "name": "17"
+          },
+          {
+            "id": 22,
+            "name": "18"
+          },
+          {
+            "id": 23,
+            "name": "19"
+          },
+          {
+            "id": 24,
+            "name": "20"
+          },
+          {
+            "id": 25,
+            "name": "21"
+          },
+          {
+            "id": 26,
+            "name": "22"
+          },
+          {
+            "id": 27,
+            "name": "23"
+          },
+          {
+            "id": 28,
+            "name": "24"
+          },
+          {
+            "id": 29,
+            "name": "25"
+          },
+          {
+            "id": 30,
+            "name": "26"
+          },
+          {
+            "id": 31,
+            "name": "27"
+          },
+          {
+            "id": 32,
+            "name": "28"
+          },
+          {
+            "id": 33,
+            "name": "29"
+          },
+          {
+            "id": 34,
+            "name": "30"
+          },
+          {
+            "id": 35,
+            "name": "31"
+          },
+          {
+            "id": 36,
+            "name": "32"
+          },
+          {
+            "id": 37,
+            "name": "33"
+          },
+          {
+            "id": 38,
+            "name": "34"
+          },
+          {
+            "id": 39,
+            "name": "35"
+          },
+          {
+            "id": 40,
+            "name": "36"
+          },
+          {
+            "id": 41,
+            "name": "37"
+          },
+          {
+            "id": 42,
+            "name": "38"
+          },
+          {
+            "id": 43,
+            "name": "39"
+          },
+          {
+            "id": 44,
+            "name": "40"
+          },
+          {
+            "id": 45,
+            "name": "41"
+          },
+          {
+            "id": 46,
+            "name": "42"
+          },
+          {
+            "id": 47,
+            "name": "43"
+          },
+          {
+            "id": 48,
+            "name": "44"
+          },
+          {
+            "id": 49,
+            "name": "45"
+          },
+          {
+            "id": 50,
+            "name": "46"
+          },
+          {
+            "id": 51,
+            "name": "47"
+          },
+          {
+            "id": 52,
+            "name": "48"
+          },
+          {
+            "id": 53,
+            "name": "49"
+          },
+          {
+            "id": 54,
+            "name": "50"
+          },
+          {
+            "id": 55,
+            "name": "51"
+          },
+          {
+            "id": 56,
+            "name": "52"
+          },
+          {
+            "id": 57,
+            "name": "53"
+          },
+          {
+            "id": 58,
+            "name": "54"
+          },
+          {
+            "id": 59,
+            "name": "55"
+          },
+          {
+            "id": 60,
+            "name": "56"
+          },
+          {
+            "id": 61,
+            "name": "57"
+          },
+          {
+            "id": 62,
+            "name": "58"
+          },
+          {
+            "id": 63,
+            "name": "59"
+          },
+          {
+            "id": 64,
+            "name": "60"
+          },
+          {
+            "id": 65,
+            "name": "61"
+          },
+          {
+            "id": 66,
+            "name": "62"
+          },
+          {
+            "id": 67,
+            "name": "63"
+          },
+          {
+            "id": 68,
+            "name": "64"
+          },
+          {
+            "id": 69,
+            "name": "65"
+          },
+          {
+            "id": 70,
+            "name": "66"
+          },
+          {
+            "id": 71,
+            "name": "67"
+          },
+          {
+            "id": 72,
+            "name": "68"
+          },
+          {
+            "id": 73,
+            "name": "69"
+          },
+          {
+            "id": 74,
+            "name": "70"
+          },
+          {
+            "id": 75,
+            "name": "71"
+          },
+          {
+            "id": 76,
+            "name": "72"
+          },
+          {
+            "id": 77,
+            "name": "73"
+          },
+          {
+            "id": 78,
+            "name": "74"
+          },
+          {
+            "id": 79,
+            "name": "75"
+          },
+          {
+            "id": 80,
+            "name": "76"
+          },
+          {
+            "id": 81,
+            "name": "77"
+          },
+          {
+            "id": 82,
+            "name": "78"
+          },
+          {
+            "id": 83,
+            "name": "79"
+          },
+          {
+            "id": 84,
+            "name": "80"
+          },
+          {
+            "id": 85,
+            "name": "81"
+          },
+          {
+            "id": 86,
+            "name": "82"
+          },
+          {
+            "id": 87,
+            "name": "83"
+          },
+          {
+            "id": 88,
+            "name": "84"
+          },
+          {
+            "id": 89,
+            "name": "85"
+          },
+          {
+            "id": 90,
+            "name": "86"
+          },
+          {
+            "id": 91,
+            "name": "87"
+          },
+          {
+            "id": 92,
+            "name": "88"
+          },
+          {
+            "id": 93,
+            "name": "89"
+          },
+          {
+            "id": 94,
+            "name": "90"
+          },
+          {
+            "id": 95,
+            "name": "91"
+          },
+          {
+            "id": 96,
+            "name": "92"
+          },
+          {
+            "id": 97,
+            "name": "93"
+          },
+          {
+            "id": 98,
+            "name": "94"
+          },
+          {
+            "id": 99,
+            "name": "95"
+          },
+          {
+            "id": 100,
+            "name": "96"
+          }
+        ],
+        "nextLink": "https://management.azure.com/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.Synapse/workspaces/exampleWorkspaceName/integrationRuntimes/testactivityv2/getObjectMetadata?api-version=2019-06-01-preview&%24skipToken=https%3a%2f%2fwcu.frontend.clouddatahub.net%2fsubscriptions%2f12345678-1234-1234-1234-12345678abc%2fdatafactories%2f6C8E7C90-FD45-4010-8B7C-B5227D0F0CB7%2fintegrationruntimes%2fTESTACTIVITYV2%2fgetSsisObjectMetadata%3f%24skipToken%3dc3Npc0ZvbGRlcnNAQDIwMTgtMTEtMjlUMDM6NTk6MzIuMDQ1Mzc1MiswMDowMEBAZm9sZGVyQEAwMDAwMDAwMDAwMDAwMDAwMTAx0%26api-version%3d1.0"
+      }
+    }
+  }
+}
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimeObjectMetadata_Refresh.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimeObjectMetadata_Refresh.json
new file mode 100644
index 000000000000..8154da9d21d0
--- /dev/null
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimeObjectMetadata_Refresh.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "subscriptionId": "12345678-1234-1234-1234-12345678abc",
+    "resourceGroupName": "exampleResourceGroup",
+    "workspaceName": "exampleWorkspace",
+    "integrationRuntimeName": "testactivityv2",
+    "api-version": "2019-06-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Date": "Mon, 03 Dec 2018 06:24:53 GMT",
+        "X-Content-Type-Options": "nosniff",
+        "x-ms-ratelimit-remaining-subscription-reads": "11999",
+        "x-ms-request-id": "20708242-215c-4101-9437-44590b27cdbf",
+        "x-ms-correlation-request-id": "20708242-215c-4101-9437-44590b27cdbf"
+      },
+      "body": {
+        "status": "Succeeded",
+        "name": "ca63c855b72d44959653ffcc6eb0b96c",
+        "properties": null,
+        "error": null
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_Create.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_Create.json
new file mode 100644
index 000000000000..225ba8b38f01
--- /dev/null
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_Create.json
@@ -0,0 +1,37 @@
+{
+  "parameters": {
+    "subscriptionId": "12345678-1234-1234-1234-12345678abc",
+    "resourceGroupName": "exampleResourceGroup",
+    "workspaceName": "exampleWorkspace",
+    "integrationRuntimeName": "exampleIntegrationRuntime",
+    "ifMatch": null,
+    "integrationRuntime": {
+      "properties": {
+        "type": "SelfHosted",
+        "description": "A selfhosted integration runtime"
+      }
+    },
+    "api-version": "2019-06-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Date": "Wed, 13 Jun 2018 22:20:47 GMT",
+        "X-Content-Type-Options": "nosniff",
+        "x-ms-ratelimit-remaining-subscription-writes": "1197",
+        "x-ms-request-id": "125c07fa-e39a-4541-885f-5019631a5ecd",
+        "x-ms-correlation-request-id": "125c07fa-e39a-4541-885f-5019631a5ecd"
+      },
+      "body": {
+        "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.Synapse/workspaces/exampleWorkspaceName/integrationruntimes/exampleIntegrationRuntime",
+        "name": "exampleIntegrationRuntime",
+        "type": "Microsoft.Synapse/workspaces/integrationruntimes",
+        "properties": {
+          "type": "SelfHosted",
+          "description": "A selfhosted integration runtime"
+        },
+        "etag": "000046c4-0000-0000-0000-5b2198bf0000"
+      }
+    }
+  }
+}
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_Delete.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_Delete.json
new file mode 100644
index 000000000000..37046b23a1aa
--- /dev/null
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_Delete.json
@@ -0,0 +1,21 @@
+{
+  "parameters": {
+    "subscriptionId": "12345678-1234-1234-1234-12345678abc",
+    "resourceGroupName": "exampleResourceGroup",
+    "workspaceName": "exampleWorkspace",
+    "integrationRuntimeName": "exampleIntegrationRuntime",
+    "api-version": "2019-06-01-preview"
+  },
+  "responses": {
+    "200": {},
+    "204": {},
+    "default": {
+      "body": {
+        "error": {
+          "code": "Error code",
+          "message": "Error message"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_Get.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_Get.json
new file mode 100644
index 000000000000..f932b98520b6
--- /dev/null
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_Get.json
@@ -0,0 +1,40 @@
+{
+  "parameters": {
+    "subscriptionId": "12345678-1234-1234-1234-12345678abc",
+    "resourceGroupName": "exampleResourceGroup",
+    "workspaceName": "exampleWorkspace",
+    "integrationRuntimeName": "exampleIntegrationRuntime",
+    "ifNoneMatch": "15003c4f-0000-0200-0000-5cbe090b0000",
+    "api-version": "2019-06-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Date": "Mon, 22 Apr 2019 18:33:47 GMT",
+        "X-Content-Type-Options": "nosniff",
+        "x-ms-ratelimit-remaining-subscription-reads": "11997",
+        "x-ms-request-id": "ad824326-e577-4a47-a092-2e621c4d59d9",
+        "x-ms-correlation-request-id": "ad824326-e577-4a47-a092-2e621c4d59d9"
+      },
+      "body": {
+        "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.Synapse/workspaces/exampleWorkspaceName/integrationruntimes/exampleIntegrationRuntime",
+        "name": "exampleIntegrationRuntime",
+        "type": "Microsoft.Synapse/workspaces/integrationruntimes",
+        "properties": {
+          "type": "SelfHosted",
+          "description": "A selfhosted integration runtime"
+        },
+        "etag": "15003c4f-0000-0200-0000-5cbe090b0000"
+      }
+    },
+    "304": {},
+    "default": {
+      "body": {
+        "error": {
+          "code": "Error code",
+          "message": "Error message"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_GetConnectionInfo.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_GetConnectionInfo.json
new file mode 100644
index 000000000000..f86e6ced9a1b
--- /dev/null
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_GetConnectionInfo.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "subscriptionId": "12345678-1234-1234-1234-12345678abc",
+    "resourceGroupName": "exampleResourceGroup",
+    "workspaceName": "exampleWorkspace",
+    "integrationRuntimeName": "exampleIntegrationRuntime",
+    "api-version": "2019-06-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Date": "Thu, 14 Jun 2018 14:53:21 GMT",
+        "X-Content-Type-Options": "nosniff",
+        "x-ms-ratelimit-remaining-subscription-reads": "14998",
+        "x-ms-request-id": "05774db5-e79b-4224-9097-46714b92fbd8",
+        "x-ms-correlation-request-id": "05774db5-e79b-4224-9097-46714b92fbd8"
+      },
+      "body": {
+        "version": "3.8.6730.2",
+        "publicKey": "**********",
+        "serviceToken": "**********",
+        "identityCertThumbprint": "**********",
+        "hostServiceUri": "https://yanzhang-dt.fareast.corp.microsoft.com:8050/HostServiceRemote.svc/",
+        "isIdentityCertExprired": false
+      }
+    }
+  }
+}
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_GetMonitoringData.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_GetMonitoringData.json
new file mode 100644
index 000000000000..9545975783d9
--- /dev/null
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_GetMonitoringData.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "subscriptionId": "12345678-1234-1234-1234-12345678abc",
+    "resourceGroupName": "exampleResourceGroup",
+    "workspaceName": "exampleWorkspace",
+    "integrationRuntimeName": "exampleIntegrationRuntime",
+    "api-version": "2019-06-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Date": "Thu, 14 Jun 2018 15:27:44 GMT",
+        "X-Content-Type-Options": "nosniff",
+        "x-ms-ratelimit-remaining-subscription-reads": "14999",
+        "x-ms-request-id": "39277952-edbe-4336-ae94-f6f42b50b5f7",
+        "x-ms-correlation-request-id": "39277952-edbe-4336-ae94-f6f42b50b5f7"
+      },
+      "body": {
+        "name": "exampleIntegrationRuntime",
+        "nodes": [
+          {
+            "nodeName": "Node_1",
+            "availableMemoryInMB": 16740,
+            "cpuUtilization": 15,
+            "concurrentJobsLimit": 28,
+            "concurrentJobsRunning": 0,
+            "sentBytes": 2.6474916934967041,
+            "receivedBytes": 6.7314233779907227
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_GetStatus.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_GetStatus.json
new file mode 100644
index 000000000000..7e6edc5e61cb
--- /dev/null
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_GetStatus.json
@@ -0,0 +1,71 @@
+{
+  "parameters": {
+    "subscriptionId": "12345678-1234-1234-1234-12345678abc",
+    "resourceGroupName": "exampleResourceGroup",
+    "workspaceName": "exampleWorkspace",
+    "integrationRuntimeName": "exampleIntegrationRuntime",
+    "api-version": "2019-06-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Date": "Thu, 14 Jun 2018 14:53:22 GMT",
+        "X-Content-Type-Options": "nosniff",
+        "x-ms-ratelimit-remaining-subscription-reads": "14997",
+        "x-ms-request-id": "19efe790-074f-4241-ae94-0422935d0f46",
+        "x-ms-correlation-request-id": "19efe790-074f-4241-ae94-0422935d0f46"
+      },
+      "body": {
+        "name": "exampleIntegrationRuntime",
+        "properties": {
+          "state": "Online",
+          "type": "SelfHosted",
+          "typeProperties": {
+            "autoUpdate": "Off",
+            "taskQueueId": "1a6296ab-423c-4346-9bcc-85a78c2c0582",
+            "version": "3.8.6730.2",
+            "nodes": [
+              {
+                "nodeName": "Node_1",
+                "machineName": "YANZHANG-DT",
+                "hostServiceUri": "https://yanzhang-dt.fareast.corp.microsoft.com:8050/HostServiceRemote.svc/",
+                "status": "Online",
+                "capabilities": {
+                  "serviceBusConnected": "True",
+                  "httpsPortEnabled": "True",
+                  "credentialInSync": "True",
+                  "connectedToResourceManager": "True",
+                  "nodeEnabled": "True"
+                },
+                "versionStatus": "UpToDate",
+                "version": "3.8.6730.2",
+                "registerTime": "2018-06-14T14:51:44.9237069Z",
+                "lastConnectTime": "2018-06-14T14:52:59.8933313Z",
+                "lastStartTime": "2018-06-14T14:52:59.8933313Z",
+                "lastUpdateResult": "None",
+                "isActiveDispatcher": true,
+                "maxConcurrentJobs": 56
+              }
+            ],
+            "updateDelayOffset": "PT3H",
+            "localTimeZoneOffset": "PT8H",
+            "serviceUrls": [
+              "wu.frontend.int.clouddatahub-int.net",
+              "*.servicebus.windows.net"
+            ],
+            "versionStatus": "UpToDate",
+            "capabilities": {
+              "serviceBusConnected": "True",
+              "httpsPortEnabled": "True",
+              "credentialInSync": "True",
+              "connectedToResourceManager": "True",
+              "nodeEnabled": "True"
+            },
+            "latestVersion": "3.7.6711.1",
+            "createTime": "2018-06-14T09:17:45.1839685Z"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_ListAuthKeys.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_ListAuthKeys.json
new file mode 100644
index 000000000000..40e67e084c76
--- /dev/null
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_ListAuthKeys.json
@@ -0,0 +1,24 @@
+{
+  "parameters": {
+    "subscriptionId": "12345678-1234-1234-1234-12345678abc",
+    "resourceGroupName": "exampleResourceGroup",
+    "workspaceName": "exampleWorkspace",
+    "integrationRuntimeName": "exampleIntegrationRuntime",
+    "api-version": "2019-06-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Date": "Thu, 14 Jun 2018 14:51:00 GMT",
+        "X-Content-Type-Options": "nosniff",
+        "x-ms-ratelimit-remaining-subscription-reads": "14999",
+        "x-ms-request-id": "2ea25426-9d1d-49f3-88b6-fb853eb02cb9",
+        "x-ms-correlation-request-id": "2ea25426-9d1d-49f3-88b6-fb853eb02cb9"
+      },
+      "body": {
+        "authKey1": "**********",
+        "authKey2": "**********"
+      }
+    }
+  }
+}
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_ListByWorkspace.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_ListByWorkspace.json
new file mode 100644
index 000000000000..82fa0bc4b4d2
--- /dev/null
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_ListByWorkspace.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "subscriptionId": "12345678-1234-1234-1234-12345678abc",
+    "resourceGroupName": "exampleResourceGroup",
+    "workspaceName": "exampleWorkspace",
+    "ifNoneMatch": null,
+    "api-version": "2019-06-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Date": "Wed, 13 Jun 2018 21:33:05 GMT",
+        "X-Content-Type-Options": "nosniff",
+        "x-ms-ratelimit-remaining-subscription-reads": "14909",
+        "x-ms-request-id": "f632df92-1140-4e19-9e19-0b1c8cbe393b",
+        "x-ms-correlation-request-id": "f632df92-1140-4e19-9e19-0b1c8cbe393b"
+      },
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.Synapse/workspaces/exampleWorkspaceName/integrationruntimes/exampleIntegrationRuntime",
+            "name": "exampleIntegrationRuntime",
+            "type": "Microsoft.Synapse/workspaces/integrationruntimes",
+            "properties": {
+              "type": "SelfHosted",
+              "description": "A selfhosted integration runtime"
+            },
+            "etag": "0400f1a1-0000-0000-0000-5b2188640000"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_RegenerateAuthKey.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_RegenerateAuthKey.json
new file mode 100644
index 000000000000..073ce3ef42ed
--- /dev/null
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_RegenerateAuthKey.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "subscriptionId": "12345678-1234-1234-1234-12345678abc",
+    "resourceGroupName": "exampleResourceGroup",
+    "workspaceName": "exampleWorkspace",
+    "integrationRuntimeName": "exampleIntegrationRuntime",
+    "regenerateKeyParameters": {
+      "keyName": "authKey2"
+    },
+    "api-version": "2019-06-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Date": "Thu, 14 Jun 2018 14:50:41 GMT",
+        "X-Content-Type-Options": "nosniff",
+        "x-ms-ratelimit-remaining-subscription-writes": "1198",
+        "x-ms-request-id": "25af6d34-52c6-40a4-a882-16052af85c99",
+        "x-ms-correlation-request-id": "25af6d34-52c6-40a4-a882-16052af85c99"
+      },
+      "body": {
+        "authKey2": "**********"
+      }
+    }
+  }
+}
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_Start.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_Start.json
new file mode 100644
index 000000000000..0975a4604ab5
--- /dev/null
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_Start.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "subscriptionId": "12345678-1234-1234-1234-12345678abc",
+    "resourceGroupName": "exampleResourceGroup",
+    "workspaceName": "exampleWorkspace",
+    "integrationRuntimeName": "exampleManagedIntegrationRuntime",
+    "api-version": "2019-06-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Date": "Wed, 13 Jun 2018 21:33:00 GMT",
+        "X-Content-Type-Options": "nosniff",
+        "x-ms-ratelimit-remaining-subscription-reads": "14912",
+        "x-ms-request-id": "2af47f9f-5625-4b01-a3a5-bccb576a4677",
+        "x-ms-correlation-request-id": "2af47f9f-5625-4b01-a3a5-bccb576a4677"
+      },
+      "body": {
+        "name": "exampleManagedIntegrationRuntime",
+        "properties": {
+          "dataFactoryName": "exampleWorkspaceName",
+          "type": "Managed",
+          "state": "Started",
+          "typeProperties": {
+            "nodes": [],
+            "otherErrors": [],
+            "createTime": "2018-06-13T21:11:01.8695494Z"
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_Stop.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_Stop.json
new file mode 100644
index 000000000000..b6638ec59d52
--- /dev/null
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_Stop.json
@@ -0,0 +1,21 @@
+{
+  "parameters": {
+    "subscriptionId": "12345678-1234-1234-1234-12345678abc",
+    "resourceGroupName": "exampleResourceGroup",
+    "workspaceName": "exampleWorkspace",
+    "integrationRuntimeName": "exampleManagedIntegrationRuntime",
+    "api-version": "2019-06-01-preview"
+  },
+  "responses": {
+    "200": {},
+    "202": {},
+    "default": {
+      "body": {
+        "error": {
+          "code": "Error code",
+          "message": "Error message"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_SyncCredentials.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_SyncCredentials.json
new file mode 100644
index 000000000000..11b0fe38e4d7
--- /dev/null
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_SyncCredentials.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "subscriptionId": "12345678-1234-1234-1234-12345678abc",
+    "resourceGroupName": "exampleResourceGroup",
+    "workspaceName": "exampleWorkspace",
+    "integrationRuntimeName": "exampleIntegrationRuntime",
+    "api-version": "2019-06-01-preview"
+  },
+  "responses": {
+    "200": {}
+  }
+}
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_Update.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_Update.json
new file mode 100644
index 000000000000..dbfe57456bf9
--- /dev/null
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_Update.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "subscriptionId": "12345678-1234-1234-1234-12345678abc",
+    "resourceGroupName": "exampleResourceGroup",
+    "workspaceName": "exampleWorkspace",
+    "integrationRuntimeName": "exampleIntegrationRuntime",
+    "updateIntegrationRuntimeRequest": {
+      "autoUpdate": "Off",
+      "updateDelayOffset": "\"PT3H\""
+    },
+    "api-version": "2019-06-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Date": "Wed, 13 Jun 2018 21:33:04 GMT",
+        "X-Content-Type-Options": "nosniff",
+        "x-ms-ratelimit-remaining-subscription-writes": "1192",
+        "x-ms-request-id": "eb1c35f8-4b37-4d08-b5dd-d6a0ad8b182d",
+        "x-ms-correlation-request-id": "eb1c35f8-4b37-4d08-b5dd-d6a0ad8b182d"
+      },
+      "body": {
+        "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.Synapse/workspaces/exampleWorkspaceName/integrationruntimes/exampleIntegrationRuntime",
+        "name": "exampleIntegrationRuntime",
+        "type": "Microsoft.Synapse/workspaces/integrationruntimes",
+        "properties": {
+          "type": "SelfHosted",
+          "description": "A selfhosted integration runtime"
+        },
+        "etag": "0400f1a1-0000-0000-0000-5b2188640000"
+      }
+    }
+  }
+}
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_Upgrade.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_Upgrade.json
new file mode 100644
index 000000000000..11b0fe38e4d7
--- /dev/null
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/IntegrationRuntimes_Upgrade.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "subscriptionId": "12345678-1234-1234-1234-12345678abc",
+    "resourceGroupName": "exampleResourceGroup",
+    "workspaceName": "exampleWorkspace",
+    "integrationRuntimeName": "exampleIntegrationRuntime",
+    "api-version": "2019-06-01-preview"
+  },
+  "responses": {
+    "200": {}
+  }
+}
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/UpdateSqlPool.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/UpdateSqlPool.json
index 0d6c2c85bb07..14abbbfe6c6f 100644
--- a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/UpdateSqlPool.json
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/UpdateSqlPool.json
@@ -48,6 +48,7 @@
           "creationDate": "1970-01-01T00:00:00.000Z"
         }
       }
-    }
+    },
+    "202": {}
   }
 }
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/integrationRuntime.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/integrationRuntime.json
new file mode 100644
index 000000000000..5f5f74294989
--- /dev/null
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/integrationRuntime.json
@@ -0,0 +1,2837 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "version": "2019-06-01-preview",
+    "title": "SynapseManagementClient",
+    "description": "Azure Synapse Analytics APIs"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "type": "oauth2",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      },
+      "description": "Azure Active Directory OAuth2 Flow"
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/integrationRuntimes/{integrationRuntimeName}": {
+      "patch": {
+        "operationId": "IntegrationRuntimes_Update",
+        "summary": "Update integration runtime",
+        "description": "Update an integration runtime",
+        "tags": [
+          "IntegrationRuntime"
+        ],
+        "deprecated": false,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./workspace.json#/parameters/workspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/IntegrationRuntimeNameParameter"
+          },
+          {
+            "name": "updateIntegrationRuntimeRequest",
+            "description": "The parameters for updating an integration runtime.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/UpdateIntegrationRuntimeRequest"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK.",
+            "schema": {
+              "$ref": "#/definitions/IntegrationRuntimeResource"
+            }
+          },
+          "default": {
+            "description": "An error response received from the Azure Synapse service.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "x-ms-examples": {
+          "Update integration runtime": {
+            "$ref": "./examples/IntegrationRuntimes_Update.json"
+          }
+        }
+      },
+      "get": {
+        "operationId": "IntegrationRuntimes_Get",
+        "summary": "Get integration runtime",
+        "description": "Get an integration runtime",
+        "tags": [
+          "IntegrationRuntime"
+        ],
+        "deprecated": false,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./workspace.json#/parameters/workspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/IntegrationRuntimeNameParameter"
+          },
+          {
+            "name": "If-None-Match",
+            "in": "header",
+            "required": false,
+            "type": "string",
+            "description": "ETag of the integration runtime entity. Should only be specified for get. If the ETag matches the existing entity tag, or if * was provided, then no content will be returned."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK.",
+            "schema": {
+              "$ref": "#/definitions/IntegrationRuntimeResource"
+            }
+          },
+          "304": {
+            "description": "Not modified."
+          },
+          "default": {
+            "description": "An error response received from GET integration runtime operation.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "x-ms-examples": {
+          "Get integration runtime": {
+            "$ref": "./examples/IntegrationRuntimes_Get.json"
+          }
+        }
+      },
+      "put": {
+        "operationId": "IntegrationRuntimes_Create",
+        "summary": "Create integration runtime",
+        "description": "Create an integration runtime",
+        "tags": [
+          "IntegrationRuntime"
+        ],
+        "deprecated": false,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./workspace.json#/parameters/workspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/IntegrationRuntimeNameParameter"
+          },
+          {
+            "name": "If-Match",
+            "in": "header",
+            "required": false,
+            "type": "string",
+            "description": "ETag of the integration runtime entity. Should only be specified for update, for which it should match existing entity or can be * for unconditional update."
+          },
+          {
+            "name": "integrationRuntime",
+            "description": "Integration runtime resource definition.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/IntegrationRuntimeResource"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK.",
+            "schema": {
+              "$ref": "#/definitions/IntegrationRuntimeResource"
+            }
+          },
+          "default": {
+            "description": "An error response received from PUT integration runtime operation.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "x-ms-examples": {
+          "Create integration runtime": {
+            "$ref": "./examples/IntegrationRuntimes_Create.json"
+          }
+        }
+      },
+      "delete": {
+        "operationId": "IntegrationRuntimes_Delete",
+        "summary": "Delete integration runtime",
+        "description": "Delete an integration runtime",
+        "tags": [
+          "IntegrationRuntime"
+        ],
+        "deprecated": false,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./workspace.json#/parameters/workspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/IntegrationRuntimeNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK."
+          },
+          "204": {
+            "description": "No Content."
+          },
+          "default": {
+            "description": "An error response received from DELETE integration runtime operation.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "x-ms-examples": {
+          "Delete integration runtime": {
+            "$ref": "./examples/IntegrationRuntimes_Delete.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/integrationRuntimes/{integrationRuntimeName}/nodes/{nodeName}/ipAddress": {
+      "post": {
+        "operationId": "IntegrationRuntimeNodeIpAddress_Get",
+        "summary": "Get integration runtime node IP address",
+        "description": "Get the IP address of an integration runtime node",
+        "tags": [
+          "IntegrationRuntime"
+        ],
+        "deprecated": false,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./workspace.json#/parameters/workspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/IntegrationRuntimeNameParameter"
+          },
+          {
+            "type": "string",
+            "in": "path",
+            "name": "nodeName",
+            "description": "Integration runtime node name",
+            "required": true
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK.",
+            "schema": {
+              "$ref": "#/definitions/IntegrationRuntimeNodeIpAddress"
+            }
+          },
+          "default": {
+            "description": "An error response received from the Azure Synapse service.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "x-ms-examples": {
+          "Get integration runtime node IP address": {
+            "$ref": "./examples/IntegrationRuntimeNodes_GetIpAddress.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/integrationRuntimes/{integrationRuntimeName}/upgrade": {
+      "post": {
+        "operationId": "IntegrationRuntimes_Upgrade",
+        "summary": "Upgrade integration runtime",
+        "description": "Upgrade an integration runtime",
+        "tags": [
+          "IntegrationRuntime"
+        ],
+        "deprecated": false,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./workspace.json#/parameters/workspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/IntegrationRuntimeNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK."
+          },
+          "default": {
+            "description": "An error response received from the Azure Synapse service.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "x-ms-examples": {
+          "Upgrade integration runtime": {
+            "$ref": "./examples/IntegrationRuntimes_Upgrade.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/integrationRuntimes/{integrationRuntimeName}/getObjectMetadata": {
+      "post": {
+        "operationId": "IntegrationRuntimeObjectMetadata_Get",
+        "summary": "Get integration runtime object metadata",
+        "description": "Get object metadata from an integration runtime",
+        "tags": [
+          "IntegrationRuntime"
+        ],
+        "deprecated": false,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./workspace.json#/parameters/workspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/IntegrationRuntimeNameParameter"
+          },
+          {
+            "name": "getMetadataRequest",
+            "description": "The parameters for getting a SSIS object metadata.",
+            "in": "body",
+            "required": false,
+            "schema": {
+              "$ref": "#/definitions/GetSsisObjectMetadataRequest"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK.",
+            "schema": {
+              "$ref": "#/definitions/SsisObjectMetadataListResponse"
+            }
+          },
+          "default": {
+            "description": "An error response received from the Azure Synapse service.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "x-ms-examples": {
+          "Get integration runtime object metadata": {
+            "$ref": "./examples/IntegrationRuntimeObjectMetadata_Get.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/integrationRuntimes/{integrationRuntimeName}/nodes/{nodeName}": {
+      "get": {
+        "operationId": "IntegrationRuntimeNodes_Get",
+        "summary": "Get integration runtime node",
+        "description": "Get an integration runtime node",
+        "tags": [
+          "IntegrationRuntime"
+        ],
+        "deprecated": false,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./workspace.json#/parameters/workspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/IntegrationRuntimeNameParameter"
+          },
+          {
+            "type": "string",
+            "in": "path",
+            "name": "nodeName",
+            "description": "Integration runtime node name",
+            "required": true
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK.",
+            "schema": {
+              "$ref": "#/definitions/SelfHostedIntegrationRuntimeNode"
+            }
+          },
+          "default": {
+            "description": "An error response received from the Azure Synapse service.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "consumes": [],
+        "produces": [
+          "application/json"
+        ],
+        "x-ms-examples": {
+          "Get integration runtime node": {
+            "$ref": "./examples/IntegrationRuntimeNodes_Get.json"
+          }
+        }
+      },
+      "patch": {
+        "operationId": "IntegrationRuntimeNodes_Update",
+        "summary": "Create integration runtime node",
+        "description": "Create an integration runtime node",
+        "tags": [
+          "IntegrationRuntime"
+        ],
+        "deprecated": false,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./workspace.json#/parameters/workspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/IntegrationRuntimeNameParameter"
+          },
+          {
+            "type": "string",
+            "in": "path",
+            "name": "nodeName",
+            "description": "Integration runtime node name",
+            "required": true
+          },
+          {
+            "name": "updateIntegrationRuntimeNodeRequest",
+            "description": "The parameters for updating an integration runtime node.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/UpdateIntegrationRuntimeNodeRequest"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK.",
+            "schema": {
+              "$ref": "#/definitions/SelfHostedIntegrationRuntimeNode"
+            }
+          },
+          "default": {
+            "description": "An error response received from the Azure Synapse service.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "x-ms-examples": {
+          "Update integration runtime node": {
+            "$ref": "./examples/IntegrationRuntimeNodes_Update.json"
+          }
+        }
+      },
+      "delete": {
+        "operationId": "IntegrationRuntimeNodes_Delete",
+        "summary": "Delete integration runtime node",
+        "description": "Delete an integration runtime node",
+        "tags": [
+          "IntegrationRuntime"
+        ],
+        "deprecated": false,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./workspace.json#/parameters/workspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/IntegrationRuntimeNameParameter"
+          },
+          {
+            "type": "string",
+            "in": "path",
+            "name": "nodeName",
+            "description": "Integration runtime node name",
+            "required": true
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK."
+          },
+          "204": {
+            "description": "No Content."
+          },
+          "default": {
+            "description": "An error response received from the Azure Synapse service.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "consumes": [],
+        "produces": [
+          "application/json"
+        ],
+        "x-ms-examples": {
+          "Delete integration runtime node": {
+            "$ref": "./examples/IntegrationRuntimeNodes_Delete.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/integrationRuntimes/{integrationRuntimeName}/syncCredentials": {
+      "post": {
+        "operationId": "IntegrationRuntimeCredentials_Sync",
+        "summary": "Sync integration runtime credentials",
+        "description": "Force the integration runtime to synchronize credentials across integration runtime nodes, and this will override the credentials across all worker nodes with those available on the dispatcher node. If you already have the latest credential backup file, you should manually import it (preferred) on any self-hosted integration runtime node than using this API directly.",
+        "tags": [
+          "IntegrationRuntime"
+        ],
+        "deprecated": false,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./workspace.json#/parameters/workspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/IntegrationRuntimeNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK."
+          },
+          "default": {
+            "description": "An error response received from the Azure Synapse service.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "x-ms-examples": {
+          "Sync credentials": {
+            "$ref": "./examples/IntegrationRuntimes_SyncCredentials.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/integrationRuntimes": {
+      "get": {
+        "operationId": "IntegrationRuntimes_ListByWorkspace",
+        "summary": "List integration runtimes",
+        "description": "List all integration runtimes",
+        "tags": [
+          "IntegrationRuntime"
+        ],
+        "deprecated": false,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./workspace.json#/parameters/workspaceNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK.",
+            "schema": {
+              "$ref": "#/definitions/IntegrationRuntimeListResponse"
+            }
+          },
+          "default": {
+            "description": "An error response received from the Azure Synapse service.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "consumes": [],
+        "produces": [
+          "application/json"
+        ],
+        "x-ms-examples": {
+          "List integration runtimes": {
+            "$ref": "./examples/IntegrationRuntimes_ListByWorkspace.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/integrationRuntimes/{integrationRuntimeName}/getConnectionInfo": {
+      "post": {
+        "operationId": "IntegrationRuntimeConnectionInfos_Get",
+        "summary": "Get integration runtime connection info",
+        "description": "Get connection info for an integration runtime",
+        "tags": [
+          "IntegrationRuntime"
+        ],
+        "deprecated": false,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./workspace.json#/parameters/workspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/IntegrationRuntimeNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK.",
+            "schema": {
+              "$ref": "#/definitions/IntegrationRuntimeConnectionInfo"
+            }
+          },
+          "default": {
+            "description": "An error response received from the Azure Synapse service.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "x-ms-examples": {
+          "Get connection info": {
+            "$ref": "./examples/IntegrationRuntimes_GetConnectionInfo.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/integrationRuntimes/{integrationRuntimeName}/start": {
+      "post": {
+        "operationId": "IntegrationRuntimes_Start",
+        "summary": "Start integration runtime",
+        "description": "Start an integration runtime",
+        "tags": [
+          "IntegrationRuntime"
+        ],
+        "deprecated": false,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./workspace.json#/parameters/workspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/IntegrationRuntimeNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK.",
+            "schema": {
+              "$ref": "#/definitions/IntegrationRuntimeStatusResponse"
+            }
+          },
+          "202": {
+            "description": "Accepted."
+          },
+          "default": {
+            "description": "An error response received from the Azure Synapse service.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "x-ms-examples": {
+          "Start integration runtime": {
+            "$ref": "./examples/IntegrationRuntimes_Start.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/integrationRuntimes/{integrationRuntimeName}/regenerateAuthKey": {
+      "post": {
+        "operationId": "IntegrationRuntimeAuthKeys_Regenerate",
+        "summary": "Regenerate integration runtime authentication key",
+        "description": "Regenerate the authentication key for an integration runtime",
+        "tags": [
+          "IntegrationRuntime"
+        ],
+        "deprecated": false,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./workspace.json#/parameters/workspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/IntegrationRuntimeNameParameter"
+          },
+          {
+            "name": "regenerateKeyParameters",
+            "description": "The parameters for regenerating integration runtime authentication key.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/IntegrationRuntimeRegenerateKeyParameters"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK.",
+            "schema": {
+              "$ref": "#/definitions/IntegrationRuntimeAuthKeys"
+            }
+          },
+          "default": {
+            "description": "An error response received from the Azure Synapse service.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "x-ms-examples": {
+          "Regenerate auth key": {
+            "$ref": "./examples/IntegrationRuntimes_RegenerateAuthKey.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/integrationRuntimes/{integrationRuntimeName}/listAuthKeys": {
+      "post": {
+        "operationId": "IntegrationRuntimeAuthKeys_List",
+        "summary": "List integration runtime authentication keys",
+        "description": "List authentication keys in an integration runtime",
+        "tags": [
+          "IntegrationRuntime"
+        ],
+        "deprecated": false,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./workspace.json#/parameters/workspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/IntegrationRuntimeNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK.",
+            "schema": {
+              "$ref": "#/definitions/IntegrationRuntimeAuthKeys"
+            }
+          },
+          "default": {
+            "description": "An error response received from the Azure Synapse service.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "x-ms-examples": {
+          "List auth keys": {
+            "$ref": "./examples/IntegrationRuntimes_ListAuthKeys.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/integrationRuntimes/{integrationRuntimeName}/monitoringData": {
+      "post": {
+        "operationId": "IntegrationRuntimeMonitoringData_Get",
+        "summary": "Get integration runtime monitoring data",
+        "description": "Get monitoring data for an integration runtime",
+        "tags": [
+          "IntegrationRuntime"
+        ],
+        "deprecated": false,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./workspace.json#/parameters/workspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/IntegrationRuntimeNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK.",
+            "schema": {
+              "$ref": "#/definitions/IntegrationRuntimeMonitoringData"
+            }
+          },
+          "default": {
+            "description": "An error response received from the Azure Synapse service.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "x-ms-examples": {
+          "Get monitoring data": {
+            "$ref": "./examples/IntegrationRuntimes_GetMonitoringData.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/integrationRuntimes/{integrationRuntimeName}/stop": {
+      "post": {
+        "operationId": "IntegrationRuntimes_Stop",
+        "summary": "Stop integration runtime",
+        "description": "Stop an integration runtime",
+        "tags": [
+          "IntegrationRuntime"
+        ],
+        "deprecated": false,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./workspace.json#/parameters/workspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/IntegrationRuntimeNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK."
+          },
+          "202": {
+            "description": "Accepted."
+          },
+          "default": {
+            "description": "An error response received from the Azure Synapse service.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "x-ms-examples": {
+          "Stop integration runtime": {
+            "$ref": "./examples/IntegrationRuntimes_Stop.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/integrationRuntimes/{integrationRuntimeName}/refreshObjectMetadata": {
+      "post": {
+        "operationId": "IntegrationRuntimeObjectMetadata_Refresh",
+        "summary": "Refresh integration runtime object metadata",
+        "description": "Refresh the object metadata in an integration runtime",
+        "tags": [
+          "IntegrationRuntime"
+        ],
+        "deprecated": false,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./workspace.json#/parameters/workspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/IntegrationRuntimeNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK.",
+            "schema": {
+              "$ref": "#/definitions/SsisObjectMetadataStatusResponse"
+            }
+          },
+          "202": {
+            "description": "Accepted."
+          },
+          "default": {
+            "description": "An error response received from the Azure Synapse service.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "x-ms-examples": {
+          "Refresh object metadata": {
+            "$ref": "./examples/IntegrationRuntimeObjectMetadata_Refresh.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/integrationRuntimes/{integrationRuntimeName}/getStatus": {
+      "post": {
+        "operationId": "IntegrationRuntimeStatus_Get",
+        "summary": "Get integration runtime status",
+        "description": "Get the integration runtime status",
+        "tags": [
+          "IntegrationRuntime"
+        ],
+        "deprecated": false,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./workspace.json#/parameters/workspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/IntegrationRuntimeNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK.",
+            "schema": {
+              "$ref": "#/definitions/IntegrationRuntimeStatusResponse"
+            }
+          },
+          "default": {
+            "description": "An error response received from the Azure Synapse service.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "x-ms-examples": {
+          "Get status": {
+            "$ref": "./examples/IntegrationRuntimes_GetStatus.json"
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "SubResource": {
+      "description": "Azure Synapse nested resource, which belongs to a factory.",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "The resource identifier.",
+          "readOnly": true
+        },
+        "name": {
+          "type": "string",
+          "description": "The resource name.",
+          "readOnly": true
+        },
+        "type": {
+          "type": "string",
+          "description": "The resource type.",
+          "readOnly": true
+        },
+        "etag": {
+          "type": "string",
+          "description": "Etag identifies change in the resource.",
+          "readOnly": true
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "IntegrationRuntime": {
+      "description": "Azure Synapse nested object which serves as a compute resource for activities.",
+      "type": "object",
+      "discriminator": "type",
+      "properties": {
+        "type": {
+          "description": "Type of integration runtime.",
+          "$ref": "#/definitions/IntegrationRuntimeType"
+        },
+        "description": {
+          "description": "Integration runtime description.",
+          "type": "string"
+        }
+      },
+      "additionalProperties": {
+        "type": "object"
+      },
+      "required": [
+        "type"
+      ]
+    },
+    "IntegrationRuntimeType": {
+      "description": "The type of integration runtime.",
+      "type": "string",
+      "enum": [
+        "Managed",
+        "SelfHosted"
+      ],
+      "x-ms-enum": {
+        "name": "IntegrationRuntimeType",
+        "modelAsString": true
+      }
+    },
+    "ManagedIntegrationRuntime": {
+      "x-ms-discriminator-value": "Managed",
+      "description": "Managed integration runtime, including managed elastic and managed dedicated integration runtimes.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/IntegrationRuntime"
+        }
+      ],
+      "properties": {
+        "state": {
+          "description": "Integration runtime state, only valid for managed dedicated integration runtime.",
+          "$ref": "#/definitions/IntegrationRuntimeState",
+          "readOnly": true
+        },
+        "typeProperties": {
+          "description": "Managed integration runtime properties.",
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ManagedIntegrationRuntimeTypeProperties"
+        }
+      },
+      "required": [
+        "typeProperties"
+      ]
+    },
+    "ManagedIntegrationRuntimeTypeProperties": {
+      "description": "Managed integration runtime type properties.",
+      "type": "object",
+      "properties": {
+        "computeProperties": {
+          "description": "The compute resource for managed integration runtime.",
+          "$ref": "#/definitions/IntegrationRuntimeComputeProperties"
+        },
+        "ssisProperties": {
+          "description": "SSIS properties for managed integration runtime.",
+          "$ref": "#/definitions/IntegrationRuntimeSsisProperties"
+        }
+      }
+    },
+    "IntegrationRuntimeComputeProperties": {
+      "description": "The compute resource properties for managed integration runtime.",
+      "type": "object",
+      "properties": {
+        "location": {
+          "description": "The location for managed integration runtime. The supported regions could be found on https://docs.microsoft.com/en-us/azure/data-factory/data-factory-data-movement-activities",
+          "type": "string"
+        },
+        "nodeSize": {
+          "description": "The node size requirement to managed integration runtime.",
+          "type": "string"
+        },
+        "numberOfNodes": {
+          "description": "The required number of nodes for managed integration runtime.",
+          "type": "integer",
+          "minimum": 1
+        },
+        "maxParallelExecutionsPerNode": {
+          "description": "Maximum parallel executions count per node for managed integration runtime.",
+          "type": "integer",
+          "minimum": 1
+        },
+        "dataFlowProperties": {
+          "description": "Data flow properties for managed integration runtime.",
+          "$ref": "#/definitions/IntegrationRuntimeDataFlowProperties"
+        },
+        "vNetProperties": {
+          "description": "VNet properties for managed integration runtime.",
+          "$ref": "#/definitions/IntegrationRuntimeVNetProperties"
+        }
+      },
+      "additionalProperties": {
+        "type": "object"
+      }
+    },
+    "IntegrationRuntimeDataFlowProperties": {
+      "description": "Data flow properties for managed integration runtime.",
+      "type": "object",
+      "properties": {
+        "computeType": {
+          "description": "Compute type of the cluster which will execute data flow job.",
+          "type": "string",
+          "enum": [
+            "General",
+            "MemoryOptimized",
+            "ComputeOptimized"
+          ],
+          "x-ms-enum": {
+            "name": "DataFlowComputeType",
+            "modelAsString": true
+          }
+        },
+        "coreCount": {
+          "description": "Core count of the cluster which will execute data flow job. Supported values are: 8, 16, 32, 48, 80, 144 and 272.",
+          "type": "integer"
+        },
+        "timeToLive": {
+          "description": "Time to live (in minutes) setting of the cluster which will execute data flow job.",
+          "type": "integer",
+          "minimum": 0
+        }
+      },
+      "additionalProperties": {
+        "type": "object"
+      }
+    },
+    "IntegrationRuntimeVNetProperties": {
+      "description": "VNet properties for managed integration runtime.",
+      "type": "object",
+      "properties": {
+        "vNetId": {
+          "description": "The ID of the VNet that this integration runtime will join.",
+          "type": "string"
+        },
+        "subnet": {
+          "description": "The name of the subnet this integration runtime will join.",
+          "type": "string"
+        },
+        "publicIPs": {
+          "description": "Resource IDs of the public IP addresses that this integration runtime will use.",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "description": "The ID of the public IP address."
+          }
+        }
+      },
+      "additionalProperties": {
+        "type": "object"
+      }
+    },
+    "IntegrationRuntimeSsisProperties": {
+      "description": "SSIS properties for managed integration runtime.",
+      "type": "object",
+      "properties": {
+        "catalogInfo": {
+          "description": "Catalog information for managed dedicated integration runtime.",
+          "$ref": "#/definitions/IntegrationRuntimeSsisCatalogInfo"
+        },
+        "licenseType": {
+          "description": "License type for bringing your own license scenario.",
+          "type": "string",
+          "enum": [
+            "BasePrice",
+            "LicenseIncluded"
+          ],
+          "x-ms-enum": {
+            "name": "IntegrationRuntimeLicenseType",
+            "modelAsString": true
+          }
+        },
+        "customSetupScriptProperties": {
+          "description": "Custom setup script properties for a managed dedicated integration runtime.",
+          "$ref": "#/definitions/IntegrationRuntimeCustomSetupScriptProperties"
+        },
+        "dataProxyProperties": {
+          "description": "Data proxy properties for a managed dedicated integration runtime.",
+          "$ref": "#/definitions/IntegrationRuntimeDataProxyProperties"
+        },
+        "edition": {
+          "description": "The edition for the SSIS Integration Runtime",
+          "type": "string",
+          "enum": [
+            "Standard",
+            "Enterprise"
+          ],
+          "x-ms-enum": {
+            "name": "IntegrationRuntimeEdition",
+            "modelAsString": true
+          }
+        },
+        "expressCustomSetupProperties": {
+          "description": "Custom setup without script properties for a SSIS integration runtime.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/CustomSetupBase"
+          }
+        }
+      },
+      "additionalProperties": {
+        "type": "object"
+      }
+    },
+    "SecretBase": {
+      "description": "The base definition of a secret type.",
+      "discriminator": "type",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "description": "Type of the secret."
+        }
+      },
+      "required": [
+        "type"
+      ]
+    },
+    "SecureString": {
+      "x-ms-discriminator-value": "SecureString",
+      "description": "Azure Synapse secure string definition. The string value will be masked with asterisks '*' during Get or List API calls.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/SecretBase"
+        }
+      ],
+      "properties": {
+        "value": {
+          "type": "string",
+          "description": "Value of secure string."
+        }
+      },
+      "required": [
+        "value"
+      ]
+    },
+    "IntegrationRuntimeSsisCatalogInfo": {
+      "description": "Catalog information for managed dedicated integration runtime.",
+      "type": "object",
+      "properties": {
+        "catalogServerEndpoint": {
+          "description": "The catalog database server URL.",
+          "type": "string"
+        },
+        "catalogAdminUserName": {
+          "description": "The administrator user name of catalog database.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "catalogAdminPassword": {
+          "description": "The password of the administrator user account of the catalog database.",
+          "$ref": "#/definitions/SecureString"
+        },
+        "catalogPricingTier": {
+          "description": "The pricing tier for the catalog database. The valid values could be found in https://azure.microsoft.com/en-us/pricing/details/sql-database/",
+          "type": "string",
+          "enum": [
+            "Basic",
+            "Standard",
+            "Premium",
+            "PremiumRS"
+          ],
+          "x-ms-enum": {
+            "name": "IntegrationRuntimeSsisCatalogPricingTier",
+            "modelAsString": true
+          }
+        }
+      },
+      "additionalProperties": {
+        "type": "object"
+      }
+    },
+    "IntegrationRuntimeCustomSetupScriptProperties": {
+      "description": "Custom setup script properties for a managed dedicated integration runtime.",
+      "type": "object",
+      "properties": {
+        "blobContainerUri": {
+          "description": "The URI of the Azure blob container that contains the custom setup script.",
+          "type": "string"
+        },
+        "sasToken": {
+          "description": "The SAS token of the Azure blob container.",
+          "$ref": "#/definitions/SecureString"
+        }
+      }
+    },
+    "IntegrationRuntimeDataProxyProperties": {
+      "description": "Data proxy properties for a managed dedicated integration runtime.",
+      "type": "object",
+      "properties": {
+        "connectVia": {
+          "description": "The self-hosted integration runtime reference.",
+          "$ref": "#/definitions/EntityReference"
+        },
+        "stagingLinkedService": {
+          "description": "The staging linked service reference.",
+          "$ref": "#/definitions/EntityReference"
+        },
+        "path": {
+          "description": "The path to contain the staged data in the Blob storage.",
+          "type": "string"
+        }
+      }
+    },
+    "CustomSetupBase": {
+      "description": "The base definition of the custom setup.",
+      "type": "object",
+      "discriminator": "type",
+      "properties": {
+        "type": {
+          "description": "The type of custom setup.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "type"
+      ]
+    },
+    "CmdkeySetup": {
+      "description": "The custom setup of running cmdkey commands.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/CustomSetupBase"
+        }
+      ],
+      "properties": {
+        "typeProperties": {
+          "description": "Cmdkey command custom setup type properties.",
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/CmdkeySetupTypeProperties"
+        }
+      },
+      "required": [
+        "typeProperties"
+      ]
+    },
+    "CmdkeySetupTypeProperties": {
+      "description": "Cmdkey command custom setup type properties.",
+      "type": "object",
+      "properties": {
+        "targetName": {
+          "description": "The server name of data source access.",
+          "type": "object"
+        },
+        "userName": {
+          "description": "The user name of data source access.",
+          "type": "object"
+        },
+        "password": {
+          "description": "The password of data source access.",
+          "$ref": "#/definitions/SecretBase"
+        }
+      },
+      "required": [
+        "targetName",
+        "userName",
+        "password"
+      ]
+    },
+    "EnvironmentVariableSetup": {
+      "description": "The custom setup of setting environment variable.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/CustomSetupBase"
+        }
+      ],
+      "properties": {
+        "typeProperties": {
+          "description": "Add environment variable type properties.",
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/EnvironmentVariableSetupTypeProperties"
+        }
+      },
+      "required": [
+        "typeProperties"
+      ]
+    },
+    "EnvironmentVariableSetupTypeProperties": {
+      "description": "Environment variable custom setup type properties.",
+      "type": "object",
+      "properties": {
+        "variableName": {
+          "description": "The name of the environment variable.",
+          "type": "string"
+        },
+        "variableValue": {
+          "description": "The value of the environment variable.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "variableName",
+        "variableValue"
+      ]
+    },
+    "ComponentSetup": {
+      "description": "The custom setup of installing 3rd party components.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/CustomSetupBase"
+        }
+      ],
+      "properties": {
+        "typeProperties": {
+          "description": "Install 3rd party component type properties.",
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/LicensedComponentSetupTypeProperties"
+        }
+      },
+      "required": [
+        "typeProperties"
+      ]
+    },
+    "LicensedComponentSetupTypeProperties": {
+      "description": "Installation of licensed component setup type properties.",
+      "type": "object",
+      "properties": {
+        "componentName": {
+          "description": "The name of the 3rd party component.",
+          "type": "string"
+        },
+        "licenseKey": {
+          "description": "The license key to activate the component.",
+          "$ref": "#/definitions/SecretBase"
+        }
+      },
+      "required": [
+        "componentName"
+      ]
+    },
+    "EntityReference": {
+      "description": "The entity reference.",
+      "type": "object",
+      "properties": {
+        "type": {
+          "description": "The type of this referenced entity.",
+          "type": "string",
+          "enum": [
+            "IntegrationRuntimeReference",
+            "LinkedServiceReference"
+          ],
+          "x-ms-enum": {
+            "name": "IntegrationRuntimeEntityReferenceType",
+            "modelAsString": true
+          }
+        },
+        "referenceName": {
+          "description": "The name of this referenced entity.",
+          "type": "string"
+        }
+      }
+    },
+    "SelfHostedIntegrationRuntime": {
+      "x-ms-discriminator-value": "SelfHosted",
+      "description": "Self-hosted integration runtime.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/IntegrationRuntime"
+        }
+      ],
+      "properties": {
+        "typeProperties": {
+          "description": "When this property is not null, means this is a linked integration runtime. The property is used to access original integration runtime.",
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/SelfHostedIntegrationRuntimeTypeProperties"
+        }
+      }
+    },
+    "SelfHostedIntegrationRuntimeTypeProperties": {
+      "description": "The self-hosted integration runtime properties.",
+      "type": "object",
+      "properties": {
+        "linkedInfo": {
+          "$ref": "#/definitions/LinkedIntegrationRuntimeType"
+        }
+      }
+    },
+    "LinkedIntegrationRuntimeType": {
+      "description": "The base definition of a linked integration runtime.",
+      "discriminator": "authorizationType",
+      "type": "object",
+      "properties": {
+        "authorizationType": {
+          "type": "string",
+          "description": "The authorization type for integration runtime sharing."
+        }
+      },
+      "required": [
+        "authorizationType"
+      ]
+    },
+    "LinkedIntegrationRuntimeKeyAuthorization": {
+      "x-ms-discriminator-value": "Key",
+      "description": "The key authorization type integration runtime.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/LinkedIntegrationRuntimeType"
+        }
+      ],
+      "properties": {
+        "key": {
+          "description": "The key used for authorization.",
+          "$ref": "#/definitions/SecureString"
+        }
+      },
+      "required": [
+        "key"
+      ]
+    },
+    "LinkedIntegrationRuntimeRbacAuthorization": {
+      "x-ms-discriminator-value": "RBAC",
+      "description": "The role based access control (RBAC) authorization type integration runtime.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/LinkedIntegrationRuntimeType"
+        }
+      ],
+      "properties": {
+        "resourceId": {
+          "description": "The resource identifier of the integration runtime to be shared.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "resourceId"
+      ]
+    },
+    "IntegrationRuntimeStatus": {
+      "description": "Integration runtime status.",
+      "type": "object",
+      "discriminator": "type",
+      "properties": {
+        "type": {
+          "description": "Type of integration runtime.",
+          "$ref": "#/definitions/IntegrationRuntimeType"
+        },
+        "dataFactoryName": {
+          "description": "The workspace name which the integration runtime belong to.",
+          "type": "string",
+          "readOnly": true
+        },
+        "state": {
+          "description": "The state of integration runtime.",
+          "$ref": "#/definitions/IntegrationRuntimeState",
+          "readOnly": true
+        }
+      },
+      "additionalProperties": {
+        "type": "object"
+      },
+      "required": [
+        "type"
+      ]
+    },
+    "IntegrationRuntimeState": {
+      "description": "The state of integration runtime.",
+      "type": "string",
+      "readOnly": true,
+      "enum": [
+        "Initial",
+        "Stopped",
+        "Started",
+        "Starting",
+        "Stopping",
+        "NeedRegistration",
+        "Online",
+        "Limited",
+        "Offline",
+        "AccessDenied"
+      ],
+      "x-ms-enum": {
+        "name": "IntegrationRuntimeState",
+        "modelAsString": true
+      }
+    },
+    "ManagedIntegrationRuntimeStatus": {
+      "x-ms-discriminator-value": "Managed",
+      "description": "Managed integration runtime status.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/IntegrationRuntimeStatus"
+        }
+      ],
+      "properties": {
+        "typeProperties": {
+          "description": "Managed integration runtime status type properties.",
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ManagedIntegrationRuntimeStatusTypeProperties"
+        }
+      },
+      "required": [
+        "typeProperties"
+      ]
+    },
+    "ManagedIntegrationRuntimeStatusTypeProperties": {
+      "description": "Managed integration runtime status type properties.",
+      "type": "object",
+      "properties": {
+        "createTime": {
+          "description": "The time at which the integration runtime was created, in ISO8601 format.",
+          "type": "string",
+          "format": "date-time",
+          "readOnly": true
+        },
+        "nodes": {
+          "description": "The list of nodes for managed integration runtime.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ManagedIntegrationRuntimeNode"
+          },
+          "readOnly": true
+        },
+        "otherErrors": {
+          "description": "The errors that occurred on this integration runtime.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ManagedIntegrationRuntimeError"
+          },
+          "readOnly": true
+        },
+        "lastOperation": {
+          "description": "The last operation result that occurred on this integration runtime.",
+          "$ref": "#/definitions/ManagedIntegrationRuntimeOperationResult",
+          "readOnly": true
+        }
+      }
+    },
+    "ManagedIntegrationRuntimeOperationResult": {
+      "description": "Properties of managed integration runtime operation result.",
+      "properties": {
+        "type": {
+          "description": "The operation type. Could be start or stop.",
+          "type": "string",
+          "readOnly": true
+        },
+        "startTime": {
+          "description": "The start time of the operation.",
+          "type": "string",
+          "format": "date-time",
+          "readOnly": true
+        },
+        "result": {
+          "description": "The operation result.",
+          "type": "string",
+          "readOnly": true
+        },
+        "errorCode": {
+          "description": "The error code.",
+          "type": "string",
+          "readOnly": true
+        },
+        "parameters": {
+          "description": "Managed integration runtime error parameters.",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "description": "Error message parameters."
+          },
+          "readOnly": true
+        },
+        "activityId": {
+          "description": "The activity id for the operation request.",
+          "type": "string",
+          "readOnly": true
+        }
+      },
+      "additionalProperties": {
+        "type": "object"
+      }
+    },
+    "ManagedIntegrationRuntimeNode": {
+      "description": "Properties of integration runtime node.",
+      "properties": {
+        "nodeId": {
+          "description": "The managed integration runtime node id.",
+          "type": "string",
+          "readOnly": true
+        },
+        "status": {
+          "description": "The managed integration runtime node status.",
+          "type": "string",
+          "readOnly": true,
+          "enum": [
+            "Starting",
+            "Available",
+            "Recycling",
+            "Unavailable"
+          ],
+          "x-ms-enum": {
+            "name": "ManagedIntegrationRuntimeNodeStatus",
+            "modelAsString": true
+          }
+        },
+        "errors": {
+          "description": "The errors that occurred on this integration runtime node.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ManagedIntegrationRuntimeError"
+          }
+        }
+      },
+      "additionalProperties": {
+        "type": "object"
+      }
+    },
+    "ManagedIntegrationRuntimeError": {
+      "description": "Error definition for managed integration runtime.",
+      "properties": {
+        "time": {
+          "description": "The time when the error occurred.",
+          "type": "string",
+          "format": "date-time",
+          "readOnly": true
+        },
+        "code": {
+          "description": "Error code.",
+          "type": "string",
+          "readOnly": true
+        },
+        "parameters": {
+          "description": "Managed integration runtime error parameters.",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "description": "Error message parameters."
+          },
+          "readOnly": true
+        },
+        "message": {
+          "description": "Error message.",
+          "type": "string",
+          "readOnly": true
+        }
+      },
+      "additionalProperties": {
+        "type": "object"
+      }
+    },
+    "SelfHostedIntegrationRuntimeStatus": {
+      "x-ms-discriminator-value": "SelfHosted",
+      "description": "Self-hosted integration runtime status.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/IntegrationRuntimeStatus"
+        }
+      ],
+      "properties": {
+        "typeProperties": {
+          "description": "Self-hosted integration runtime status type properties.",
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/SelfHostedIntegrationRuntimeStatusTypeProperties"
+        }
+      },
+      "required": [
+        "typeProperties"
+      ]
+    },
+    "SelfHostedIntegrationRuntimeStatusTypeProperties": {
+      "description": "Self-hosted integration runtime status type properties.",
+      "type": "object",
+      "properties": {
+        "createTime": {
+          "description": "The time at which the integration runtime was created, in ISO8601 format.",
+          "type": "string",
+          "format": "date-time",
+          "readOnly": true
+        },
+        "taskQueueId": {
+          "description": "The task queue id of the integration runtime.",
+          "type": "string",
+          "readOnly": true
+        },
+        "internalChannelEncryption": {
+          "description": "It is used to set the encryption mode for node-node communication channel (when more than 2 self-hosted integration runtime nodes exist).",
+          "type": "string",
+          "readOnly": true,
+          "enum": [
+            "NotSet",
+            "SslEncrypted",
+            "NotEncrypted"
+          ],
+          "x-ms-enum": {
+            "name": "IntegrationRuntimeInternalChannelEncryptionMode",
+            "modelAsString": true
+          }
+        },
+        "version": {
+          "description": "Version of the integration runtime.",
+          "type": "string",
+          "readOnly": true
+        },
+        "nodes": {
+          "description": "The list of nodes for this integration runtime.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SelfHostedIntegrationRuntimeNode"
+          }
+        },
+        "scheduledUpdateDate": {
+          "description": "The date at which the integration runtime will be scheduled to update, in ISO8601 format.",
+          "type": "string",
+          "format": "date-time",
+          "readOnly": true
+        },
+        "updateDelayOffset": {
+          "description": "The time in the date scheduled by service to update the integration runtime, e.g., PT03H is 3 hours",
+          "type": "string",
+          "readOnly": true
+        },
+        "localTimeZoneOffset": {
+          "description": "The local time zone offset in hours.",
+          "type": "string",
+          "readOnly": true
+        },
+        "capabilities": {
+          "description": "Object with additional information about integration runtime capabilities.",
+          "type": "object",
+          "readOnly": true,
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "serviceUrls": {
+          "description": "The URLs for the services used in integration runtime backend service.",
+          "type": "array",
+          "items": {
+            "description": "The service URL",
+            "type": "string"
+          },
+          "readOnly": true
+        },
+        "autoUpdate": {
+          "description": "Whether Self-hosted integration runtime auto update has been turned on.",
+          "$ref": "#/definitions/IntegrationRuntimeAutoUpdate",
+          "readOnly": true
+        },
+        "versionStatus": {
+          "description": "Status of the integration runtime version.",
+          "type": "string",
+          "readOnly": true
+        },
+        "links": {
+          "description": "The list of linked integration runtimes that are created to share with this integration runtime.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/LinkedIntegrationRuntime"
+          }
+        },
+        "pushedVersion": {
+          "description": "The version that the integration runtime is going to update to.",
+          "type": "string",
+          "readOnly": true
+        },
+        "latestVersion": {
+          "description": "The latest version on download center.",
+          "type": "string",
+          "readOnly": true
+        },
+        "autoUpdateETA": {
+          "description": "The estimated time when the self-hosted integration runtime will be updated.",
+          "type": "string",
+          "format": "date-time",
+          "readOnly": true
+        }
+      }
+    },
+    "IntegrationRuntimeAutoUpdate": {
+      "description": "The state of integration runtime auto update.",
+      "type": "string",
+      "enum": [
+        "On",
+        "Off"
+      ],
+      "x-ms-enum": {
+        "name": "IntegrationRuntimeAutoUpdate",
+        "modelAsString": true
+      }
+    },
+    "LinkedIntegrationRuntime": {
+      "description": "The linked integration runtime information.",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "The name of the linked integration runtime.",
+          "type": "string",
+          "readOnly": true
+        },
+        "subscriptionId": {
+          "description": "The subscription ID for which the linked integration runtime belong to.",
+          "type": "string",
+          "readOnly": true
+        },
+        "dataFactoryName": {
+          "description": "The name of the workspace for which the linked integration runtime belong to.",
+          "type": "string",
+          "readOnly": true
+        },
+        "dataFactoryLocation": {
+          "description": "The location of the workspace for which the linked integration runtime belong to.",
+          "type": "string",
+          "readOnly": true
+        },
+        "createTime": {
+          "description": "The creating time of the linked integration runtime.",
+          "type": "string",
+          "format": "date-time",
+          "readOnly": true
+        }
+      }
+    },
+    "SelfHostedIntegrationRuntimeNode": {
+      "description": "Properties of Self-hosted integration runtime node.",
+      "properties": {
+        "nodeName": {
+          "description": "Name of the integration runtime node.",
+          "type": "string",
+          "readOnly": true
+        },
+        "machineName": {
+          "description": "Machine name of the integration runtime node.",
+          "type": "string",
+          "readOnly": true
+        },
+        "hostServiceUri": {
+          "description": "URI for the host machine of the integration runtime.",
+          "type": "string",
+          "readOnly": true
+        },
+        "status": {
+          "description": "Status of the integration runtime node.",
+          "type": "string",
+          "readOnly": true,
+          "enum": [
+            "NeedRegistration",
+            "Online",
+            "Limited",
+            "Offline",
+            "Upgrading",
+            "Initializing",
+            "InitializeFailed"
+          ],
+          "x-ms-enum": {
+            "name": "SelfHostedIntegrationRuntimeNodeStatus",
+            "modelAsString": true
+          }
+        },
+        "capabilities": {
+          "description": "The integration runtime capabilities dictionary",
+          "type": "object",
+          "readOnly": true,
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "versionStatus": {
+          "description": "Status of the integration runtime node version.",
+          "type": "string",
+          "readOnly": true
+        },
+        "version": {
+          "description": "Version of the integration runtime node.",
+          "type": "string",
+          "readOnly": true
+        },
+        "registerTime": {
+          "description": "The time at which the integration runtime node was registered in ISO8601 format.",
+          "type": "string",
+          "format": "date-time",
+          "readOnly": true
+        },
+        "lastConnectTime": {
+          "description": "The most recent time at which the integration runtime was connected in ISO8601 format.",
+          "type": "string",
+          "format": "date-time",
+          "readOnly": true
+        },
+        "expiryTime": {
+          "description": "The time at which the integration runtime will expire in ISO8601 format.",
+          "type": "string",
+          "format": "date-time",
+          "readOnly": true
+        },
+        "lastStartTime": {
+          "description": "The time the node last started up.",
+          "type": "string",
+          "format": "date-time",
+          "readOnly": true
+        },
+        "lastStopTime": {
+          "description": "The integration runtime node last stop time.",
+          "type": "string",
+          "format": "date-time",
+          "readOnly": true
+        },
+        "lastUpdateResult": {
+          "description": "The result of the last integration runtime node update.",
+          "type": "string",
+          "enum": [
+            "None",
+            "Succeed",
+            "Fail"
+          ],
+          "x-ms-enum": {
+            "name": "IntegrationRuntimeUpdateResult",
+            "modelAsString": true
+          },
+          "readOnly": true
+        },
+        "lastStartUpdateTime": {
+          "description": "The last time for the integration runtime node update start.",
+          "type": "string",
+          "format": "date-time",
+          "readOnly": true
+        },
+        "lastEndUpdateTime": {
+          "description": "The last time for the integration runtime node update end.",
+          "type": "string",
+          "format": "date-time",
+          "readOnly": true
+        },
+        "isActiveDispatcher": {
+          "description": "Indicates whether this node is the active dispatcher for integration runtime requests.",
+          "type": "boolean",
+          "readOnly": true
+        },
+        "concurrentJobsLimit": {
+          "description": "Maximum concurrent jobs on the integration runtime node.",
+          "type": "integer",
+          "readOnly": true
+        },
+        "maxConcurrentJobs": {
+          "description": "The maximum concurrent jobs in this integration runtime.",
+          "type": "integer",
+          "readOnly": true
+        }
+      },
+      "additionalProperties": {
+        "type": "object"
+      }
+    },
+    "IntegrationRuntimeConnectionInfo": {
+      "description": "Connection information for encrypting the on-premises data source credentials.",
+      "type": "object",
+      "properties": {
+        "serviceToken": {
+          "description": "The token generated in service. Callers use this token to authenticate to integration runtime.",
+          "type": "string",
+          "readOnly": true
+        },
+        "identityCertThumbprint": {
+          "description": "The integration runtime SSL certificate thumbprint. Click-Once application uses it to do server validation.",
+          "type": "string",
+          "readOnly": true
+        },
+        "hostServiceUri": {
+          "description": "The on-premises integration runtime host URL.",
+          "type": "string",
+          "readOnly": true
+        },
+        "version": {
+          "description": "The integration runtime version.",
+          "type": "string",
+          "readOnly": true
+        },
+        "publicKey": {
+          "description": "The public key for encrypting a credential when transferring the credential to the integration runtime.",
+          "type": "string",
+          "readOnly": true
+        },
+        "isIdentityCertExprired": {
+          "description": "Whether the identity certificate is expired.",
+          "type": "boolean",
+          "readOnly": true
+        }
+      },
+      "additionalProperties": {
+        "type": "object"
+      }
+    },
+    "IntegrationRuntimeRegenerateKeyParameters": {
+      "description": "Parameters to regenerate the authentication key.",
+      "type": "object",
+      "properties": {
+        "keyName": {
+          "description": "The name of the authentication key to regenerate.",
+          "type": "string",
+          "enum": [
+            "authKey1",
+            "authKey2"
+          ],
+          "x-ms-enum": {
+            "name": "IntegrationRuntimeAuthKeyName",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "IntegrationRuntimeAuthKeys": {
+      "description": "The integration runtime authentication keys.",
+      "type": "object",
+      "properties": {
+        "authKey1": {
+          "type": "string",
+          "description": "The primary integration runtime authentication key."
+        },
+        "authKey2": {
+          "type": "string",
+          "description": "The secondary integration runtime authentication key."
+        }
+      }
+    },
+    "IntegrationRuntimeMonitoringData": {
+      "description": "Get monitoring data response.",
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Integration runtime name."
+        },
+        "nodes": {
+          "type": "array",
+          "description": "Integration runtime node monitoring data.",
+          "items": {
+            "$ref": "#/definitions/IntegrationRuntimeNodeMonitoringData"
+          }
+        }
+      }
+    },
+    "IntegrationRuntimeNodeMonitoringData": {
+      "description": "Monitoring data for integration runtime node.",
+      "type": "object",
+      "properties": {
+        "nodeName": {
+          "description": "Name of the integration runtime node.",
+          "type": "string",
+          "readOnly": true
+        },
+        "availableMemoryInMB": {
+          "description": "Available memory (MB) on the integration runtime node.",
+          "type": "integer",
+          "readOnly": true
+        },
+        "cpuUtilization": {
+          "description": "CPU percentage on the integration runtime node.",
+          "type": "integer",
+          "readOnly": true
+        },
+        "concurrentJobsLimit": {
+          "description": "Maximum concurrent jobs on the integration runtime node.",
+          "type": "integer",
+          "readOnly": true
+        },
+        "concurrentJobsRunning": {
+          "description": "The number of jobs currently running on the integration runtime node.",
+          "type": "integer",
+          "readOnly": true
+        },
+        "maxConcurrentJobs": {
+          "description": "The maximum concurrent jobs in this integration runtime.",
+          "type": "integer",
+          "readOnly": true
+        },
+        "sentBytes": {
+          "description": "Sent bytes on the integration runtime node.",
+          "type": "number",
+          "readOnly": true
+        },
+        "receivedBytes": {
+          "description": "Received bytes on the integration runtime node.",
+          "type": "number",
+          "readOnly": true
+        }
+      },
+      "additionalProperties": {
+        "type": "object"
+      }
+    },
+    "IntegrationRuntimeNodeIpAddress": {
+      "type": "object",
+      "description": "The IP address of self-hosted integration runtime node.",
+      "properties": {
+        "ipAddress": {
+          "description": "The IP address of self-hosted integration runtime node.",
+          "type": "string",
+          "readOnly": true
+        }
+      }
+    },
+    "SsisObjectMetadataListResponse": {
+      "type": "object",
+      "description": "A list of SSIS object metadata.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "description": "List of SSIS object metadata.",
+          "items": {
+            "$ref": "#/definitions/SsisObjectMetadata"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "The link to the next page of results, if any remaining results exist."
+        }
+      }
+    },
+    "SsisObjectMetadata": {
+      "type": "object",
+      "description": "SSIS object metadata.",
+      "discriminator": "type",
+      "properties": {
+        "type": {
+          "description": "Type of metadata.",
+          "$ref": "#/definitions/SsisObjectMetadataType"
+        },
+        "id": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Metadata id."
+        },
+        "name": {
+          "type": "string",
+          "description": "Metadata name."
+        },
+        "description": {
+          "type": "string",
+          "description": "Metadata description."
+        }
+      },
+      "required": [
+        "type"
+      ]
+    },
+    "SsisObjectMetadataType": {
+      "description": "The type of SSIS object metadata.",
+      "type": "string",
+      "enum": [
+        "Folder",
+        "Project",
+        "Package",
+        "Environment"
+      ],
+      "x-ms-enum": {
+        "name": "SsisObjectMetadataType",
+        "modelAsString": true
+      }
+    },
+    "SsisFolder": {
+      "x-ms-discriminator-value": "Folder",
+      "type": "object",
+      "description": "Ssis folder.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/SsisObjectMetadata"
+        }
+      ]
+    },
+    "SsisProject": {
+      "x-ms-discriminator-value": "Project",
+      "type": "object",
+      "description": "Ssis project.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/SsisObjectMetadata"
+        }
+      ],
+      "properties": {
+        "folderId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Folder id which contains project."
+        },
+        "version": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Project version."
+        },
+        "environmentRefs": {
+          "type": "array",
+          "description": "Environment reference in project",
+          "items": {
+            "$ref": "#/definitions/SsisEnvironmentReference"
+          }
+        },
+        "parameters": {
+          "type": "array",
+          "description": "Parameters in project",
+          "items": {
+            "$ref": "#/definitions/SsisParameter"
+          }
+        }
+      }
+    },
+    "SsisPackage": {
+      "x-ms-discriminator-value": "Package",
+      "type": "object",
+      "description": "Ssis Package.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/SsisObjectMetadata"
+        }
+      ],
+      "properties": {
+        "folderId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Folder id which contains package."
+        },
+        "projectVersion": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Project version which contains package."
+        },
+        "projectId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Project id which contains package."
+        },
+        "parameters": {
+          "type": "array",
+          "description": "Parameters in package",
+          "items": {
+            "$ref": "#/definitions/SsisParameter"
+          }
+        }
+      }
+    },
+    "SsisEnvironment": {
+      "x-ms-discriminator-value": "Environment",
+      "type": "object",
+      "description": "Ssis environment.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/SsisObjectMetadata"
+        }
+      ],
+      "properties": {
+        "folderId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Folder id which contains environment."
+        },
+        "variables": {
+          "type": "array",
+          "description": "Variable in environment",
+          "items": {
+            "$ref": "#/definitions/SsisVariable"
+          }
+        }
+      }
+    },
+    "SsisParameter": {
+      "type": "object",
+      "description": "Ssis parameter.",
+      "properties": {
+        "id": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Parameter id."
+        },
+        "name": {
+          "type": "string",
+          "description": "Parameter name."
+        },
+        "description": {
+          "type": "string",
+          "description": "Parameter description."
+        },
+        "dataType": {
+          "type": "string",
+          "description": "Parameter type."
+        },
+        "required": {
+          "type": "boolean",
+          "description": "Whether parameter is required."
+        },
+        "sensitive": {
+          "type": "boolean",
+          "description": "Whether parameter is sensitive."
+        },
+        "designDefaultValue": {
+          "type": "string",
+          "description": "Design default value of parameter."
+        },
+        "defaultValue": {
+          "type": "string",
+          "description": "Default value of parameter."
+        },
+        "sensitiveDefaultValue": {
+          "type": "string",
+          "description": "Default sensitive value of parameter."
+        },
+        "valueType": {
+          "type": "string",
+          "description": "Parameter value type."
+        },
+        "valueSet": {
+          "type": "boolean",
+          "description": "Parameter value set."
+        },
+        "variable": {
+          "type": "string",
+          "description": "Parameter reference variable."
+        }
+      }
+    },
+    "SsisVariable": {
+      "type": "object",
+      "description": "Ssis variable.",
+      "properties": {
+        "id": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Variable id."
+        },
+        "name": {
+          "type": "string",
+          "description": "Variable name."
+        },
+        "description": {
+          "type": "string",
+          "description": "Variable description."
+        },
+        "dataType": {
+          "type": "string",
+          "description": "Variable type."
+        },
+        "sensitive": {
+          "type": "boolean",
+          "description": "Whether variable is sensitive."
+        },
+        "value": {
+          "type": "string",
+          "description": "Variable value."
+        },
+        "sensitiveValue": {
+          "type": "string",
+          "description": "Variable sensitive value."
+        }
+      }
+    },
+    "SsisEnvironmentReference": {
+      "type": "object",
+      "description": "Ssis environment reference.",
+      "properties": {
+        "id": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Environment reference id."
+        },
+        "environmentFolderName": {
+          "type": "string",
+          "description": "Environment folder name."
+        },
+        "environmentName": {
+          "type": "string",
+          "description": "Environment name."
+        },
+        "referenceType": {
+          "type": "string",
+          "description": "Reference type"
+        }
+      }
+    },
+    "CloudError": {
+      "x-ms-external": true,
+      "description": "The object that defines the structure of an Azure Synapse error response.",
+      "type": "object",
+      "properties": {
+        "error": {
+          "x-ms-client-flatten": true,
+          "description": "Error data",
+          "$ref": "#/definitions/CloudErrorBody"
+        }
+      },
+      "required": [
+        "error"
+      ]
+    },
+    "CloudErrorBody": {
+      "x-ms-external": true,
+      "description": "The object that defines the structure of an Azure Synapse error.",
+      "type": "object",
+      "properties": {
+        "code": {
+          "description": "Error code.",
+          "type": "string"
+        },
+        "message": {
+          "description": "Error message.",
+          "type": "string"
+        },
+        "target": {
+          "description": "Property name/path in request associated with error.",
+          "type": "string"
+        },
+        "details": {
+          "description": "Array with additional error details.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/CloudError"
+          }
+        }
+      },
+      "required": [
+        "code",
+        "message"
+      ]
+    },
+    "UpdateIntegrationRuntimeRequest": {
+      "description": "Update integration runtime request.",
+      "type": "object",
+      "properties": {
+        "autoUpdate": {
+          "description": "Enables or disables the auto-update feature of the self-hosted integration runtime. See https://go.microsoft.com/fwlink/?linkid=854189.",
+          "$ref": "#/definitions/IntegrationRuntimeAutoUpdate"
+        },
+        "updateDelayOffset": {
+          "description": "The time offset (in hours) in the day, e.g., PT03H is 3 hours. The integration runtime auto update will happen on that time.",
+          "type": "string"
+        }
+      }
+    },
+    "IntegrationRuntimeResource": {
+      "description": "Integration runtime resource type.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/SubResource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/IntegrationRuntime",
+          "description": "Integration runtime properties."
+        }
+      },
+      "required": [
+        "properties"
+      ]
+    },
+    "GetSsisObjectMetadataRequest": {
+      "type": "object",
+      "description": "The request payload of get SSIS object metadata.",
+      "properties": {
+        "metadataPath": {
+          "type": "string",
+          "description": "Metadata path."
+        }
+      }
+    },
+    "UpdateIntegrationRuntimeNodeRequest": {
+      "description": "Update integration runtime node request.",
+      "type": "object",
+      "properties": {
+        "concurrentJobsLimit": {
+          "description": "The number of concurrent jobs permitted to run on the integration runtime node. Values between 1 and maxConcurrentJobs(inclusive) are allowed.",
+          "type": "integer",
+          "minimum": 1
+        }
+      }
+    },
+    "IntegrationRuntimeListResponse": {
+      "description": "A list of integration runtime resources.",
+      "type": "object",
+      "required": [
+        "value"
+      ],
+      "properties": {
+        "value": {
+          "type": "array",
+          "description": "List of integration runtimes.",
+          "items": {
+            "$ref": "#/definitions/IntegrationRuntimeResource"
+          }
+        },
+        "nextLink": {
+          "description": "The link to the next page of results, if any remaining results exist.",
+          "type": "string"
+        }
+      }
+    },
+    "IntegrationRuntimeStatusResponse": {
+      "description": "Integration runtime status response.",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The integration runtime name.",
+          "readOnly": true
+        },
+        "properties": {
+          "$ref": "#/definitions/IntegrationRuntimeStatus",
+          "description": "Integration runtime properties."
+        }
+      },
+      "required": [
+        "properties"
+      ]
+    },
+    "SsisObjectMetadataStatusResponse": {
+      "type": "object",
+      "description": "The status of the operation.",
+      "properties": {
+        "status": {
+          "type": "string",
+          "description": "The status of the operation."
+        },
+        "name": {
+          "type": "string",
+          "description": "The operation name."
+        },
+        "properties": {
+          "type": "string",
+          "description": "The operation properties."
+        },
+        "error": {
+          "type": "string",
+          "description": "The operation error message."
+        }
+      }
+    }
+  },
+  "parameters": {
+    "IntegrationRuntimeNameParameter": {
+      "name": "integrationRuntimeName",
+      "type": "string",
+      "required": true,
+      "in": "path",
+      "description": "Integration runtime name",
+      "x-ms-parameter-location": "method"
+    }
+  }
+}
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/sqlPool.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/sqlPool.json
index 89cbb96cc710..5d40707bd2ae 100644
--- a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/sqlPool.json
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/sqlPool.json
@@ -113,6 +113,9 @@
               "$ref": "#/definitions/SqlPool"
             },
             "description": "OK"
+          },
+          "202": {
+            "description": "Accepted"
           }
         },
         "consumes": [],
diff --git a/specification/synapse/resource-manager/readme.md b/specification/synapse/resource-manager/readme.md
index c315c5b92f5f..8187b4cf96c6 100644
--- a/specification/synapse/resource-manager/readme.md
+++ b/specification/synapse/resource-manager/readme.md
@@ -43,6 +43,7 @@ input-file:
 - Microsoft.Synapse/preview/2019-06-01-preview/operations.json
 - Microsoft.Synapse/preview/2019-06-01-preview/sqlPool.json
 - Microsoft.Synapse/preview/2019-06-01-preview/workspace.json
+- Microsoft.Synapse/preview/2019-06-01-preview/integrationRuntime.json
 ```
 
 ## Suppressions
@@ -122,6 +123,7 @@ input-file:
   - $(this-folder)/Microsoft.Synapse/preview/2019-06-01-preview/operations.json
   - $(this-folder)/Microsoft.Synapse/preview/2019-06-01-preview/sqlPool.json
   - $(this-folder)/Microsoft.Synapse/preview/2019-06-01-preview/workspace.json
+  - $(this-folder)/Microsoft.Synapse/preview/2019-06-01-preview/integrationRuntime.json
 
 ```